diff options
| author | Alexey Zelkin <phantom@FreeBSD.org> | 1999-09-18 16:19:01 +0000 |
|---|---|---|
| committer | Alexey Zelkin <phantom@FreeBSD.org> | 1999-09-18 16:19:01 +0000 |
| commit | 78ee35a9f80f80acc3e1717c995e8c2161259424 (patch) | |
| tree | 9fac26189b1fbe740f0590fbb10d6f84ae8bdb49 /lib | |
| parent | ea6e6f1fa154a92ee9bba35240b3fde354b01327 (diff) | |
Notes
Diffstat (limited to 'lib')
| -rw-r--r-- | lib/libc/sys/_exit.2 | 6 | ||||
| -rw-r--r-- | lib/libc/sys/chflags.2 | 7 | ||||
| -rw-r--r-- | lib/libc/sys/fork.2 | 2 | ||||
| -rw-r--r-- | lib/libc/sys/getdtablesize.2 | 3 | ||||
| -rw-r--r-- | lib/libc/sys/getlogin.2 | 3 | ||||
| -rw-r--r-- | lib/libc/sys/gettimeofday.2 | 4 | ||||
| -rw-r--r-- | lib/libc/sys/issetugid.2 | 11 | ||||
| -rw-r--r-- | lib/libc/sys/kldfind.2 | 3 | ||||
| -rw-r--r-- | lib/libc/sys/kldfirstmod.2 | 3 | ||||
| -rw-r--r-- | lib/libc/sys/kldload.2 | 3 | ||||
| -rw-r--r-- | lib/libc/sys/kldnext.2 | 3 | ||||
| -rw-r--r-- | lib/libc/sys/kldstat.2 | 3 | ||||
| -rw-r--r-- | lib/libc/sys/kldunload.2 | 3 | ||||
| -rw-r--r-- | lib/libc/sys/ktrace.2 | 2 | ||||
| -rw-r--r-- | lib/libc/sys/nanosleep.2 | 13 | ||||
| -rw-r--r-- | lib/libc/sys/quotactl.2 | 14 | ||||
| -rw-r--r-- | lib/libc/sys/reboot.2 | 7 | ||||
| -rw-r--r-- | lib/libc/sys/recv.2 | 3 | ||||
| -rw-r--r-- | lib/libc/sys/rtprio.2 | 2 | ||||
| -rw-r--r-- | lib/libc/sys/sigreturn.2 | 2 |
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 */ |
