diff options
author | Aaron Campbell <aaron@cvs.openbsd.org> | 1999-05-29 20:07:15 +0000 |
---|---|---|
committer | Aaron Campbell <aaron@cvs.openbsd.org> | 1999-05-29 20:07:15 +0000 |
commit | 26ca1f82240d7e05c80808847236a9e0fb5d42f8 (patch) | |
tree | 1e0e09cb6bcd49d0c606b85a6f75d9c38a1d8895 /lib/libc | |
parent | b2a110ce8991f3cd33c033c6958e5eddfc745d25 (diff) |
repairs
Diffstat (limited to 'lib/libc')
-rw-r--r-- | lib/libc/gen/isalnum.3 | 9 | ||||
-rw-r--r-- | lib/libc/gen/isalpha.3 | 8 | ||||
-rw-r--r-- | lib/libc/gen/isascii.3 | 11 | ||||
-rw-r--r-- | lib/libc/gen/isblank.3 | 8 | ||||
-rw-r--r-- | lib/libc/gen/iscntrl.3 | 8 | ||||
-rw-r--r-- | lib/libc/gen/isdigit.3 | 9 | ||||
-rw-r--r-- | lib/libc/gen/isgraph.3 | 11 | ||||
-rw-r--r-- | lib/libc/gen/isinf.3 | 4 | ||||
-rw-r--r-- | lib/libc/gen/islower.3 | 8 | ||||
-rw-r--r-- | lib/libc/gen/isprint.3 | 11 | ||||
-rw-r--r-- | lib/libc/gen/ispunct.3 | 13 | ||||
-rw-r--r-- | lib/libc/gen/isspace.3 | 8 | ||||
-rw-r--r-- | lib/libc/gen/isupper.3 | 8 | ||||
-rw-r--r-- | lib/libc/gen/isxdigit.3 | 8 | ||||
-rw-r--r-- | lib/libc/gen/lockf.3 | 28 | ||||
-rw-r--r-- | lib/libc/gen/nlist.3 | 4 | ||||
-rw-r--r-- | lib/libc/gen/pause.3 | 16 | ||||
-rw-r--r-- | lib/libc/gen/popen.3 | 29 | ||||
-rw-r--r-- | lib/libc/gen/sysctl.3 | 16 | ||||
-rw-r--r-- | lib/libc/gen/syslog.3 | 4 | ||||
-rw-r--r-- | lib/libc/gen/toascii.3 | 3 | ||||
-rw-r--r-- | lib/libc/gen/tolower.3 | 6 | ||||
-rw-r--r-- | lib/libc/gen/toupper.3 | 6 |
23 files changed, 128 insertions, 108 deletions
diff --git a/lib/libc/gen/isalnum.3 b/lib/libc/gen/isalnum.3 index d6d22734fac..479380ad0e8 100644 --- a/lib/libc/gen/isalnum.3 +++ b/lib/libc/gen/isalnum.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: isalnum.3,v 1.3 1999/05/16 19:54:53 alex Exp $ +.\" $OpenBSD: isalnum.3,v 1.4 1999/05/29 20:07:13 aaron Exp $ .\" .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. @@ -56,10 +56,9 @@ is true. .Sh RETURN VALUES The .Fn isalnum -macro returns zero if the character tests false and -returns non-zero if the character tests true. +macro returns zero if the character tests false or +non-zero if the character tests true. .Sh SEE ALSO -.Xr isalnum 3 , .Xr isalpha 3 , .Xr isascii 3 , .Xr isblank 3 , @@ -74,7 +73,7 @@ returns non-zero if the character tests true. .Xr isxdigit 3 , .Xr stdio 3 , .Xr toascii 3 , -.Xr tolower 3 , +.Xr tolower 3 , .Xr toupper 3 , .Xr ascii 7 .Sh STANDARDS diff --git a/lib/libc/gen/isalpha.3 b/lib/libc/gen/isalpha.3 index d6d889eb8c6..502ed2a864d 100644 --- a/lib/libc/gen/isalpha.3 +++ b/lib/libc/gen/isalpha.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: isalpha.3,v 1.3 1999/05/16 19:54:54 alex Exp $ +.\" $OpenBSD: isalpha.3,v 1.4 1999/05/29 20:07:13 aaron Exp $ .\" .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. @@ -73,8 +73,8 @@ is true. .Sh RETURN VALUES The .Fn isalpha -macro returns zero if the character tests false and -returns non-zero if the character tests true. +macro returns zero if the character tests false or +non-zero if the character tests true. .Sh SEE ALSO .Xr isalnum 3 , .Xr isascii 3 , @@ -90,7 +90,7 @@ returns non-zero if the character tests true. .Xr isxdigit 3 , .Xr stdio 3 , .Xr toascii 3 , -.Xr tolower 3 , +.Xr tolower 3 , .Xr toupper 3 , .Xr ascii 7 .Sh STANDARDS diff --git a/lib/libc/gen/isascii.3 b/lib/libc/gen/isascii.3 index c349530c4ed..1d81875ce89 100644 --- a/lib/libc/gen/isascii.3 +++ b/lib/libc/gen/isascii.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: isascii.3,v 1.5 1999/05/16 19:54:54 alex Exp $ +.\" $OpenBSD: isascii.3,v 1.6 1999/05/29 20:07:13 aaron Exp $ .\" .\" Copyright (c) 1989, 1991 The Regents of the University of California. .\" All rights reserved. @@ -36,7 +36,7 @@ .Os .Sh NAME .Nm isascii -.Nd test for ASCII character +.Nd ASCII character test .Sh SYNOPSIS .Fd #include <ctype.h> .Ft int @@ -48,6 +48,11 @@ function tests for an .Tn ASCII character, which is any character with a value less than or equal to 0177. +.Sh RETURN VALUES +The +.Fn isascii +macro returns zero if the character tests false or +non-zero if the character tests true. .Sh SEE ALSO .Xr isalnum 3 , .Xr isalpha 3 , @@ -63,7 +68,7 @@ equal to 0177. .Xr isxdigit 3 , .Xr stdio 3 , .Xr toascii 3 , -.Xr tolower 3 , +.Xr tolower 3 , .Xr toupper 3 , .Xr ascii 7 .Sh STANDARDS diff --git a/lib/libc/gen/isblank.3 b/lib/libc/gen/isblank.3 index 6b1c56a896a..94971b6684d 100644 --- a/lib/libc/gen/isblank.3 +++ b/lib/libc/gen/isblank.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: isblank.3,v 1.3 1999/05/16 19:54:54 alex Exp $ +.\" $OpenBSD: isblank.3,v 1.4 1999/05/29 20:07:13 aaron Exp $ .\" .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. @@ -66,8 +66,8 @@ returns true only for the standard blank-space characters. .Sh RETURN VALUES The .Fn isblank -macro returns zero if the character tests false and -returns non-zero if the character tests true. +macro returns zero if the character tests false or +non-zero if the character tests true. .Sh SEE ALSO .Xr isalnum 3 , .Xr isalpha 3 , @@ -83,6 +83,6 @@ returns non-zero if the character tests true. .Xr isxdigit 3 , .Xr stdio 3 , .Xr toascii 3 , -.Xr tolower 3 , +.Xr tolower 3 , .Xr toupper 3 , .Xr ascii 7 diff --git a/lib/libc/gen/iscntrl.3 b/lib/libc/gen/iscntrl.3 index 72f87306e60..fe47987fd65 100644 --- a/lib/libc/gen/iscntrl.3 +++ b/lib/libc/gen/iscntrl.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: iscntrl.3,v 1.3 1999/05/16 19:54:55 alex Exp $ +.\" $OpenBSD: iscntrl.3,v 1.4 1999/05/29 20:07:13 aaron Exp $ .\" .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. @@ -52,8 +52,8 @@ function tests for any control character. .Sh RETURN VALUES The .Fn iscntrl -macro returns zero if the character tests false and -returns non-zero if the character tests true. +macro returns zero if the character tests false or +non-zero if the character tests true. .Sh SEE ALSO .Xr isalnum 3 , .Xr isalpha 3 , @@ -69,7 +69,7 @@ returns non-zero if the character tests true. .Xr isxdigit 3 , .Xr stdio 3 , .Xr toascii 3 , -.Xr tolower 3 , +.Xr tolower 3 , .Xr toupper 3 , .Xr ascii 7 .Sh STANDARDS diff --git a/lib/libc/gen/isdigit.3 b/lib/libc/gen/isdigit.3 index d0c35be439e..49ba362d038 100644 --- a/lib/libc/gen/isdigit.3 +++ b/lib/libc/gen/isdigit.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: isdigit.3,v 1.3 1999/05/16 19:54:55 alex Exp $ +.\" $OpenBSD: isdigit.3,v 1.4 1999/05/29 20:07:13 aaron Exp $ .\" .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. @@ -52,15 +52,14 @@ function tests for any decimal-digit character. .Sh RETURN VALUES The .Fn isdigit -macro returns zero if the character tests false and -returns non-zero if the character tests true. +macro returns zero if the character tests false or +non-zero if the character tests true. .Sh SEE ALSO .Xr isalnum 3 , .Xr isalpha 3 , .Xr isascii 3 , .Xr isblank 3 , .Xr iscntrl 3 , -.Xr isdigit 3 , .Xr isgraph 3 , .Xr islower 3 , .Xr isprint 3 , @@ -70,7 +69,7 @@ returns non-zero if the character tests true. .Xr isxdigit 3 , .Xr stdio 3 , .Xr toascii 3 , -.Xr tolower 3 , +.Xr tolower 3 , .Xr toupper 3 , .Xr ascii 7 .Sh STANDARDS diff --git a/lib/libc/gen/isgraph.3 b/lib/libc/gen/isgraph.3 index f142dd25909..2ee60fa4fd7 100644 --- a/lib/libc/gen/isgraph.3 +++ b/lib/libc/gen/isgraph.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: isgraph.3,v 1.3 1999/05/16 19:54:56 alex Exp $ +.\" $OpenBSD: isgraph.3,v 1.4 1999/05/29 20:07:13 aaron Exp $ .\" .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. @@ -48,12 +48,13 @@ .Sh DESCRIPTION The .Fn isgraph -function tests for any printing character except space (' '). +function tests for any printing character except space +.Pq Sq \ \& . .Sh RETURN VALUES The .Fn isgraph -macro returns zero if the character tests false and -returns non-zero if the character tests true. +macro returns zero if the character tests false or +non-zero if the character tests true. .Sh SEE ALSO .Xr isalnum 3 , .Xr isalpha 3 , @@ -69,7 +70,7 @@ returns non-zero if the character tests true. .Xr isxdigit 3 , .Xr stdio 3 , .Xr toascii 3 , -.Xr tolower 3 , +.Xr tolower 3 , .Xr toupper 3 , .Xr ascii 7 .Sh STANDARDS diff --git a/lib/libc/gen/isinf.3 b/lib/libc/gen/isinf.3 index 1f16db4dd7e..8a24f7ecd5d 100644 --- a/lib/libc/gen/isinf.3 +++ b/lib/libc/gen/isinf.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: isinf.3,v 1.4 1999/05/25 01:50:57 aaron Exp $ +.\" $OpenBSD: isinf.3,v 1.5 1999/05/29 20:07:13 aaron Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -50,7 +50,7 @@ The function returns 1 if the number .Fa n -is infinity, otherwise 0. +is \*(If, otherwise 0. .Pp The .Fn isnan diff --git a/lib/libc/gen/islower.3 b/lib/libc/gen/islower.3 index 35bbd0dd8f8..845fdb44c98 100644 --- a/lib/libc/gen/islower.3 +++ b/lib/libc/gen/islower.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: islower.3,v 1.3 1999/05/16 19:54:56 alex Exp $ +.\" $OpenBSD: islower.3,v 1.4 1999/05/29 20:07:13 aaron Exp $ .\" .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. @@ -66,8 +66,8 @@ returns true only for the characters defined as lower-case letters. .Sh RETURN VALUES The .Fn islower -macro returns zero if the character tests false and -returns non-zero if the character tests true. +macro returns zero if the character tests false or +non-zero if the character tests true. .Sh SEE ALSO .Xr isalnum 3 , .Xr isalpha 3 , @@ -83,7 +83,7 @@ returns non-zero if the character tests true. .Xr isxdigit 3 , .Xr stdio 3 , .Xr toascii 3 , -.Xr tolower 3 , +.Xr tolower 3 , .Xr toupper 3 , .Xr ascii 7 .Sh STANDARDS diff --git a/lib/libc/gen/isprint.3 b/lib/libc/gen/isprint.3 index f214fdda5da..f6aa636f394 100644 --- a/lib/libc/gen/isprint.3 +++ b/lib/libc/gen/isprint.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: isprint.3,v 1.3 1999/05/16 19:54:57 alex Exp $ +.\" $OpenBSD: isprint.3,v 1.4 1999/05/29 20:07:13 aaron Exp $ .\" .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. @@ -48,12 +48,13 @@ .Sh DESCRIPTION The .Fn isprint -function tests for any printing character including space (' '). +function tests for any printing character including space +.Pq Sq \ \& . .Sh RETURN VALUES The .Fn isprint -macro returns zero if the character tests false and -returns non-zero if the character tests true. +macro returns zero if the character tests false or +non-zero if the character tests true. .Sh SEE ALSO .Xr isalnum 3 , .Xr isalpha 3 , @@ -69,7 +70,7 @@ returns non-zero if the character tests true. .Xr isxdigit 3 , .Xr stdio 3 , .Xr toascii 3 , -.Xr tolower 3 , +.Xr tolower 3 , .Xr toupper 3 , .Xr ascii 7 .Sh STANDARDS diff --git a/lib/libc/gen/ispunct.3 b/lib/libc/gen/ispunct.3 index 8f9327d24a6..97c21c0e52e 100644 --- a/lib/libc/gen/ispunct.3 +++ b/lib/libc/gen/ispunct.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ispunct.3,v 1.3 1999/05/16 19:54:57 alex Exp $ +.\" $OpenBSD: ispunct.3,v 1.4 1999/05/29 20:07:13 aaron Exp $ .\" .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. @@ -48,15 +48,16 @@ .Sh DESCRIPTION The .Fn ispunct -function tests for any printing character except space (' ') or a -character for which +function tests for any printing character except space +.Pq Sq \ \& +or a character for which .Xr isalnum 3 is true. .Sh RETURN VALUES The .Fn ispunct -macro returns zero if the character tests false and -returns non-zero if the character tests true. +macro returns zero if the character tests false or +non-zero if the character tests true. .Sh SEE ALSO .Xr isalnum 3 , .Xr isalpha 3 , @@ -72,7 +73,7 @@ returns non-zero if the character tests true. .Xr isxdigit 3 , .Xr stdio 3 , .Xr toascii 3 , -.Xr tolower 3 , +.Xr tolower 3 , .Xr toupper 3 , .Xr ascii 7 .Sh STANDARDS diff --git a/lib/libc/gen/isspace.3 b/lib/libc/gen/isspace.3 index 6ea3db65f6d..2ba610352c5 100644 --- a/lib/libc/gen/isspace.3 +++ b/lib/libc/gen/isspace.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: isspace.3,v 1.3 1999/05/16 19:54:58 alex Exp $ +.\" $OpenBSD: isspace.3,v 1.4 1999/05/29 20:07:13 aaron Exp $ .\" .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. @@ -79,8 +79,8 @@ returns true only for the standard white-space characters. .Sh RETURN VALUES The .Fn isspace -macro returns zero if the character tests false and -returns non-zero if the character tests true. +macro returns zero if the character tests false or +non-zero if the character tests true. .Sh SEE ALSO .Xr isalnum 3 , .Xr isalpha 3 , @@ -96,7 +96,7 @@ returns non-zero if the character tests true. .Xr isxdigit 3 , .Xr stdio 3 , .Xr toascii 3 , -.Xr tolower 3 , +.Xr tolower 3 , .Xr toupper 3 , .Xr ascii 7 .Sh STANDARDS diff --git a/lib/libc/gen/isupper.3 b/lib/libc/gen/isupper.3 index 27e144d1b23..603779c21ae 100644 --- a/lib/libc/gen/isupper.3 +++ b/lib/libc/gen/isupper.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: isupper.3,v 1.3 1999/05/16 19:54:58 alex Exp $ +.\" $OpenBSD: isupper.3,v 1.4 1999/05/29 20:07:13 aaron Exp $ .\" .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. @@ -64,8 +64,8 @@ returns true only for the characters defined as upper-case letters. .Sh RETURN VALUES The .Fn isupper -macro returns zero if the character tests false and -returns non-zero if the character tests true. +macro returns zero if the character tests false or +non-zero if the character tests true. .Sh SEE ALSO .Xr isalnum 3 , .Xr isalpha 3 , @@ -81,7 +81,7 @@ returns non-zero if the character tests true. .Xr isxdigit 3 , .Xr stdio 3 , .Xr toascii 3 , -.Xr tolower 3 , +.Xr tolower 3 , .Xr toupper 3 , .Xr ascii 7 .Sh STANDARDS diff --git a/lib/libc/gen/isxdigit.3 b/lib/libc/gen/isxdigit.3 index 169938242ed..ecb1ede4b41 100644 --- a/lib/libc/gen/isxdigit.3 +++ b/lib/libc/gen/isxdigit.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: isxdigit.3,v 1.3 1999/05/16 19:54:58 alex Exp $ +.\" $OpenBSD: isxdigit.3,v 1.4 1999/05/29 20:07:13 aaron Exp $ .\" .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. @@ -52,8 +52,8 @@ function tests for any hexadecimal-digit character. .Sh RETURN VALUES The .Fn isxdigit -macro returns zero if the character tests false and -returns non-zero if the character tests true. +macro returns zero if the character tests false or +non-zero if the character tests true. .Sh SEE ALSO .Xr isalnum 3 , .Xr isalpha 3 , @@ -69,7 +69,7 @@ returns non-zero if the character tests true. .Xr isupper 3 , .Xr stdio 3 , .Xr toascii 3 , -.Xr tolower 3 , +.Xr tolower 3 , .Xr toupper 3 , .Xr ascii 7 .Sh STANDARDS diff --git a/lib/libc/gen/lockf.3 b/lib/libc/gen/lockf.3 index e85ed1d294e..9928802f83f 100644 --- a/lib/libc/gen/lockf.3 +++ b/lib/libc/gen/lockf.3 @@ -58,9 +58,9 @@ The argument .Fa filedes is an open file descriptor. The file descriptor must have been opened either for write-only -.Dv ( O_WRONLY ) +.Pq Dv O_WRONLY or read/write -.Dv ( O_RDWR ) +.Pq Dv O_RDWR operation. .Pp The @@ -69,21 +69,23 @@ argument is a control value which specifies the action to be taken. The permissible values for .Fa function are as follows: +.Pp .Bl -tag -width F_ULOCKXX -compact -offset indent .It Sy Function .Sy Description .It Dv F_ULOCK -unlock locked sections +Unlock locked sections. .It Dv F_LOCK -lock a section for exclusive use +Lock a section for exclusive use. .It Dv F_TLOCK -test and lock a section for exclusive use +Test and lock a section for exclusive use. .It Dv F_TEST -test a section for locks by other processes +Test a section for locks by other processes. .El .Pp +The .Dv F_ULOCK -removes locks from a section of the file; +function removes locks from a section of the file; .Dv F_LOCK and .Dv F_TLOCK @@ -115,6 +117,7 @@ locked sections would occur, the sections are combined into a single locked section. If the request would cause the number of locks to exceed a system-imposed limit, the request will fail. .Pp +The .Dv F_LOCK and .Dv F_TLOCK @@ -130,11 +133,11 @@ File locks are released on first close by the locking process of any file descriptor for the file. .Pp .Dv F_ULOCK -requests release (wholly or in part) one or more locked sections +requests release (wholly or in part) of one or more locked sections controlled by the process. Locked sections will be unlocked starting at the current file offset through .Fa size -bytes or to the end of file if size is 0. When all of a locked section +bytes or to the end of the file if size is 0. When all of a locked section is not released (that is, when the beginning or end of the area to be unlocked falls within a locked section), the remaining portions of that section are still locked by the process. Releasing the center @@ -147,7 +150,8 @@ An .Dv F_ULOCK request in which size is non-zero and the offset of the last byte of the requested section is the maximum value for an object of type -off_t, when the process has an existing lock in which size is 0 and +.Em off_t , +when the process has an existing lock in which size is 0 and which includes the last byte of the requested section, will be treated as a request to unlock from the start of the requested section with a size equal to 0. Otherwise an @@ -172,8 +176,8 @@ Blocking on a section is interrupted by any signal. If successful, the .Fn lockf function returns 0. -Otherwise, it returns -1, sets -.Dv errno +Otherwise, it returns -1, sets the global variable +.Va errno to indicate an error, and existing locks are not changed. .Sh ERRORS .Fn lockf diff --git a/lib/libc/gen/nlist.3 b/lib/libc/gen/nlist.3 index 51dbb0b0899..4393de20d61 100644 --- a/lib/libc/gen/nlist.3 +++ b/lib/libc/gen/nlist.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: nlist.3,v 1.5 1999/05/23 14:11:00 aaron Exp $ +.\" $OpenBSD: nlist.3,v 1.6 1999/05/29 20:07:13 aaron Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -60,7 +60,7 @@ and .Fa n_value for the entry are copied into the list referenced by -.Fa \&nl . +.Fa nl . No other data is copied. The last entry in the list always has its .Fa n_name diff --git a/lib/libc/gen/pause.3 b/lib/libc/gen/pause.3 index cb509ee407b..e6429cc5d37 100644 --- a/lib/libc/gen/pause.3 +++ b/lib/libc/gen/pause.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pause.3,v 1.4 1999/05/23 14:11:00 aaron Exp $ +.\" $OpenBSD: pause.3,v 1.5 1999/05/29 20:07:13 aaron Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -54,21 +54,23 @@ forces a process to pause until a signal is received from either the .Xr kill 2 function -or an interval timer. -(See -.Xr setitimer 2 . ) +or an interval timer +(see +.Xr setitimer 2 ) . +.Pp Upon termination of a signal handler started during a .Fn pause , the .Fn pause call will return. .Sh RETURN VALUES -Always returns \-1. +Always returns -1. .Sh ERRORS The .Fn pause -function -always returns: +function may set the global variable +.Va errno +to the following error: .Bl -tag -width Er .It Bq Er EINTR The call was interrupted. diff --git a/lib/libc/gen/popen.3 b/lib/libc/gen/popen.3 index 088e299d7fa..7795a02b14f 100644 --- a/lib/libc/gen/popen.3 +++ b/lib/libc/gen/popen.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: popen.3,v 1.3 1999/05/16 19:55:00 alex Exp $ +.\" $OpenBSD: popen.3,v 1.4 1999/05/29 20:07:14 aaron Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -60,8 +60,9 @@ the resulting stream is correspondingly read-only or write-only. .Pp The .Fa command -argument is a pointer to a null-terminated string -containing a shell command line. +argument is a pointer to a +.Dv NULL Ns -terminated +string containing a shell command line. This command is passed to .Pa /bin/sh using the @@ -69,12 +70,13 @@ using the flag; interpretation, if any, is performed by the shell. The .Fa mode -argument is a pointer to a null-terminated string -which must be either -.Ql r +argument is a pointer to a +.Dv NULL Ns -terminated +string which must be either +.Qq r for reading or -.Ql w +.Qq w for writing. .Pp The return value from @@ -82,7 +84,7 @@ The return value from is a normal standard .Tn I/O stream in all respects -save that it must be closed with +except that it must be closed with .Fn pclose rather than .Fn fclose . @@ -106,7 +108,7 @@ The function waits for the associated process to terminate and returns the exit status of the command as returned by -.Fn wait4 . +.Xr wait4 2 . .Sh RETURN VALUE The .Fn popen @@ -122,7 +124,7 @@ or if it cannot allocate memory. The .Fn pclose function -returns \-1 if +returns -1 if .Fa stream is not associated with a .Dq popened @@ -168,10 +170,9 @@ The only hint is an exit status of 127. .Pp The .Fn popen -argument -always calls -.Xr sh , -never calls +argument always calls +.Xr sh ; +it never calls .Xr csh . .Sh HISTORY A diff --git a/lib/libc/gen/sysctl.3 b/lib/libc/gen/sysctl.3 index 7c35a4790b1..fe12328fa7e 100644 --- a/lib/libc/gen/sysctl.3 +++ b/lib/libc/gen/sysctl.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sysctl.3,v 1.14 1999/05/27 20:49:34 aaron Exp $ +.\" $OpenBSD: sysctl.3,v 1.15 1999/05/29 20:07:14 aaron Exp $ .\" .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -80,16 +80,20 @@ and that location gives the amount of data copied after a successful call. If the amount of data available is greater than the size of the buffer supplied, the call supplies as much data as fits in the buffer provided -and returns with the error code ENOMEM. +and returns with the error code +.Er ENOMEM . If the old value is not desired, .Fa oldp and .Fa oldlenp -should be set to NULL. +should be set to +.Dv NULL . .Pp The size of the available data can be determined by calling .Nm sysctl -with a NULL parameter for +with a +.Dv NULL +parameter for .Fa oldp . The size of the available data will be returned in the location pointed to by .Fa oldlenp . @@ -105,7 +109,9 @@ is set to point to a buffer of length from which the requested value is to be taken. If a new value is not to be set, .Fa newp -should be set to NULL and +should be set to +.Dv NULL +and .Fa newlen set to 0. .Pp diff --git a/lib/libc/gen/syslog.3 b/lib/libc/gen/syslog.3 index 4bd3f15ad45..ca7dbbfcce2 100644 --- a/lib/libc/gen/syslog.3 +++ b/lib/libc/gen/syslog.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: syslog.3,v 1.3 1999/05/23 14:11:00 aaron Exp $ +.\" $OpenBSD: syslog.3,v 1.4 1999/05/29 20:07:14 aaron Exp $ .\" .\" Copyright (c) 1985, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -132,7 +132,7 @@ The .Fa logopt argument is a bit field specifying logging options, which is formed by -.Tn OR Ns 'ing +.Em OR Ns 'ing one or more of the following values: .Bl -tag -width LOG_AUTHPRIV .It Dv LOG_CONS diff --git a/lib/libc/gen/toascii.3 b/lib/libc/gen/toascii.3 index 56f3f736b84..cd1b703c581 100644 --- a/lib/libc/gen/toascii.3 +++ b/lib/libc/gen/toascii.3 @@ -56,6 +56,7 @@ function always returns a valid ASCII character. .Xr isalnum 3 , .Xr isalpha 3 , .Xr isascii 3 , +.Xr isblank 3 , .Xr iscntrl 3 , .Xr isdigit 3 , .Xr isgraph 3 , @@ -66,6 +67,6 @@ function always returns a valid ASCII character. .Xr isupper 3 , .Xr isxdigit 3 , .Xr stdio 3 , -.Xr tolower 3 , +.Xr tolower 3 , .Xr toupper 3 , .Xr ascii 7 diff --git a/lib/libc/gen/tolower.3 b/lib/libc/gen/tolower.3 index 43352b5340f..52e7e6669ae 100644 --- a/lib/libc/gen/tolower.3 +++ b/lib/libc/gen/tolower.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: tolower.3,v 1.6 1999/05/16 19:55:01 alex Exp $ +.\" $OpenBSD: tolower.3,v 1.7 1999/05/29 20:07:14 aaron Exp $ .\" .\" Copyright (c) 1989, 1991 The Regents of the University of California. .\" All rights reserved. @@ -78,10 +78,10 @@ is returned; otherwise the output is undefined. .\" .Xr islower .\" is true. .Sh SEE ALSO -.Xr _toupper 3 , .Xr isalnum 3 , .Xr isalpha 3 , .Xr isascii 3 , +.Xr isblank 3 , .Xr iscntrl 3 , .Xr isdigit 3 , .Xr isgraph 3 , @@ -93,7 +93,7 @@ is returned; otherwise the output is undefined. .Xr isxdigit 3 , .Xr stdio 3 , .Xr toascii 3 , -.Xr toupper 3 , +.Xr toupper 3 , .Xr ascii 7 .Sh STANDARDS The diff --git a/lib/libc/gen/toupper.3 b/lib/libc/gen/toupper.3 index d342d8afed9..0fc16e18854 100644 --- a/lib/libc/gen/toupper.3 +++ b/lib/libc/gen/toupper.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: toupper.3,v 1.8 1999/05/16 19:55:01 alex Exp $ +.\" $OpenBSD: toupper.3,v 1.9 1999/05/29 20:07:14 aaron Exp $ .\" .\" Copyright (c) 1989, 1991 The Regents of the University of California. .\" All rights reserved. @@ -78,10 +78,10 @@ is returned; otherwise the output is undefined. .\" .Xr isupper .\" is true. .Sh SEE ALSO -.Xr _tolower 3 , .Xr isalnum 3 , .Xr isalpha 3 , .Xr isascii 3 , +.Xr isblank 3 , .Xr iscntrl 3 , .Xr isdigit 3 , .Xr isgraph 3 , @@ -93,7 +93,7 @@ is returned; otherwise the output is undefined. .Xr isxdigit 3 , .Xr stdio 3 , .Xr toascii 3 , -.Xr tolower 3 , +.Xr tolower 3 , .Xr ascii 7 .Sh STANDARDS The |