Visit Our UNIX and Linux User Community

Linux and UNIX Man Pages

Test Your Knowledge in Computers #32
Difficulty: Easy
There are 9 pins in a basic serial port.
True or False?
Linux & Unix Commands - Search Man Pages

setregid(2) [ultrix man page]

setregid(2)							System Calls Manual						       setregid(2)

Name
       setregid - set real and effective group ID

Syntax
       setregid(rgid, egid)
       int rgid, egid;

Description
       The real and effective group ID's of the current process are set to the arguments.

       Supplying a value of -1 for either the real or effective group ID forces the system to substitute the current ID for the -1 parameter.

Environment
       BSD
       If  the	process is superuser, or and matches with the real group ID, the effective group ID, or the saved set-group-id (as described in ),
       then the real, effective, and saved set-group-id are set to and respectively.

       POSIX
       SYSTEM-FIVE
       When your program is compiled in POSIX or SYSTEM-FIVE mode, the following semantics apply when using the function.

       If the process is the superuser, the real, effective, and saved set-group-id (as described in ) are set to and respectively.

       If the process is not the superuser, but the and matches the real group ID, the effective group ID (only in SYSTEM-FIVE	and  BSD  environ-
       ment), or the saved set-group-id, then the effective ID is set to The real group ID and the saved set-group-id are left unchanged.

Return Values
       Upon successful completion, a value of zero (0) is returned.  Otherwise, a value of -1 is returned, and errno is set to indicate the error.

Diagnostics
       [EPERM]	      The  current process is not the superuser and the and specified does not match with the real group ID or the effective group
		      ID (only in SYSTEM-FIVE and BSD environment) or the saved set-group-id.

See Also
       getgid(2), setreuid(2), setgid(3)

																       setregid(2)

Check Out this Related Man Page

setregid(2)							   System Calls 						       setregid(2)

NAME
setregid - set real and effective group IDs SYNOPSIS
#include <unistd.h> int setregid(gid_t rgid, gid_t egid); DESCRIPTION
The setregid() function is used to set the real and effective group IDs of the calling process. If rgid is -1, the real group ID is not changed; if egid is -1, the effective group ID is not changed. The real and effective group IDs may be set to different values in the same call. If the {PRIV_PROC_SETID} privilege is asserted in the effective set of the calling process, the real group ID and the effective group ID can be set to any legal value. If the {PRIV_PROC_SETID} privilege is not asserted in the effective set of the calling process, either the real group ID can be set to the saved set-group-ID from execve(2), or the effective group ID can either be set to the saved set-group-ID or the real group ID. In either case, if the real group ID is being changed (that is, if rgid is not -1), or the effective group ID is being changed to a value not equal to the real group ID, the saved set-group-ID is set equal to the new effective group ID. RETURN VALUES
Upon successful completion, 0 is returned. Otherwise, -1 is returned, errno is set to indicate the error, and neither of the group IDs will be changed. ERRORS
The setregid() function will fail if: EINVAL The value of rgid or egid is less than 0 or greater than UID_MAX (defined in <limits.h>). EPERM The {PRIV_PROC_SETID} privilege is not asserted in the effective set of the calling processes and a change was specified other than changing the real group ID to the saved set-group-ID or changing the effective group ID to the real group ID or the saved group ID. USAGE
If a set-group-ID process sets its effective group ID to its real group ID, it can still set its effective group ID back to the saved set- group-ID. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ SEE ALSO
execve(2), getgid(2), setreuid(2), setuid(2), attributes(5), privileges(5), standards(5) SunOS 5.10 22 Mar 2004 setregid(2)

Featured Tech Videos