summaryrefslogtreecommitdiff
path: root/lib/libc/sys
diff options
context:
space:
mode:
authorMike Pechkin <mpech@cvs.openbsd.org>2002-04-30 16:31:43 +0000
committerMike Pechkin <mpech@cvs.openbsd.org>2002-04-30 16:31:43 +0000
commit53d632a56390b1be823ac94e26c8cbea0b0886ed (patch)
treec883cb4deabbed473bc5d3a0faba13f99da8281f /lib/libc/sys
parent98acfc3b963a7db3fbfdedc7829303261eb50d63 (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.24
-rw-r--r--lib/libc/sys/extattr_get_file.27
-rw-r--r--lib/libc/sys/flock.24
-rw-r--r--lib/libc/sys/getitimer.24
-rw-r--r--lib/libc/sys/getlogin.24
-rw-r--r--lib/libc/sys/getpgrp.24
-rw-r--r--lib/libc/sys/getrusage.28
-rw-r--r--lib/libc/sys/kqueue.240
-rw-r--r--lib/libc/sys/mmap.26
-rw-r--r--lib/libc/sys/open.25
-rw-r--r--lib/libc/sys/pathconf.24
-rw-r--r--lib/libc/sys/shmget.28
-rw-r--r--lib/libc/sys/sigaction.24
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 ,