diff options
-rw-r--r-- | usr.sbin/pwd_mkdb/pwd_mkdb.8 | 48 | ||||
-rw-r--r-- | usr.sbin/quot/quot.8 | 10 | ||||
-rw-r--r-- | usr.sbin/quotaon/quotaon.8 | 22 | ||||
-rw-r--r-- | usr.sbin/rarpd/rarpd.8 | 32 | ||||
-rw-r--r-- | usr.sbin/rbootd/rbootd.8 | 39 | ||||
-rw-r--r-- | usr.sbin/rdate/rdate.8 | 15 | ||||
-rw-r--r-- | usr.sbin/repquota/repquota.8 | 15 | ||||
-rw-r--r-- | usr.sbin/rmt/rmt.8 | 27 |
8 files changed, 112 insertions, 96 deletions
diff --git a/usr.sbin/pwd_mkdb/pwd_mkdb.8 b/usr.sbin/pwd_mkdb/pwd_mkdb.8 index 8615ded314c..d4570a40f5c 100644 --- a/usr.sbin/pwd_mkdb/pwd_mkdb.8 +++ b/usr.sbin/pwd_mkdb/pwd_mkdb.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pwd_mkdb.8,v 1.4 1998/06/03 06:44:25 deraadt Exp $ +.\" $OpenBSD: pwd_mkdb.8,v 1.5 1999/03/11 19:39:40 aaron Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -40,23 +40,23 @@ .Nm pwd_mkdb .Nd "generate the password databases" .Sh SYNOPSIS -.Nm pwd_mkdb +.Nm .Op Fl c .Op Fl p .Op Fl d Ar directory .Ar file .Sh DESCRIPTION -.Nm Pwd_mkdb +.Nm creates .Xr db 3 style secure and insecure databases for the specified file. These databases are then installed into -.Dq Pa /etc/spwd.db +.Pa /etc/spwd.db and -.Dq Pa /etc/pwd.db +.Pa /etc/pwd.db , respectively. The file is installed into -.Dq Pa /etc/master.passwd . +.Pa /etc/master.passwd . The file must be in the correct format (see .Xr passwd 5 ) . It is important to note that the format used in this system is @@ -69,10 +69,10 @@ Check if the password file is in the correct format. Do not change, add, or remove any files. .It Fl p Create a Version 7 style password file and install it into -.Dq Pa /etc/passwd . -.It Fl d +.Pa /etc/passwd . +.It Fl d Ar directory Operate in a base directory other than the default of -.Dq Pa /etc . +.Pa /etc . .It Ar file The absolute path to a file in .Ar master.passwd @@ -81,48 +81,49 @@ format, as described in .El .Pp The two databases differ in that the secure version contains the user's -encrypted password and the insecure version has an asterisk (``*'') +encrypted password and the insecure version has an asterisk +.Pq Sq \&* . .Pp The databases are used by the C library password routines (see .Xr getpwent 3 ) . .Pp -.Nm Pwd_mkdb +.Nm exits zero on success, non-zero on failure. .Sh FILES -.Bl -tag -width Pa -compact +.Bl -tag -width /etc/master.passwd -compact .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 .It Pa /etc/pwd.db -The insecure password database file. +insecure password database file .It Pa /etc/pwd.db.tmp -A temporary file. +temporary file .It Pa /etc/spwd.db -The secure password database file. +secure password database file .It Pa /etc/spwd.db.tmp -A temporary file. +temporary file .El .Sh BUGS Because of the necessity for atomic update of the password files, -.Nm pwd_mkdb +.Nm uses .Xr rename 2 to install them. This, however, requires that the file specified on the command line live on the same file system as the -.Dq Pa /etc +.Pa /etc directory. .Pp There are the obvious races with multiple people running -.Nm pwd_mkdb +.Nm on different password files at the same time. The front-ends to .Nm pwd_mkdb , .Xr chpass 1 , -.Xr passwd 1 +.Xr passwd 1 , and -.Xr vipw 8 , +.Xr vipw 8 handle the locking necessary to avoid this problem. .Sh COMPATIBILITY Previous versions of the system had a program similar to @@ -141,3 +142,4 @@ not be surprised by the changes in functionality. .Xr getpwent 3 , .Xr passwd 5 , .Xr vipw 8 + diff --git a/usr.sbin/quot/quot.8 b/usr.sbin/quot/quot.8 index 10a405205f0..b6ac2d306ec 100644 --- a/usr.sbin/quot/quot.8 +++ b/usr.sbin/quot/quot.8 @@ -27,7 +27,7 @@ .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" $Id: quot.8,v 1.4 1998/06/08 17:28:35 deraadt Exp $ +.\" $Id: quot.8,v 1.5 1999/03/11 19:39:42 aaron Exp $ .\" .Dd February 8, 1994 .Dt QUOT 8 @@ -36,14 +36,14 @@ .Nm quot .Nd display disk space occupied by each user .Sh SYNOPSIS -.Nm quot +.Nm .Op Fl acfhknv .Op Ar filesystem ... .Sh DESCRIPTION -.Nm Quot +.Nm is used to gather statistics about the disk usage for each local user. .Pp -The following options are available: +The options are as follows: .Bl -tag -width Ds .It Fl a Include statistics for all mounted filesystems. @@ -83,7 +83,7 @@ not accessed within 30, 60 and 90 days. If the environment variable .Ev BLOCKSIZE is set, and the -.Gl k +.Fl k option is not specified, the block counts will be displayed in units of that size block. .El diff --git a/usr.sbin/quotaon/quotaon.8 b/usr.sbin/quotaon/quotaon.8 index 110364a83fb..1658d91cb6f 100644 --- a/usr.sbin/quotaon/quotaon.8 +++ b/usr.sbin/quotaon/quotaon.8 @@ -1,3 +1,4 @@ +.\" $OpenBSD: quotaon.8,v 1.2 1999/03/11 19:39:43 aaron Exp $ .\" Copyright (c) 1983, 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" @@ -32,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)quotaon.8 8.2 (Berkeley) 12/11/93 -.\" $Id: quotaon.8,v 1.1 1995/10/18 08:48:02 deraadt Exp $ +.\" $Id: quotaon.8,v 1.2 1999/03/11 19:39:43 aaron Exp $ .\" .Dd December 11, 1993 .Dt QUOTAON 8 @@ -46,34 +47,35 @@ .Op Fl g .Op Fl u .Op Fl v -.Ar filesystem Ar ... +.Ar filesystem Op Ar ... .Nm quotaon .Op Fl g .Op Fl u .Op Fl v .Fl a +.Pp .Nm quotaoff .Op Fl g .Op Fl u .Op Fl v -.Ar filesystem Ar ... +.Ar filesystem Op Ar ... .Nm quotaoff .Op Fl g .Op Fl u .Op Fl v .Fl a .Sh DESCRIPTION -.Nm Quotaon +.Nm quotaon announces to the system that disk quotas should be enabled on one or more filesystems. -.Nm Quotaoff +.Nm quotaoff announces to the system that the specified filesystems should have any disk quotas diskquotas turned off. The filesystems specified must have entries in .Pa /etc/fstab and be mounted. -.Nm Quotaon +.Nm quotaon expects each filesystem to have quota files named .Pa quota.user and @@ -83,7 +85,7 @@ These defaults may be overridden in .Pa /etc/fstab . By default both user and group quotas are enabled. .Pp -Available options: +The options are as follows: .Bl -tag -width Ds .It Fl a If the @@ -135,6 +137,8 @@ filesystem table .Xr repquota 8 .Sh HISTORY The -.Nm -command appeared in +.Nm quotaon +and +.Nm quotaoff +commands appeared in .Bx 4.2 . diff --git a/usr.sbin/rarpd/rarpd.8 b/usr.sbin/rarpd/rarpd.8 index e79b76bcb7e..8ff4268fc81 100644 --- a/usr.sbin/rarpd/rarpd.8 +++ b/usr.sbin/rarpd/rarpd.8 @@ -17,23 +17,23 @@ .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. -.\" @(#) $Id: rarpd.8,v 1.3 1998/04/25 06:29:52 deraadt Exp $ +.\" @(#) $Id: rarpd.8,v 1.4 1999/03/11 19:39:43 aaron Exp $ .\" .Dd October 26, 1990 .Dt RARPD 8 .Sh NAME .Nm rarpd -.Nd Reverse ARP Daemon +.Nd reverse ARP daemon .Sh SYNOPSIS -.Nm rarpd +.Nm .Op Fl adfl .Op Ar interface .Sh DESCRIPTION -.Nm Rarpd +.Nm services Reverse ARP requests on the Ethernet connected to -.Ar interface. +.Ar interface . Upon receiving a request, -.Nm rarpd +.Nm maps the target hardware address to an IP address via its name, which must be present in both the .Xr ethers 5 @@ -52,17 +52,20 @@ proceed and a reply will not be sent. .\" is the target IP address. .Pp In normal operation, -.Nm rarpd +.Nm forks a copy of itself and runs in the background. Anomalies and errors are reported via .Xr syslog 3 . -.Sh OPTIONS +.Pp +The options are as follows: .Bl -tag -width indent .It Fl a Listen on all the Ethernets attached to the system. If -.Sq Fl a -is omitted, an interface must be specified. +.Fl a +is omitted, an +.Ar interface +must be specified. .It Fl d Run in debug mode, with all the output to stderr. This option implies the @@ -71,17 +74,20 @@ option. .It Fl f Run in the foreground. .It Fl l -Log all requests to syslog. +Log all requests to +.Xr syslog 3 . .El .Sh FILES -.Bl -tag -width Pa -compact +.Bl -tag -width /etc/ethers -compact .It Pa /etc/ethers +Ethernet host name data base .It Pa /etc/hosts +host name data base .\" .It Pa /tftpboot .El .Sh SEE ALSO .Xr bpf 4 , -.Xr diskless 8 , +.Xr diskless 8 .Rs .%R A Reverse Address Resolution Protocol .%N RFC 903 diff --git a/usr.sbin/rbootd/rbootd.8 b/usr.sbin/rbootd/rbootd.8 index 71e5964afb5..db1aad45a17 100644 --- a/usr.sbin/rbootd/rbootd.8 +++ b/usr.sbin/rbootd/rbootd.8 @@ -1,3 +1,4 @@ +.\" $OpenBSD: rbootd.8,v 1.3 1999/03/11 19:39:43 aaron Exp $ .\" $NetBSD: rbootd.8,v 1.3 1995/08/21 17:05:16 thorpej Exp $ .\" .\" Copyright (c) 1988, 1992 The University of Utah and the Center @@ -51,20 +52,20 @@ .Nm rbootd .Nd HP remote boot server .Sh SYNOPSIS -.Nm rbootd +.Nm .Op Fl ad .Op Fl i Ar interface -.Op config_file +.Op Ar config_file .Sh DESCRIPTION The -.Nm rbootd +.Nm utility services boot requests from Hewlett-Packard workstations over a local area network. All boot files must reside in the boot file directory; further, if a client supplies path information in its boot request, it will be silently stripped away before processing. By default, -.Nm rbootd +.Nm only responds to requests from machines listed in its configuration file. .Pp The options are as follows: @@ -74,13 +75,14 @@ Respond to boot requests from any machine. The configuration file is ignored if this option is specified. .It Fl d Run -.Nm rbootd +.Nm in debug mode. Packets sent and received are displayed to the terminal. .It Fl i Ar interface -Service boot requests on specified interface. +Service boot requests on specified +.Ar interface . If unspecified, -.Nm rbootd +.Nm searches the system interface list for the lowest numbered, configured ``up'' interface (excluding loopback). Ties are broken by choosing the earliest match. @@ -89,7 +91,7 @@ Ties are broken by choosing the earliest match. Specifying .Ar config_file on the command line causes -.Nm rbootd +.Nm to use a different configuration file from the default. .Pp The configuration file is a text file where each line describes a particular @@ -99,7 +101,7 @@ list of boot file names. An Ethernet address is specified in hexadecimal with each of its six octets separated by a colon. The boot file names come from the boot file directory. -The ethernet address and boot file(s) must be separated by white-space +The Ethernet address and boot file(s) must be separated by white-space and/or comma characters. A pound sign causes the remainder of a line to be ignored. .Pp @@ -113,13 +115,13 @@ Here is a sample configuration file: .It 8::9:1:C6:75 SYSHPBSD,SYSHPUX # jaguar (either) .El .Pp -.Nm Rbootd +.Nm logs status and error messages via .Xr syslog 3 . A startup message is always logged, and in the case of fatal errors (or deadly signals) a message is logged announcing the server's termination. In general, a non-fatal error is handled by ignoring the event that caused -it (e.g. an invalid Ethernet address in the config file causes that line +it (e.g., an invalid Ethernet address in the config file causes that line to be invalidated). .Pp The following signals have the specified effect when sent to the server @@ -136,23 +138,22 @@ Turn off debugging, do nothing if already off. .El .Sh "FILES" .Bl -tag -width /usr/libexec/rbootd -compact -.It /dev/bpf# +.It Pa /dev/bpf# packet-filter device -.It /etc/rbootd.conf +.It Pa /etc/rbootd.conf configuration file -.It /tmp/rbootd.dbg +.It Pa /tmp/rbootd.dbg debug output -.It /usr/mdec/rbootd +.It Pa /usr/mdec/rbootd directory containing boot files -.It /var/run/rbootd.pid -process id +.It Pa /var/run/rbootd.pid +process ID .El .Sh SEE ALSO .Xr kill 1 , .Xr socket 2 , .Xr signal 3 , -.Xr syslog 3 , -.Xr rmp 4 +.Xr syslog 3 .Sh BUGS If multiple servers are started on the same interface, each will receive and respond to the same boot packets. diff --git a/usr.sbin/rdate/rdate.8 b/usr.sbin/rdate/rdate.8 index 1cd02fcfeca..241905af205 100644 --- a/usr.sbin/rdate/rdate.8 +++ b/usr.sbin/rdate/rdate.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rdate.8,v 1.6 1997/07/16 01:07:37 deraadt Exp $ +.\" $OpenBSD: rdate.8,v 1.7 1999/03/11 19:39:44 aaron Exp $ .\" $NetBSD: rdate.8,v 1.4 1996/04/08 20:55:17 jtc Exp $ .\" .\" Copyright (c) 1994 Christos Zoulas @@ -36,17 +36,17 @@ .Nm rdate .Nd set the system's date from a remote host .Sh SYNOPSIS -.Nm rdate +.Nm .Op Fl psa .Ar host .Sh DESCRIPTION -.Nm Rdate +.Nm displays and sets the local date and time from the host name or address given as the argument. It uses the RFC868 protocol which is usually implemented as a built-in service of .Xr inetd 8 . .Pp -Available options: +The options are as follows: .Pp .Bl -tag -width indent .It Fl p @@ -61,8 +61,9 @@ remote time rather than just hopping. .Sh FILES .Bl -tag -width /var/log/wtmp -compact .It Pa /var/log/wtmp -A record of date resets and time changes. +record of date resets and time changes .Sh SEE ALSO -.Xr inetd 8 , .Xr adjtime 2 , -.Xr gettimeofday 2 +.Xr gettimeofday 2 , +.Xr inetd 8 + diff --git a/usr.sbin/repquota/repquota.8 b/usr.sbin/repquota/repquota.8 index a1808f9a188..169c07a3120 100644 --- a/usr.sbin/repquota/repquota.8 +++ b/usr.sbin/repquota/repquota.8 @@ -1,3 +1,4 @@ +.\" $OpenBSD: repquota.8,v 1.2 1999/03/11 19:39:44 aaron Exp $ .\" Copyright (c) 1983, 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" @@ -33,7 +34,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)repquota.8 8.1 (Berkeley) 6/6/93 -.\" $Id: repquota.8,v 1.1 1995/10/18 08:48:05 deraadt Exp $ +.\" $Id: repquota.8,v 1.2 1999/03/11 19:39:44 aaron Exp $ .\" .Dd June 6, 1993 .Dt REPQUOTA 8 @@ -46,21 +47,21 @@ .Op Fl g .Op Fl u .Op Fl v -.Ar filesystem Ar ... +.Ar filesystem Op Ar ... .Nm repquota .Op Fl g .Op Fl u .Op Fl v .Fl a .Sh DESCRIPTION -.Nm Repquota +.Nm prints a summary of the disk usage and quotas for the -specified file systems. +specified filesystem(s). .Pp -Available options: +The options are as follows: .Bl -tag -width Ds .It Fl a -Print the quotas of all the filesystems listed in +Print the quotas of all filesystems listed in .Pa /etc/fstab . .It Fl g Print only group quotas (the default is to print both @@ -69,7 +70,7 @@ group and user quotas if they exist). Print only user quotas (the default is to print both group and user quotas if they exist). .It Fl v -Print a header line before printing each filesystem quotas. +Print a header line before printing each filesystem's quota. .El .Pp For each user or group, the current diff --git a/usr.sbin/rmt/rmt.8 b/usr.sbin/rmt/rmt.8 index 14c1d0c5f18..79c989d87f3 100644 --- a/usr.sbin/rmt/rmt.8 +++ b/usr.sbin/rmt/rmt.8 @@ -1,3 +1,4 @@ +.\" $OpenBSD: rmt.8,v 1.3 1999/03/11 19:39:45 aaron Exp $ .\" Copyright (c) 1983, 1991 The Regents of the University of California. .\" All rights reserved. .\" @@ -30,7 +31,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)rmt.8 6.5 (Berkeley) 3/16/91 -.\" $Id: rmt.8,v 1.2 1997/07/01 21:17:54 deraadt Exp $ +.\" $Id: rmt.8,v 1.3 1999/03/11 19:39:45 aaron Exp $ .\" .Dd March 16, 1991 .Dt RMT 8 @@ -39,13 +40,13 @@ .Nm rmt .Nd remote magtape protocol module .Sh SYNOPSIS -.Nm rmt +.Nm .Sh DESCRIPTION -.Nm Rmt +.Nm is a program used by the remote dump and restore programs in manipulating a magnetic tape drive through an interprocess communication connection. -.Nm Rmt +.Nm is normally started up with an .Xr rexec 3 or @@ -53,7 +54,7 @@ or call. .Pp The -.Nm rmt +.Nm program accepts requests specific to the manipulation of magnetic tapes, performs the commands, then responds with a status indication. All responses are in @@ -67,7 +68,7 @@ Successful commands have responses of: .Sm on .Ed .Pp -.Ar Number +.Ar number is an .Tn ASCII representation of a decimal number. @@ -81,7 +82,7 @@ Unsuccessful commands are responded to with: .Sm on .Ed .Pp -.Ar Error-number +.Ar error-number is one of the possible error numbers described in .Xr intro 2 @@ -104,7 +105,7 @@ Open the specified .Ar device using the indicated .Ar mode . -.Ar Device +.Ar device is a full pathname and .Ar mode is an @@ -134,7 +135,7 @@ call. .It Sy W Ar count No \en .Sm on Write data onto the open device. -.Nm Rmt +.Nm reads .Ar count bytes from the connection, aborting if @@ -153,7 +154,7 @@ If .Ar count exceeds the size of the data buffer (10 kilobytes), it is truncated to the data buffer size. -.Nm rmt +.Nm then performs the requested .Xr read 2 and responds with @@ -169,7 +170,7 @@ was successful, the data read is then sent. .No \en Ar count No \en .Xc .Sm on -Perform a +Perform an .Dv MTIOCOP .Xr ioctl 2 command using the specified parameters. @@ -181,7 +182,7 @@ to place in the and .Ar mt_count fields of the structure used in the -.Xr ioctl +.Fn ioctl call. The return value is the .Ar count parameter when the operation is successful. @@ -198,7 +199,7 @@ sent (in binary). .Sm on .Pp Any other command causes -.Nm rmt +.Nm to exit. .Sh DIAGNOSTICS All responses are of the form described above. |