README
1NAME
2 Unix::Groups - Perl to support "getgroups" and "setgroups" syscalls
3
4SYNOPSIS
5 use Unix::Groups qw/:all/;
6
7 $ngroups_max=NGROUPS_MAX;
8 @gids=getgroups;
9 $success=setgroups(@gids);
10
11INSTALLATION
12 perl Makefile.PL
13 make
14 make test
15 make install
16
17DESCRIPTION
18 This module implements a very thin layer around the getgroups(2) and
19 setgroups(2) syscalls. See your system manual for more information.
20
21 Note, the module is written and tested on Linux. For other UNIX-like
22 systems there are good chances that it will work at least if it compiles
23 properly.
24
25 Functions
26 $n=NGROUPS_MAX
27 returns the max. number of arguments that "setgroups" will accept.
28
29 @gids=getgroups
30 returns the list of supplementary group IDs of the current process. It
31 is very similar to the $( variable. But $( is a string and its first
32 element is the current effective GID.
33
34 $success=setgroups @gids
35 sets the list of supplementary group IDs of the current process. On most
36 systems this is a privileged operation. On Linux "CAP_SETGID" is
37 required.
38
39 EXPORT
40 None by default.
41
42 On demand all functions are exported.
43
44 Export tags
45 :all
46 export all functions.
47
48SEE ALSO
49 Linux manual.
50
51AUTHOR
52 Torsten Förtsch, <torsten.foertsch@gmx.net>
53
54COPYRIGHT AND LICENSE
55 Copyright (C) 2011 by Torsten Foertsch
56
57 This library is free software; you can redistribute it and/or modify it
58 under the same terms as Perl itself, either Perl version 5.12.3 or, at
59 your option, any later version of Perl 5 you may have available.
60
61