diff options
| author | Kaz Kylheku <kaz@kylheku.com> | 2016-05-01 18:54:03 -0700 |
|---|---|---|
| committer | Kaz Kylheku <kaz@kylheku.com> | 2016-05-01 18:54:03 -0700 |
| commit | 9bbc744c3b5e0584ad7c9abe244128572a692229 (patch) | |
| tree | dc82317dbb71798d60bb637fe8ae53ce651d13b4 /txr.1 | |
| parent | 9c6d6519236f536efcd284f714e6f3f145767a57 (diff) | |
| download | txr-9bbc744c3b5e0584ad7c9abe244128572a692229.tar.gz txr-9bbc744c3b5e0584ad7c9abe244128572a692229.tar.bz2 txr-9bbc744c3b5e0584ad7c9abe244128572a692229.zip | |
Adding setgroups function.
* configure: Test for setgroups. New HAVE_SETGROUPS
preprocessor symbol for config/config.h.
* sysif.c (setgroups_wrap): New static function.
(sysif_init): Register intrinsic setgroups function.
* txr.1: Documented setgroups. Rearranged sections
so getgroups and setgroups descriptions are consecutive.
Diffstat (limited to 'txr.1')
| -rw-r--r-- | txr.1 | 44 |
1 files changed, 32 insertions, 12 deletions
@@ -36954,6 +36954,23 @@ of the same name. They retrieve the real user ID, effective user ID, real group ID and effective group ID, respectively, of the calling process. +.coNP Functions @, setuid @, seteuid @ setgid and @ setegid +.synb +.mets (setuid << uid ) +.mets (seteuid << uid ) +.mets (setgid << gid ) +.mets (setegid << gid ) +.syne +.desc +These functions directly correspond to the POSIX C library functions +of the same name. They set the real user ID, effective user ID, +real group ID and effective group ID, respectively, of the calling +process. +On success, they return +.codn t . +On failure, they throw an exception of type +.codn system-error . + .coNP Function @ getgroups .synb .mets (getgroups) @@ -36969,21 +36986,24 @@ Whether or not the effective group ID retrieved by is included in this list is system-dependent. Programs should not depend on its presence or absence. -.coNP Functions @, setuid @, seteuid @ setgid and @ setegid +.coNP Function @ setgroups .synb -.mets (setuid << uid ) -.mets (seteuid << uid ) -.mets (setgid << gid ) -.mets (setegid << gid ) +.mets (setgroups << gid-list ) .syne .desc -These functions directly correspond to the POSIX C library functions -of the same name. They set the real user ID, effective user ID, -real group ID and effective group ID, respectively, of the calling -process. -On success, they return -.codn t . -On failure, they throw an exception of type +The +.code setgroups +function corresponds to a C library function found in some Unix +operating systems, complementary to the +.code getgroups +function. The argument to +.meta gid-list +must be a list of numeric group IDs. +If the function is successful, this list is installed as the list of +supplementary group IDs of the calling process, and the value +.code t +is returned. +On failure, it throws an exception of type .codn system-error . .SS* Unix Password Database |