NAME
Unix::setuid - Get/set real/effective UID/username via (localizeable)
variable
VERSION
This document describes version 0.02 of Unix::setuid (from Perl
distribution Unix-setuid), released on 2014-10-09.
SYNOPSIS
use Unix::setuid; # exports $RUID, $EUID, $RUSER, $EUSER
say "Real UID : $RUID";
say "Effective UID : $EUID";
say "Real username : $RUSER";
say "Effective user: $EUSER";
{
# become UID 1000 temporarily
local $EUID = 1000;
# same thing
#local $EUSER = "jajang"; # or 1000
}
# we're back to previous UID/user
DESCRIPTION
This module is inspired by File::chdir and File::umask, using a tied
scalar variable to get/set stuffs. One benefit of this is being able to
use Perl's "local" with it, effectively setting something locally.
EXPORTS
$RUID (real UID)
This will get/set $<.
$EUID (effective UID)
This will get/set $>.
$RUSER (real user)
Same as $RUID except you will get username and you can set using
UID/username. Will return numeric UID if no user exists with that ID.
Will die if setting to non-existing username.
$EUSER (effective user)
Same as $EUID except you will get username and you can set using
UID/username. Will return numeric UID if no user exists with that ID.
Will die if setting to non-existing username.
SEE ALSO
Perl's $< and $>.
Other modules with the same concept: File::chdir, File::umask,
Locale::Tie.
HOMEPAGE
Please visit the project's homepage at
<
https://metacpan.org/release/Unix-setuid>.
SOURCE
Source repository is at
<
https://github.com/perlancar/perl-System-setuid>.
BUGS
Please report any bugs or feature requests on the bugtracker website
<
https://rt.cpan.org/Public/Dist/Display.html?Name=Unix-setuid>
When submitting a bug or request, please include a test-file or a patch
to an existing test-file that illustrates the bug or desired feature.
AUTHOR
perlancar <
[email protected]>
COPYRIGHT AND LICENSE
This software is copyright (c) 2014 by
[email protected].
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.