summaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
authorAlexey Zelkin <phantom@FreeBSD.org>1999-09-18 16:19:01 +0000
committerAlexey Zelkin <phantom@FreeBSD.org>1999-09-18 16:19:01 +0000
commit78ee35a9f80f80acc3e1717c995e8c2161259424 (patch)
tree9fac26189b1fbe740f0590fbb10d6f84ae8bdb49 /lib
parentea6e6f1fa154a92ee9bba35240b3fde354b01327 (diff)
Notes
Diffstat (limited to 'lib')
-rw-r--r--lib/libc/sys/_exit.26
-rw-r--r--lib/libc/sys/chflags.27
-rw-r--r--lib/libc/sys/fork.22
-rw-r--r--lib/libc/sys/getdtablesize.23
-rw-r--r--lib/libc/sys/getlogin.23
-rw-r--r--lib/libc/sys/gettimeofday.24
-rw-r--r--lib/libc/sys/issetugid.211
-rw-r--r--lib/libc/sys/kldfind.23
-rw-r--r--lib/libc/sys/kldfirstmod.23
-rw-r--r--lib/libc/sys/kldload.23
-rw-r--r--lib/libc/sys/kldnext.23
-rw-r--r--lib/libc/sys/kldstat.23
-rw-r--r--lib/libc/sys/kldunload.23
-rw-r--r--lib/libc/sys/ktrace.22
-rw-r--r--lib/libc/sys/nanosleep.213
-rw-r--r--lib/libc/sys/quotactl.214
-rw-r--r--lib/libc/sys/reboot.27
-rw-r--r--lib/libc/sys/recv.23
-rw-r--r--lib/libc/sys/rtprio.22
-rw-r--r--lib/libc/sys/sigreturn.22
20 files changed, 64 insertions, 33 deletions
diff --git a/lib/libc/sys/_exit.2 b/lib/libc/sys/_exit.2
index cd8688b83687..a7d282d6f504 100644
--- a/lib/libc/sys/_exit.2
+++ b/lib/libc/sys/_exit.2
@@ -67,7 +67,9 @@ is set as defined by
.It
The parent process-ID of all of the calling process's existing child
processes are set to 1; the initialization process
-(see the DEFINITIONS section of
+(see the
+.Sx DEFINITIONS
+section of
.Xr intro 2 )
inherits each of these processes.
.It
@@ -98,7 +100,7 @@ which flushes buffers, closes streams, unlinks temporary files, etc.,
before
calling
.Fn _exit .
-.Sh RETURN VALUE
+.Sh RETURN VALUES
.Fn _exit
can never return.
.Sh SEE ALSO
diff --git a/lib/libc/sys/chflags.2 b/lib/libc/sys/chflags.2
index 553a284f2423..305a73e3fa79 100644
--- a/lib/libc/sys/chflags.2
+++ b/lib/libc/sys/chflags.2
@@ -30,6 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)chflags.2 8.3 (Berkeley) 5/2/95
+.\" $FreeBSD$
.\"
.Dd May 2, 1995
.Dt CHFLAGS 2
@@ -80,16 +81,14 @@ The file may not be renamed or deleted.
.El
.Pp
The
-.Dq UF_IMMUTABLE
-,
+.Dq UF_IMMUTABLE ,
.Dq UF_APPEND
and
.Dq UF_NOUNLINK
flags may be set or unset by either the owner of a file or the super-user.
.Pp
The
-.Dq SF_IMMUTABLE
-,
+.Dq SF_IMMUTABLE ,
.Dq SF_APPEND
and
.Dq SF_NOUNLINK
diff --git a/lib/libc/sys/fork.2 b/lib/libc/sys/fork.2
index 2e76bc0998aa..d01e60035e60 100644
--- a/lib/libc/sys/fork.2
+++ b/lib/libc/sys/fork.2
@@ -122,6 +122,6 @@ There is insufficient swap space for the new process.
.Xr wait 2
.Sh HISTORY
A
-.Fn fork 2
+.Fn fork
function call appeared in
.At v6 .
diff --git a/lib/libc/sys/getdtablesize.2 b/lib/libc/sys/getdtablesize.2
index 8251fec96747..d9bca9d3ba16 100644
--- a/lib/libc/sys/getdtablesize.2
+++ b/lib/libc/sys/getdtablesize.2
@@ -30,6 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)getdtablesize.2 8.1 (Berkeley) 6/4/93
+,\" $FreeBSD$
.\"
.Dd June 4, 1993
.Dt GETDTABLESIZE 2
@@ -55,6 +56,6 @@ returns the size of this table.
.Xr select 2
.Sh HISTORY
The
-.Nm
+.Fn getdtablesize
function call appeared in
.Bx 4.2 .
diff --git a/lib/libc/sys/getlogin.2 b/lib/libc/sys/getlogin.2
index f628b3189bd7..53a1a926bb69 100644
--- a/lib/libc/sys/getlogin.2
+++ b/lib/libc/sys/getlogin.2
@@ -30,6 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)getlogin.2 8.1 (Berkeley) 6/9/93
+.\" $FreeBSD$
.\"
.Dd June 9, 1993
.Dt GETLOGIN 2
@@ -57,7 +58,7 @@ and is inherited by all processes descended from the login shell.
(This is true even if some of those processes assume another user ID,
for example when
.Xr su 1
-is used.)
+is used).
.Pp
.Fn Setlogin
sets the login name of the user associated with the current session to
diff --git a/lib/libc/sys/gettimeofday.2 b/lib/libc/sys/gettimeofday.2
index 7ac615c9518b..cb385a49bb92 100644
--- a/lib/libc/sys/gettimeofday.2
+++ b/lib/libc/sys/gettimeofday.2
@@ -59,7 +59,9 @@ call, and set with the
call. The time is expressed in seconds and microseconds
since midnight (0 hour), January 1, 1970. The resolution of the system
clock is hardware dependent, and the time may be updated continuously or
-in ``ticks.'' If
+in
+.Dq ticks .
+If
.Fa tp
or
.Fa tzp
diff --git a/lib/libc/sys/issetugid.2 b/lib/libc/sys/issetugid.2
index bc131081f55a..91adf6cd72cb 100644
--- a/lib/libc/sys/issetugid.2
+++ b/lib/libc/sys/issetugid.2
@@ -47,7 +47,9 @@
The
.Fn issetugid
function returns 1 if the process environment or memory address space
-is considered ``tainted'', and returns 0 otherwise.
+is considered
+.Dq tainted ,
+and returns 0 otherwise.
.Pp
A process is tainted if it was created as a result of an
.Xr execve 2
@@ -61,13 +63,16 @@ that was obtained from the user, in particular the results from
.Xr getenv 3
should be viewed with suspicion if it is used to control operation.
.Pp
-A ``tainted'' status is inherited by child processes as a result of the
+A
+.Dq tainted
+status is inherited by child processes as a result of the
.Xr fork 2
system call (or other library code that calls fork, such as
.Xr popen 3 ) .
.Pp
It is assumed that a program that clears all privileges as it prepares
-to execute another will also reset the environment, hence the ``tainted''
+to execute another will also reset the environment, hence the
+.Dq tainted
status will not be passed on. This is important for programs such as
.Xr su 1
which begin setuid but need to be able to create an untainted process.
diff --git a/lib/libc/sys/kldfind.2 b/lib/libc/sys/kldfind.2
index 4e4e71dcca3e..c01ce7daa190 100644
--- a/lib/libc/sys/kldfind.2
+++ b/lib/libc/sys/kldfind.2
@@ -72,4 +72,5 @@ does not exist or is not readable.
.Sh HISTORY
The
.Nm kld
-interface first appeared in FreeBSD 3.0.
+interface first appeared in
+.Fx 3.0 .
diff --git a/lib/libc/sys/kldfirstmod.2 b/lib/libc/sys/kldfirstmod.2
index f5901c4b4329..29e43d69e4dd 100644
--- a/lib/libc/sys/kldfirstmod.2
+++ b/lib/libc/sys/kldfirstmod.2
@@ -63,4 +63,5 @@ was not found.
.Sh HISTORY
The
.Nm kld
-interface first appeared in FreeBSD 3.0.
+interface first appeared in
+.Fx 3.0 .
diff --git a/lib/libc/sys/kldload.2 b/lib/libc/sys/kldload.2
index 8df9ffae2146..7a2f9a1dd15f 100644
--- a/lib/libc/sys/kldload.2
+++ b/lib/libc/sys/kldload.2
@@ -79,4 +79,5 @@ was unrecognized.
.Sh HISTORY
The
.Nm kld
-interface first appeared in FreeBSD 3.0.
+interface first appeared in
+.Fx 3.0 .
diff --git a/lib/libc/sys/kldnext.2 b/lib/libc/sys/kldnext.2
index c253dc27e14b..9e7356433fd8 100644
--- a/lib/libc/sys/kldnext.2
+++ b/lib/libc/sys/kldnext.2
@@ -66,4 +66,5 @@ refers to a kld file that does not exist (isn't loaded).
.Sh HISTORY
The
.Nm kld
-interface first appeared in FreeBSD 3.0.
+interface first appeared in
+.Fx 3.0 .
diff --git a/lib/libc/sys/kldstat.2 b/lib/libc/sys/kldstat.2
index 91fb58e8553a..bc9adb3db67c 100644
--- a/lib/libc/sys/kldstat.2
+++ b/lib/libc/sys/kldstat.2
@@ -112,4 +112,5 @@ function.
.Sh HISTORY
The
.Nm kld
-interface first appeared in FreeBSD 3.0.
+interface first appeared in
+.Fx 3.0 .
diff --git a/lib/libc/sys/kldunload.2 b/lib/libc/sys/kldunload.2
index 92a16e20900d..fd803e7c2ace 100644
--- a/lib/libc/sys/kldunload.2
+++ b/lib/libc/sys/kldunload.2
@@ -74,4 +74,5 @@ You attempted to unload a file linked by the kernel.
.Sh HISTORY
The
.Nm kld
-interface first appeared in FreeBSD 3.0.
+interface first appeared in
+.Fx 3.0 .
diff --git a/lib/libc/sys/ktrace.2 b/lib/libc/sys/ktrace.2
index e15aeea45e69..9b25bdb1cbc4 100644
--- a/lib/libc/sys/ktrace.2
+++ b/lib/libc/sys/ktrace.2
@@ -162,6 +162,6 @@ support.
.Xr ktrace 1
.Sh HISTORY
A
-.Nm ktrace
+.Fn ktrace
function call first appeared in
.Bx 4.4 .
diff --git a/lib/libc/sys/nanosleep.2 b/lib/libc/sys/nanosleep.2
index c560582c4026..fe39fd74fdef 100644
--- a/lib/libc/sys/nanosleep.2
+++ b/lib/libc/sys/nanosleep.2
@@ -40,6 +40,7 @@
.Os
.Sh NAME
.Nm nanosleep
+.Nd suspend process execution for an interval measured in nanoseconds
.Sh SYNOPSIS
.Fd #include <time.h>
.Ft int
@@ -50,7 +51,7 @@ causes the process to sleep for the specified time. An unmasked signal will
cause it to terminate the sleep early, regardless of the
.Dv SA_RESTART
value on the interrupting signal.
-.Sh RETURN VALUE
+.Sh RETURN VALUES
If the
.Fn nanosleep
function returns because the requested time has elapsed, the value
@@ -68,12 +69,12 @@ is
.Pf non- Dv NULL ,
the timespec structure it references is updated to contain the
unslept amount (the request time minus the time actually slept).
-.Sh ERRORS
+.Pp
If any of the following conditions occur, the
-.Nm
+.Fn nanosleep
function shall return -1 and set
.Va errno
-to the corresponding value.
+to the corresponding value:
.Bl -tag -width Er
.It Bq Er EFAULT
Either
@@ -83,14 +84,14 @@ or
points to memory that is not a valid part of the process
address space.
.It Bq Er EINTR
-.Nm
+.Fn nanosleep
was interrupted by the delivery of a signal.
.It Bq Er EINVAL
.Fa rqtp
specified a nanosecond value less than zero
or greater than or equal to 1000 million.
.It Bq Er ENOSYS
-.Nm
+.Fn nanosleep
is not supported by this implementation.
.El
.Sh SEE ALSO
diff --git a/lib/libc/sys/quotactl.2 b/lib/libc/sys/quotactl.2
index ac6d912aaeb9..675863c57302 100644
--- a/lib/libc/sys/quotactl.2
+++ b/lib/libc/sys/quotactl.2
@@ -33,6 +33,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)quotactl.2 8.2 (Berkeley) 3/10/95
+.\" $FreeBSD$
.\"
.Dd March 10, 1995
.Dt QUOTACTL 2
@@ -66,15 +67,20 @@ The address of an optional command specific data structure,
may be given; its interpretation
is discussed below with each command.
.Pp
-Currently quotas are supported only for the ``ufs'' filesystem.
-For ``ufs'',
+Currently quotas are supported only for the
+.Dq ufs
+filesystem.
+For
+.Dq ufs ,
a command is composed of a primary command (see below)
and a command type used to interpret the
.Fa id .
Types are supported for interpretation of user identifiers (USRQUOTA)
and group identifiers (GRPQUOTA).
-The ``ufs'' specific commands are:
-.Bl -tag -width Q_QUOTAON
+The
+.Dq ufs
+specific commands are:
+.Bl -tag -width Q_QUOTAOFFxx
.It Dv Q_QUOTAON
Enable disk quotas for the filesystem specified by
.Fa path .
diff --git a/lib/libc/sys/reboot.2 b/lib/libc/sys/reboot.2
index 1eda9b353223..f7a28bcc3906 100644
--- a/lib/libc/sys/reboot.2
+++ b/lib/libc/sys/reboot.2
@@ -30,6 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)reboot.2 8.1 (Berkeley) 6/4/93
+.\" $FreeBSD$
.\"
.Dd June 4, 1993
.Dt REBOOT 2
@@ -122,16 +123,18 @@ on the console.
is actually interpreted by the
.Xr init 8
program in the newly booted system.
+.El
.Pp
When no options are given (i.e.,
.Dv RB_AUTOBOOT
is used), the system is
-rebooted from file ``kernel'' in the root file system of unit 0
+rebooted from file
+.Dq kernel
+in the root file system of unit 0
of a disk chosen in a processor specific way.
An automatic consistency check of the disks is normally performed
(see
.Xr fsck 8 ) .
-.El
.Sh RETURN VALUES
If successful, this call never returns.
Otherwise, a -1 is returned and an error is returned in the global
diff --git a/lib/libc/sys/recv.2 b/lib/libc/sys/recv.2
index fdf02e32631e..a18db890b3b8 100644
--- a/lib/libc/sys/recv.2
+++ b/lib/libc/sys/recv.2
@@ -30,6 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)recv.2 8.3 (Berkeley) 2/21/94
+.\" $FreeBSD$
.\"
.Dd February 21, 1994
.Dt RECV 2
@@ -120,6 +121,7 @@ one or more of the values:
.It Dv MSG_PEEK Ta peek at incoming message
.It Dv MSG_WAITALL Ta wait for full request or error
.El
+.Pp
The
.Dv MSG_OOB
flag requests receipt of out-of-band data
@@ -182,6 +184,7 @@ struct cmsghdr {
/* followed by
u_char cmsg_data[]; */
};
+.Pp
.Ed
As an example, one could use this to learn of changes in the data-stream
in XNS/SPP, or in ISO, to obtain user-connection-request data by requesting
diff --git a/lib/libc/sys/rtprio.2 b/lib/libc/sys/rtprio.2
index ddc204cb09c6..579ed1bf45c0 100644
--- a/lib/libc/sys/rtprio.2
+++ b/lib/libc/sys/rtprio.2
@@ -98,7 +98,7 @@ The specified process was not found.
The original author was
.An Henrik Vestergaard Draboel Aq hvd@terry.ping.dk .
This implementation in
-.Bx Free
+.Fx
was substantially rewritten by
.An David Greenman .
.Sh SEE ALSO
diff --git a/lib/libc/sys/sigreturn.2 b/lib/libc/sys/sigreturn.2
index 0e848c3169f0..5f9597246adf 100644
--- a/lib/libc/sys/sigreturn.2
+++ b/lib/libc/sys/sigreturn.2
@@ -30,6 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)sigreturn.2 8.1 (Berkeley) 6/4/93
+.\" $FreeBSD$
.\"
.Dd June 4, 1993
.Dt SIGRETURN 2
@@ -39,6 +40,7 @@
.Nd return from signal
.Sh SYNOPSIS
.Fd #include <signal.h>
+.Pp
.Bd -literal
struct sigcontext {
int sc_onstack; /* sigstack state to restore */