diff options
author | Mike Pechkin <mpech@cvs.openbsd.org> | 2002-04-30 16:31:43 +0000 |
---|---|---|
committer | Mike Pechkin <mpech@cvs.openbsd.org> | 2002-04-30 16:31:43 +0000 |
commit | 53d632a56390b1be823ac94e26c8cbea0b0886ed (patch) | |
tree | c883cb4deabbed473bc5d3a0faba13f99da8281f /lib/libc/sys | |
parent | 98acfc3b963a7db3fbfdedc7829303261eb50d63 (diff) |
Initial cleanup:
o) remove extra space in the end of line;
o) remove extra blank lines in the end of file;
o) remove .Pp before .Ss;
o) CAVEAT -> CAVEATS;
o) fix usage of .Fa;
o) <blank-line> -> .Pp;
o) wrap long lines;
millert@ ok
Diffstat (limited to 'lib/libc/sys')
-rw-r--r-- | lib/libc/sys/chown.2 | 4 | ||||
-rw-r--r-- | lib/libc/sys/extattr_get_file.2 | 7 | ||||
-rw-r--r-- | lib/libc/sys/flock.2 | 4 | ||||
-rw-r--r-- | lib/libc/sys/getitimer.2 | 4 | ||||
-rw-r--r-- | lib/libc/sys/getlogin.2 | 4 | ||||
-rw-r--r-- | lib/libc/sys/getpgrp.2 | 4 | ||||
-rw-r--r-- | lib/libc/sys/getrusage.2 | 8 | ||||
-rw-r--r-- | lib/libc/sys/kqueue.2 | 40 | ||||
-rw-r--r-- | lib/libc/sys/mmap.2 | 6 | ||||
-rw-r--r-- | lib/libc/sys/open.2 | 5 | ||||
-rw-r--r-- | lib/libc/sys/pathconf.2 | 4 | ||||
-rw-r--r-- | lib/libc/sys/shmget.2 | 8 | ||||
-rw-r--r-- | lib/libc/sys/sigaction.2 | 4 |
13 files changed, 52 insertions, 50 deletions
diff --git a/lib/libc/sys/chown.2 b/lib/libc/sys/chown.2 index 3a83c3ce09e..b10157abca3 100644 --- a/lib/libc/sys/chown.2 +++ b/lib/libc/sys/chown.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chown.2,v 1.10 2001/08/06 10:42:26 mpech Exp $ +.\" $OpenBSD: chown.2,v 1.11 2002/04/30 16:31:42 mpech Exp $ .\" $NetBSD: chown.2,v 1.10 1995/10/12 15:40:47 jtc Exp $ .\" .\" Copyright (c) 1980, 1991, 1993, 1994 @@ -162,5 +162,5 @@ functions were changed to follow symbolic links in The .Fn lchown function was added to -.Ox +.Ox due to the above. diff --git a/lib/libc/sys/extattr_get_file.2 b/lib/libc/sys/extattr_get_file.2 index 94d92c4c71b..fa7a91f70be 100644 --- a/lib/libc/sys/extattr_get_file.2 +++ b/lib/libc/sys/extattr_get_file.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: extattr_get_file.2,v 1.3 2002/02/23 19:29:15 fgsch Exp $ +.\" $OpenBSD: extattr_get_file.2,v 1.4 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 2001 Dima Dorfman <dima@unixfreak.org> .\" All rights reserved. @@ -64,8 +64,7 @@ call retrieves the value of the specified extended attribute into a buffer pointed to by .Fa data of size -.Fa nbytes -. +.Fa nbytes . The .Fn extattr_set_file call sets the value of the specified extended attribute to the data @@ -130,7 +129,7 @@ is attribute-specific. .Pp For more information on named extended attributes, please see .Xr extattr 9 . -.Sh CAVEAT +.Sh CAVEATS This interface is under active development, and as such is subject to change as applications are adapted to use it. Developers are discouraged from relying on its stability. diff --git a/lib/libc/sys/flock.2 b/lib/libc/sys/flock.2 index 27e66928fe3..d3dfa03e5ce 100644 --- a/lib/libc/sys/flock.2 +++ b/lib/libc/sys/flock.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: flock.2,v 1.12 2000/10/18 05:12:09 aaron Exp $ +.\" $OpenBSD: flock.2,v 1.13 2002/04/30 16:31:42 mpech Exp $ .\" $NetBSD: flock.2,v 1.5 1995/02/27 12:32:32 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -42,7 +42,7 @@ .Nd "apply or remove an advisory lock on an open file" .Sh SYNOPSIS .Fd #include <fcntl.h> - +.Pp .Fd #define LOCK_SH 1 /* shared lock */ .Fd #define LOCK_EX 2 /* exclusive lock */ .Fd #define LOCK_NB 4 /* don't block when locking */ diff --git a/lib/libc/sys/getitimer.2 b/lib/libc/sys/getitimer.2 index f383480f215..421cebefb2c 100644 --- a/lib/libc/sys/getitimer.2 +++ b/lib/libc/sys/getitimer.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getitimer.2,v 1.16 2001/09/07 14:35:59 niklas Exp $ +.\" $OpenBSD: getitimer.2,v 1.17 2002/04/30 16:31:42 mpech Exp $ .\" $NetBSD: getitimer.2,v 1.6 1995/10/12 15:40:54 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -43,7 +43,7 @@ .Nd get/set value of interval timer .Sh SYNOPSIS .Fd #include <sys/time.h> - +.Pp .Fd #define ITIMER_REAL 0 .Fd #define ITIMER_VIRTUAL 1 .Fd #define ITIMER_PROF 2 diff --git a/lib/libc/sys/getlogin.2 b/lib/libc/sys/getlogin.2 index 38fe906ab0e..40281ba537f 100644 --- a/lib/libc/sys/getlogin.2 +++ b/lib/libc/sys/getlogin.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getlogin.2,v 1.12 2002/02/23 00:31:22 millert Exp $ +.\" $OpenBSD: getlogin.2,v 1.13 2002/04/30 16:31:42 mpech Exp $ .\" $NetBSD: getlogin.2,v 1.4 1995/02/27 12:33:03 cgd Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 @@ -81,7 +81,7 @@ that it is detached from its parent's session. The .Em ONLY way to do this is via the -.Fn setsid +.Fn setsid function. The .Fn daemon diff --git a/lib/libc/sys/getpgrp.2 b/lib/libc/sys/getpgrp.2 index cea0ddacefc..8cd6c20bb89 100644 --- a/lib/libc/sys/getpgrp.2 +++ b/lib/libc/sys/getpgrp.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getpgrp.2,v 1.8 2001/08/06 10:42:26 mpech Exp $ +.\" $OpenBSD: getpgrp.2,v 1.9 2002/04/30 16:31:42 mpech Exp $ .\" $NetBSD: getpgrp.2,v 1.8 1995/02/27 12:33:09 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -101,7 +101,7 @@ function conforms to The .Fn getpgid function call is derived from its usage in System V Release 4, and -first appeared in +first appeared in .Nx 1.2 a. .Sh COMPATIBILITY This version of diff --git a/lib/libc/sys/getrusage.2 b/lib/libc/sys/getrusage.2 index f08c11eabe8..2925486f930 100644 --- a/lib/libc/sys/getrusage.2 +++ b/lib/libc/sys/getrusage.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getrusage.2,v 1.7 2000/10/18 05:12:09 aaron Exp $ +.\" $OpenBSD: getrusage.2,v 1.8 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1985, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -42,9 +42,9 @@ .Sh SYNOPSIS .Fd #include <sys/time.h> .Fd #include <sys/resource.h> - -.Fd #define RUSAGE_SELF 0 -.Fd #define RUSAGE_CHILDREN -1 +.Pp +.Fd #define RUSAGE_SELF 0 +.Fd #define RUSAGE_CHILDREN -1 .Ft int .Fn getrusage "int who" "struct rusage *rusage" .Sh DESCRIPTION diff --git a/lib/libc/sys/kqueue.2 b/lib/libc/sys/kqueue.2 index 068084ffcc5..93af1fd104f 100644 --- a/lib/libc/sys/kqueue.2 +++ b/lib/libc/sys/kqueue.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: kqueue.2,v 1.8 2002/03/02 21:47:16 art Exp $ +.\" $OpenBSD: kqueue.2,v 1.9 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 2000 Jonathan Lemon .\" All rights reserved. @@ -87,10 +87,10 @@ is used to register events with the queue, and return any pending events to the user. .Fa changelist is a pointer to an array of -.Va kevent +.Va kevent structures, as defined in .Aq Pa sys/event.h . -All changes contained in the +All changes contained in the .Fa changelist are applied before any pending events are read from the queue. .Fa nchanges @@ -118,7 +118,7 @@ argument should be non-null, pointing to a zero-valued structure. The same array may be used for the .Fa changelist -and +and .Fa eventlist . .Pp .Fn EV_SET @@ -202,7 +202,7 @@ below. .El .Pp The predefined system filters are listed below. -Arguments may be passed to and from the filter via the +Arguments may be passed to and from the filter via the .Va fflags and .Va data @@ -227,9 +227,9 @@ subject to the .Dv SO_RCVLOWAT value of the socket buffer. This may be overridden with a per-filter low water mark at the -time the filter is added by setting the -.Dv NOTE_LOWAT -flag in +time the filter is added by setting the +.Dv NOTE_LOWAT +flag in .Va fflags , and specifying the new low water mark in .Va data . @@ -242,7 +242,7 @@ also sets .Dv EV_EOF in .Va flags , -and returns the socket error (if any) in +and returns the socket error (if any) in .Va fflags . It is possible for EOF to be returned (indicating the connection is gone) while there is still data pending in the socket buffer. @@ -278,17 +278,17 @@ this may be cleared by use of .Dv EV_CLEAR . Note that this filter is not supported for vnodes. .Pp -For sockets, the low water mark and socket error handling is +For sockets, the low water mark and socket error handling is identical to the .Dv EVFILT_READ case. .It Dv EVFILT_AIO The sigevent portion of the AIO request is filled in, with -.Va sigev_notify_kqueue +.Va sigev_notify_kqueue containing the descriptor of the kqueue that the event should be attached to, .Va sigev_value -containing the udata value, and +containing the udata value, and .Va sigev_notify set to .Dv SIGEV_EVENT . @@ -300,7 +300,7 @@ argument set to the returned by the aio_* function. The filter returns under the same conditions as aio_error. .Pp -Alternatively, a kevent structure may be initialized, with +Alternatively, a kevent structure may be initialized, with .Va ident containing the descriptor of the kqueue, and the address of the kevent structure placed in the @@ -309,7 +309,7 @@ field of the AIO request. However, this approach will not work on architectures with 64-bit pointers, and should be considered depreciated. .It Dv EVFILT_VNODE -Takes a file descriptor as the identifier and the events to watch for in +Takes a file descriptor as the identifier and the events to watch for in .Va fflags , and returns when one or more of the requested events occurs on the descriptor. The events to monitor are: @@ -328,7 +328,7 @@ The link count on the file changed. .It Dv NOTE_RENAME The file referenced by the descriptor was renamed. .It Dv NOTE_REVOKE -Access to the file was revoked via +Access to the file was revoked via .Xr revoke 2 or the underlying fileystem was unmounted. .El @@ -337,7 +337,7 @@ On return, .Va fflags contains the events which triggered the filter. .It Dv EVFILT_PROC -Takes the process ID to monitor as the identifier and the events to watch for +Takes the process ID to monitor as the identifier and the events to watch for in .Va fflags , and returns when the process performs one or more of the requested events. @@ -350,7 +350,7 @@ The process has exited. The process has called .Fn fork . .It Dv NOTE_EXEC -The process has executed a new process via +The process has executed a new process via .Xr execve 2 or similar call. .It Dv NOTE_TRACK @@ -365,7 +365,7 @@ field, while the child process will return with .Dv NOTE_CHILD set in .Va fflags -and the parent PID in +and the parent PID in .Va data . .It Dv NOTE_TRACKERR This flag is returned if the system was unable to attach an event to @@ -380,7 +380,7 @@ Takes the signal number to monitor as the identifier and returns when the given signal is delivered to the process. This coexists with the .Fn signal -and +and .Fn sigaction facilities, and has a lower precedence. The filter will record all attempts to deliver a signal to a process, @@ -445,7 +445,7 @@ function fails if: .It Bq Er EACCES The process does not have permission to register a filter. .It Bq Er EFAULT -There was an error reading or writing the +There was an error reading or writing the .Va kevent structure. .It Bq Er EBADF diff --git a/lib/libc/sys/mmap.2 b/lib/libc/sys/mmap.2 index 307c00b9a6a..af6a31329b0 100644 --- a/lib/libc/sys/mmap.2 +++ b/lib/libc/sys/mmap.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mmap.2,v 1.27 2001/12/03 23:58:48 ericj Exp $ +.\" $OpenBSD: mmap.2,v 1.28 2002/04/30 16:31:42 mpech Exp $ .\" $NetBSD: mmap.2,v 1.5 1995/06/24 10:48:59 cgd Exp $ .\" .\" Copyright (c) 1991, 1993 @@ -224,8 +224,8 @@ Due to a limitation of the current vm system (see mapping descriptors .Dv PROT_WRITE without also specifying -.Dv PROT_READ -is useless +.Dv PROT_READ +is useless (results in a segmentation fault when first accessing the mapping). This means that such descriptors must be opened with .Dv O_RDWR , diff --git a/lib/libc/sys/open.2 b/lib/libc/sys/open.2 index a2d70601b87..c6724865ba3 100644 --- a/lib/libc/sys/open.2 +++ b/lib/libc/sys/open.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: open.2,v 1.25 2002/01/24 21:18:36 mickey Exp $ +.\" $OpenBSD: open.2,v 1.26 2002/04/30 16:31:42 mpech Exp $ .\" $NetBSD: open.2,v 1.8 1995/02/27 12:35:14 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -132,7 +132,8 @@ in the process being blocked for some reason (e.g., waiting for carrier on a dialup line), .Fn open returns immediately. -This flag also has the effect of making all subsequent I/O on the open file non-blocking. +This flag also has the effect of making all subsequent I/O on the open file +non-blocking. If the .Dv O_SYNC flag is set, all I/O operations on the file will be done synchronously. diff --git a/lib/libc/sys/pathconf.2 b/lib/libc/sys/pathconf.2 index 7bf955237e1..a0ccd34ac33 100644 --- a/lib/libc/sys/pathconf.2 +++ b/lib/libc/sys/pathconf.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pathconf.2,v 1.8 2002/01/02 16:31:30 aaron Exp $ +.\" $OpenBSD: pathconf.2,v 1.9 2002/04/30 16:31:42 mpech Exp $ .\" $NetBSD: pathconf.2,v 1.2 1995/02/27 12:35:22 cgd Exp $ .\" .\" Copyright (c) 1993 @@ -87,7 +87,7 @@ a terminal input queue. The maximum number of bytes in a file name. .It Dv _PC_PATH_MAX The maximum number of bytes in a pathname. -.It Dv _PC_PIPE_BUF +.It Dv _PC_PIPE_BUF The maximum number of bytes which will be written atomically to a pipe. .It Dv _PC_CHOWN_RESTRICTED Return 1 if appropriate privileges are required for the diff --git a/lib/libc/sys/shmget.2 b/lib/libc/sys/shmget.2 index f6dfc64dae1..aa5956a42b6 100644 --- a/lib/libc/sys/shmget.2 +++ b/lib/libc/sys/shmget.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: shmget.2,v 1.9 2001/08/25 17:54:34 hugh Exp $ +.\" $OpenBSD: shmget.2,v 1.10 2002/04/30 16:31:42 mpech Exp $ .\" $NetBSD: shmget.2,v 1.2 1997/03/27 08:20:39 mikel Exp $ .\" .\" Copyright (c) 1995 Frank van der Linden @@ -58,7 +58,8 @@ does not have a shared memory segment identifier associated with it, and the bit is set in .Fa shmflg . .Pp -If a new shared memory segment is created, the data structure associated with it (the +If a new shared memory segment is created, the data structure associated with +it (the .Va shmid_ds structure, see .Xr shmctl 2 ) @@ -94,7 +95,8 @@ is set to the value of .Fa size . .El .Sh RETURN VALUES -Upon successful completion a positive shared memory segment identifier is returned. +Upon successful completion a positive shared memory segment identifier is +returned. Otherwise, \-1 is returned and the global variable .Va errno is set to indicate the error. diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2 index 5f9cd7f0283..fc41bf91dac 100644 --- a/lib/libc/sys/sigaction.2 +++ b/lib/libc/sys/sigaction.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sigaction.2,v 1.32 2002/03/14 16:21:26 millert Exp $ +.\" $OpenBSD: sigaction.2,v 1.33 2002/04/30 16:31:42 mpech Exp $ .\" $NetBSD: sigaction.2,v 1.7 1995/10/12 15:41:16 jtc Exp $ .\" .\" Copyright (c) 1980, 1990, 1993 @@ -702,7 +702,7 @@ a signal handler is undefined. .Pp As well, inside the signal handler it is also considered more safe to make a copy the global variable -.Va errno +.Va errno and restore it before returning from the signal handler. .Sh SEE ALSO .Xr kill 1 , |