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 | |
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')
49 files changed, 179 insertions, 180 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 , diff --git a/lib/libc_r/man/pthread_cond_init.3 b/lib/libc_r/man/pthread_cond_init.3 index ef4d2005b99..c88490c6b69 100644 --- a/lib/libc_r/man/pthread_cond_init.3 +++ b/lib/libc_r/man/pthread_cond_init.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pthread_cond_init.3,v 1.8 2002/02/21 20:12:19 fgsch Exp $ +.\" $OpenBSD: pthread_cond_init.3,v 1.9 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1997 Brian Cully <shmit@kublai.com> .\" All rights reserved. @@ -67,7 +67,7 @@ is invalid. The process cannot allocate enough memory to create another condition variable. .It Bq Er EAGAIN -The system temporarily lacks the resources to create another condition +The system temporarily lacks the resources to create another condition variable. .El .Sh SEE ALSO diff --git a/lib/libc_r/man/pthread_equal.3 b/lib/libc_r/man/pthread_equal.3 index d43bb802736..ef469ed6687 100644 --- a/lib/libc_r/man/pthread_equal.3 +++ b/lib/libc_r/man/pthread_equal.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pthread_equal.3,v 1.7 2002/02/21 20:12:19 fgsch Exp $ +.\" $OpenBSD: pthread_equal.3,v 1.8 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1996 John Birrell <jb@cimlogic.com.au>. .\" All rights reserved. @@ -65,4 +65,4 @@ None. .Sh STANDARDS .Fn pthread_equal conforms to -.St -p1003.1-96 . +.St -p1003.1-96 . diff --git a/lib/libc_r/man/pthread_key_delete.3 b/lib/libc_r/man/pthread_key_delete.3 index 0135abd7357..02c1ee952a1 100644 --- a/lib/libc_r/man/pthread_key_delete.3 +++ b/lib/libc_r/man/pthread_key_delete.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pthread_key_delete.3,v 1.6 2002/02/21 20:12:19 fgsch Exp $ +.\" $OpenBSD: pthread_key_delete.3,v 1.7 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1996 John Birrell <jb@cimlogic.com.au>. .\" All rights reserved. @@ -91,4 +91,4 @@ value is invalid. .Sh STANDARDS .Fn pthread_key_delete conforms to -.St -p1003.1-96 . +.St -p1003.1-96 . diff --git a/lib/libc_r/man/pthread_testcancel.3 b/lib/libc_r/man/pthread_testcancel.3 index f2eeb0106dc..84fef8dbb57 100644 --- a/lib/libc_r/man/pthread_testcancel.3 +++ b/lib/libc_r/man/pthread_testcancel.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pthread_testcancel.3,v 1.7 2002/02/21 20:12:19 fgsch Exp $ +.\" $OpenBSD: pthread_testcancel.3,v 1.8 2002/04/30 16:31:42 mpech Exp $ .\" .Dd January 17, 1999 .Dt PTHREAD_TESTCANCEL 3 @@ -67,7 +67,6 @@ The function creates a cancellation point in the calling thread. The .Fn pthread_testcancel function has no effect if cancelability is disabled. -.Pp .Ss Cancelability States The cancelability state of a thread determines the action taken upon receipt of a cancellation request. The thread may control cancellation in @@ -188,4 +187,4 @@ or .Sh STANDARDS .Fn pthread_testcancel conforms to -.St -p1003.1-96 +.St -p1003.1-96 diff --git a/lib/libc_r/man/pthreads.3 b/lib/libc_r/man/pthreads.3 index c7ec1795c05..ebf34d84ac5 100644 --- a/lib/libc_r/man/pthreads.3 +++ b/lib/libc_r/man/pthreads.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pthreads.3,v 1.16 2002/02/21 08:37:55 fgsch Exp $ +.\" $OpenBSD: pthreads.3,v 1.17 2002/04/30 16:31:42 mpech Exp $ .\" David Leonard <d@openbsd.org>, 1998. Public domain. .Dd August 17, 1998 .Dt PTHREADS 3 @@ -33,10 +33,9 @@ flags (see .Sx Thread flags ) , signal mask, and name (as set by .Xr pthread_set_name_np 3 ) . -If the environment variable +If the environment variable .Ev PTHREAD_DEBUG is defined additional information is displayed. -.Pp .Ss Thread states Threads can be in one of these states: .Bl -tag -offset indent -width Dv -compact diff --git a/lib/libc_r/man/sigwait.3 b/lib/libc_r/man/sigwait.3 index f13d6b9071b..56f7576c4a2 100644 --- a/lib/libc_r/man/sigwait.3 +++ b/lib/libc_r/man/sigwait.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sigwait.3,v 1.10 2002/02/21 20:12:19 fgsch Exp $ +.\" $OpenBSD: sigwait.3,v 1.11 2002/04/30 16:31:42 mpech Exp $ .\" .\" David Leonard <d@openbsd.org>, 1998. Public domain. .Dd August 20, 1998 @@ -22,7 +22,8 @@ that signal number in the location referenced by If prior to the call to .Fn sigwait there are multiple pending instances of a single signal number, -it is undefined whether upon successful return there are any remaining pending signals for that signal number. +it is undefined whether upon successful return there are any remaining pending +signals for that signal number. If no signal in .Fa set is pending at the time of the call, diff --git a/lib/libcompat/4.3/insque.3 b/lib/libcompat/4.3/insque.3 index b16eb2e2727..af76566722a 100644 --- a/lib/libcompat/4.3/insque.3 +++ b/lib/libcompat/4.3/insque.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: insque.3,v 1.4 2000/03/02 00:29:48 todd Exp $ +.\" $OpenBSD: insque.3,v 1.5 2002/04/30 16:31:42 mpech Exp $ .\" Copyright (c) 1993 John Brezak .\" All rights reserved. .\" @@ -64,4 +64,3 @@ must begin with a "struct qelem". These functions are not atomic unless that machine architecture allows it. .Sh HISTORY These are derived from the insque and remque instructions on a VAX. - diff --git a/lib/libkeynote/keynote.1 b/lib/libkeynote/keynote.1 index 91332ab8ebe..7af0cbbf41f 100644 --- a/lib/libkeynote/keynote.1 +++ b/lib/libkeynote/keynote.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: keynote.1,v 1.20 2001/09/03 20:14:51 deraadt Exp $ +.\" $OpenBSD: keynote.1,v 1.21 2002/04/30 16:31:42 mpech Exp $ .\" .\" The author of this code is Angelos D. Keromytis (angelos@dsl.cis.upenn.edu) .\" @@ -159,7 +159,7 @@ string. .Pp If the .Fl v -flag is provided, +flag is provided, .Qq keynote sign will also verify the newly-created signature using the .Fa Authorizer diff --git a/lib/libkeynote/keynote.3 b/lib/libkeynote/keynote.3 index 8eb5ef41404..56f48c09a5a 100644 --- a/lib/libkeynote/keynote.3 +++ b/lib/libkeynote/keynote.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: keynote.3,v 1.31 2001/09/03 20:14:51 deraadt Exp $ +.\" $OpenBSD: keynote.3,v 1.32 2002/04/30 16:31:42 mpech Exp $ .\" .\" The author of this code is Angelos D. Keromytis (angelos@dsl.cis.upenn.edu) .\" @@ -270,12 +270,12 @@ if it has been defined as the callback function for more than one attribute. In this case, .Fa name is a regular expression that may match more than one attribute. -In case of conflict between a regular expression and a +In case of conflict between a regular expression and a .Dq simple attribute, the latter will be given priority. In case of conflict between two regular expression attributes, the one added later will be given priority. -A callback function should never change the current +A callback function should never change the current .Nm session, start/invoke/operate on another session, or call one of the session-API functions. diff --git a/lib/libkeynote/keynote.4 b/lib/libkeynote/keynote.4 index 06198f52a8e..33f5bf8ae3c 100644 --- a/lib/libkeynote/keynote.4 +++ b/lib/libkeynote/keynote.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: keynote.4,v 1.20 2001/09/03 20:14:51 deraadt Exp $ +.\" $OpenBSD: keynote.4,v 1.21 2002/04/30 16:31:42 mpech Exp $ .\" .\" The author of this code is Angelos D. Keromytis (angelos@dsl.cis.upenn.edu) .\" @@ -54,16 +54,16 @@ to the authorization to perform specific tasks. A trust-management system has five basic components: .Bl -bullet -offset "xxx" .It -A language for describing +A language for describing .Sq actions , which are operations with security consequences that are to be controlled by the system. .It -A mechanism for identifying +A mechanism for identifying .Sq principals , which are entities that can be authorized to perform actions. .It -A language for specifying application +A language for specifying application .Sq policies , which govern the actions that principals are authorized to perform. .It @@ -71,7 +71,7 @@ A language for specifying .Sq credentials , which allow principals to delegate authorization to other principals. .It -A +A .Sq compliance checker , which provides a service to applications for determining how an action requested by principals should be handled, given a policy and a set @@ -111,7 +111,7 @@ contain predicates that describe the trusted actions permitted by the holders of specific public keys. KeyNote assertions are essentially small, highly-structured programs. A signed assertion, which can be sent over an untrusted network, is also -called a +called a .Sq credential assertion . Credential assertions, which also serve the role of certificates, have the same syntax as policy assertions but are also signed by the principal @@ -124,7 +124,7 @@ Actions are specified as a collection of name-value pairs. .It Principal names can be any convenient string and can directly represent cryptographic public keys. -.It +.It The same language is used for both policies and credentials. .It The policy and credential language is concise, highly expressive, human @@ -133,7 +133,7 @@ transmission media, including electronic mail. .It The compliance checker returns an application-configured .Sq policy compliance value -that describes how a request should be handled by the application. +that describes how a request should be handled by the application. Policy compliance values are always positively derived from policy and credentials, facilitating analysis of KeyNote-based systems. .It @@ -142,7 +142,7 @@ applications. .El .Pp In KeyNote, the authority to perform trusted actions is associated -with one or more +with one or more .Sq principals . A principal may be a physical entity, a process in an operating system, a public key, or any other convenient abstraction. @@ -152,7 +152,7 @@ In some cases, a Principal Identifier will contain a cryptographic key interpreted by the KeyNote system (e.g., for credential signature verification). In other cases, Principal Identifiers may have a structure that is opaque -to KeyNote. +to KeyNote. .Pp Principals perform two functions of concern to KeyNote: They request .Sq actions @@ -174,7 +174,7 @@ Applications invoke the KeyNote compliance checker by issuing a .Sq query containing a proposed action attribute set and identifying the principal(s) requesting it. -The KeyNote system determines and returns an appropriate +The KeyNote system determines and returns an appropriate .Sq policy compliance value from an ordered set of possible responses. .Pp @@ -189,7 +189,7 @@ compliance values, when appropriate for the application (e.g., .Qq no access , .Qq restricted access , .Qq full access ) . -Applications can configure the relative ordering (from +Applications can configure the relative ordering (from .Sq weakest to .Sq strongest ) @@ -401,7 +401,7 @@ through a mechanism (e.g., for attribute values that represent values from among a very large namespace). .Sh ACTION REQUESTER -At least one Principal must be identified in each query as the +At least one Principal must be identified in each query as the .Sq requester of the action. Actions may be requested by several principals, each considered to have individually requested it. @@ -444,7 +444,7 @@ normalizing them by conversion to a canonical form. .Pp Every cryptographic algorithm used in KeyNote defines a method for converting keys to their canonical form and that specifies how the -comparison for equality of two keys is performed. +comparison for equality of two keys is performed. If the algorithm named in the identifier is unknown to KeyNote, the identifier is treated as opaque. .Pp @@ -542,7 +542,7 @@ Here, if the value of the .Qq user_id attribute is .Qq 1073 -and the +and the .Qq user_name attribute is .Qq root , diff --git a/lib/libkeynote/keynote.5 b/lib/libkeynote/keynote.5 index db0a3659578..030a0bc4663 100644 --- a/lib/libkeynote/keynote.5 +++ b/lib/libkeynote/keynote.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: keynote.5,v 1.9 2001/09/03 20:14:51 deraadt Exp $ +.\" $OpenBSD: keynote.5,v 1.10 2002/04/30 16:31:42 mpech Exp $ .\" .\" The author of this code is Angelos D. Keromytis (angelos@dsl.cis.upenn.edu) .\" @@ -133,7 +133,7 @@ and (where o represents any octal digit) may be used to represent any non-NUL ASCII characters with their corresponding octal values (thus, .Qq \e Ns 012 -is the same as +is the same as .Qq \e Ns n , .Qq \e Ns 101 is @@ -159,7 +159,7 @@ becomes .Qq a , and .Qq \e\e -becomes +becomes .Qq \e ) . The following four strings are equivalent: .Bd -literal @@ -233,7 +233,7 @@ expressions and may be recursively dereferenced. In the simplest case, an attribute is dereferenced simply by using its name outside of quotes; e.g., the string value of the attribute named .Qq foo -is by reference to +is by reference to .Sq foo (outside of quotes). The @@ -329,7 +329,7 @@ and key bit encoding (e.g., HEX or BASE64). By convention, the ALGORITHM substring starts with an alphabetic character and can contain letters, digits, underscores, or dashes (i.e., it should match the regular expression .Qo Ns Bo a-zA-Z -.Bc Ns Bo a-zA-Z0-9_- +.Bc Ns Bo a-zA-Z0-9_- .Bc Ns * .Qc Ns ) . The IANA (or some other appropriate authority) will provide a registry of @@ -367,7 +367,7 @@ KeyNote-Version field, if included, should appear first. This field adds or overrides action attributes in the current assertion only. This mechanism allows the use of short names for (frequently lengthy) -cryptographic principal identifiers, especially to make the Licensees field +cryptographic principal identifiers, especially to make the Licensees field more readable. The Local-Constants field is of the form: .Bd -literal @@ -540,7 +540,7 @@ within clauses of condition fields, but in no other KeyNote field. .Pp The keywords .Qq true -and +and .Qq false are not reserved; they can be used as attribute or principal identifier names (although this practice makes assertions difficult to understand diff --git a/lib/libpthread/man/pthread_cond_init.3 b/lib/libpthread/man/pthread_cond_init.3 index ef4d2005b99..c88490c6b69 100644 --- a/lib/libpthread/man/pthread_cond_init.3 +++ b/lib/libpthread/man/pthread_cond_init.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pthread_cond_init.3,v 1.8 2002/02/21 20:12:19 fgsch Exp $ +.\" $OpenBSD: pthread_cond_init.3,v 1.9 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1997 Brian Cully <shmit@kublai.com> .\" All rights reserved. @@ -67,7 +67,7 @@ is invalid. The process cannot allocate enough memory to create another condition variable. .It Bq Er EAGAIN -The system temporarily lacks the resources to create another condition +The system temporarily lacks the resources to create another condition variable. .El .Sh SEE ALSO diff --git a/lib/libpthread/man/pthread_equal.3 b/lib/libpthread/man/pthread_equal.3 index d43bb802736..ef469ed6687 100644 --- a/lib/libpthread/man/pthread_equal.3 +++ b/lib/libpthread/man/pthread_equal.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pthread_equal.3,v 1.7 2002/02/21 20:12:19 fgsch Exp $ +.\" $OpenBSD: pthread_equal.3,v 1.8 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1996 John Birrell <jb@cimlogic.com.au>. .\" All rights reserved. @@ -65,4 +65,4 @@ None. .Sh STANDARDS .Fn pthread_equal conforms to -.St -p1003.1-96 . +.St -p1003.1-96 . diff --git a/lib/libpthread/man/pthread_key_delete.3 b/lib/libpthread/man/pthread_key_delete.3 index 0135abd7357..02c1ee952a1 100644 --- a/lib/libpthread/man/pthread_key_delete.3 +++ b/lib/libpthread/man/pthread_key_delete.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pthread_key_delete.3,v 1.6 2002/02/21 20:12:19 fgsch Exp $ +.\" $OpenBSD: pthread_key_delete.3,v 1.7 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 1996 John Birrell <jb@cimlogic.com.au>. .\" All rights reserved. @@ -91,4 +91,4 @@ value is invalid. .Sh STANDARDS .Fn pthread_key_delete conforms to -.St -p1003.1-96 . +.St -p1003.1-96 . diff --git a/lib/libpthread/man/pthread_testcancel.3 b/lib/libpthread/man/pthread_testcancel.3 index f2eeb0106dc..84fef8dbb57 100644 --- a/lib/libpthread/man/pthread_testcancel.3 +++ b/lib/libpthread/man/pthread_testcancel.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pthread_testcancel.3,v 1.7 2002/02/21 20:12:19 fgsch Exp $ +.\" $OpenBSD: pthread_testcancel.3,v 1.8 2002/04/30 16:31:42 mpech Exp $ .\" .Dd January 17, 1999 .Dt PTHREAD_TESTCANCEL 3 @@ -67,7 +67,6 @@ The function creates a cancellation point in the calling thread. The .Fn pthread_testcancel function has no effect if cancelability is disabled. -.Pp .Ss Cancelability States The cancelability state of a thread determines the action taken upon receipt of a cancellation request. The thread may control cancellation in @@ -188,4 +187,4 @@ or .Sh STANDARDS .Fn pthread_testcancel conforms to -.St -p1003.1-96 +.St -p1003.1-96 diff --git a/lib/libpthread/man/pthreads.3 b/lib/libpthread/man/pthreads.3 index c7ec1795c05..ebf34d84ac5 100644 --- a/lib/libpthread/man/pthreads.3 +++ b/lib/libpthread/man/pthreads.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pthreads.3,v 1.16 2002/02/21 08:37:55 fgsch Exp $ +.\" $OpenBSD: pthreads.3,v 1.17 2002/04/30 16:31:42 mpech Exp $ .\" David Leonard <d@openbsd.org>, 1998. Public domain. .Dd August 17, 1998 .Dt PTHREADS 3 @@ -33,10 +33,9 @@ flags (see .Sx Thread flags ) , signal mask, and name (as set by .Xr pthread_set_name_np 3 ) . -If the environment variable +If the environment variable .Ev PTHREAD_DEBUG is defined additional information is displayed. -.Pp .Ss Thread states Threads can be in one of these states: .Bl -tag -offset indent -width Dv -compact diff --git a/lib/libpthread/man/sigwait.3 b/lib/libpthread/man/sigwait.3 index f13d6b9071b..56f7576c4a2 100644 --- a/lib/libpthread/man/sigwait.3 +++ b/lib/libpthread/man/sigwait.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sigwait.3,v 1.10 2002/02/21 20:12:19 fgsch Exp $ +.\" $OpenBSD: sigwait.3,v 1.11 2002/04/30 16:31:42 mpech Exp $ .\" .\" David Leonard <d@openbsd.org>, 1998. Public domain. .Dd August 20, 1998 @@ -22,7 +22,8 @@ that signal number in the location referenced by If prior to the call to .Fn sigwait there are multiple pending instances of a single signal number, -it is undefined whether upon successful return there are any remaining pending signals for that signal number. +it is undefined whether upon successful return there are any remaining pending +signals for that signal number. If no signal in .Fa set is pending at the time of the call, diff --git a/lib/libskey/skey.3 b/lib/libskey/skey.3 index 8b209356414..81e344b6561 100644 --- a/lib/libskey/skey.3 +++ b/lib/libskey/skey.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: skey.3,v 1.2 2001/06/23 21:42:39 millert Exp $ +.\" $OpenBSD: skey.3,v 1.3 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 2001 Todd C. Miller <Todd.Miller@courtesan.com> .\" All rights reserved. @@ -224,7 +224,7 @@ function returns The .Fn readskey function reads up to -.Fa n +.Fa n characters from standard input with echo turned on, converting the resulting string to 7 bits, storing the result in .Fa buf . @@ -250,7 +250,7 @@ The function presents the .Fa user with an S/Key challenge and authenticates the response. -The +The .Fn skey_authenticate function returns 0 if authentication is successful or -1 if not. .Pp diff --git a/lib/libusbhid/usbhid.3 b/lib/libusbhid/usbhid.3 index a31e261b118..fbfc61077bb 100644 --- a/lib/libusbhid/usbhid.3 +++ b/lib/libusbhid/usbhid.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: usbhid.3,v 1.1 2001/12/30 07:04:38 pvalchev Exp $ +.\" $OpenBSD: usbhid.3,v 1.2 2002/04/30 16:31:42 mpech Exp $ .\" $NetBSD: usb.3,v 1.14 2001/04/09 12:09:49 wiz Exp $ .\" .\" Copyright (c) 1999 Lennart Augustsson <augustss@netbsd.org> @@ -157,7 +157,6 @@ To locate a single item the function can be used. It should be given the usage code of the item and its kind and it will fill the item and return non-zero if the item was found. -.Pp .Ss NAME TRANSLATION FUNCTIONS The function .Fn hid_usage_page diff --git a/lib/libutil/opendev.3 b/lib/libutil/opendev.3 index ce1cb77b19b..da874e58597 100644 --- a/lib/libutil/opendev.3 +++ b/lib/libutil/opendev.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: opendev.3,v 1.13 2002/02/26 21:16:26 pvalchev Exp $ +.\" $OpenBSD: opendev.3,v 1.14 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 2000, Todd C. Miller. All rights reserved. .\" Copyright (c) 1996, Jason Downs. All rights reserved. @@ -87,7 +87,7 @@ return value and errors are the same as the return value and errors of .Sh WARNINGS If .Fa realpath -is not +is not .Dv NULL , on return it will point to internal static storage space that will be overwritten by subsequent calls. diff --git a/lib/libwrap/rfc1413.3 b/lib/libwrap/rfc1413.3 index 6f379d9a66f..59d2a11e6aa 100644 --- a/lib/libwrap/rfc1413.3 +++ b/lib/libwrap/rfc1413.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rfc1413.3,v 1.3 2001/09/06 15:04:34 mpech Exp $ +.\" $OpenBSD: rfc1413.3,v 1.4 2002/04/30 16:31:42 mpech Exp $ .\" .\" Copyright (c) 2001, Bob Beck. All rights reserved. .\" @@ -42,21 +42,21 @@ .Fn rfc1413 "struct sockaddr *rmt_sin" "struct sockaddr *our_sin" "char *dest" "size_t dsize" "int ident_timeout_time" .Sh DESCRIPTION .Fn rfc1413 -retrieves a user name from a remote system using the +retrieves a user name from a remote system using the .Nm ident -protocol described in rfc 1413. It is implenented in the +protocol described in rfc 1413. It is implenented in the .Nm libwrap.a -library. +library. .Pp -.Fn rfc1413 +.Fn rfc1413 takes two sockaddr pointers as parameters: .Nm rmt_sin -for the remote host end of a connected TCP socket, and +for the remote host end of a connected TCP socket, and .Nm our_sin -for the local end. -.Nm dest +for the local end. +.Nm dest should be allocated by the caller to store the found username, -and must be of length at least +and must be of length at least .Nm dsize. .Nm ident_timeout_time is a timeout in seconds on the entire ident query, used to ensure @@ -67,11 +67,11 @@ When username lookup is successful, .Fn rfc1413 strips the trailing CRLF from the returned value and stores up to .Nm "dsize - 1" -bytes of the returned username into -.Nm dest, -always terminating with a nul byte. In this case 0 is returned. +bytes of the returned username into +.Nm dest, +always terminating with a nul byte. In this case 0 is returned. .Fn rfc1413 -returns -1 if any failure occurs such that it was unable to +returns -1 if any failure occurs such that it was unable to retrieve the remote username. .Sh SEE ALSO .Xr hosts_access 3 @@ -82,5 +82,5 @@ Ident connections are made unencrypted, and nothing prevents the remote server from lying about who the user is. Consequently, ident should never be used to authenticate users. ident is however, quite useful for logging users of connections from multiuser machines that -can be trusted not to lie about it. +can be trusted not to lie about it. \" @(#) hosts_access.3 1.8 96/02/11 17:01:26 |