d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document the SUSER_RUID flag.

Browse Source 
Reminded by:	pjd
This commit is contained in:
Colin Percival 2004-07-17 15:21:34 +00:00
parent ebf89b8e17
commit 75877b7564
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=132294
1 changed files with 14 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
share/man/man9/suser.9
View File

@ -62,8 +62,9 @@ circumstances dictate otherwise.
The
.Fn suser_cred
function should be used when the credentials to be checked are
not the thread's own, when there is no thread, or when superuser
powers should be extended to imprisoned roots.
not the thread's own, when there is no thread, when superuser
powers should be extended to imprisoned roots, or when the credential
to be checked is the real user rather than the effective user.
.Pp
By default, a process does not command superuser powers if it has
been imprisoned by the
@ -85,6 +86,17 @@ implicit in the
.Xr jail 2
call should such powers be granted.
.Pp
By default, the credential checked is the effective user. There are cases
where it is instead necessary to check the real user (for example, when
determining if resource limits should be applied), and this can be done
by passing the
.Dv SUSER_RUID
flag in the
.Fa flag
argument to the
.Fn suser_cred
function.
.Pp
The
.Fn suser
and