
The URLs of the form `help://man/<section>/<page>` link to another help page inside the help application. All previous relative page links are replaced by this new form. This doesn't change any behavior but it looks much nicer :^) Note that man doesn't handle these new links, but the previous relative links didn't work either.
37 lines
967 B
Markdown
37 lines
967 B
Markdown
## Name
|
|
|
|
setuid, setgid - set user / group ID
|
|
|
|
## Synopsis
|
|
|
|
```**c++
|
|
#include <unistd.h>
|
|
|
|
int setuid(uid_t);
|
|
int setgid(gid_t);
|
|
```
|
|
|
|
## Description
|
|
|
|
Sets all of real, effective, and saved user or group ID to the given ID.
|
|
|
|
For non-superusers, the given ID has to be equal to the current real or effective ID for the call to succeed.
|
|
|
|
## Return value
|
|
|
|
If the call was set successful, returns 0.
|
|
Otherwise, returns -1 and sets `errno` to describe the error.
|
|
|
|
## Errors
|
|
|
|
* `EPERM`: The new ID is not equal to the real ID or effective ID, and the user is not superuser.
|
|
* `EINVAL`: The new ID is set to invalid value (-1).
|
|
|
|
## See also
|
|
|
|
* [`setuid_overview`(7)](help://man/7/setuid_overview)
|
|
* [`geteuid`(2) / `getegid`(2)](help://man/2/geteuid)
|
|
* [`getuid`(2) / `getgid`(2)](help://man/2/getuid)
|
|
* [`getresuid`(2) / `getresgid`(2)](help://man/2/getresuid)
|
|
* [`seteuid`(2) / `setegid`(2)](help://man/2/seteuid)
|
|
* [`setresuid`(2) / `setresgid`(2)](help://man/2/setresuid)
|