From 7e0f021a9aec35fd8e6725e87e3313b101d26f5e Mon Sep 17 00:00:00 2001 From: Tobias Klauser Date: Sun, 27 Jan 2008 11:37:44 +0100 Subject: Initial import (2.0.2-6) --- reference/C/MAN/getgroupd.htm | 163 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 163 insertions(+) create mode 100644 reference/C/MAN/getgroupd.htm (limited to 'reference/C/MAN/getgroupd.htm') diff --git a/reference/C/MAN/getgroupd.htm b/reference/C/MAN/getgroupd.htm new file mode 100644 index 0000000..e6cd339 --- /dev/null +++ b/reference/C/MAN/getgroupd.htm @@ -0,0 +1,163 @@ +getgroups + +
+
+
+
+
+
GETGROUPS(2)        Linux Programmer's Manual        GETGROUPS(2)
+

+
+
NAME
+
       getgroups, setgroups - get/set group access list
+
+
SYNOPSIS
+
       #include <unistd.h>
+
+       int getgroups(int size, gid_t list[]);
+
+
+       #define __USE_BSD
+       #include <grp.h>
+
+       int setgroups(size_t size, const gid_t *list);
+
+
DESCRIPTION
+
       getgroups
+              Up  to  size  supplemental  groups  are returned in
+              list.  If size is zero, list is not  modified,  but
+              the  total  number  of  supplemental groups for the
+              process is returned.
+
+       setgroups
+              Sets the supplemental groups for the process.  Only
+              the super-user may use this function.
+
+
RETURN VALUE
+
       getgroups
+              On  success, the number of groups stored in list is
+              returned (if size is zero, however, the  number  of
+              supplemental  group IDs associated with the process
+              is returned).  On error, -1 is returned, and  errno
+              is set appropriately.
+
+       setgroups
+              On  success,  zero  is  returned.   On error, -1 is
+              returned, and errno is set appropriately.
+
+
ERRORS
+
       EFAULT list has an invalid address.
+
+       EPERM  For setgroups, the user is not the super-user.
+
+       EINVAL For setgroups, gidsetsize is greater  than  NGROUPS
+              (32 for Linux 0.99.11).
+
+
CONFORMING TO
+
       getgroups conforms to POSIX.1 (and is present in BSD 4.3).
+       Since setgroups requires  privilege,  it  is  not  covered
+       under POSIX.1.
+
+
BUGS
+
       The __USE_BSD flag probably shouldn't be required for set-
+       groups.
+
+
+
+
+
Linux 0.99.11              23 July 1993                         1
+

+
+
+
+
+
GETGROUPS(2)        Linux Programmer's Manual        GETGROUPS(2)
+

+
+
+
+

SEE ALSO +

+initgroups, +

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Linux 0.99.11              23 July 1993                         2
+

+
+
+

+

+

+

+ + + + +
+Top + +Master Index + +Keywords + +Functions +
+
+

+

+ +This manual page was brought to you by mjl_man V-2.0 -- cgit v1.2.3-54-g00ecf