diff options
author | 2002-04-30 16:31:42 +0000 | |
---|---|---|
committer | 2002-04-30 16:31:42 +0000 | |
commit | 49bdad570bd1d68338d6afe21882d4af0d059a5c (patch) | |
tree | 4bf69fc12d4b749e6f9b04d90650efc793ea2676 /lib/libc | |
parent | typo: form -> from. From form@ (diff) | |
download | wireguard-openbsd-49bdad570bd1d68338d6afe21882d4af0d059a5c.tar.xz wireguard-openbsd-49bdad570bd1d68338d6afe21882d4af0d059a5c.zip |
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')
-rw-r--r-- | lib/libc/compat-43/sigvec.3 | 4 | ||||
-rw-r--r-- | lib/libc/gen/auth_subr.3 | 4 | ||||
-rw-r--r-- | lib/libc/gen/err.3 | 4 | ||||
-rw-r--r-- | lib/libc/gen/getcap.3 | 4 | ||||
-rw-r--r-- | lib/libc/gen/glob.3 | 6 | ||||
-rw-r--r-- | lib/libc/gen/setjmp.3 | 4 | ||||
-rw-r--r-- | lib/libc/gen/signal.3 | 4 | ||||
-rw-r--r-- | lib/libc/gen/sysctl.3 | 5 | ||||
-rw-r--r-- | lib/libc/gen/syslog.3 | 44 | ||||
-rw-r--r-- | lib/libc/net/getaddrinfo.3 | 4 | ||||
-rw-r--r-- | lib/libc/net/gethostbyname.3 | 4 | ||||
-rw-r--r-- | lib/libc/net/getrrsetbyname.3 | 4 | ||||
-rw-r--r-- | lib/libc/posix1e/posix1e.3 | 6 | ||||
-rw-r--r-- | lib/libc/stdlib/strtoul.3 | 4 | ||||
-rw-r--r-- | lib/libc/string/strlcpy.3 | 4 | ||||
-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 |
28 files changed, 105 insertions, 102 deletions
diff --git a/lib/libc/compat-43/sigvec.3 b/lib/libc/compat-43/sigvec.3 index c1cc86d9727..492650dcd3c 100644 --- a/lib/libc/compat-43/sigvec.3 +++ b/lib/libc/compat-43/sigvec.3 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $OpenBSD: sigvec.3,v 1.18 2000/12/15 14:31:19 aaron Exp $ +.\" $OpenBSD: sigvec.3,v 1.19 2002/04/30 16:31:42 mpech Exp $ .\" .Dd April 29, 1991 .Dt SIGVEC 3 @@ -39,7 +39,7 @@ .Nd software signal facilities .Sh SYNOPSIS .Fd #include <signal.h> - +.Pp .Bd -literal struct sigvec { void (*sv_handler)(); diff --git a/lib/libc/gen/auth_subr.3 b/lib/libc/gen/auth_subr.3 index 78d79af426c..1877b62e7b0 100644 --- a/lib/libc/gen/auth_subr.3 +++ b/lib/libc/gen/auth_subr.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: auth_subr.3,v 1.6 2002/03/16 19:20:05 millert Exp $ +.\" $OpenBSD: auth_subr.3,v 1.7 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1997 Berkeley Software Design, Inc. All rights reserved. .\" @@ -221,7 +221,7 @@ The name and value are separated by an .Sq = : .Pp .Li Ta Fl v Ar name=value - +.Pp .Pp Once the login script has been spawned, any data specified by the .Fn auth_setdata diff --git a/lib/libc/gen/err.3 b/lib/libc/gen/err.3 index 40960e5d98b..c8473d9d37b 100644 --- a/lib/libc/gen/err.3 +++ b/lib/libc/gen/err.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: err.3,v 1.12 2001/02/17 17:01:03 pjanzen Exp $ +.\" $OpenBSD: err.3,v 1.13 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -80,7 +80,7 @@ specification (and associated arguments) may be any format allowed by .Xr printf 3 , a simple string, or .Dv NULL . -If the +If the .Fa fmt argument is not .Dv NULL , diff --git a/lib/libc/gen/getcap.3 b/lib/libc/gen/getcap.3 index 07b31baf59b..be738d704d1 100644 --- a/lib/libc/gen/getcap.3 +++ b/lib/libc/gen/getcap.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getcap.3,v 1.21 2001/06/18 18:11:14 millert Exp $ +.\" $OpenBSD: getcap.3,v 1.22 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1992, 1993 .\" The Regents of the University of California. All rights reserved. @@ -260,7 +260,7 @@ being used. Note that it does not erase the buffer pushed by a call to .Fn cgetset . .Pp -.Fn cgetusedb +.Fn cgetusedb allows the user to specify whether use or ignore database files ending in .Dq .db . If diff --git a/lib/libc/gen/glob.3 b/lib/libc/gen/glob.3 index a43f73c4df7..4c992c3be5d 100644 --- a/lib/libc/gen/glob.3 +++ b/lib/libc/gen/glob.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: glob.3,v 1.17 2001/03/18 17:18:58 deraadt Exp $ +.\" $OpenBSD: glob.3,v 1.18 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1989, 1991, 1993, 1994 .\" The Regents of the University of California. All rights reserved. @@ -260,7 +260,7 @@ Limit the amount of memory used by matches to .Li ARG_MAX This option should be set for programs that can be coerced to a denial of service attack via patterns that expand to a very large number of matches, -such as a long string of +such as a long string of .Li */../*/.. .El .Pp @@ -372,7 +372,7 @@ in the include file .Bl -tag -width GLOB_NOCHECK .It Dv GLOB_NOSPACE An attempt to allocate memory failed, or if -.Va errno +.Va errno was 0 .Li GLOB_LIMIT was specified in the flags and diff --git a/lib/libc/gen/setjmp.3 b/lib/libc/gen/setjmp.3 index 3ecef8e42e4..b4f07f889bf 100644 --- a/lib/libc/gen/setjmp.3 +++ b/lib/libc/gen/setjmp.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: setjmp.3,v 1.13 2001/11/20 18:59:08 deraadt Exp $ +.\" $OpenBSD: setjmp.3,v 1.14 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -146,7 +146,7 @@ Conversely, .Fn _setjmp Ns / Ns Fn _longjmp are functionally equivalent to .Fn sigsetjmp Ns / Ns Fn siglongjmp -when +when .Fn sigsetjmp is called with a zero-value .Fa savemask . diff --git a/lib/libc/gen/signal.3 b/lib/libc/gen/signal.3 index d694fb107f7..550e3e5e46a 100644 --- a/lib/libc/gen/signal.3 +++ b/lib/libc/gen/signal.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: signal.3,v 1.17 2002/01/07 16:16:32 millert Exp $ +.\" $OpenBSD: signal.3,v 1.18 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -346,7 +346,7 @@ flag; most other actions are not safe. .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 RETURN VALUES The previous action is returned on a successful call. diff --git a/lib/libc/gen/sysctl.3 b/lib/libc/gen/sysctl.3 index 24aa56e4189..5f77fd082ed 100644 --- a/lib/libc/gen/sysctl.3 +++ b/lib/libc/gen/sysctl.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sysctl.3,v 1.84 2002/04/03 20:33:49 angelos Exp $ +.\" $OpenBSD: sysctl.3,v 1.85 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -895,7 +895,8 @@ If set to 0, incoming WCCPv1-style GRE packets will not be processed. If set to any other value, and gre.allow allows GRE packet processing, WCCPv1-style GRE packets will be processed. .It Li mobileip.allow -If set to 0, incoming MobileIP encapsulated packets (RFC 2004) will not be processed. +If set to 0, incoming MobileIP encapsulated packets (RFC 2004) will not be +processed. If set to any other value, processing will occur. .It Li etherip.allow If set to 0, incoming Ethernet-in-IPv4 packets will not be processed. diff --git a/lib/libc/gen/syslog.3 b/lib/libc/gen/syslog.3 index 1be2f077c4d..f903794c51e 100644 --- a/lib/libc/gen/syslog.3 +++ b/lib/libc/gen/syslog.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: syslog.3,v 1.15 2001/11/08 11:12:09 mpech Exp $ +.\" $OpenBSD: syslog.3,v 1.16 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1985, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -104,19 +104,19 @@ see A trailing newline is added if none is present. .Pp The -.Fn syslog_r +.Fn syslog_r function is a reentrant version of the .Xr syslog 3 function. -It takes a pointer to a +It takes a pointer to a .Fa syslog_data structure which is used to store information. This parameter must be initialized before .Fn syslog_r is called. -The SYSLOG_DATA_INIT constant is used for this purpose. -The +The SYSLOG_DATA_INIT constant is used for this purpose. +The .Fa syslog_data structure is composed of the following elements: .Bl -tag -width connected @@ -125,8 +125,8 @@ contains the file descriptor of the file where the message is logged. .It Dv connected indicates if connect has been done .It Dv opened -indicates if -.Xr openlog_r 3 +indicates if +.Xr openlog_r 3 has been called. .It Dv log_stat status bits, set by @@ -181,15 +181,15 @@ normally of use only when debugging a program. .Pp The .Fn vsyslog_r -is used the same way than +is used the same way than .Fn vsyslog except than it takes an additional pointer on a .Fa syslog_data structure. -It is a reentrant version of the -.Fn vsyslog +It is a reentrant version of the +.Fn vsyslog function described above. -.Pp +.Pp The .Fn openlog function provides for more specialized processing of the messages sent by @@ -286,21 +286,21 @@ through .Pp The .Fn openlog_r -function is the reentrant version of the -.Fn openlog +function is the reentrant version of the +.Fn openlog function. -It takes an additional pointer on a +It takes an additional pointer on a .Fa syslog_data structure. This function must be used in conjunction with the other -reentrant functions. +reentrant functions. .Pp The .Fn closelog -function can be used to close the log file. +function can be used to close the log file. .Fn closelog_r do the same thing but in a reentrant way and takes an additional -pointer on a +pointer on a .Fa syslog_data structure. .Pp @@ -396,12 +396,12 @@ Always be sure to use the proper secure idiom: syslog("%s", string); .Ed .Pp -.Fn syslog_r -and the other reentrant functions should only be used where +.Fn syslog_r +and the other reentrant functions should only be used where reentrancy is required (for instance in a signal handler). .Fn syslog -being not reentrant, only -.Fn syslog_r +being not reentrant, only +.Fn syslog_r should be used here. -For more information about reentrancy and signal handlers, see +For more information about reentrancy and signal handlers, see .Xr signal 3 . diff --git a/lib/libc/net/getaddrinfo.3 b/lib/libc/net/getaddrinfo.3 index f9fbe96feb7..5c4be167328 100644 --- a/lib/libc/net/getaddrinfo.3 +++ b/lib/libc/net/getaddrinfo.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getaddrinfo.3,v 1.19 2001/08/06 10:42:26 mpech Exp $ +.\" $OpenBSD: getaddrinfo.3,v 1.20 2002/04/30 16:31:42 mpech Exp $ .\" $KAME: getaddrinfo.3,v 1.29 2001/02/12 09:24:45 itojun Exp $ .\" .\" Copyright (c) 1983, 1987, 1991, 1993 @@ -258,7 +258,7 @@ Here are pitfall cases you may encounter: .Bl -bullet .It .Fn getaddrinfo -will raise an error if members of the +will raise an error if members of the .Fa hints structure are not consistent. For example, for internet address families, diff --git a/lib/libc/net/gethostbyname.3 b/lib/libc/net/gethostbyname.3 index 94a848eecc8..d90ea55542c 100644 --- a/lib/libc/net/gethostbyname.3 +++ b/lib/libc/net/gethostbyname.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: gethostbyname.3,v 1.16 2000/12/24 00:30:56 aaron Exp $ +.\" $OpenBSD: gethostbyname.3,v 1.17 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1983, 1987, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -222,7 +222,7 @@ for example, a mail-forwarder may be registered for this domain. .Xr resolv.conf 5 , .Xr hostname 7 , .Xr named 8 -.Sh CAVEAT +.Sh CAVEATS If the search routines in .Xr resolv.conf 5 decide to read the diff --git a/lib/libc/net/getrrsetbyname.3 b/lib/libc/net/getrrsetbyname.3 index 1cec0c726ba..25bb539f71b 100644 --- a/lib/libc/net/getrrsetbyname.3 +++ b/lib/libc/net/getrrsetbyname.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getrrsetbyname.3,v 1.4 2001/08/08 16:28:43 jakob Exp $ +.\" $OpenBSD: getrrsetbyname.3,v 1.5 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (C) 2000, 2001 Internet Software Consortium. .\" @@ -70,7 +70,7 @@ Properties of the rdataset are represented in the bitfield. If the .Dv RRSET_VALIDATED bit is set, the data has been DNSSEC -validated and the signatures verified. +validated and the signatures verified. .Pp The following structures are used: .Bd -literal -offset diff --git a/lib/libc/posix1e/posix1e.3 b/lib/libc/posix1e/posix1e.3 index 136028eaafb..a15d887b5df 100644 --- a/lib/libc/posix1e/posix1e.3 +++ b/lib/libc/posix1e/posix1e.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: posix1e.3,v 1.3 2002/02/23 19:26:20 fgsch Exp $ +.\" $OpenBSD: posix1e.3,v 1.4 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 2000 Robert N. M. Watson .\" All rights reserved. @@ -41,11 +41,11 @@ although efforts are underway to complete the integration at this time. .Pp POSIX.1e describes five security extensions to the base POSIX.1 API: Access Control Lists (ACLs), Auditing, Capabilities, Mandatory Access -Control, and Information Flow Labels. +Control, and Information Flow Labels. .Pp POSIX.1e defines both syntax and semantics for these features, but fairly substantial changes are required to implement these features in the -operating system. +operating system. .Sh IMPLEMENTATION NOTES .Fx Ns 's support for POSIX.1e interfaces and features is still under diff --git a/lib/libc/stdlib/strtoul.3 b/lib/libc/stdlib/strtoul.3 index 991f8113869..61269bc900f 100644 --- a/lib/libc/stdlib/strtoul.3 +++ b/lib/libc/stdlib/strtoul.3 @@ -33,7 +33,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $OpenBSD: strtoul.3,v 1.8 2000/08/09 15:51:21 aaron Exp $ +.\" $OpenBSD: strtoul.3,v 1.9 2002/04/30 16:31:42 mpech Exp $ .\" .Dd June 25, 1992 .Dt STRTOUL 3 @@ -47,7 +47,7 @@ .Fd #include <limits.h> .Ft unsigned long .Fn strtoul "const char *nptr" "char **endptr" "int base" - +.Pp .Fd #include <sys/types.h> .Fd #include <stdlib.h> .Fd #include <limits.h> diff --git a/lib/libc/string/strlcpy.3 b/lib/libc/string/strlcpy.3 index 8bb1b3a1e28..b103588b960 100644 --- a/lib/libc/string/strlcpy.3 +++ b/lib/libc/string/strlcpy.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: strlcpy.3,v 1.13 2001/06/18 22:29:59 millert Exp $ +.\" $OpenBSD: strlcpy.3,v 1.14 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1998, 2000 Todd C. Miller <Todd.Miller@courtesan.com> .\" All rights reserved. @@ -63,7 +63,7 @@ as long as there is at least one byte free in Note that you should include a byte for the NUL in .Fa size . Also note that -.Fn strlcpy +.Fn strlcpy and .Fn strlcat only operate on true 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 , |