summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--bin/cat/cat.15
-rw-r--r--lib/libc/gen/fts.368
-rw-r--r--lib/libc/gen/getcwd.36
-rw-r--r--lib/libc/gen/getdiskbyname.36
-rw-r--r--lib/libc/gen/getdomainname.310
-rw-r--r--lib/libc/gen/getfsent.313
-rw-r--r--lib/libc/gen/getgrent.331
-rw-r--r--lib/libc/gen/getgrouplist.36
-rw-r--r--lib/libc/gen/gethostname.323
-rw-r--r--lib/libc/gen/getloadavg.34
-rw-r--r--lib/libc/gen/getnetgrent.338
-rw-r--r--lib/libc/gen/getpagesize.310
-rw-r--r--lib/libc/gen/getpass.329
-rw-r--r--lib/libc/gen/getpwent.358
-rw-r--r--lib/libc/gen/getttyent.330
-rw-r--r--lib/libc/gen/getusershell.38
-rw-r--r--lib/libc/gen/glob.361
-rw-r--r--lib/libc/gen/initgroups.36
18 files changed, 212 insertions, 200 deletions
diff --git a/bin/cat/cat.1 b/bin/cat/cat.1
index 2efaee5ff71..8cd7d85a1fa 100644
--- a/bin/cat/cat.1
+++ b/bin/cat/cat.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: cat.1,v 1.9 1999/05/23 14:10:46 aaron Exp $
+.\" $OpenBSD: cat.1,v 1.10 1999/05/29 19:11:10 aaron Exp $
.\" $NetBSD: cat.1,v 1.12 1995/09/27 05:38:55 cgd Exp $
.\"
.\" Copyright (c) 1989, 1990, 1993
@@ -79,7 +79,8 @@ for control-X. The only exception is the tab character, control-I (see the
option). The DEL
character (octal 0177) prints as
.Ql ^? .
-Non-ASCII characters (with the high bit set) are printed as
+.Pf Non- Ns Tn ASCII
+characters (with the high bit set) are printed as
.Ql M-
(for meta) followed by the character for the low 7 bits.
.It Fl e
diff --git a/lib/libc/gen/fts.3 b/lib/libc/gen/fts.3
index d036d773df5..56bd2eddd1f 100644
--- a/lib/libc/gen/fts.3
+++ b/lib/libc/gen/fts.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: fts.3,v 1.7 1999/05/29 16:08:55 aaron Exp $
+.\" $OpenBSD: fts.3,v 1.8 1999/05/29 19:11:10 aaron Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993, 1994
.\" The Regents of the University of California. All rights reserved.
@@ -92,22 +92,22 @@ The first is
.Dv FTS ,
the structure that represents the file hierarchy itself.
The second is
-.Dv FTSENT ,
+.Em FTSENT ,
the structure that represents a file in the file
hierarchy.
Normally, an
-.Dv FTSENT
+.Em FTSENT
structure is returned for every file in the file
hierarchy.
In this manual page,
.Dq file
and
-.Dq Dv FTSENT No structure
+.Dq Em FTSENT No structure
are generally
interchangeable.
.Pp
The
-.Dv FTSENT
+.Em FTSENT
structure contains at least the following fields, which are
described in greater detail below:
.Bd -literal
@@ -133,7 +133,7 @@ These fields are defined as follows:
.Bl -tag -width "fts_namelen"
.It Fa fts_info
One of the following flags describing the returned
-.Dv FTSENT
+.Em FTSENT
structure and
the file it represents.
With the exception of directories without errors
@@ -149,11 +149,11 @@ A directory that causes a cycle in the tree.
(The
.Fa fts_cycle
field of the
-.Dv FTSENT
+.Em FTSENT
structure will be filled in as well.)
.It Dv FTS_DEFAULT
Any
-.Dv FTSENT
+.Em FTSENT
structure that represents a file type not explicitly described
by one of the other
.Fa fts_info
@@ -175,7 +175,7 @@ which was not specified as a file name to
.It Dv FTS_DP
A directory being visited in post-order.
The contents of the
-.Dv FTSENT
+.Em FTSENT
structure will be unchanged from when
it was returned in pre-order, i.e., with the
.Fa fts_info
@@ -232,15 +232,15 @@ The length of the string referenced by
The depth of the traversal, numbered from -1 to N, where this file
was found.
The
-.Dv FTSENT
+.Em FTSENT
structure representing the parent of the starting point (or root)
of the traversal is numbered -1, and the
-.Dv FTSENT
+.Em FTSENT
structure for the root
itself is numbered 0.
.It Fa fts_errno
Upon return of an
-.Dv FTSENT
+.Em FTSENT
structure from the
.Fn fts_children
or
@@ -275,7 +275,7 @@ It is initialized to
.Dv NULL .
.It Fa fts_parent
A pointer to the
-.Dv FTSENT
+.Em FTSENT
structure referencing the file in the hierarchy
immediately above the current file, i.e., the directory of which this
file is a member.
@@ -305,9 +305,9 @@ of a hard link between two directories, or a symbolic link pointing to a
directory, the
.Fa fts_cycle
field of the structure will point to the
-.Dv FTSENT
+.Em FTSENT
structure in the hierarchy that references the same file as the current
-.Dv FTSENT
+.Em FTSENT
structure.
Otherwise, the contents of the
.Fa fts_cycle
@@ -330,10 +330,10 @@ fields are guaranteed to be
for the file most recently returned by
.Fn fts_read .
To use these fields to reference any files represented by other
-.Dv FTSENT
+.Em FTSENT
structures will require that the path buffer be modified using the
information contained in that
-.Dv FTSENT
+.Em FTSENT
structure's
.Fa fts_pathlen
field.
@@ -374,11 +374,11 @@ is also specified.
This option causes the
.Nm
routines to return
-.Dv FTSENT
+.Em FTSENT
structures for the targets of symbolic links
instead of the symbolic links themselves.
If this option is set, the only symbolic links for which
-.Dv FTSENT
+.Em FTSENT
structures
are returned to the application are those referencing non-existent files.
Either
@@ -408,7 +408,7 @@ pathnames were provided as arguments to
.Fn fts_open .
.It Dv FTS_NOSTAT
By default, returned
-.Dv FTSENT
+.Em FTSENT
structures reference file characteristic information (the
.Fa statp
field) for each file visited.
@@ -426,11 +426,11 @@ field undefined.
This option causes the
.Nm
routines to return
-.Dv FTSENT
+.Em FTSENT
structures for symbolic links themselves instead
of the target files they point to.
If this option is set,
-.Dv FTSENT
+.Em FTSENT
structures for all symbolic links in the
hierarchy are returned to the application.
Either
@@ -452,7 +452,7 @@ encountered in the file hierarchy are ignored.
This option causes the
.Nm
routines to return
-.Dv FTSENT
+.Em FTSENT
structures for them.
.It Dv FTS_XDEV
This option prevents
@@ -474,7 +474,7 @@ specifies a user-defined function which may be used to order the traversal
of the hierarchy.
It
takes two pointers to pointers to
-.Dv FTSENT
+.Em FTSENT
structures as arguments and
should return a negative value, zero, or a positive value to indicate
if the file referenced by its first argument comes before, in any order
@@ -485,7 +485,7 @@ The
and
.Fa fts_pathlen
fields of the
-.Dv FTSENT
+.Em FTSENT
structures may
.Em never
be used in this comparison.
@@ -510,7 +510,7 @@ everything else.
The
.Fn fts_read
function returns a pointer to an
-.Dv FTSENT
+.Em FTSENT
structure describing a file in
the hierarchy.
Directories (that are readable and do not cause cycles) are visited at
@@ -535,14 +535,14 @@ and sets
.Va errno
appropriately.
If an error related to a returned file occurs, a pointer to an
-.Dv FTSENT
+.Em FTSENT
structure is returned, and
.Va errno
may or may not have been set (see
.Fa fts_info ) .
.Pp
The
-.Dv FTSENT
+.Em FTSENT
structures returned by
.Fn fts_read
may be overwritten after a call to
@@ -553,7 +553,7 @@ on the same file hierarchy stream unless they represent a file of type
directory, in which case they will not be overwritten until after a call to
.Fn fts_read
after the
-.Dv FTSENT
+.Em FTSENT
structure has been returned by the function
.Fn fts_read
in post-order.
@@ -561,16 +561,16 @@ in post-order.
The
.Fn fts_children
function returns a pointer to an
-.Dv FTSENT
+.Em FTSENT
structure describing the first entry in a NULL-terminated linked list of
the files in the directory represented by the
-.Dv FTSENT
+.Em FTSENT
structure most recently returned by
.Fn fts_read .
The list is linked through the
.Fa fts_link
field of the
-.Dv FTSENT
+.Em FTSENT
structure, and is ordered by the user-specified comparison function, if any.
Repeated calls to
.Fn fts_children
@@ -585,7 +585,7 @@ will return a pointer to the files in the logical directory specified to
i.e., the arguments specified to
.Fn fts_open .
Otherwise, if the
-.Dv FTSENT
+.Em FTSENT
structure most recently returned by
.Fn fts_read
is not a directory being visited in pre-order,
@@ -605,7 +605,7 @@ and sets
appropriately.
.Pp
The
-.Dv FTSENT
+.Em FTSENT
structures returned by
.Fn fts_children
may be overwritten after a call to
diff --git a/lib/libc/gen/getcwd.3 b/lib/libc/gen/getcwd.3
index 517ab1f6059..0f0003ddfca 100644
--- a/lib/libc/gen/getcwd.3
+++ b/lib/libc/gen/getcwd.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getcwd.3,v 1.4 1999/05/23 14:10:59 aaron Exp $
+.\" $OpenBSD: getcwd.3,v 1.5 1999/05/29 19:11:10 aaron Exp $
.\"
.\" Copyright (c) 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -86,7 +86,7 @@ These routines have traditionally been used by programs to save the
name of a working directory for the purpose of returning to it.
A much faster and less error-prone method of accomplishing this is to
open the current directory
-.Pq Ql \&.
+.Pq Pa \&.
and use the
.Xr fchdir 2
function to return.
@@ -105,7 +105,7 @@ into the memory referenced by
.Fa buf .
.Sh ERRORS
The
-.Fn getcwd
+.Fn getwd
function
will fail if:
.Bl -tag -width Er
diff --git a/lib/libc/gen/getdiskbyname.3 b/lib/libc/gen/getdiskbyname.3
index e8c3b230447..fcc27f34b20 100644
--- a/lib/libc/gen/getdiskbyname.3
+++ b/lib/libc/gen/getdiskbyname.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getdiskbyname.3,v 1.3 1999/05/23 14:10:59 aaron Exp $
+.\" $OpenBSD: getdiskbyname.3,v 1.4 1999/05/29 19:11:11 aaron Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -45,8 +45,8 @@
The
.Fn getdiskbyname
function
-takes a disk name (e.g.
-.Ql rm03 )
+takes a disk name (e.g.,
+.Qq rm03 )
and returns a prototype disk label
describing its geometry information and the standard
disk partition tables. All information is obtained from
diff --git a/lib/libc/gen/getdomainname.3 b/lib/libc/gen/getdomainname.3
index 8d7b76559db..c7ab59f72fa 100644
--- a/lib/libc/gen/getdomainname.3
+++ b/lib/libc/gen/getdomainname.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getdomainname.3,v 1.10 1999/05/16 19:54:51 alex Exp $
+.\" $OpenBSD: getdomainname.3,v 1.11 1999/05/29 19:11:11 aaron Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -45,7 +45,9 @@
.Ft int
.Fn setdomainname "const char *name" "size_t namelen"
.Sh DESCRIPTION
+The
.Fn getdomainname
+function
returns the YP domain name for the current processor, as
previously set by
.Fn setdomainname .
@@ -54,7 +56,8 @@ The parameter
specifies the size of the
.Fa name
array. If insufficient space is provided, the returned name is truncated.
-The returned name is always null-terminated.
+The returned name is always
+.Dv NULL Ns -terminated.
.Pp
.Fn setdomainname
sets the domain name of the host machine to be
@@ -66,7 +69,7 @@ is normally used only when the system is bootstrapped.
.Sh RETURN VALUES
If the call succeeds a value of 0 is returned. If the call
fails, a value of -1 is returned and an error code is
-placed in the global location
+placed in the global variable
.Va errno .
.Sh ERRORS
The following errors may be returned by these calls:
@@ -86,6 +89,7 @@ The caller tried to set the domain name and was not the super-user.
.Xr gethostid 3 ,
.Xr gethostname 3 ,
.Xr sysctl 3 ,
+.Xr sysctl 8 ,
.Xr yp 8
.Sh BUGS
Domain names are limited to
diff --git a/lib/libc/gen/getfsent.3 b/lib/libc/gen/getfsent.3
index 6d3642b2fbd..39b0d228ee2 100644
--- a/lib/libc/gen/getfsent.3
+++ b/lib/libc/gen/getfsent.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getfsent.3,v 1.3 1999/05/23 14:10:59 aaron Exp $
+.\" $OpenBSD: getfsent.3,v 1.4 1999/05/29 19:11:11 aaron Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -79,15 +79,11 @@ struct fstab {
The fields have meanings described in
.Xr fstab 5 .
.Pp
-The
.Fn setfsent
-function
opens the file (closing any previously opened file) or rewinds it
if it is already open.
.Pp
-The
.Fn endfsent
-function
closes the file.
.Pp
The
@@ -112,13 +108,15 @@ The
and
.Fn getfsfile
functions
-return a null pointer (0) on
+return a
+.Dv NULL
+pointer on
.Dv EOF
or error.
The
.Fn setfsent
function
-returns 0 on failure, 1 on success.
+returns 0 on failure or 1 on success.
The
.Fn endfsent
function
@@ -126,6 +124,7 @@ returns nothing.
.Sh FILES
.Bl -tag -width /etc/fstab -compact
.It Pa /etc/fstab
+file system table
.El
.Sh SEE ALSO
.Xr fstab 5
diff --git a/lib/libc/gen/getgrent.3 b/lib/libc/gen/getgrent.3
index 1b8727b3711..a0de73fcfba 100644
--- a/lib/libc/gen/getgrent.3
+++ b/lib/libc/gen/getgrent.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getgrent.3,v 1.2 1996/08/19 08:23:27 tholo Exp $
+.\" $OpenBSD: getgrent.3,v 1.3 1999/05/29 19:11:11 aaron Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -67,7 +67,7 @@ which is described
in
.Xr group 5 .
Each line of the database is defined by the structure
-.Ar group
+.Em group
found in the include
file
.Aq Pa grp.h :
@@ -85,35 +85,29 @@ The functions
and
.Fn getgrgid
search the group database for the given group name pointed to by
-.Ar name
-or the group id pointed to by
-.Ar gid ,
+.Fa name
+or the group ID pointed to by
+.Fa gid ,
respectively, returning the first one encountered. Identical group
-names or group gids may result in undefined behavior.
+names or group GIDs may result in undefined behavior.
.Pp
-The
.Fn getgrent
-function
sequentially reads the group database and is intended for programs
that wish to step through the complete list of groups.
.Pp
All three routines will open the group file for reading, if necessary.
.Pp
-The
.Fn setgroupent
-function
opens the file, or rewinds it if it is already open. If
.Fa stayopen
is non-zero, file descriptors are left open, significantly speeding
-functions subsequent calls. This functionality is unnecessary for
+subsequent function calls. This functionality is unnecessary for
.Fn getgrent
as it doesn't close its file descriptors by default. It should also
be noted that it is dangerous for long-running programs to use this
functionality as the group file may be updated.
.Pp
-The
.Fn setgrent
-function
is equivalent to
.Fn setgroupent
with an argument of zero.
@@ -127,13 +121,14 @@ The functions
.Fn getgrent ,
.Fn getgrnam ,
and
-.Fn getgrgid ,
+.Fn getgrgid
return a pointer to the group entry if successful; if end-of-file
-is reached or an error occurs a null pointer is returned.
+is reached or an error occurs a
+.Dv NULL
+pointer is returned.
The
.Fn setgroupent
-function returns the value 1 if successful, otherwise the value
-0 is returned.
+function returns the value 1 if successful, otherwise 0.
The
.Fn endgrent
and
@@ -165,7 +160,7 @@ appeared in
.Bx 4.3 Reno .
.Sh COMPATIBILITY
The historic function
-.Fn setgrfile ,
+.Xr setgrfile 3 ,
which allowed the specification of alternate password databases, has
been deprecated and is no longer available.
.Sh BUGS
diff --git a/lib/libc/gen/getgrouplist.3 b/lib/libc/gen/getgrouplist.3
index f1cef5eb76f..faddaa8bd78 100644
--- a/lib/libc/gen/getgrouplist.3
+++ b/lib/libc/gen/getgrouplist.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getgrouplist.3,v 1.4 1998/06/15 17:54:54 mickey Exp $
+.\" $OpenBSD: getgrouplist.3,v 1.5 1999/05/29 19:11:11 aaron Exp $
.\"
.\" Copyright (c) 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -65,13 +65,13 @@ the actual number of groups found is returned in
The
.Fn getgrouplist
function
-returns \-1 if the size of the group list is too small to
+returns -1 if the size of the group list is too small to
hold all the user's groups.
Here, the group array will be filled with as many groups as will fit.
.Sh FILES
.Bl -tag -width /etc/group -compact
.It Pa /etc/group
-group membership list
+group database file
.El
.Sh SEE ALSO
.Xr setgroups 2 ,
diff --git a/lib/libc/gen/gethostname.3 b/lib/libc/gen/gethostname.3
index e0667c5e380..60856b6b86e 100644
--- a/lib/libc/gen/gethostname.3
+++ b/lib/libc/gen/gethostname.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: gethostname.3,v 1.10 1999/05/23 14:10:59 aaron Exp $
+.\" $OpenBSD: gethostname.3,v 1.11 1999/05/29 19:11:11 aaron Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -45,16 +45,18 @@
.Ft int
.Fn sethostname "const char *name" "size_t namelen"
.Sh DESCRIPTION
+The
.Fn gethostname
-returns the standard host name for the current processor, as
-previously set by
+function returns the standard host name for the current
+processor, as previously set by
.Fn sethostname .
The parameter
.Fa namelen
specifies the size of the
.Fa name
array. If insufficient space is provided, the returned name is truncated.
-The returned name is always null-terminated.
+The returned name is always
+.Dv NULL Ns -terminated.
.Pp
.Fn sethostname
sets the name of the host machine to be
@@ -66,7 +68,7 @@ is normally used only when the system is bootstrapped.
.Sh RETURN VALUES
If the call succeeds a value of 0 is returned. If the call
fails, a value of -1 is returned and an error code is
-placed in the global location
+placed in the global variable
.Va errno .
.Sh ERRORS
The following errors may be returned by these calls:
@@ -82,9 +84,12 @@ invalid address.
The caller tried to set the hostname and was not the super-user.
.El
.Sh SEE ALSO
+.Xr hostname 1 ,
+.Xr getdomainname 3 ,
.Xr gethostid 3 ,
.Xr sysctl 3 ,
-.Xr sysctl 8
+.Xr sysctl 8 ,
+.Xr yp 8
.Sh BUGS
Host names are limited to
.Dv MAXHOSTNAMELEN
@@ -93,17 +98,17 @@ Host names are limited to
characters, currently 256. This includes the terminating NUL character.
.Pp
If the buffer passed to
-.Fn getdomainname
+.Fn gethostname
is smaller than
.Dv MAXHOSTNAMELEN ,
other operating systems may not guarantee termination with NUL.
.Sh HISTORY
The
-.Nm
+.Fn gethostname
function call appeared in
.Bx 4.2 .
.Sh STANDARDS
The
-.Nm
+.Fn gethostname
function call conforms to
.St -xpg4.2 .
diff --git a/lib/libc/gen/getloadavg.3 b/lib/libc/gen/getloadavg.3
index a58487b2445..b0ca8f1f4bc 100644
--- a/lib/libc/gen/getloadavg.3
+++ b/lib/libc/gen/getloadavg.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getloadavg.3,v 1.5 1999/05/16 19:54:52 alex Exp $
+.\" $OpenBSD: getloadavg.3,v 1.6 1999/05/29 19:11:11 aaron Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -56,7 +56,7 @@ over the last 1, 5, and 15 minutes, respectively.
Upon successful completion, the number of samples retrieved is
returned. If an error occurs, -1 is returned and the global variable
.Va errno
-is set indicate the error.
+is set to indicate the error.
.Sh ERRORS
Please see
.Xr sysctl 3
diff --git a/lib/libc/gen/getnetgrent.3 b/lib/libc/gen/getnetgrent.3
index 02fa35a5ff0..c722c3f9908 100644
--- a/lib/libc/gen/getnetgrent.3
+++ b/lib/libc/gen/getnetgrent.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getnetgrent.3,v 1.7 1999/02/27 21:55:08 deraadt Exp $
+.\" $OpenBSD: getnetgrent.3,v 1.8 1999/05/29 19:11:11 aaron Exp $
.\"
.\" Copyright (c) 1992, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -56,27 +56,24 @@ These functions operate on the netgroup database file
which is described
in
.Xr netgroup 5 .
-If that file does not exist, and the system supports
-.Sy YP ,
-then the
-.Sy netgroup
-.Sy YP
-databases are used instead.
+If that file does not exist, and the system supports YP,
+then the netgroup YP databased are used instead.
The database defines a set of netgroups, each made up of one or more triples:
.Bd -literal -offset indent
(host, user, domain)
.Ed
.Pp
that defines a combination of host, user and domain.
-Any of the three fields may be specified as ``wildcards'' that match any
-string.
+Any of the three fields may be specified as
+.Dq wildcards
+that match any string.
.Pp
The function
.Fn getnetgrent
sets the three pointer arguments to the strings of the next member of the
current netgroup.
If any of the string pointers are
-.Sy (char *)0
+.Fa (char *)0
that field is considered a wildcard.
.Pp
The functions
@@ -96,28 +93,30 @@ The function
.Fn innetgr
searches for a match of all fields within the specified group.
If any of the
-.Sy host ,
-.Sy user ,
+.Ar host ,
+.Ar user ,
or
-.Sy domain
+.Ar domain
arguments are
-.Sy (char *)0
+.Fa (char *)0
those fields will match any string value in the netgroup member.
.Sh RETURN VALUES
The function
.Fn getnetgrent
-returns 0 for ``no more netgroup members'' and 1 otherwise.
+returns 0 for
+.Dq no more netgroup members
+or 1 otherwise.
The function
.Fn innetgr
-returns 1 for a successful match and 0 otherwise.
+returns 1 for a successful match or 0 otherwise.
The functions
.Fn setnetgrent
and
.Fn endnetgrent
have no return value.
.Sh FILES
-.Bl -tag -width /etc/netgroup -compact
-.It Pa /etc/netgroup
+.Bl -tag -width /etc/netgroup.db -compact
+.It Pa /etc/netgroup.db
netgroup database file
.El
.Sh SEE ALSO
@@ -125,7 +124,8 @@ netgroup database file
.Sh BUGS
The function
.Fn getnetgrent
-returns pointers to dynamically allocated data areas that are free'd when
+returns pointers to dynamically allocated data areas that are
+.Xr free Ns 'd when
the function
.Fn endnetgrent
is called.
diff --git a/lib/libc/gen/getpagesize.3 b/lib/libc/gen/getpagesize.3
index 6273c16d7c4..0a40da96c4e 100644
--- a/lib/libc/gen/getpagesize.3
+++ b/lib/libc/gen/getpagesize.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getpagesize.3,v 1.6 1999/05/23 14:10:59 aaron Exp $
+.\" $OpenBSD: getpagesize.3,v 1.7 1999/05/29 19:11:11 aaron Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -49,13 +49,13 @@ Use
.Fn sysconf _SC_PAGESIZE .
.Ef
.Pp
+The
.Fn getpagesize
-returns the number of bytes in a page.
+function returns the number of bytes in a page.
Page granularity is the granularity of many of the memory
management calls.
.Pp
-The page size is a
-.Xr system
+The page size is a system
page size and may not be the same as the underlying
hardware page size.
.Sh SEE ALSO
@@ -64,6 +64,6 @@ hardware page size.
.Xr sysconf 3
.Sh HISTORY
The
-.Nm
+.Fn getpagesize
function call appeared in
.Bx 4.2 .
diff --git a/lib/libc/gen/getpass.3 b/lib/libc/gen/getpass.3
index d3f8a1a1d8d..6fca68c7681 100644
--- a/lib/libc/gen/getpass.3
+++ b/lib/libc/gen/getpass.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getpass.3,v 1.3 1998/06/08 17:17:07 deraadt Exp $
+.\" $OpenBSD: getpass.3,v 1.4 1999/05/29 19:11:11 aaron Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -48,21 +48,28 @@ The
function displays a prompt to, and reads in a password from,
.Pa /dev/tty .
If this file is not accessible,
-.Nm getpass
+.Fn getpass
displays the prompt on the standard error output and reads from the standard
input.
.Pp
-The password may be up to _PASSWORD_LEN (currently 128)
+The password may be up to _PASSWORD_LEN (currently 128, as defined in
+the include file
+.Aq Pa pwd.h )
characters in length.
Any additional
characters and the terminating newline character are discarded.
.Pp
-.Nm getpass
+.Fn getpass
turns off character echoing while reading the password.
.Pp
+The calling process should zero the password as soon as possible to
+avoid leaving the cleartext password visible in the process's address
+space.
.Sh RETURN VALUES
-.Nm getpass
-returns a pointer to the null terminated password.
+.Fn getpass
+returns a pointer to the
+.Dv NULL Ns -terminated
+password.
.Sh FILES
.Bl -tag -width /dev/tty -compact
.It Pa /dev/tty
@@ -71,18 +78,14 @@ returns a pointer to the null terminated password.
.Xr crypt 3
.Sh HISTORY
A
-.Nm getpass
+.Fn getpass
function appeared in
.At v7 .
.Sh BUGS
The
-.Nm getpass
+.Fn getpass
function leaves its result in an internal static object and returns
a pointer to that object.
Subsequent calls to
-.Nm getpass
+.Fn getpass
will modify the same object.
-.Pp
-The calling process should zero the password as soon as possible to
-avoid leaving the cleartext password visible in the process's address
-space.
diff --git a/lib/libc/gen/getpwent.3 b/lib/libc/gen/getpwent.3
index 746f3e11d4e..c0de291a2ae 100644
--- a/lib/libc/gen/getpwent.3
+++ b/lib/libc/gen/getpwent.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getpwent.3,v 1.5 1997/07/15 16:30:59 deraadt Exp $
+.\" $OpenBSD: getpwent.3,v 1.6 1999/05/29 19:11:11 aaron Exp $
.\"
.\" Copyright (c) 1988, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -60,13 +60,11 @@
.Sh DESCRIPTION
These functions
operate on the password database file
-which is described
-in
+which is described in
.Xr passwd 5 .
Each entry in the database is defined by the structure
-.Ar passwd
-found in the include
-file
+.Em passwd
+found in the include file
.Aq Pa pwd.h :
.Bd -literal -offset indent
struct passwd {
@@ -87,22 +85,20 @@ The functions
.Fn getpwnam
and
.Fn getpwuid
-search the password database for the given login name or user uid,
+search the password database for the given login name or user ID,
respectively, always returning the first one encountered.
.Pp
-The
.Fn getpwent
-function
sequentially reads the password database and is intended for programs
that wish to process the complete list of users.
.Pp
-The
.Fn setpassent
-function
accomplishes two purposes.
First, it causes
.Fn getpwent
-to ``rewind'' to the beginning of the database.
+to
+.Dq rewind
+to the beginning of the database.
Additionally, if
.Fa stayopen
is non-zero, file descriptors are left open, significantly speeding
@@ -115,9 +111,7 @@ It is dangerous for long-running programs to keep the file descriptors
open as the database will become out of date if it is updated while the
program is running.
.Pp
-The
.Fn setpwent
-function
is equivalent to
.Fn setpassent
with an argument of zero.
@@ -127,9 +121,11 @@ The
function
closes any open files.
.Pp
-These routines have been written to ``shadow'' the password file, e.g.
+These routines have been written to
+.Dq shadow
+the password file, e.g.,
allow only certain programs to have access to the encrypted password.
-If the process which calls them has an effective uid of 0, the encrypted
+If the process which calls them has an effective UID of 0, the encrypted
password will be returned, otherwise, the password field of the returned
structure will point to the string
.Ql * .
@@ -138,12 +134,14 @@ The functions
.Fn getpwent ,
.Fn getpwnam ,
and
-.Fn getpwuid ,
+.Fn getpwuid
return a valid pointer to a passwd structure on success
-and a null pointer if end-of-file is reached or an error occurs.
+or a
+.Dv NULL
+pointer if end-of-file is reached or an error occurs.
The
.Fn setpassent
-function returns 0 on failure and 1 on success.
+function returns 0 on failure or 1 on success.
The
.Fn endpwent
and
@@ -153,13 +151,13 @@ have no return value.
.Sh FILES
.Bl -tag -width /etc/master.passwd -compact
.It Pa /etc/pwd.db
-The insecure password database file
+insecure password database file
.It Pa /etc/spwd.db
-The secure password database file
+secure password database file
.It Pa /etc/master.passwd
-The current password file
+current password file
.It Pa /etc/passwd
-A Version 7 format password file
+a Version 7 format password file
.El
.Sh SEE ALSO
.Xr getlogin 2 ,
@@ -169,16 +167,16 @@ A Version 7 format password file
.Xr vipw 8
.Sh HISTORY
The
-.Nm getpwent ,
-.Nm getpwnam ,
-.Nm getpwuid ,
-.Nm setpwent,
+.Fn getpwent ,
+.Fn getpwnam ,
+.Fn getpwuid ,
+.Fn setpwent,
and
-.Nm endpwent
+.Fn endpwent
functions appeared in
.At v7 .
The
-.Nm setpassent
+.Fn setpassent
function appeared in
.Bx 4.3 Reno .
.Sh BUGS
@@ -186,7 +184,7 @@ The functions
.Fn getpwent ,
.Fn getpwnam ,
and
-.Fn getpwuid ,
+.Fn getpwuid
leave their results in an internal static object and return
a pointer to that object. Subsequent calls to
any of these functions
diff --git a/lib/libc/gen/getttyent.3 b/lib/libc/gen/getttyent.3
index 52cd4c15291..7f8bcd7da74 100644
--- a/lib/libc/gen/getttyent.3
+++ b/lib/libc/gen/getttyent.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getttyent.3,v 1.5 1999/05/25 01:50:57 aaron Exp $
+.\" $OpenBSD: getttyent.3,v 1.6 1999/05/29 19:11:11 aaron Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -79,13 +79,13 @@ struct ttyent {
The fields are as follows:
.Bl -tag -width ty_comment
.It Fa ty_name
-The name of the character-special file.
+Name of the character-special file.
.It Fa ty_getty
-The name of the command invoked by
+Name of the command invoked by
.Xr init 8
to initialize tty line characteristics.
.It Fa ty_type
-The name of the default terminal type connected to this tty line.
+Name of the default terminal type connected to this tty line.
.It Fa ty_status
A mask of bit fields which indicate various actions allowed on this
tty line.
@@ -98,11 +98,11 @@ will start the command referenced by
.Fa ty_getty
on this entry).
.It Dv TTY_SECURE
-Allow users with a uid of 0 to login on this terminal.
+Allow users with a UID of 0 to login on this terminal.
.It Dv TTY_LOCAL
If the terminal port's driver supports it, cause the line
to be treated as
-.Dq local.
+.Dq local .
.It Dv TTY_MDMBUF
If the terminal port's driver supports it, use
DTR/DCD hardware flow control on the line by default.
@@ -115,7 +115,7 @@ If the terminal port's driver supports it, ignore hardware
carrier on the line.
.El
.It Fa ty_window
-The command to execute for a window system associated with the line.
+Command to execute for a window system associated with the line.
.It Fa ty_comment
Any trailing comment field, with any leading hash marks
.Pq Sq \&#
@@ -123,7 +123,9 @@ or whitespace removed.
.El
.Pp
If any of the fields pointing to character strings are unspecified,
-they are returned as null pointers.
+they are returned as
+.Dv NULL
+pointers.
The field
.Fa ty_status
will be zero if no flag values are specified.
@@ -137,18 +139,12 @@ The
.Fn getttyent
function
reads the next line from the ttys file, opening the file if necessary.
-The
.Fn setttyent
-function
rewinds the file if open, or opens the file if it is unopened.
-The
.Fn endttyent
-function
closes any open files.
.Pp
-The
.Fn getttynam
-function
searches from the beginning of the file until a matching
.Fa name
is found
@@ -160,7 +156,9 @@ The routines
.Fn getttyent
and
.Fn getttynam
-return a null pointer on
+return a
+.Dv NULL
+pointer on
.Dv EOF
or error.
The
@@ -168,7 +166,7 @@ The
function
and
.Fn endttyent
-return 0 on failure and 1 on success.
+return 0 on failure or 1 on success.
.Sh FILES
.Bl -tag -width /etc/ttys -compact
.It Pa /etc/ttys
diff --git a/lib/libc/gen/getusershell.3 b/lib/libc/gen/getusershell.3
index bce81ea3dcd..2159e7bea3f 100644
--- a/lib/libc/gen/getusershell.3
+++ b/lib/libc/gen/getusershell.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getusershell.3,v 1.4 1999/05/23 14:11:00 aaron Exp $
+.\" $OpenBSD: getusershell.3,v 1.5 1999/05/29 19:11:11 aaron Exp $
.\"
.\" Copyright (c) 1985, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -58,7 +58,7 @@ If
.Pa /etc/shells
is unreadable or does not exist,
.Fn getusershell
-behaves as if
+behaves as if only
.Pa /bin/sh
and
.Pa /bin/csh
@@ -80,7 +80,9 @@ closes it.
.Sh DIAGNOSTICS
The routine
.Fn getusershell
-returns a null pointer (0) on
+returns a
+.Dv NULL
+pointer on
.Dv EOF .
.Sh SEE ALSO
.Xr shells 5
diff --git a/lib/libc/gen/glob.3 b/lib/libc/gen/glob.3
index 89d71f08c91..1c9a77894fc 100644
--- a/lib/libc/gen/glob.3
+++ b/lib/libc/gen/glob.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: glob.3,v 1.7 1998/02/03 18:25:55 millert Exp $
+.\" $OpenBSD: glob.3,v 1.8 1999/05/29 19:11:11 aaron Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993, 1994
.\" The Regents of the University of California. All rights reserved.
@@ -54,9 +54,9 @@ is a pathname generator that implements the rules for file name pattern
matching used by the shell.
.Pp
The include file
-.Pa glob.h
+.Aq Pa glob.h
defines the structure type
-.Fa glob_t ,
+.Em glob_t ,
which contains at least the following fields:
.Bd -literal
typedef struct {
@@ -71,9 +71,7 @@ typedef struct {
The argument
.Fa pattern
is a pointer to a pathname pattern to be expanded.
-The
.Fn glob
-argument
matches all accessible pathnames against the pattern and creates
a list of the pathnames that match.
In order to have access to a pathname,
@@ -87,12 +85,9 @@ that contains any of the special characters
or
.Ql [ .
.Pp
-The
-.Fn glob
-argument
-stores the number of matched pathnames into the
+The number of matched pathnames is stored in the
.Fa gl_pathc
-field, and a pointer to a list of pointers to pathnames into the
+field, and a pointer to a list of pointers to pathnames in the
.Fa gl_pathv
field.
The first pointer after the last pathname is
@@ -115,10 +110,10 @@ is used to modify the behavior of
The value of
.Fa flags
is the bitwise inclusive
-.Tn OR
+.Em OR
of any of the following
values defined in
-.Pa glob.h :
+.Aq Pa glob.h :
.Bl -tag -width GLOB_ALTDIRFUNC
.It Dv GLOB_APPEND
Append pathnames generated to the ones from a previous call (or calls)
@@ -208,8 +203,12 @@ however, they are non-standard extensions to
.St -p1003.2 .
.Bl -tag -width GLOB_ALTDIRFUNC
.It Dv GLOB_ALTDIRFUNC
-The following additional fields in the pglob structure have been
-initialized with alternate functions for glob to use to open, read,
+The following additional fields in the
+.Fa pglob
+structure have been
+initialized with alternate functions for
+.Fn glob
+to use to open, read,
and close directories and to get stat information on names found
in those directories.
.Bd -literal
@@ -231,7 +230,7 @@ strings like
The pattern
.Ql {}
is left unexpanded for historical reasons.
-.Xr (Csh 1
+.Xr (csh 1
does the same thing to
ease typing
of
@@ -249,7 +248,11 @@ Is the same as
.Dv GLOB_NOCHECK
but it only appends the
.Fa pattern
-if it does not contain any of the special characters ``*'', ``?'' or ``[''.
+if it does not contain any of the special characters
+.Ql * ,
+.Ql ? ,
+or
+.Ql [ .
.Dv GLOB_NOMAGIC
is provided to simplify implementing the historic
.Xr csh 1
@@ -272,19 +275,19 @@ is
calls
.Fa (*errfunc)(path, errno) .
This may be unintuitive: a pattern like
-.Ql */Makefile
+.Dq */Makefile
will try to
.Xr stat 2
-.Ql foo/Makefile
+.Dq foo/Makefile
even if
-.Ql foo
+.Dq foo
is not a directory, resulting in a
call to
.Fa errfunc .
The error routine can suppress this action by testing for
-.Dv ENOENT
+.Er ENOENT
and
-.Dv ENOTDIR ;
+.Er ENOTDIR ;
however, the
.Dv GLOB_ERR
flag will still cause an immediate
@@ -333,26 +336,30 @@ In addition the fields of
contain the values described below:
.Bl -tag -width GLOB_NOCHECK
.It Fa gl_pathc
-contains the total number of matched pathnames so far.
+Contains the total number of matched pathnames so far.
This includes other matches from previous invocations of
.Fn glob
if
.Dv GLOB_APPEND
was specified.
.It Fa gl_matchc
-contains the number of matched pathnames in the current invocation of
+Contains the number of matched pathnames in the current invocation of
.Fn glob .
.It Fa gl_flags
-contains a copy of the
+Contains a copy of the
.Fa flags
parameter with the bit
.Dv GLOB_MAGCHAR
set if
.Fa pattern
-contained any of the special characters ``*'', ``?'' or ``['', cleared
-if not.
+contained any of the special characters
+.Ql * ,
+.Ql ? ,
+or
+.Ql [ ,
+cleared if not.
.It Fa gl_pathv
-contains a pointer to a
+Contains a pointer to a
.Dv NULL Ns -terminated
list of matched pathnames.
However, if
diff --git a/lib/libc/gen/initgroups.3 b/lib/libc/gen/initgroups.3
index ac43105d248..533afe27795 100644
--- a/lib/libc/gen/initgroups.3
+++ b/lib/libc/gen/initgroups.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: initgroups.3,v 1.5 1999/05/23 14:11:00 aaron Exp $
+.\" $OpenBSD: initgroups.3,v 1.6 1999/05/29 19:11:11 aaron Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -69,7 +69,7 @@ the later groups are ignored.
The
.Fn initgroups
function
-returns \-1 if it was not invoked by the super-user.
+returns -1 if it was not invoked by the super-user.
.Sh SEE ALSO
.Xr setgroups 2 ,
.Xr getgrouplist 3
@@ -80,7 +80,7 @@ function appeared in
.Bx 4.2 .
.Sh BUGS
The
-.Fn getgrouplist
+.Xr getgrouplist 3
function called by
.Fn initgroups
uses the routines based on