A module for handling UNIX privileges
Perl 6 C Makefile
Switch branches/tags
Nothing to show
Permalink
Failed to load latest commit information.
lib/UNIX Update to work with v6.c Jan 23, 2017
src Update to work with v6.c Jan 23, 2017
t Add META test Aug 24, 2017
.gitignore Update to work with v6.c Jan 23, 2017
Build.pm Update to work with v6.c Jan 23, 2017
LICENSE Add License Aug 29, 2015
META6.json Modernise the META Aug 24, 2017
README.md Add installation instrunctions Aug 24, 2017

README.md

UNIX::Privileges

A module for handling UNIX privileges

Example

Synopsis:

use UNIX::Privileges;

UNIX::Privileges::userinfo($user);
UNIX::Privileges::chown($user, $file);
UNIX::Privileges::drop($user);
UNIX::Privileges::chroot($directory);

Example usage:

use UNIX::Privileges;

UNIX::Privileges::chown("nobody", "test.txt");
UNIX::Privileges::drop("nobody");

Example with a chroot:

use UNIX::Privileges;

my $user = UNIX::Privileges::userinfo("nobody");
UNIX::Privileges::chown($user, "/tmp/test.txt");
UNIX::Privileges::chroot("/tmp");
# once in the chroot access to the system password file is lost
# therefore UNIX::Privileges::drop("nobody") will no longer work
# as the system cannot find the uid or gid of "nobody" anymore
# fortunately we already have this information in the $user var
# that we defined above by calling UNIX::Privileges::userinfo
# just remember you have to do this *before* creating the chroot
UNIX::Privileges::drop($user);

Installation

Assuming ypu have a working Rakudo Perl 6 installation you can install this with zef :

zef install UNIX::Privileges