diff options
| author | Aaron Campbell <aaron@cvs.openbsd.org> | 1998-09-27 16:57:55 +0000 |
|---|---|---|
| committer | Aaron Campbell <aaron@cvs.openbsd.org> | 1998-09-27 16:57:55 +0000 |
| commit | 67d4a6033bddb7d54e3ef944dae899133e293901 (patch) | |
| tree | e9fa8b31d399fbf78eb212bff674a4eb212767b0 /usr.bin | |
| parent | ef3f0c32a94fffe5f70dc86aaca4e234fe407c4b (diff) | |
usr.bin/ man page cleanups, n-s
Diffstat (limited to 'usr.bin')
44 files changed, 403 insertions, 395 deletions
diff --git a/usr.bin/nc/nc.1 b/usr.bin/nc/nc.1 index 2900fc76019..8ada12ff95f 100644 --- a/usr.bin/nc/nc.1 +++ b/usr.bin/nc/nc.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: nc.1,v 1.2 1998/03/11 18:42:23 deraadt Exp $ +.\" $OpenBSD: nc.1,v 1.3 1998/09/27 16:57:47 aaron Exp $ .\" .\" Copyright (c) 1996 David Sacerdote .\" All rights reserved. @@ -26,12 +26,11 @@ .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .Dd August 1, 1996 -.Dt nc 1 +.Dt NC 1 .Sh NAME .Os .Nm nc -.Nd -Arbitrary tcp and udp connections and listens. +.Nd arbitrary TCP and UDP connections and listens .Pp .Sh SYNOPSIS .Nm nc @@ -53,8 +52,8 @@ The (or .Nm netcat ) utility is used for just about anything under the sun -involving TCP or UDP. It can open tcp connections, send udp packets, -listen on arbitrary tcp and udp ports, do port scanning, and source +involving TCP or UDP. It can open TCP connections, send UDP packets, +listen on arbitrary TCP and UDP ports, do port scanning, and source routing. Unlike .Xr telnet 1 , .Nm nc @@ -71,9 +70,9 @@ ranges may be specified on the command line. Common uses include: .Bl -bullet .It -simple tcp proxies +simple TCP proxies .It -shell\-script based http clients and servers +shell\-script based HTTP clients and servers .It network daemon testing .It @@ -103,7 +102,7 @@ Also causes a delay time between connections to multiple ports. Is used to specify that .Nm nc should listen for an incoming connection, rather than initiate a -connection to a remote host. Any hostname/ip address and port arguments +connection to a remote host. Any hostname/IP address and port arguments restrict the source of inbound connections to only that address and source port. .It Fl n @@ -111,20 +110,21 @@ Do not do DNS lookups on any of the specified addresses or hostnames, or names of port numbers from /etc/services. .It Fl o Ar filename Create a hexadecimal log of data transferred in the specified file. -Each line begins with < or >. < means "from the net" and > means -"to the net." +Each line begins with ``<'' or ``>''. ``<'' means "from the net" and ``>'' +means "to the net". .It Fl p Ar port Specifies the source port .Nm nc should use, subject to privilege restrictions and availability. .It Fl r -Specified that source and/or destination ports should be chosen semi-randomly +Specifies that source and/or destination ports should be chosen semi-randomly instead of sequentially within a range or in the order that the system assigns. .It Fl s Ar hostname/ip-address -Specifies the ip of the interface which is used to send the packets. -On some platforms, this can be used for udp spoofing by using ifconfig -to bring up a dummy interface with the desired source ip address. +Specifies the IP of the interface which is used to send the packets. +On some platforms, this can be used for UDP spoofing by using +.Xr ifconfig 8 +to bring up a dummy interface with the desired source IP address. .It Fl t Causes .Nm nc @@ -143,7 +143,8 @@ sends. .It Fl v Verbose. Cause .Nm nc -to display connection information. Using \-v +to display connection information. Using +.Fl v more than once will cause .Nm nc to become even more verbose. @@ -160,9 +161,10 @@ Specifies that should just scan for listening daemons, without sending any data to them. Diagnostic messages about refused connections will not be -displayed unless \-v is specified twice. +displayed unless +.Fl v +is specified twice. .Sh EXAMPLES -.Pp .Bl -tag -width x .It Li "nc" Wait for the user to type what would normally be command-line @@ -174,27 +176,27 @@ fails, do not display any error messages, but simply exit. Open a TCP connection to port 42 of example.host, and use port 31337 as the source port. .It Li "nc -w 5 example.host 42" -Open a tcp connection to port 42 of example.host, and time out after +Open a TCP connection to port 42 of example.host, and time out after five seconds while attempting to connect. .It Li "nc -u example.host 53" Send any data from stdin to UDP port 53 of example.host, and display any data returned. .It Li "nc -s 10.1.2.3 example.host 42" -Open a tcp connection to port 42 of example.host using 10.1.2.3 as the -ip for the local end of the connection. +Open a TCP connection to port 42 of example.host using 10.1.2.3 as the +IP for the local end of the connection. .It Li "nc -v example.host 42" -Open a tcp connection to port 42 of example.host, displaying some +Open a TCP connection to port 42 of example.host, displaying some diagnostic messages on stderr. .It Li "nc -v -v example.host 42" -Open a tcp connection to port 42 of example.host, displaying all +Open a TCP connection to port 42 of example.host, displaying all diagnostic messages on stderr. .It Li "nc -v -z example.host 20-30" -Attempt to open tcp connections to ports 20 through 30 of +Attempt to open TCP connections to ports 20 through 30 of example.host, and report which ones .Nm nc was able to connect to. .It Li "nc -v -u -z -w 3 example.host 20-30" -Send udp packets to ports 20-30 of example.host, and report which ones +Send UDP packets to ports 20-30 of example.host, and report which ones did not respond with an ICMP packet after three seconds. .It Li "nc -l -p 3000" Listen on TCP port 3000, and once there is a connection, send stdin to @@ -205,10 +207,11 @@ followed by a newline, and move data from port 1000 of example.host to stdout until example.host closes the connection. .El .Sh SEE ALSO -.Xr telnet 1 , .Xr cat 1 , -and the +.Xr telnet 1 +.Pp +The .Nm netcat -.Pa README +.Pa README . .Sh AUTHOR *Hobbit* [hobbit@avian.org] diff --git a/usr.bin/netstat/netstat.1 b/usr.bin/netstat/netstat.1 index 10aad49fd7f..5329da119c7 100644 --- a/usr.bin/netstat/netstat.1 +++ b/usr.bin/netstat/netstat.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: netstat.1,v 1.11 1998/09/07 16:44:33 aaron Exp $ +.\" $OpenBSD: netstat.1,v 1.12 1998/09/27 16:57:48 aaron Exp $ .\" $NetBSD: netstat.1,v 1.11 1995/10/03 21:42:43 thorpej Exp $ .\" .\" Copyright (c) 1983, 1990, 1992, 1993 @@ -80,7 +80,7 @@ will continuously display the information regarding packet traffic on the configured network interfaces. The fourth form displays statistics about the named protocol. .Pp -The options have the following meaning: +The options are as follows: .Bl -tag -width flag .It Fl A With the default display, @@ -98,34 +98,34 @@ show the number of dropped packets. .It Fl f Ar address_family Limit statistics or address control block reports to those of the specified -.Ar address family . +.Ar address_family . The following address families are recognized: -.Ar inet , +.Ar inet , for -.Dv AF_INET , +.Dv AF_INET , .Ar ipx , for -.Dv AF_IPX , +.Dv AF_IPX , .Ar atalk , for .Dv AF_APPLETALK , .Ar ns , for -.Dv AF_NS , +.Dv AF_NS , .Ar iso , for .Dv AF_ISO , .Ar encap , for .Dv AF_ENCAP , -.Ar local , +.Ar local , for -.Dv AF_LOCAL , +.Dv AF_LOCAL , and -.Ar unix , +.Ar unix , for -.Dv AF_UNIX . +.Dv AF_UNIX . .It Fl g Show information related to multicast (group address) routing. By default, show the IP Multicast virtual-interface and routing tables. @@ -169,7 +169,7 @@ symbolically). This option may be used with any of the display formats. .It Fl p Ar protocol Show statistics about -.Ar protocol , +.Ar protocol , which is either a well-known name for a protocol or an alias for it. Some protocol names and aliases are listed in the file .Pa /etc/protocols . @@ -187,7 +187,7 @@ When .Fl s is also present, show routing statistics instead. .It Fl v -be verbose. This currently has no effect. +Be verbose. This currently has no effect. .It Fl w Ar wait Show network interface statistics at intervals of .Ar wait @@ -212,18 +212,18 @@ to the address family. For more information regarding the Internet ``dot format,'' refer to -.Xr inet 3 ) . +.Xr inet 3 . Unspecified, -or ``wildcard'', addresses and ports appear as ``*''. +or ``wildcard'' addresses and ports appear as ``*''. If a local port number is registered as being in use for RPC by -.Xr portmap 8 +.Xr portmap 8 , its RPC service name or RPC service number will be printed in -[ ] immediately after the port number. +``[]'' immediately after the port number. .Pp The interface display provides a table of cumulative statistics regarding packets transferred, errors, and collisions. The network addresses of the interface -and the maximum transmission unit (``mtu'') are also displayed. +and the maximum transmission unit (``MTU'') are also displayed. .Pp The routing table display indicates the available routes and their status. Each route consists of a destination host or network and @@ -238,19 +238,19 @@ and manual pages. The mapping between letters and flags is: .Bl -column XXXX RTF_BLACKHOLE -1 RTF_PROTO1 Protocol specific routing flag #1 -2 RTF_PROTO2 Protocol specific routing flag #2 -B RTF_BLACKHOLE Just discard pkts (during updates) -C RTF_CLONING Generate new routes on use -D RTF_DYNAMIC Created dynamically (by redirect) -G RTF_GATEWAY Destination requires forwarding by intermediary -H RTF_HOST Host entry (net otherwise) +1 RTF_PROTO1 Protocol specific routing flag #1. +2 RTF_PROTO2 Protocol specific routing flag #2. +B RTF_BLACKHOLE Just discard pkts (during updates). +C RTF_CLONING Generate new routes on use. +D RTF_DYNAMIC Created dynamically (by redirect). +G RTF_GATEWAY Destination requires forwarding by intermediary. +H RTF_HOST Host entry (net otherwise). L RTF_LLINFO Valid protocol to link address translation. -M RTF_MODIFIED Modified dynamically (by redirect) -R RTF_REJECT Host or net unreachable -S RTF_STATIC Manually added -U RTF_UP Route usable -X RTF_XRESOLVE External daemon translates proto to link address +M RTF_MODIFIED Modified dynamically (by redirect). +R RTF_REJECT Host or net unreachable. +S RTF_STATIC Manually added. +U RTF_UP Route usable. +X RTF_XRESOLVE External daemon translates proto to link address. .El .Pp Direct routes are created for each @@ -262,11 +262,11 @@ protocols normally hold on to a single route for the duration of a connection while connectionless protocols obtain a route while sending to the same destination. The use field provides a count of the number of packets -sent using that route. The mtu entry shows the mtu associated with -that route. This mtu value is used as the basis for the TCP maximum -segment size. A +sent using that route. The MTU entry shows the MTU associated with +that route. This MTU value is used as the basis for the TCP maximum +segment size (MSS). A .Sq - -indicates that the mtu for this route has not been set, and a default +indicates that the MTU for this route has not been set, and a default TCP maximum segment size will be used. The interface entry indicates the network interface utilized for the route. .Pp diff --git a/usr.bin/newsyslog/newsyslog.8 b/usr.bin/newsyslog/newsyslog.8 index 0b549b2f137..58a854593a3 100644 --- a/usr.bin/newsyslog/newsyslog.8 +++ b/usr.bin/newsyslog/newsyslog.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: newsyslog.8,v 1.7 1998/09/24 03:36:58 millert Exp $ +.\" $OpenBSD: newsyslog.8,v 1.8 1998/09/27 16:57:48 aaron Exp $ .\" .\" Copyright (c) 1997, Jason Downs. All rights reserved. .\" @@ -59,7 +59,7 @@ .Op Fl vmnr .Op Fl f Ar configuration file .Sh DESCRIPTION -.Nm Newsyslog +.Nm newsyslog is a program that should be scheduled to run periodically by .Xr cron 8 . When it is executed it archives log files if necessary. If a log file @@ -127,7 +127,7 @@ files compressed to save space using or .Xr compress 1 , depending on compilation options. The ``B'' flag means that the file is a -binary file, and so the ascii message which +binary file, and so the ASCII message which .Nm newsyslog inserts to indicate the fact that the logs have been turned over should not be included. The ``M'' flag marks this entry as a monitored @@ -145,24 +145,27 @@ instead of .El .Pp .Sh OPTIONS -The following options can be used with newsyslog: +The following options can be used with +.Nm newsyslog : .Bl -tag -width XXX .It Fl f Ar config-file -instructs newsyslog to use +Instructs newsyslog to use .Ar config-file -instead of /etc/newsyslog.conf for its configuration file. +instead of +.Pa /etc/newsyslog.conf +for its configuration file. .It Fl v -places +Places .Nm newsyslog in verbose mode. In this mode it will print out each log and its reasons for either trimming that log or skipping it. .It Fl n -causes +Causes .Nm newsyslog not to trim the logs, but to print out what it would do if this option were not specified. .It Fl r -removes the restriction that +Removes the restriction that .Nm newsyslog must be running as root. Of course, .Nm newsyslog @@ -170,7 +173,7 @@ will not be able to send a HUP signal to .Xr syslogd 8 , so this option should only be used in debugging. .It Fl m -places +Places .Nm newsyslog in monitoring mode; only entries marked with an ``M'' in flags are processed, and notifications sent if any have changed. Without this option, monitored @@ -180,13 +183,13 @@ entries are not processed. .Sh FILES .Bl -tag -width /etc/newsyslog.conf .It Pa /etc/newsyslog.conf -Default configuration file. +efault configuration file .El .Sh SEE ALSO -.Xr gzip 1 , .Xr compress 1 , +.Xr gzip 1 , .Xr syslog 3 , -.Xr syslogd 8 . +.Xr syslogd 8 .Sh AUTHOR .Bd -unfilled -offset indent Theodore Ts'o, MIT Project Athena diff --git a/usr.bin/nfsstat/nfsstat.1 b/usr.bin/nfsstat/nfsstat.1 index c2ae980897d..4ad753c6f1e 100644 --- a/usr.bin/nfsstat/nfsstat.1 +++ b/usr.bin/nfsstat/nfsstat.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: nfsstat.1,v 1.4 1996/12/15 20:57:59 kstailey Exp $ +.\" $OpenBSD: nfsstat.1,v 1.5 1998/09/27 16:57:48 aaron Exp $ .\" $NetBSD: nfsstat.1,v 1.8 1996/03/03 17:21:28 thorpej Exp $ .\" .\" Copyright (c) 1989, 1990, 1993 @@ -50,21 +50,21 @@ statistics .Op Fl s .Op Fl c .Sh DESCRIPTION -.Nm Nfsstat +.Nm nfsstat displays statistics kept about .Tn NFS client and server activity. .Pp The options are as follows: .Bl -tag -width Ds -.It Fl M +.It Fl M Ar core Extract values associated with the name list from the specified core instead of the default .Pa /dev/kmem . -.It Fl N +.It Fl N Ar system Extract the name list from the specified system instead of the default .Pa /bsd . -.It Fl w +.It Fl w Ar wait Display a shorter summary of .Tn NFS activity for both the client and server at @@ -93,5 +93,5 @@ default memory file .Sh HISTORY The .Nm nfsstat -command appears in +command appeared in .Bx 4.4 . diff --git a/usr.bin/nice/nice.1 b/usr.bin/nice/nice.1 index 50fb9e78dc2..b72cb229132 100644 --- a/usr.bin/nice/nice.1 +++ b/usr.bin/nice/nice.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: nice.1,v 1.3 1997/08/25 17:51:02 deraadt Exp $ +.\" $OpenBSD: nice.1,v 1.4 1998/09/27 16:57:48 aaron Exp $ .\" $NetBSD: nice.1,v 1.6 1995/08/31 23:30:57 jtc Exp $ .\" .\" Copyright (c) 1980, 1990, 1993 @@ -46,7 +46,7 @@ .Ar utility .Op Ar argument ... .Sh DESCRIPTION -.Nm Nice +.Nm nice runs .Ar utility at an altered scheduling priority. @@ -65,7 +65,7 @@ Available options: .It Fl n Ar increment A positive or negative decimal integer used to modify the system scheduling priority of -.Ar utility. +.Ar utility . .El .Sh DIAGNOSTICS The @@ -110,7 +110,7 @@ A utility appeared in .At v6 . .Sh BUGS -.Nm Nice +.Nm nice is built into .Xr csh 1 with a slightly different syntax than described here. The form diff --git a/usr.bin/nm/nm.1 b/usr.bin/nm/nm.1 index 0ee783ebfb2..31d262febbf 100644 --- a/usr.bin/nm/nm.1 +++ b/usr.bin/nm/nm.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: nm.1,v 1.2 1996/06/26 05:37:32 deraadt Exp $ +.\" $OpenBSD: nm.1,v 1.3 1998/09/27 16:57:48 aaron Exp $ .\" $NetBSD: nm.1,v 1.3 1995/08/31 23:41:58 jtc Exp $ .\" .\" Copyright (c) 1980, 1990, 1993 @@ -43,7 +43,7 @@ .Sh SYNOPSIS .Nm nm .Op Fl agnopruw -.Ar +.Ar file Op Ar ... .Sh DESCRIPTION The symbol table (name list) of each object in .Ar file(s) @@ -78,7 +78,9 @@ Reverse order sort. Display undefined symbols only. .It Fl w Warn about non-object archive members. -Normally, nm will silently ignore all archive members which are not +Normally, +.Nm nm +will silently ignore all archive members which are not object files. .El .Pp @@ -110,8 +112,8 @@ If the symbol is local (non-external) the type letter is in lower case. The output is sorted alphabetically. .Sh SEE ALSO .Xr ar 1 , -.Xr ar 5 , .Xr a.out 5 , +.Xr ar 5 , .Xr stab 5 .Sh HISTORY An diff --git a/usr.bin/nohup/nohup.1 b/usr.bin/nohup/nohup.1 index 5a9952159a1..e616508d8b0 100644 --- a/usr.bin/nohup/nohup.1 +++ b/usr.bin/nohup/nohup.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: nohup.1,v 1.2 1996/06/26 05:37:35 deraadt Exp $ +.\" $OpenBSD: nohup.1,v 1.3 1998/09/27 16:57:49 aaron Exp $ .\" $NetBSD: nohup.1,v 1.5 1995/08/31 23:35:24 jtc Exp $ .\" .\" Copyright (c) 1989, 1990, 1993 @@ -65,7 +65,7 @@ If standard error is a terminal, it is directed to the same place as the standard output. .Sh ENVIRONMENT The following variable is utilized by -.Nm nohup . +.Nm nohup : .Bl -tag -width flag .It Ev HOME If the output file diff --git a/usr.bin/oldrdist/oldrdist.1 b/usr.bin/oldrdist/oldrdist.1 index a20ad1f4ffb..133c9a9cc37 100644 --- a/usr.bin/oldrdist/oldrdist.1 +++ b/usr.bin/oldrdist/oldrdist.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: oldrdist.1,v 1.2 1996/06/26 05:37:40 deraadt Exp $ +.\" $OpenBSD: oldrdist.1,v 1.3 1998/09/27 16:57:49 aaron Exp $ .\" Copyright (c) 1985, 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" @@ -51,11 +51,11 @@ .Ar name ... .Oo login@ Oc Ns Ar host Ns Op :dest .Sh DESCRIPTION -.Nm Rdist +.Nm rdist is a program to maintain identical copies of files over multiple hosts. It preserves the owner, group, mode, and mtime of files if possible and can update programs that are executing. -.Nm Rdist +.Nm rdist reads commands from .Ar distfile to direct the updating of files and/or directories. @@ -63,15 +63,12 @@ to direct the updating of files and/or directories. Options specific to the first SYNOPSIS form: .Pp .Bl -tag -width indent -.It Fl -If -.Ar distfile -is -.Sq Fl , -the standard input is used. .It Fl f Ar distfile Use the specified -.Ar distfile. +.Ar distfile . +If +.Ar distfile +is `-', the standard input is used. .El .Pp If either the @@ -139,7 +136,7 @@ Follow symbolic links. Copy the file that the link points to rather than the link itself. .It Fl i Ignore unresolved links. -.Nm Rdist +.Nm rdist will normally try to maintain the link structure of files being transferred and warn the user if all the links cannot be found. .It Fl m Ar host @@ -188,10 +185,10 @@ to prevent newer copies on other hosts from being replaced. A warning message is printed for files which are newer than the master copy. .El .Pp -.Ar Distfile +.Ar distfile contains a sequence of entries that specify the files to be copied, the destination hosts, and what operations to perform -to do the updating. Each entry has one of the following formats. +to do the updating. Each entry has one of the following formats: .Pp .Bd -literal -offset indent -compact <variable name> `=' <name list> @@ -247,7 +244,7 @@ File names which do not begin with `/' or `~' use the destination user's home directory as the root directory for the rest of the file name. .Pp The command list consists of zero or more commands of the following -format. +format: .Bd -ragged -offset indent -compact .Bl -column except_patx pattern\ listx .It `install' <options> opt_dest_name `;' @@ -263,7 +260,7 @@ The command is used to copy out of date files and/or directories. Each source file is copied to each host in the destination list. Directories are recursively copied in the same way. -.Ar Opt_dest_name +.Ar opt_dest_name is an optional parameter to rename files. If no .Ic install @@ -283,7 +280,7 @@ and have the same semantics as options on the command line except they only apply to the files in the source list. The login name used on the destination host is the same as the local host -unless the destination name is of the format ``login@host". +unless the destination name is of the format ``login@host''. .Pp The .Ic notify @@ -295,8 +292,7 @@ the name .Pp The .Ic except -command is used to update all of the files in the source list -.Ic except +command is used to update all of the files in the source list except for the files listed in .Ar name list . This is usually used to copy everything in a directory except certain files. @@ -330,10 +326,10 @@ is updated or installed. If the .Ar name list is omitted then the shell commands will be executed -for every file updated or installed. The shell variable `FILE' is set +for every file updated or installed. The shell variable FILE is set to the current filename before executing the commands in .Ar string . -.Ar String +.Ar string starts and ends with `"' and can cross multiple lines in .Ar distfile . Multiple commands to the shell should be separated by `;'. @@ -383,8 +379,8 @@ input command file temporary file for update lists .El .Sh SEE ALSO -.Xr sh 1 , .Xr csh 1 , +.Xr sh 1 , .Xr stat 2 .Sh HISTORY The @@ -392,7 +388,9 @@ The command appeared in .Bx 4.3 . .Sh DIAGNOSTICS -A complaint about mismatch of rdist version numbers may really stem +A complaint about mismatch of +.Nm rdist +version numbers may really stem from some problem with starting your shell, e.g., you are in too many groups. .Sh BUGS Source files must reside on the local host where @@ -405,7 +403,7 @@ in a directory have been updated. Variable expansion only works for name lists; there should be a general macro facility. .Pp -.Nm Rdist +.Nm rdist aborts on files which have a negative mtime (before Jan 1, 1970). .Pp There should be a `force' option to allow replacement of non-empty directories diff --git a/usr.bin/pagesize/pagesize.1 b/usr.bin/pagesize/pagesize.1 index c4ff472dca8..917cecc3eed 100644 --- a/usr.bin/pagesize/pagesize.1 +++ b/usr.bin/pagesize/pagesize.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pagesize.1,v 1.3 1997/01/07 06:15:21 kstailey Exp $ +.\" $OpenBSD: pagesize.1,v 1.4 1998/09/27 16:57:49 aaron Exp $ .\" $NetBSD: pagesize.1,v 1.4 1995/08/31 23:38:50 jtc Exp $ .\" .\" Copyright (c) 1983, 1990, 1993 @@ -43,7 +43,7 @@ .Sh SYNOPSIS .Nm pagesize .Sh DESCRIPTION -.Nm Pagesize +.Nm pagesize prints the size of a page of memory in bytes, as returned by .Xr getpagesize 3 . diff --git a/usr.bin/passwd/passwd.1 b/usr.bin/passwd/passwd.1 index bc8f837f8c6..496820e21c6 100644 --- a/usr.bin/passwd/passwd.1 +++ b/usr.bin/passwd/passwd.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: passwd.1,v 1.6 1998/01/20 19:51:58 art Exp $ +.\" $OpenBSD: passwd.1,v 1.7 1998/09/27 16:57:49 aaron Exp $ .\" Copyright (c) 1990 The Regents of the University of California. .\" All rights reserved. .\" @@ -50,7 +50,7 @@ .Op Ar user .\" This should really be: passwd [-l] [-y] [-k [-n name] [-i instance] [-r realm] [-u username[.instance][@realm]]] [user] .Sh DESCRIPTION -.Nm Passwd +.Nm passwd changes the user's local, Kerberos, or YP password. First, the user is prompted for their current password. If the current password is correctly typed, a new password is @@ -62,21 +62,21 @@ purely alphabetic. Its total length must be less than .Dv _PASSWORD_LEN (currently 128 characters). -Numbers, upper case letters and meta characters +Numbers, upper case letters and meta-characters are encouraged. .Bl -tag -width flag .It Fl l -This option causes the password to be updated only in the local +Causes the password to be updated only in the local password file. When changing only the local password, .Xr pwd_mkdb 8 is used to update the password databases. .It Fl y -This forces the YP password database entry to be changed, even if +Forces the YP password database entry to be changed, even if the user has an entry in the local database. The .Xr rpc.yppasswdd 8 daemon should be running on the YP master server. .It Fl k -This option forces the change to affect the Kerberos database, even +Forces the change to affect the Kerberos database, even if the user has a password in the local database. Once the password has been verified, .Nm passwd @@ -86,33 +86,33 @@ the Kerberos authenticating host. .Pp The following flags are only used when the .Fl k -flag is specified. +flag is specified: .Bl -tag -width flag -.It Fl n -This option lets you specify a -.Nm name +.It Fl n Ar name +Specifies a +.Ar name that will be used as the principal name rather than the username of the user running -.Nm passwd. +.Nm passwd . (This is determined from the ticket file if it exists; otherwise, -it is determined from the unix user id.) -.It Fl i -This option lets you specify an -.Nm instance +it is determined from the Unix user ID.) +.It Fl i Ar instance +Specifies an +.Ar instance to use rather than a null instance. -.It Fl r -This option lets you use -.Nm realm +.It Fl r Ar realm +Specifies a +.Ar realm instead of the local realm. -.It Fl u -This option lets you specify a fully qualified kerberos principal. +.It Fl u Ar username[.instance][@realm] +Specifies a fully qualified kerberos principal. .El .Pp This is the behavior if no flags are specified: if Kerberos is active then .Nm passwd will talk to the Kerberos server (even if the user has an entry -in the local database.) +in the local database). If the password is not in the local password database, then an attempt is made to use the YP database. .Pp @@ -131,13 +131,13 @@ It can be different for local and YP passwords. .Sh FILES .Bl -tag -width /etc/master.passwd -compact .It Pa /etc/master.passwd -The user database +user database .It Pa /etc/passwd -A Version 7 format password file +a Version 7 format password file .It Pa /etc/passwd.XXXXXX -Temporary copy of the password file +temporary copy of the password file .It /etc/passwd.conf -Configuration options +configuration options .El .Sh SEE ALSO .Xr chpass 1 , diff --git a/usr.bin/paste/paste.1 b/usr.bin/paste/paste.1 index 5b5600ed540..315022d8e24 100644 --- a/usr.bin/paste/paste.1 +++ b/usr.bin/paste/paste.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: paste.1,v 1.2 1996/06/26 05:37:50 deraadt Exp $ +.\" $OpenBSD: paste.1,v 1.3 1998/09/27 16:57:49 aaron Exp $ .\" Copyright (c) 1989, 1990 The Regents of the University of California. .\" All rights reserved. .\" @@ -46,7 +46,7 @@ .Nm paste .Op Fl s .Op Fl d Ar list -.Ar file ... +.Ar file Op Ar ... .Sh DESCRIPTION The .Nm paste @@ -70,7 +70,9 @@ is exhausted the first character from .Ar list is reused. This continues until a line from the last input file (in default operation) -or the last line in each file (using the -s option) is displayed, at which +or the last line in each file (using the +.Fl s +option) is displayed, at which time .Nm paste begins selecting characters from the beginning of @@ -87,7 +89,7 @@ tab character .It Li \e\e backslash character .It Li \e0 -Empty string (not a null character). +empty string (not a null character) .El .Pp Any other character preceded by a backslash is equivalent to the @@ -97,7 +99,9 @@ Concatenate all of the lines of each separate input file in command line order. The newline character of every line except the last line in each input file is replaced with the tab character, unless otherwise specified by -the -d option. +the +.Fl d +option. .El .Pp If @@ -109,7 +113,7 @@ for each instance of .Pp The .Nm paste -utility exits 0 on success, and >0 if an error occurs. +utility exits 0 on success or >0 if an error occurred. .Sh SEE ALSO .Xr cut 1 .Sh STANDARDS diff --git a/usr.bin/pctr/pctr.1 b/usr.bin/pctr/pctr.1 index f5f9d65f839..0897f4dc227 100644 --- a/usr.bin/pctr/pctr.1 +++ b/usr.bin/pctr/pctr.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pctr.1,v 1.1 1998/08/30 22:58:03 downsj Exp $ +.\" $OpenBSD: pctr.1,v 1.2 1998/09/27 16:57:49 aaron Exp $ .\" .\" Copyright (c) 1998, Jason Downs. All rights reserved. .\" @@ -28,7 +28,7 @@ .Os .Sh NAME .Nm pctr -.Nd display cpu performance counters +.Nd display CPU performance counters .Sh SYNOPSIS .Nm .Op Fl l Ar 5 | 6 @@ -56,7 +56,7 @@ designation of the current processor. .Sh RETURN VALUES The .Nm -program exits with a value of 0 on success, and 1 on failure. +program exits with a value of 0 on success or 1 on failure. .Sh BUGS The .Nm diff --git a/usr.bin/pnpinfo/pnpinfo.8 b/usr.bin/pnpinfo/pnpinfo.8 index 9e1208c0343..0041c028417 100644 --- a/usr.bin/pnpinfo/pnpinfo.8 +++ b/usr.bin/pnpinfo/pnpinfo.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pnpinfo.8,v 1.1 1996/08/11 15:48:55 shawn Exp $ +.\" $OpenBSD: pnpinfo.8,v 1.2 1998/09/27 16:57:49 aaron Exp $ .\" Copyright (c) 1996, Sujal M. Patel .\" All rights reserved. .\" @@ -34,7 +34,7 @@ .Os .Sh NAME .Nm pnpinfo -.Nd "Reports information about Plug-n-Play ISA devices" +.Nd reports information about Plug-n-Play ISA devices .Sh SYNOPSIS .Nm pnpinfo .Sh DESCRIPTION @@ -43,7 +43,7 @@ reports information about Plug-n-Play ISA devices. Some of the information, such as the vendor ID, serial number, I/O ports, IRQ, etc. are useful when configuring a kernel with ISA PnP devices. .Sh BUGS -A few of the tags are unimplemented (Enough exist for 99% of PnP cards). +A few of the tags are unimplemented (enough exist for 99% of PnP cards). .Sh SEE ALSO .Xr pnp 4 .Sh HISTORY diff --git a/usr.bin/pr/pr.1 b/usr.bin/pr/pr.1 index 5399e13c937..cd1aca9d537 100644 --- a/usr.bin/pr/pr.1 +++ b/usr.bin/pr/pr.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pr.1,v 1.5 1997/06/26 21:53:04 deraadt Exp $ +.\" $OpenBSD: pr.1,v 1.6 1998/09/27 16:57:50 aaron Exp $ .\" Copyright (c) 1991 Keith Muller. .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -118,7 +118,7 @@ can be expanded to input relative or .Em <space>s can contracted to output relative -.Em <tab>s. +.Em <tab>s . The .Nm pr utility also interprets @@ -137,7 +137,6 @@ diagnostic messages are suppressed until the .Nm pr utility has completed processing. .Sh OPTIONS -.Pp In the following option descriptions, .Em column , .Em lines , @@ -294,7 +293,7 @@ Line numbers longer than .Ar width columns are truncated. .It Fl o Ar offset -Each line of output is preceeded by +Each line of output is preceded by .Ar offset .Em <spaces>s . If the @@ -360,7 +359,6 @@ and require that both arguments, if present, not be separated from the option letter. .Sh ERRORS -.Pp If .Nm pr receives an interrupt while printing to a terminal, it @@ -375,7 +373,6 @@ Error messages are written to standard error during the printing process (if output is redirected) or after all successful file printing is complete (when printing to a terminal). .Sh NOTES -.Pp The interpretation of .Em <form-feed>s in the input stream is that they are special @@ -387,7 +384,6 @@ common convention of placing a on a line by itself is actually interpreted as a blank line, page break, blank line. .Sh RESTRICTIONS -.Pp The .Nm pr utility is intended to paginate input containing basic diff --git a/usr.bin/printenv/printenv.1 b/usr.bin/printenv/printenv.1 index 44bf82a0fec..f83f1e43fe4 100644 --- a/usr.bin/printenv/printenv.1 +++ b/usr.bin/printenv/printenv.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: printenv.1,v 1.2 1996/06/26 05:37:56 deraadt Exp $ +.\" $OpenBSD: printenv.1,v 1.3 1998/09/27 16:57:50 aaron Exp $ .\" Copyright (c) 1980, 1990 The Regents of the University of California. .\" All rights reserved. .\" @@ -44,7 +44,7 @@ .Nm printenv .Op Ar name .Sh DESCRIPTION -.Nm Printenv +.Nm printenv prints out the names and values of the variables in the environment, with one name/value pair per line. If .Ar name diff --git a/usr.bin/printf/printf.1 b/usr.bin/printf/printf.1 index 56db39d0bb0..0779c2d03e2 100644 --- a/usr.bin/printf/printf.1 +++ b/usr.bin/printf/printf.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: printf.1,v 1.4 1998/08/25 13:35:52 deraadt Exp $ +.\" $OpenBSD: printf.1,v 1.5 1998/09/27 16:57:50 aaron Exp $ .\" Copyright (c) 1989, 1990 The Regents of the University of California. .\" All rights reserved. .\" @@ -46,7 +46,7 @@ .Ar format .Op Ar arguments ... .Sh DESCRIPTION -.Nm Printf +.Nm printf formats and prints its arguments, after the first, under control of the .Ar format . @@ -129,7 +129,7 @@ For .Cm c , .Cm d , and -.Cm s , +.Cm s formats, this option has no effect. For the .Cm o formats the precision of the number is increased to force the first @@ -145,7 +145,7 @@ prepended to it. For .Cm f , .Cm g , and -.Cm G , +.Cm G formats, the result will always contain a decimal point, even if no digits follow the point (normally, a decimal point only appears in the results of those formats if a digit follows the decimal point). For @@ -153,20 +153,20 @@ results of those formats if a digit follows the decimal point). For and .Cm G formats, trailing zeros are not removed from the result as they -would otherwise be; +would otherwise be. .It Cm \&\- A minus sign `\-' which specifies .Em left adjustment -of the output in the indicated field; +of the output in the indicated field. .It Cm \&+ A `+' character specifying that there should always be a sign placed before the number when using signed formats. .It Sq \&\ \& A space specifying that a blank should be left before a positive number -for a signed format. A `+' overrides a space if both are used; +for a signed format. A `+' overrides a space if both are used. .It Cm \&0 A zero `0' character indicating that zero-padding should be used -rather than blank-padding. A `\-' overrides a `0' if both are used; +rather than blank-padding. A `\-' overrides a `0' if both are used. .El .It "Field Width:" An optional digit string specifying a @@ -174,7 +174,7 @@ An optional digit string specifying a if the output string has fewer characters than the field width it will be blank-padded on the left (or right, if the left-adjustment indicator has been given) to make up the field width (note that a leading zero -is a flag, but an embedded zero is part of a field width); +is a flag, but an embedded zero is part of a field width). .It Precision: An optional period, .Sq Cm \&.\& , @@ -187,7 +187,7 @@ and .Cm f formats, or the maximum number of characters to be printed from a string; if the digit string is missing, the precision is treated -as zero; +as zero. .It Format: A character which indicates the type of format to use (one of .Cm diouxXfEgGbcs ) . @@ -262,8 +262,8 @@ In no case does a non-existent or small field width cause truncation of a field; padding takes place only if the specified field width exceeds the actual width. .Sh RETURN VALUES -.Nm Printf -exits 0 on success, 1 on failure. +.Nm printf +exits 0 on success or 1 on failure. .Sh SEE ALSO .Xr echo 1 , .Xr printf 3 diff --git a/usr.bin/quota/quota.1 b/usr.bin/quota/quota.1 index 66171337dd6..12de3ccae31 100644 --- a/usr.bin/quota/quota.1 +++ b/usr.bin/quota/quota.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: quota.1,v 1.4 1996/12/10 09:06:34 deraadt Exp $ +.\" $OpenBSD: quota.1,v 1.5 1998/09/27 16:57:50 aaron Exp $ .\" Copyright (c) 1983, 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" @@ -55,7 +55,7 @@ .Op Fl v | Fl q .Ar group .Sh DESCRIPTION -.Nm Quota +.Nm quota displays users' disk usage and limits. By default only the user quotas are printed. .Pp @@ -102,17 +102,14 @@ flag takes precedence over the .Fl v flag. .Pp -.Nm Quota +.Nm quota tries to report the quotas of all mounted filesystems. -If the filesystem is mounted via -.Nm NFS , +If the filesystem is mounted via NFS, it will attempt to contact the .Xr rpc.rquotad 8 daemon on the -.Nm NFS -server. -For -.Nm FFS +NFS server. +For FFS filesystems, quotas must be turned on in .Pa /etc/fstab . If diff --git a/usr.bin/ranlib/ranlib.1 b/usr.bin/ranlib/ranlib.1 index 90cee578559..d2e48049b3f 100644 --- a/usr.bin/ranlib/ranlib.1 +++ b/usr.bin/ranlib/ranlib.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ranlib.1,v 1.3 1998/09/06 22:23:17 aaron Exp $ +.\" $OpenBSD: ranlib.1,v 1.4 1998/09/27 16:57:50 aaron Exp $ .\" Copyright (c) 1990 Regents of the University of California. .\" All rights reserved. .\" @@ -41,9 +41,9 @@ .Sh SYNOPSIS .Nm ranlib .Op Fl t -.Ar file ... +.Ar file Op Ar ... .Sh DESCRIPTION -.Nm Ranlib +.Nm ranlib creates a table of external references for archive libraries, normally used by the loader, .Xr ld 1 . @@ -78,7 +78,7 @@ The pathname of the directory to use when creating temporary files. .Sh FILES .Bl -tag -width /tmp/ranlib.XXXXXX -compact .It Pa /tmp/ranlib.XXXXXX -Temporary file names. +temporary files .El .Sh SEE ALSO .Xr ar 1 , diff --git a/usr.bin/ranlib/ranlib.5 b/usr.bin/ranlib/ranlib.5 index 2a2d1365969..62565a18c1c 100644 --- a/usr.bin/ranlib/ranlib.5 +++ b/usr.bin/ranlib/ranlib.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ranlib.5,v 1.2 1996/06/26 05:38:05 deraadt Exp $ +.\" $OpenBSD: ranlib.5,v 1.3 1998/09/27 16:57:50 aaron Exp $ .\" Copyright (c) 1990, 1991 The Regents of the University of California. .\" All rights reserved. .\" @@ -50,7 +50,7 @@ It operates on archives created with the utility .Xr ar 1 . .Pp The -.Nm Ranlib +.Nm ranlib function prepends a new file to the archive which has three separate parts. The first part is a standard archive header, which has a special name diff --git a/usr.bin/readlink/readlink.1 b/usr.bin/readlink/readlink.1 index 5bede815c65..687b9c037eb 100644 --- a/usr.bin/readlink/readlink.1 +++ b/usr.bin/readlink/readlink.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: readlink.1,v 1.3 1997/09/23 20:13:21 niklas Exp $ +.\" $OpenBSD: readlink.1,v 1.4 1998/09/27 16:57:50 aaron Exp $ .\" .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. All rights reserved. @@ -50,10 +50,10 @@ The utility when invoked with the pathname of a symbolic link as its argument dereferences the symbolic link and prints the name of target on standard output. If readlink is invoked with an argument other -than the pathname of a symbolic link it exits with a non-zero exit -code and without printing anything. +than the pathname of a symbolic link, it exits with a non-zero exit +code without printing anything. .Pp -The following option is available: +The following options are available: .Bl -tag -width flag .It Fl f Canonicalize by following every symlink in every component of the given @@ -64,11 +64,11 @@ Do not print a trailing newline character. .Pp The .Nm readlink -utility exits 0 on success, and >0 if an error occurs. +utility exits 0 on success or >0 if an error occurred. .Sh SEE ALSO .Xr readlink 2 .Sh HISTORY The .Nm readlink utility first appeared in -.Ox 2.1 +.Ox 2.1 . diff --git a/usr.bin/renice/renice.8 b/usr.bin/renice/renice.8 index 2492975b16c..76ed2bdb778 100644 --- a/usr.bin/renice/renice.8 +++ b/usr.bin/renice/renice.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: renice.8,v 1.4 1997/08/25 17:51:03 deraadt Exp $ +.\" $OpenBSD: renice.8,v 1.5 1998/09/27 16:57:51 aaron Exp $ .\" Copyright (c) 1983, 1991 The Regents of the University of California. .\" All rights reserved. .\" @@ -54,23 +54,23 @@ .Ar user ... .Oc .Sh DESCRIPTION -.Nm Renice +.Nm renice alters the scheduling .Ar priority (an integer) of one or more running processes. The following .Ar who -parameters (pid, pgrp and user) are interpreted as process ID's, process group -ID's, or user names. -.Nm Renice Ns 'ing +parameters (pid, pgrp and user) are interpreted as process IDs, process group +IDs, or user names. +.Nm renice Ns ing a process group causes all processes in the process group to have their scheduling priority altered. -.Nm Renice Ns 'ing +.Nm renice Ns ing a user causes all processes owned by the user to have their scheduling priority altered. By default, the processes to be affected are specified by -their process ID's. +their process IDs. .Pp Options supported by .Nm renice : @@ -78,7 +78,7 @@ Options supported by .It Fl g Force .Ar who -parameters to be interpreted as process group ID's. +parameters to be interpreted as process group IDs. .It Fl u Force the .Ar who @@ -86,7 +86,7 @@ parameters to be interpreted as user names. .It Fl p Resets the .Ar who -interpretation to be (the default) process ID's. +interpretation to be (the default) process IDs. .El .Pp For example, @@ -94,7 +94,7 @@ For example, renice +1 987 -u daemon root -p 32 .Ed .Pp -would change the priority of process ID's 987 and 32, and +would change the priority of process IDs 987 and 32, and all processes owned by users daemon and root. .Pp Users other than the super-user may only alter the priority of @@ -119,14 +119,14 @@ anything negative (to make things go very fast). .Sh FILES .Bl -tag -width /etc/passwd -compact .It Pa /etc/passwd -to map user names to user ID's +to map user names to user IDs .El .Sh SEE ALSO .Xr nice 1 , .Xr getpriority 2 , .Xr setpriority 2 .Sh BUGS -Non super-users can not increase scheduling priorities of their own processes, +Non-super-users cannot increase scheduling priorities of their own processes, even if they were the ones that decreased the priorities in the first place. .Sh HISTORY The diff --git a/usr.bin/rlogin/rlogin.1 b/usr.bin/rlogin/rlogin.1 index 1a418fe5863..63da1a808f0 100644 --- a/usr.bin/rlogin/rlogin.1 +++ b/usr.bin/rlogin/rlogin.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rlogin.1,v 1.3 1996/07/04 20:55:40 deraadt Exp $ +.\" $OpenBSD: rlogin.1,v 1.4 1998/09/27 16:57:51 aaron Exp $ .\" $NetBSD: rlogin.1,v 1.4 1995/08/18 15:07:35 pk Exp $ .\" .\" Copyright (c) 1983, 1990, 1993 @@ -48,13 +48,13 @@ .Op Fl l Ar username .Ar host .Sh DESCRIPTION -.Nm Rlogin +.Nm rlogin starts a terminal session on a remote host .Ar host . .Pp -.Nm Rlogin +.Nm rlogin first attempts to use the Kerberos authorization mechanism, described below. -If the remote host does not supporting Kerberos the standard Berkeley +If the remote host does not support Kerberos the standard Berkeley .Pa rhosts authorization mechanism is used. The options are as follows: @@ -89,14 +89,14 @@ The option turns on socket debugging (see .Xr setsockopt 2 ) on the TCP sockets used for communication with the remote host. -.It Fl e +.It Fl e Ar char The .Fl e option allows user specification of the escape character, which is ``~'' by default. This specification may be as a literal character, or as an octal value in the form \ennn. -.It Fl k +.It Fl k Ar realm The .Fl k option requests rlogin to obtain tickets for the remote host @@ -115,7 +115,7 @@ This may impact response time and .Tn CPU utilization, but provides increased security. -.It Fl l +.It Fl l Ar username The .Fl l option specifies a different @@ -177,15 +177,15 @@ Determines the user's terminal type. .Sh SEE ALSO .Xr rsh 1 , .Xr kerberos 3 , -.Xr krb_sendauth 3 , -.Xr krb_realmofhost 3 +.Xr krb_realmofhost 3 , +.Xr krb_sendauth 3 .Sh HISTORY The .Nm rlogin command appeared in .Bx 4.2 . .Sh BUGS -.Nm Rlogin +.Nm rlogin will be replaced by .Xr telnet 1 in the near future. diff --git a/usr.bin/rpcgen/rpcgen.1 b/usr.bin/rpcgen/rpcgen.1 index 25321165d58..475a4c81c03 100644 --- a/usr.bin/rpcgen/rpcgen.1 +++ b/usr.bin/rpcgen/rpcgen.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rpcgen.1,v 1.3 1996/06/26 05:38:42 deraadt Exp $ +.\" $OpenBSD: rpcgen.1,v 1.4 1998/09/27 16:57:51 aaron Exp $ .\" $NetBSD: rpcgen.1,v 1.5.2.1 1995/12/05 02:51:02 jtc Exp $ .\" from: @(#)rpcgen.new.1 1.1 90/11/09 TIRPC 1.0; from 40.10 of 10/10/89 .\" Copyright (c) 1988,1990 Sun Microsystems, Inc. - All Rights Reserved. @@ -114,7 +114,7 @@ When the server is self-started, it backgrounds itself by default. A special define symbol .Dv RPC_SVC_FG -can be used to run the server process in foreground. +can be used to run the server process in the foreground. .P The second synopsis provides special features which allow for the creation of more sophisticated @@ -172,40 +172,35 @@ accepts the standard input. The C preprocessor, .Xr cpp 1 is run on the input file before it is actually interpreted by -.Nm rpcgen +.Nm rpcgen . For each type of output file, .Nm rpcgen defines a special preprocessor symbol for use by the .Nm rpcgen programmer: .Pp -.PD 0 -.TP 12 -.Dv RPC_HDR -defined when compiling into header files -.TP -.Dv RPC_XDR -defined when compiling into +.Bl -tag -width RPC_CLNT -compact +.It Dv RPC_HDR +Defined when compiling into header files. +.It Dv RPC_XDR +Defined when compiling into .Tn XDR -routines -.TP -.Dv RPC_SVC -defined when compiling into server-side stubs -.TP -.Dv RPC_CLNT -defined when compiling into client-side stubs -.TP -.Dv RPC_TBL -defined when compiling into +routines. +.It Dv RPC_SVC +Defined when compiling into server-side stubs. +.It Dv RPC_CLNT +Defined when compiling into client-side stubs. +.It Dv RPC_TBL +Defined when compiling into .Tn RPC -dispatch tables -.PD +dispatch tables. +.El .Pp Any line beginning with .Sq % is passed directly into the output file, uninterpreted by -.Nm rpcgen +.Nm rpcgen . .Pp For every data type referred to in .Ar infile @@ -228,7 +223,7 @@ Generate all the files including sample code for client and server side. .It Fl b This generates code for the .Tn SunOS4.1 -style of rpc. This is the default. +style of RPC. This is the default. .It Fl c Compile into .Tn XDR @@ -297,7 +292,7 @@ routine to do initialization. .It Fl n Ar netid Compile into server-side stubs for the transport specified by -.Ar netid. +.Ar netid . There should be an entry for .Ar netid in the @@ -305,11 +300,15 @@ netconfig database. This option may be specified more than once, so as to compile a server that serves multiple transports. .It Fl N -Use the newstyle of rpcgen. This allows procedures to have multiple arguments. +Use the newstyle of +.Nm rpcgen . +This allows procedures to have multiple arguments. It also uses the style of parameter passing that closely resembles C. So, when passing an argument to a remote procedure you do not have to pass a pointer to the argument but the argument itself. This behaviour is different from the oldstyle -of rpcgen generated code. The newstyle is not the default case because of +of +.Nm rpcgen +generated code. The newstyle is not the default case because of backward compatibility. .It Fl o Ar outfile Specify the name of the output file. @@ -319,19 +318,19 @@ standard output is used .Fl c Fl h Fl l .Fl m Fl n Fl s modes only -.Pc +.Pc . .It Fl s Ar nettype Compile into server-side stubs for all the transports belonging to the class .Ar nettype . The supported classes are -.Em netpath, -.Em visible, -.Em circuit_n, -.Em circuit_v, -.Em datagram_n, -.Em datagram_v, -.Em tcp, +.Em netpath , +.Em visible , +.Em circuit_n , +.Em circuit_v , +.Em datagram_n , +.Em datagram_v , +.Em tcp , and .Em udp [see @@ -348,7 +347,8 @@ Note: the transports are chosen at run time and not at compile time. .It Fl S\&c Generate sample code to show the use of remote procedure and how to bind -to the server before calling the client side stubs generated by rpcgen. +to the server before calling the client side stubs generated by +.Nm rpcgen . .It Fl S\&s Generate skeleton code for the remote procedures on the server side. You would need to fill in the actual code for the remote procedures. @@ -398,7 +398,6 @@ option refers to the transport indicated by .Em netid and hence is very site specific. .Sh EXAMPLE -.Pp The command .Pp .Bd -literal -offset indent @@ -414,7 +413,7 @@ and .Pa prot_tbl.i . .Pp The following example sends the C data-definitions (header file) -to standard output. +to standard output: .Pp .Bd -literal -offset indent $ rpcgen -h prot.x diff --git a/usr.bin/rpcinfo/rpcinfo.8 b/usr.bin/rpcinfo/rpcinfo.8 index 14fcb5130d3..0109c4d6849 100644 --- a/usr.bin/rpcinfo/rpcinfo.8 +++ b/usr.bin/rpcinfo/rpcinfo.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rpcinfo.8,v 1.2 1996/06/26 05:38:44 deraadt Exp $ +.\" $OpenBSD: rpcinfo.8,v 1.3 1998/09/27 16:57:51 aaron Exp $ .\" from: @(#)rpcinfo.8c 2.2 88/08/03 4.0 RPCSRC; from 1.24 88/02/25 SMI .\" .Dd December 17, 1987 @@ -110,7 +110,7 @@ numbers for the specified .Ar program by calling version 0 (which is presumed not to exist; if it does exist, -.Ar rpcinfo +.Nm rpcinfo attempts to obtain this information by calling an extremely high version number instead) and attempts to call each registered version. diff --git a/usr.bin/rsh/rsh.1 b/usr.bin/rsh/rsh.1 index a7170752ff6..7bc72c83243 100644 --- a/usr.bin/rsh/rsh.1 +++ b/usr.bin/rsh/rsh.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rsh.1,v 1.3 1997/07/27 06:28:23 deraadt Exp $ +.\" $OpenBSD: rsh.1,v 1.4 1998/09/27 16:57:51 aaron Exp $ .\" Copyright (c) 1983, 1990 The Regents of the University of California. .\" All rights reserved. .\" @@ -44,15 +44,15 @@ .Op Fl k Ar realm .Op Fl l Ar username .Ar host -.Op command +.Op Ar command .Sh DESCRIPTION -.Nm Rsh +.Nm rsh executes .Ar command on .Ar host . .Pp -.Nm Rsh +.Nm rsh copies its standard input to the remote command, the standard output of the remote command to its standard output, and the standard error of the remote command to its standard error. @@ -113,8 +113,8 @@ If no is specified, you will be logged in on the remote host using .Xr rlogin 1 . .Pp -Shell metacharacters which are not quoted are interpreted on local machine, -while quoted metacharacters are interpreted on the remote machine. +Shell meta-characters which are not quoted are interpreted on local machine, +while quoted meta-characters are interpreted on the remote machine. For example, the command .Pp .Dl rsh otherhost cat remotefile >> localfile @@ -143,8 +143,8 @@ to .Sh SEE ALSO .Xr rlogin 1 , .Xr kerberos 3 , -.Xr krb_sendauth 3 , .Xr krb_realmofhost 3 , +.Xr krb_sendauth 3 , .Xr rcmd 3 .Sh HISTORY The diff --git a/usr.bin/ruptime/ruptime.1 b/usr.bin/ruptime/ruptime.1 index a9dbb4d8324..df3ee176b71 100644 --- a/usr.bin/ruptime/ruptime.1 +++ b/usr.bin/ruptime/ruptime.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ruptime.1,v 1.3 1997/03/26 00:45:46 deraadt Exp $ +.\" $OpenBSD: ruptime.1,v 1.4 1998/09/27 16:57:51 aaron Exp $ .\" Copyright (c) 1983, 1990 The Regents of the University of California. .\" All rights reserved. .\" @@ -42,7 +42,7 @@ .Nm ruptime .Op Fl alrtu .Sh DESCRIPTION -.Nm Ruptime +.Nm ruptime gives a status line like .Ar uptime for each machine on the local network; these are formed from packets @@ -79,6 +79,6 @@ data files .Xr uptime 1 , .Xr rwhod 8 .Sh HISTORY -.Nm Ruptime +.Nm ruptime appeared in .Bx 4.2 . diff --git a/usr.bin/rusers/rusers.1 b/usr.bin/rusers/rusers.1 index cfc561ece32..e265ae173cf 100644 --- a/usr.bin/rusers/rusers.1 +++ b/usr.bin/rusers/rusers.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rusers.1,v 1.2 1996/06/26 05:38:56 deraadt Exp $ +.\" $OpenBSD: rusers.1,v 1.3 1998/09/27 16:57:52 aaron Exp $ .\" Copyright (c) 1983, 1990 The Regents of the University of California. .\" All rights reserved. .\" @@ -46,11 +46,13 @@ The .Nm rusers command produces output similar to -.Xr who , +.Xr who 1 , but for the list of hosts or all machines on the local network. For each host responding to the rusers query, the hostname with the names of the users currently logged -on is printed on each line. The rusers command will wait for +on is printed on each line. The +.Nm rusers +command will wait for one minute to catch late responders. .Pp The following options are available: @@ -80,7 +82,7 @@ The remote host is not running the portmapper (see and cannot accommodate any RPC-based services. The host may be down. .El .Sh SEE ALSO -.Xr rwho 1 +.Xr rwho 1 , .Xr users 1 , .Xr who 1 , .Xr portmap 8 , diff --git a/usr.bin/rwho/rwho.1 b/usr.bin/rwho/rwho.1 index 096ea453a0c..7ef073f9e0b 100644 --- a/usr.bin/rwho/rwho.1 +++ b/usr.bin/rwho/rwho.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rwho.1,v 1.2 1996/06/26 05:39:00 deraadt Exp $ +.\" $OpenBSD: rwho.1,v 1.3 1998/09/27 16:57:52 aaron Exp $ .\" Copyright (c) 1983, 1990 The Regents of the University of California. .\" All rights reserved. .\" @@ -45,7 +45,7 @@ The .Nm rwho command produces output similar to -.Xr who , +.Xr who 1 , but for all machines on the local network. If no report has been received from a machine for 11 minutes then @@ -53,7 +53,7 @@ received from a machine for 11 minutes then assumes the machine is down, and does not report users last known to be logged into that machine. .Pp -If a users hasn't typed to the system for a minute or more, then +If a user hasn't typed to the system for a minute or more, then .Nm rwho reports this idle time. If a user hasn't typed to the system for an hour or more, then diff --git a/usr.bin/script/script.1 b/usr.bin/script/script.1 index 791a210bf29..f9c52cc8498 100644 --- a/usr.bin/script/script.1 +++ b/usr.bin/script/script.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: script.1,v 1.2 1996/06/26 05:39:02 deraadt Exp $ +.\" $OpenBSD: script.1,v 1.3 1998/09/27 16:57:52 aaron Exp $ .\" $NetBSD: script.1,v 1.3 1994/12/21 08:55:41 jtc Exp $ .\" .\" Copyright (c) 1980, 1990, 1993 @@ -45,7 +45,7 @@ .Op Fl a .Op Ar file .Sh DESCRIPTION -.Nm Script +.Nm script makes a typescript of everything printed on your terminal. It is useful for students who need a hardcopy record of an interactive session as proof of an assignment, as the typescript file @@ -90,7 +90,7 @@ C-shell, Certain interactive commands, such as .Xr vi 1 , create garbage in the typescript file. -.Nm Script +.Nm script works best with commands that do not manipulate the screen, the results are meant to emulate a hardcopy terminal. @@ -106,21 +106,21 @@ exists, the shell forked by will be that shell. If .Ev SHELL is not set, the Bourne shell -is assumed. (Most shells set this variable automatically). +is assumed. (Most shells set this variable automatically.) .El .Sh SEE ALSO .Xr csh 1 (for the .Em history -mechanism). +mechanism) .Sh HISTORY The .Nm script command appeared in .Bx 3.0 . .Sh BUGS -.Nm Script +.Nm script places -.Sy everything +.Em everything in the log file, including linefeeds and backspaces. This is not what the naive user expects. diff --git a/usr.bin/sed/sed.1 b/usr.bin/sed/sed.1 index 3340e904955..e2b2e956063 100644 --- a/usr.bin/sed/sed.1 +++ b/usr.bin/sed/sed.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sed.1,v 1.4 1997/05/30 07:49:28 deraadt Exp $ +.\" $OpenBSD: sed.1,v 1.5 1998/09/27 16:57:52 aaron Exp $ .\" Copyright (c) 1992, 1993 .\" The Regents of the University of California. All rights reserved. .\" @@ -495,7 +495,7 @@ option on the command line. .Pp The .Nm sed -utility exits 0 on success and >0 if an error occurs. +utility exits 0 on success or >0 if an error occurred. .Sh SEE ALSO .Xr awk 1 , .Xr ed 1 , diff --git a/usr.bin/shar/shar.1 b/usr.bin/shar/shar.1 index edcec27b5c8..d5f457cc4fa 100644 --- a/usr.bin/shar/shar.1 +++ b/usr.bin/shar/shar.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: shar.1,v 1.2 1996/06/26 05:39:13 deraadt Exp $ +.\" $OpenBSD: shar.1,v 1.3 1998/09/27 16:57:52 aaron Exp $ .\" $NetBSD: shar.1,v 1.4 1995/08/18 14:55:40 pk Exp $ .\" .\" Copyright (c) 1990, 1993 @@ -41,9 +41,9 @@ .Nm shar .Nd create a shell archive of files .Sh SYNOPSIS -.Nm shar Ar +.Nm shar Ar file Op Ar ... .Sh DESCRIPTION -.Nm Shar +.Nm shar writes an .Xr sh 1 shell script to the standard output which will recreate the file @@ -53,7 +53,7 @@ files they contain (the .Xr find 1 utility does this correctly). .Pp -.Nm Shar +.Nm shar is normally used for distributing files by .Xr ftp 1 or @@ -61,10 +61,10 @@ or .Sh SEE ALSO .Xr compress 1 , .Xr mail 1 , -.Xr uuencode 1 , -.Xr tar 1 +.Xr tar 1 , +.Xr uuencode 1 .Sh BUGS -.Nm Shar +.Nm shar makes no provisions for special types of files or files containing magic characters. .Pp @@ -101,5 +101,5 @@ sh archive .Sh HISTORY The .Nm -command appears in +command appeared in .Bx 4.4 . diff --git a/usr.bin/showmount/showmount.8 b/usr.bin/showmount/showmount.8 index e4e8a276083..99e59710f7e 100644 --- a/usr.bin/showmount/showmount.8 +++ b/usr.bin/showmount/showmount.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: showmount.8,v 1.4 1998/06/15 17:56:07 mickey Exp $ +.\" $OpenBSD: showmount.8,v 1.5 1998/09/27 16:57:52 aaron Exp $ .\" $NetBSD: showmount.8,v 1.5 1995/08/31 22:26:07 jtc Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 @@ -42,13 +42,13 @@ .Os BSD 4 .Sh NAME .Nm showmount -.Nd show remote nfs mounts on host +.Nd show remote NFS mounts on host .Sh SYNOPSIS .Nm showmount .Op Fl ade3 .Op Ar host .Sh DESCRIPTION -.Nm Showmount +.Nm showmount shows status information about the .Tn NFS server on @@ -68,14 +68,14 @@ for a detailed description of the protocol. .It Fl a List all mount points in the form: .Bd -ragged -offset indent -compact -.Ar host : Ns Ar dirpath +.Ar host : Ns Ar dirpath . .Ed .It Fl d -List directory paths of mount points instead of hosts +List directory paths of mount points instead of hosts. .It Fl e Show the .Ar host Ns 's -exports list +exports list. .It Fl 3 Use mount protocol Version 3, compatible with NFS Version 3. .El @@ -87,7 +87,7 @@ The mount daemon running on the server only has an idea of the actual mounts, since the .Tn NFS server is stateless. -.Nm Showmount +.Nm showmount will only display the information as accurately as the mount daemon reports it. .Sh HISTORY diff --git a/usr.bin/size/size.1 b/usr.bin/size/size.1 index 2db69a3f0d9..fa17fa21247 100644 --- a/usr.bin/size/size.1 +++ b/usr.bin/size/size.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: size.1,v 1.4 1997/01/28 07:12:25 deraadt Exp $ +.\" $OpenBSD: size.1,v 1.5 1998/09/27 16:57:53 aaron Exp $ .\" $NetBSD: size.1,v 1.6 1996/01/14 23:07:11 pk Exp $ .\" .\" Copyright (c) 1990, 1993, 1994 @@ -44,9 +44,9 @@ .Nm size .Op Fl t .Op Fl w -.Ar +.Ar file Op Ar ... .Sh DESCRIPTION -.Nm Size +.Nm size displays the text, data and bss segment sizes of the specified .Ar file(s) in bytes (in decimal), and the sum of the three segments (in diff --git a/usr.bin/skey/skey.1 b/usr.bin/skey/skey.1 index e838f18d13c..04b050d391f 100644 --- a/usr.bin/skey/skey.1 +++ b/usr.bin/skey/skey.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: skey.1,v 1.11 1998/08/17 17:41:50 deraadt Exp $ +.\" $OpenBSD: skey.1,v 1.12 1998/09/27 16:57:53 aaron Exp $ .\" @(#)skey.1 1.1 10/28/93 .\" .Dd 28 October 1993 @@ -16,7 +16,7 @@ <sequence#>[/] key .Sh DESCRIPTION .Nm S/key -is a procedure for using one time passwords to authenticate access to +is a procedure for using one-time passwords to authenticate access to computer systems. It uses 64 bits of information transformed by the MD4, MD5, or SHA1 algorithms. The user supplies the 64 bits in the form of 6 English words that are generated by a secure computer. This @@ -49,14 +49,14 @@ prints them capitalized. .It Fl n Ar count Prints out .Ar count -one time passwords. The default is to print one. +one-time passwords. The default is to print one. .It Fl p Ar password Uses .Ar password as the secret password. Use of this option is discouraged as your secret password could be visible in a process listing. .It Fl x -causes output to be in hexidecimal instead of ASCII. +Causes output to be in hexadecimal instead of ASCII. .It Fl md4 Selects MD4 as the hash algorithm. .It Fl md5 @@ -76,9 +76,10 @@ Selects RMD-160 (160 bit Ripe Message Digest) as the hash algorithm. .sp 0 % .Sh SEE ALSO -.Xr skeyinit 1 , .Xr skeyinfo 1 , -.Xr login 1 , +.Xr skeyinit 1 , +.Xr login 1 +.Pp .Em RFC1938 .Sh TRADEMARKS AND PATENTS S/Key is a Trademark of Bellcore. diff --git a/usr.bin/skey/skeyprune.8 b/usr.bin/skey/skeyprune.8 index 4631a7179e2..b1c4c48350d 100644 --- a/usr.bin/skey/skeyprune.8 +++ b/usr.bin/skey/skeyprune.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: skeyprune.8,v 1.2 1997/09/22 05:15:05 millert Exp $ +.\" $OpenBSD: skeyprune.8,v 1.3 1998/09/27 16:57:53 aaron Exp $ .\" .\" .Dd 27 Sep 1996 @@ -14,7 +14,7 @@ .Nm skeyprune searches through the file .Dq Pa /etc/skeykeys -and prunes out users who have zeroed they entries via +and prunes out users who have zeroed their entries via .Xr skeyinit 1 as well as entries that have not been modified in .Ar days @@ -24,11 +24,11 @@ is not specified only commented out entries are pruned. .Sh FILES .Bl -tag -width /etc/skeykeys -compact .It Pa /etc/skeykeys -The S/Key key information database +S/Key key information database .El .Sh SEE ALSO -.Xr skeyinit 1 , -.Xr skey 1 +.Xr skey 1 , +.Xr skeyinit 1 .Sh BUGS Since .Nm skeyprune diff --git a/usr.bin/skeyaudit/skeyaudit.1 b/usr.bin/skeyaudit/skeyaudit.1 index 569d28033be..8b4b26ec622 100644 --- a/usr.bin/skeyaudit/skeyaudit.1 +++ b/usr.bin/skeyaudit/skeyaudit.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: skeyaudit.1,v 1.2 1997/07/24 03:43:58 millert Exp $ +.\" $OpenBSD: skeyaudit.1,v 1.3 1998/09/27 16:57:53 aaron Exp $ .\" .\" .Dd 22 July 1997 @@ -39,8 +39,8 @@ than 12 keys left. .Sh FILES .Bl -tag -width /etc/skeykeys -compact .It Pa /etc/skeykeys -The S/Key key information database +S/Key key information database .El .Sh SEE ALSO -.Xr skeyinit 1 , -.Xr skey 1 +.Xr skey 1 , +.Xr skeyinit 1 diff --git a/usr.bin/skeyinfo/skeyinfo.1 b/usr.bin/skeyinfo/skeyinfo.1 index ebb516f8d64..f7f60bf1db7 100644 --- a/usr.bin/skeyinfo/skeyinfo.1 +++ b/usr.bin/skeyinfo/skeyinfo.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: skeyinfo.1,v 1.1 1997/07/23 04:10:53 millert Exp $ +.\" $OpenBSD: skeyinfo.1,v 1.2 1998/09/27 16:57:53 aaron Exp $ .\" .Dd 22 July 1997 .Dt SKEYINFO 1 @@ -22,5 +22,5 @@ flag is given, the hash algorithm is printed as well. This would print out a list of S/Key passwords for use over an untrusted network (perhaps for use at a conference). .Sh SEE ALSO -.Xr skeyinit 1 , -.Xr skey 1 +.Xr skey 1 , +.Xr skeyinit 1 diff --git a/usr.bin/skeyinit/skeyinit.1 b/usr.bin/skeyinit/skeyinit.1 index 97f88bd2ed6..6b9427dc40f 100644 --- a/usr.bin/skeyinit/skeyinit.1 +++ b/usr.bin/skeyinit/skeyinit.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: skeyinit.1,v 1.11 1998/02/24 20:52:46 millert Exp $ +.\" $OpenBSD: skeyinit.1,v 1.12 1998/09/27 16:57:53 aaron Exp $ .\" $NetBSD: skeyinit.1,v 1.4 1995/07/07 22:24:09 jtc Exp $ .\" @(#)skeyinit.1 1.1 10/28/93 .\" @@ -42,12 +42,12 @@ S/Key challenge and allowed to proceed if it is correct. .Sh OPTIONS .Bl -tag -width XXXXXXX .It Fl x -Displays pass phrase in hexidecimal instead of ASCII. +Displays pass phrase in hexadecimal instead of ASCII. .It Fl s Set secure mode where the user is expected to have used a secure -machine to generate the first one time password. Without the +machine to generate the first one-time password. Without the .Fl s -the system will assume you are direct connected over secure +option the system will assume you are directly connected over secure communications and prompt you for your secret password. The .Fl s option also allows one to set the seed and count for complete @@ -92,7 +92,7 @@ does not exist. It must be created by the superuser in order to use .Sh FILES .Bl -tag -width /etc/skeykeys .It Pa /etc/skeykeys -data base of information for S/Key system. +database of information for S/Key system .Sh SEE ALSO .Xr skey 1 .Sh AUTHORS diff --git a/usr.bin/soelim/soelim.1 b/usr.bin/soelim/soelim.1 index ff830527b52..7cc6755124b 100644 --- a/usr.bin/soelim/soelim.1 +++ b/usr.bin/soelim/soelim.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: soelim.1,v 1.2 1996/06/26 05:39:25 deraadt Exp $ +.\" $OpenBSD: soelim.1,v 1.3 1998/09/27 16:57:53 aaron Exp $ .\" $NetBSD: soelim.1,v 1.3 1994/12/21 08:11:24 jtc Exp $ .\" .\" Copyright (c) 1980, 1990, 1993 @@ -44,7 +44,7 @@ .Nm soelim .Op Ar file ... .Sh DESCRIPTION -.Nm Soelim +.Nm soelim reads the specified files or the standard input and performs the textual inclusion implied by the .Xr nroff 1 diff --git a/usr.bin/sort/sort.1 b/usr.bin/sort/sort.1 index e8d64573a25..992fb59a20a 100644 --- a/usr.bin/sort/sort.1 +++ b/usr.bin/sort/sort.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sort.1,v 1.2 1998/07/24 00:32:23 deraadt Exp $ +.\" $OpenBSD: sort.1,v 1.3 1998/09/27 16:57:54 aaron Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -67,7 +67,7 @@ lexicographically. By default, if keys are not given, regards each input line as a single field. .Pp The following options are available: -.Bl -tag -width indent +.Bl -tag -width file indent .It Fl c Check that the single input file is sorted. If the file is not sorted, @@ -76,7 +76,7 @@ produces the appropriate error messages and exits with code 1; otherwise, .Nm sort returns 0. -.Nm Sort +.Nm sort .Fl c produces no output. .It Fl m @@ -151,7 +151,7 @@ Use a merge sort instead of a radix sort. This option should be used for files larger than 60Mb. .El .Pp -The treatment of field separators can be altered using the +The treatment of field separators can be altered using these options: .Bl -tag -width indent .It Fl b @@ -177,7 +177,7 @@ Note that the option has no effect unless key fields are specified. .It Fl t Ar char -.Ar Char +.Ar char is used as the field separator character. The initial .Ar char is not considered to be part of a field when determining @@ -193,7 +193,7 @@ is not specified, blank space characters are used as default field separators. .It Fl R Ar char -.Ar Char +.Ar char is used as the record separator character. This should be used with discretion; .Fl R Ar <alphanumeric> @@ -215,13 +215,17 @@ and .Pp The following operands are available: .Bl -tag -width indent -.Ar file +.It Ar file The pathname of a file to be sorted, merged, or checked. -If no file +If no +.Ar file operands are specified, or if -a file operand is +a +.Ar file +operand is .Fl , the standard input is used. +.El .Pp A field is defined as a minimal sequence of characters followed by a @@ -268,7 +272,7 @@ means indicating the first character of the .Em m Ns th field; -If the +if the .Fl b option is in effect, .Em n @@ -316,20 +320,17 @@ The obsolescent .Cm \(pl Ns Ar pos1 .Fl Ns Ar pos2 option is still supported, except for -.Fl Ns Ar w\&.0b, +.Fl Ns Ar w\&.0b , which has no .Fl k equivalent. .Sh ENVIRONMENT If the following environment variable exists, it is utilized by -.Nm sort . +.Nm sort : .Bl -tag -width Fl .It Ev TMPDIR -.Nm Sort -uses the contents of the -.Ev TMPDIR -environment variable as the path in which to store -temporary files. Note that +Path in which to store temporary files. +Note that .Ev TMPDIR may be overridden by the .Fl T @@ -337,29 +338,31 @@ option. .Sh FILES .Bl -tag -width Pa -compact .It Pa /var/tmp/sort.* -Default temporary directories. +default temporary directories .It Pa Ar output Ns #PID -Temporary name for +temporary name for .Ar output if .Ar output -already exists. +already exists .El .Sh SEE ALSO .Xr comm 1 , -.Xr uniq 1 , -.Xr join 1 +.Xr join 1 , +.Xr uniq 1 .Sh RETURN VALUES -Sort exits with one of the following values: +.Nm sort +exits with one of the following values: +.Pp .Bl -tag -width flag -compact -.It Pa 0: -normal behavior. -.It Pa 1: -on disorder (or non-uniqueness) with the +.It 0 +Normal behavior. +.It 1 +On disorder (or non-uniqueness) with the .Fl c -option -.It Pa 2: -an error occurred. +option. +.It 2 +An error occurred. .Sh BUGS Lines longer than 65522 characters are discarded and processing continues. To sort files larger than 60Mb, use @@ -378,7 +381,7 @@ command appeared in .Sh NOTES The current sort command uses lexicographic radix sorting, which requires that sort keys be kept in memory (as opposed to previous versions which used quick -and merge sorts and did not.) +and merge sorts and did not). Thus performance depends highly on efficient choice of sort keys, and the .Fl b option and the diff --git a/usr.bin/strings/strings.1 b/usr.bin/strings/strings.1 index d225e1eb50b..3a956ea3516 100644 --- a/usr.bin/strings/strings.1 +++ b/usr.bin/strings/strings.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: strings.1,v 1.2 1996/06/26 05:39:30 deraadt Exp $ +.\" $OpenBSD: strings.1,v 1.3 1998/09/27 16:57:54 aaron Exp $ .\" $NetBSD: strings.1,v 1.4 1994/12/10 11:54:28 jtc Exp $ .\" .\" Copyright (c) 1980, 1990, 1993 @@ -47,7 +47,7 @@ .Op Fl t Ar radix .Op Ar file ... .Sh DESCRIPTION -.Nm Strings +.Nm strings displays the sequences of printable characters in each of the specified files, or in the standard input, by default. By default, a sequence must be at least four characters in length @@ -67,13 +67,13 @@ to search the entire object file. .It Fl f Each string is preceded by the name of the file in which it was found. -.It Fl n +.It Fl n Ar number Specifies the minimum number of characters in a sequence to be .Ar number , instead of four. .It Fl o Each string is preceded by its octal offset in the file. -.It Fl t +.It Fl t Ar radix Each string is preceded by its offset in the file. The first character of .Ar radix determines the radix of the offset: @@ -85,7 +85,7 @@ for decimal; or for hexadecimal. .El .Pp -.Nm Strings +.Nm strings is useful for identifying random binaries, among other things. .Sh SEE ALSO .Xr hexdump 1 , diff --git a/usr.bin/strip/strip.1 b/usr.bin/strip/strip.1 index 6ecaf5ec0e1..135ba30ff2c 100644 --- a/usr.bin/strip/strip.1 +++ b/usr.bin/strip/strip.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: strip.1,v 1.2 1996/06/26 05:39:32 deraadt Exp $ +.\" $OpenBSD: strip.1,v 1.3 1998/09/27 16:57:54 aaron Exp $ .\" Copyright (c) 1989, 1990 The Regents of the University of California. .\" All rights reserved. .\" @@ -42,7 +42,7 @@ .Nm strip .Op Fl d .Op Fl x -.Ar file ... +.Ar file Op Ar ... .Sh DESCRIPTION The .Nm strip @@ -60,8 +60,8 @@ Delete only debugging and empty symbols. Delete only debugging, compiler identification, and local symbols. .El .Pp -.Nm Strip -exits 0 on success and 1 if an error occurred. +.Nm strip +exits 0 on success or 1 if an error occurred. .Sh SEE ALSO .Xr cc 1 , .Xr ld 1 , diff --git a/usr.bin/su/su.1 b/usr.bin/su/su.1 index 83fd31b2274..90b8e411202 100644 --- a/usr.bin/su/su.1 +++ b/usr.bin/su/su.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: su.1,v 1.6 1997/09/04 08:16:22 provos Exp $ +.\" $OpenBSD: su.1,v 1.7 1998/09/27 16:57:54 aaron Exp $ .\" Copyright (c) 1988, 1990 The Regents of the University of California. .\" All rights reserved. .\" @@ -43,18 +43,18 @@ .Op Fl Kflm .Op Ar login Op Ar "shell arguments" .Sh DESCRIPTION -.Nm Su +.Nm su requests the Kerberos password for .Ar login (or for .Dq Ar login Ns .root , if no login is provided), and switches to -that user and group ID after obtaining a Kerberos ticket granting ticket. +that user and group ID after obtaining a Kerberos ticket granting access. A shell is then executed, and any additional .Ar "shell arguments" after the login name are passed to the shell. -.Nm Su +.Nm su will resort to the local password file to find the password for .Ar login if there is a Kerberos error or if Kerberos is not installed. @@ -130,7 +130,7 @@ The invoked shell is your login shell, and no directory changes are made. As a security precaution, if the target user's shell is a non-standard shell (as defined by .Xr getusershell 3 ) -and the caller's real uid is +and the caller's real UID is non-zero, .Nm su will fail. @@ -196,13 +196,13 @@ Pretend a login for user .El .Sh SEE ALSO .Xr csh 1 , +.Xr kerberos 1 , +.Xr kinit 1 , .Xr login 1 , .Xr sh 1 , .Xr skey 1 , -.Xr kinit 1 , -.Xr kerberos 1 , -.Xr passwd 5 , .Xr group 5 , +.Xr passwd 5 , .Xr environ 7 .Sh ENVIRONMENT Environment variables used by diff --git a/usr.bin/systat/systat.1 b/usr.bin/systat/systat.1 index b7c0a8ae4eb..dc3ed05376e 100644 --- a/usr.bin/systat/systat.1 +++ b/usr.bin/systat/systat.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: systat.1,v 1.7 1998/09/01 16:38:25 deraadt Exp $ +.\" $OpenBSD: systat.1,v 1.8 1998/09/27 16:57:54 aaron Exp $ .\" $NetBSD: systat.1,v 1.6 1996/05/10 23:16:39 thorpej Exp $ .\" .\" Copyright (c) 1985, 1990, 1993 @@ -48,7 +48,7 @@ .Op Ar display .Op Ar refresh-interval .Sh DESCRIPTION -.Nm Systat +.Nm systat displays various system statistics in a screen oriented fashion using the curses screen display library, .Xr curses 3 . @@ -86,7 +86,7 @@ Command line options: Extract values associated with the name list from .Ar core instead of the default -.Pa /dev/mem . +.Pa /dev/kmem . .It Fl N Ar system Extract the name list from .Ar system @@ -180,7 +180,7 @@ on disk throughput show, for each drive, kilobytes of data transferred, number of disk transactions performed, and time spent in disk accesses (in milliseconds). This information may be displayed as bar graphs or as rows of numbers which scroll downward. Bar -graphs are shown by default; +graphs are shown by default. .Pp The following commands are specific to the .Ic iostat @@ -209,9 +209,9 @@ The .Ar Used column indicates the total blocks used so far; the graph shows the percentage of space in use on each partition. -If there are more than one swap partition in use, +If there is more than one swap partition in use, a total line is also shown. -Areas known to the kernel, but not in use are shown as not available. +Areas known to the kernel but not in use are shown as not available. .It Ic mbufs Display, in the lower window, the number of mbufs allocated for particular uses, i.e. data, socket structures, etc. @@ -223,21 +223,21 @@ device interrupts, system name translation cacheing, disk etc. .Pp The upper left quadrant of the screen shows the number -of users logged in and the load average over the last one, five, -and fifteen minute intervals. +of users logged in and the load average over the last 1, 5, +and 15 minute intervals. Below this line are statistics on memory utilization. The first row of the table reports memory usage only among -active processes, that is processes that have run in the previous +active processes, that is, processes that have run in the previous twenty seconds. The second row reports on memory usage of all processes. The first column reports on the number of physical pages claimed by processes. The second column reports the number of physical pages that -are devoted to read only text pages. +are devoted to read-only text pages. The third and fourth columns report the same two figures for -virtual pages, that is the number of pages that would be +virtual pages, that is, the number of pages that would be needed if all processes had all of their pages. -Finally the last column shows the number of physical pages +Finally, the last column shows the number of physical pages on the free list. .Pp Below the memory display is a list of the average number of processes @@ -276,8 +276,8 @@ The third and fourth columns report the average number of pages brought in and out per second over the last refresh interval due to swap requests initiated by the scheduler. The first row of the display shows the average -number of disk transfers per second over the last refresh interval; -the second row of the display shows the average +number of disk transfers per second over the last refresh interval. +The second row of the display shows the average number of pages transferred per second over the last refresh interval. .Pp Running down the right hand side of the display is a breakdown @@ -380,7 +380,7 @@ spaces. Display information about the connections associated with the specified hosts or ports. As for .Ar ignore , -.Op Ar items +.Ar items may be names or numbers. .It Cm show Op Ar ports\&|hosts Show, on the command line, the currently selected protocols, @@ -425,17 +425,17 @@ may be specified, separated by spaces. .Sh FILES .Bl -tag -width /etc/networks -compact .It Pa /bsd -For the namelist. +for the namelist .It Pa /dev/kmem -For information in main memory. +for information in main memory .It Pa /dev/drum -For information about swapped out processes. +for information about swapped out processes .It Pa /etc/hosts -For host names. +or host names .It Pa /etc/networks -For network names. +for network names .It Pa /etc/services -For port names. +or port names .El .Sh HISTORY The |