summaryrefslogtreecommitdiffstats
path: root/share/man/man9/suser.9
diff options
context:
space:
mode:
authorsheldonh <sheldonh@FreeBSD.org>2000-08-17 08:17:16 +0000
committersheldonh <sheldonh@FreeBSD.org>2000-08-17 08:17:16 +0000
commit01355e8af4a3105c282b454994af85f7f3ebda2c (patch)
tree0cdd20d5799bd697edc6bb61369ee66a52db1f4f /share/man/man9/suser.9
parent14e8818587db0aeacd1e3ab544ae126caf402d6d (diff)
downloadFreeBSD-src-01355e8af4a3105c282b454994af85f7f3ebda2c.zip
FreeBSD-src-01355e8af4a3105c282b454994af85f7f3ebda2c.tar.gz
Clear extraneous arguments to the name (Nm) macro.
Mark PRISON_ROOT and EPERM as defined values (Dv).
Diffstat (limited to 'share/man/man9/suser.9')
-rw-r--r--share/man/man9/suser.916
1 files changed, 9 insertions, 7 deletions
diff --git a/share/man/man9/suser.9 b/share/man/man9/suser.9
index 7b3591d..ec63456 100644
--- a/share/man/man9/suser.9
+++ b/share/man/man9/suser.9
@@ -50,13 +50,13 @@
.Fn suser_xxx "struct ucred *cred" "struct proc *proc" "int flags"
.Sh DESCRIPTION
The
-.Nm suser
+.Nm
and
.Nm suser_xxx
functions checks if the credentials given include superuser powers.
.Pp
The
-.Nm suser
+.Nm
function is the most common, and should be used unless special
circumstances dictate otherwise.
.Pp
@@ -72,7 +72,7 @@ been imprisoned by the
system call.
There are cases however where this is appropriate, and this can
be done by setting the
-.Ql PRISON_ROOT
+.Dv PRISON_ROOT
bit in the flags argument to the
.Nm suser_xxx
function. It is important to review carefully in each case that
@@ -84,7 +84,7 @@ implicit in
call should such powers be granted.
.Pp
The
-.Nm suser
+.Nm
and
.Nm suser_xxx
functions note the fact that superuser powers have been used in the
@@ -95,14 +95,16 @@ the functions should only be called after other permission
possibilities have been exhausted.
.Sh RETURN VALUES
The
-.Nm suser
+.Nm
and
.Nm suser_xxx
-functions return 0 if the user has superuser powers and EPERM otherwise.
+functions return 0 if the user has superuser powers and
+.Dv EPERM
+otherwise.
This is the
.Em reverse logic
of some other implementations of
-.Nm suser
+.Nm
in which a TRUE response indicates superuser powers.
.Sh SEE ALSO
.Xr chroot 2 ,
OpenPOWER on IntegriCloud