Document the getresgid and getresuid system calls.
authorSascha Wildner <swildner@dragonflybsd.org>
Fri, 3 Aug 2007 08:40:14 +0000 (08:40 +0000)
committerSascha Wildner <swildner@dragonflybsd.org>
Fri, 3 Aug 2007 08:40:14 +0000 (08:40 +0000)
Taken-from: FreeBSD

lib/libc/sys/Makefile.inc
lib/libc/sys/setresuid.2

index 8806734..01469a6 100644 (file)
@@ -1,6 +1,6 @@
 #      @(#)Makefile.inc        8.3 (Berkeley) 10/24/94
 # $FreeBSD: src/lib/libc/sys/Makefile.inc,v 1.75.2.7 2003/04/22 17:31:18 trhodes Exp $
-# $DragonFly: src/lib/libc/sys/Makefile.inc,v 1.27 2007/07/05 17:36:46 josepht Exp $
+# $DragonFly: src/lib/libc/sys/Makefile.inc,v 1.28 2007/08/03 08:40:14 swildner Exp $
 
 # sys sources
 .PATH: ${.CURDIR}/../libc/${MACHINE_ARCH}/sys ${.CURDIR}/../libc/sys
@@ -130,7 +130,7 @@ MLINKS+=read.2 pread.2 read.2 preadv.2 read.2 readv.2
 MLINKS+=recv.2 recvfrom.2 recv.2 recvmsg.2
 MLINKS+=send.2 sendmsg.2 send.2 sendto.2
 MLINKS+=setpgid.2 setpgrp.2
-MLINKS+=setresuid.2 setresgid.2
+MLINKS+=setresuid.2 getresgid.2 setresuid.2 getresuid.2 setresuid.2 setresgid.2
 MLINKS+=setuid.2 setegid.2 setuid.2 seteuid.2 setuid.2 setgid.2
 MLINKS+=shmat.2 shmdt.2
 MLINKS+=stat.2 fstat.2 stat.2 lstat.2
index 7fdeee5..7f6fd4a 100644 (file)
 .\" DAMAGES
 .\"
 .\" $FreeBSD: src/lib/libc/sys/setresuid.2,v 1.2.2.8 2001/12/14 18:34:01 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/setresuid.2,v 1.3 2004/03/11 12:28:51 hmp Exp $
+.\" $DragonFly: src/lib/libc/sys/setresuid.2,v 1.4 2007/08/03 08:40:14 swildner Exp $
 .\"
-.Dd January 17, 2000
+.Dd August 3, 2007
 .Dt SETRESUID 2
 .Os
 .Sh NAME
+.Nm getresgid ,
+.Nm getresuid ,
 .Nm setresgid ,
 .Nm setresuid
-.Nd set real, effective and saved user or group ID
+.Nd get or set real, effective and saved user or group ID
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In sys/types.h
 .In unistd.h
 .Ft int
+.Fn getresgid "gid_t *rgid" "gid_t *egid" "gid_t *sgid"
+.Ft int
+.Fn getresuid "uid_t *ruid" "uid_t *euid" "uid_t *suid"
+.Ft int
 .Fn setresgid "gid_t rgid" "gid_t egid" "gid_t sgid"
 .Ft int
 .Fn setresuid "uid_t ruid" "uid_t euid" "uid_t suid"
@@ -52,10 +58,23 @@ in that each of the new IDs must match one of the current IDs.
 .Pp
 Passing -1 as an argument causes the corresponding value
 to remain unchanged.
+.Pp
+The
+.Fn getresgid
+and
+.Fn getresuid
+calls retrieve the real, effective, and saved group and user IDs of
+the current process, respectively.
 .Sh RETURN VALUES
 .Rv -std
 .Sh ERRORS
 .Bl -tag -width Er
+.It Bq Er EFAULT
+An address passed to
+.Fn getresgid
+or
+.Fn getresuid
+was invalid.
 .It Bq Er EPERM
 The calling process was not privileged
 and tried to change one or more IDs to a value