|SETRUID(3)||FreeBSD Library Functions Manual||SETRUID(3)|
NAMEsetruid, setrgid — set user and group ID
LIBRARYStandard C Library (libc, -lc)
SYNOPSIS#include < unistd.h>
setruid( uid_t ruid);
setrgid( gid_t rgid);
DESCRIPTIONThe setruid() function ( setrgid()) sets the real user ID (group ID) of the current process.
RETURN VALUESUpon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error.
COMPATIBILITYThe use of these calls is not portable. Their use is discouraged; they will be removed in the future.
ERRORSThe functions fail if:
- [ EPERM]
- The user is not the super user and the ID specified is not the real or effective ID.
HISTORYThe setruid() and setrgid() syscalls appeared in 4.2BSD and were dropped in 4.4BSD.
|June 2, 1993||FreeBSD|