diff options
| author | Aaron Campbell <aaron@cvs.openbsd.org> | 1998-11-08 00:21:31 +0000 |
|---|---|---|
| committer | Aaron Campbell <aaron@cvs.openbsd.org> | 1998-11-08 00:21:31 +0000 |
| commit | 31da08892cd3349676917320548e92b7170e539f (patch) | |
| tree | 2bcc05bd61d8dc50843a9df23594a4b4501a7f54 /usr.sbin | |
| parent | 3035e250c3d7a79b3f5d0de48cc642b4d4752ad1 (diff) | |
usr.sbin/ man page repairs, a-i
Diffstat (limited to 'usr.sbin')
31 files changed, 473 insertions, 462 deletions
diff --git a/usr.sbin/ac/ac.8 b/usr.sbin/ac/ac.8 index 4395c62ff4c..8bce5241a2d 100644 --- a/usr.sbin/ac/ac.8 +++ b/usr.sbin/ac/ac.8 @@ -28,7 +28,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" $Id: ac.8,v 1.2 1996/10/08 01:21:00 michaels Exp $ +.\" $Id: ac.8,v 1.3 1998/11/08 00:21:25 aaron Exp $ .\" .Dd March 15, 1994 .Dt AC 8 @@ -52,7 +52,7 @@ times are written to it by and .Xr init 8 , respectively. -.Nm \&Ac +.Nm ac examines these records and writes the accumulated connect time for all logins to the standard output. .Pp @@ -120,7 +120,7 @@ to be charged out at a different rate than .Pp The .Nm ac -utility exits 0 on success, and >0 if a fatal error occurs. +utility exits 0 on success or >0 if a fatal error occurred. .Sh FILES .Bl -tag -width /var/log/wtmp.[0-7] -compact .It Pa /var/log/wtmp @@ -129,10 +129,10 @@ connect time accounting file rotated files .El .Sh SEE ALSO -.Xr init 8 , -.Xr sa 8 , .Xr login 1 , -.Xr utmp 5 +.Xr utmp 5 , +.Xr init 8 , +.Xr sa 8 .Sh HISTORY An .Nm ac diff --git a/usr.sbin/adduser/adduser.8 b/usr.sbin/adduser/adduser.8 index ecce3dcc033..748dfcfbcfb 100644 --- a/usr.sbin/adduser/adduser.8 +++ b/usr.sbin/adduser/adduser.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: adduser.8,v 1.4 1998/09/22 01:40:30 weingart Exp $ +.\" $OpenBSD: adduser.8,v 1.5 1998/11/08 00:21:25 aaron Exp $ .\" .\" Copyright (c) 1995-1996 Wolfram Schneider <wosch@FreeBSD.org>. Berlin. .\" All rights reserved. @@ -25,33 +25,39 @@ .\" SUCH DAMAGE. .\" .\" $From: adduser.8,v 1.12 1996/08/28 17:54:13 adam Exp $ - .Dd Jan, 9, 1995 .Dt ADDUSER 8 .Os OpenBSD .Sh NAME .Nm adduser .Nd command for adding new users - .Sh SYNOPSIS .Nm adduser - [-batch username [group[,group]...] [fullname] [password]] - [-check_only] [-config_create] [-dotdir dotdir] - [-e|-encrypt method] [-group login_group] [-h|-help] - [-home home] [-message message_file] [-noconfig] - [-shell shell] [-s|-silent|-q|-quiet] - [-uid_start uid_start] [-uid_end uid_end] - [-v|-verbose] - +.Op Fl batch Ar username No [group[,group]...] [fullname] [password] +.Op Fl check_only +.Op Fl config_create +.Op Fl dotdir Ar dotdir +.Op Fl e | encrypt_method +.Op Fl group Ar login_group +.Op Fl h | help +.Op Fl home Ar home +.Op Fl message Ar message_file +.Op Fl noconfig +.Op Fl shell Ar shell +.Op Fl s | silent | q | quiet +.Op Fl uid_start Ar uid_start +.Op Fl uid_end Ar uid_end +.Op Fl v | verbose .Sh DESCRIPTION -.Nm Adduser -is a simple program for adding new users. Adduser first performs consistency +.Nm adduser +is a simple program for adding new users. +.Nm adduser +first performs consistency checks on the passwd, group, and shell databases. It creates passwd/group -entries, a HOME-directory, dotfiles for a new user, and sends him or her a +entries, a HOME directory, dotfiles for a new user, and sends him or her a welcome message at the discretion of the person creating the account. - .Sh RESTRICTIONS -.Bl -tag -width Ds -compact +.Bl -tag -width Ds .It Sy username Login names should contain only lowercase characters or digits. They should be no longer than 8 characters (see @@ -70,29 +76,32 @@ you can define an alias in .Pa /etc/aliases . .It Sy fullname This should contain the user's firstname and surname. The -.Ql Pa \: +.Dq \&: is not permitted. .It Sy shell Only valid entries from the .Xr shells 5 -database or entries corresponding to sliplogin and pppd are permitted. +database or entries corresponding to +.Xr sliplogin 8 +and +.Xr pppd 8 +are permitted. .It Sy uid_start -This value is the start of the range where free uid values are +This value is the start of the range where free UID values are searched for. This value must be less than the value of uid_end. The default value is 1000 or as configured in the configuration file. .It Sy uid_end -This value is the end of the range where free uid values are +This value is the end of the range where free UID values are searched for. This value must be more than the value of uid_start. The default value is 32000 or as configured in the configuration file. .It Sy gid/login group -This value is generated automatically, but it can be specified at the +This value is generated automatically, but can be specified at the discretion of the person invoking the program. .It Sy password If not empty, the password is encrypted according to .Xr passwd.conf 5 . If empty, the account will be automatically disabled to prevent spurious access to it. -. .El .\" .Sh UNIQUE GROUP .\" Perhaps you're missing what *can* be done with this scheme that falls apart @@ -111,130 +120,140 @@ access to it. .\" I have been using this model for almost 10 years and found that it works .\" for most situations, and has never gotten in the way. (Rod Grimes) .Sh CONFIGURATION -Adduser follows these steps to extract its configuration +.Nm adduser +follows these steps to extract its configuration information: +.Pp .Bl -tag -width Ds -compact .It Sy 1. Read internal variables. .It Sy 2. -Read configuration file (/etc/adduser.conf) +Read configuration file +.Po Ns Pa /etc/adduser.conf +.Pc . .It Sy 3. -Parse command-line options +Parse command-line options. .El - +.Pp The adduser.conf format is explained within that file and is quite straightforward. - .Sh OPTIONS .Bl -tag -width Ds .It Sy -batch username [group[,group]...] [fullname] [password] Enter batch mode in which multiple users are specified on the command-line in a compact format. - .It Sy -check_only -Check the passwd, group, shells databases for consistency and problems +Check the passwd, group, and shells databases for consistency and problems then exit without performing any other operation. - .It Sy -create_config Create or edit default configuration information and message file before proceeding with the normal interactive adduser procedure. - .It Sy -dotdir Ar directory Copy files from .Ar directory -into the HOME-directory of new users. Files named in the fashion of -.Ql Pa dot.foo +into the HOME directory of new users. Files named in the fashion of +.Dq Pa dot.foo will be renamed to -.Ql Pa .foo . +.Dq Pa .foo . By default, all files are made writable and readable by their owner. .\" don't allow group or world to write files and allow only owner .\" to read/execute/write .rhost, .Xauthority, .kermrc, .netrc, Mail, .\" prv, iscreen, term. - .It Sy -encrypt,-e Ar method Encrypt local passwords using .Ar method of encryption as described in .Xr passwd.conf 5 . - .It Sy -group Ar login_group Specify the default login group. A value of .Ar USER means that the username is to be used as the login group. - .It Sy -help,-h,-? Print a summary of options and exit. - .It Sy -home Ar partition Specify the default home partition where all users' home directories are to be located. - .It Sy -message Ar file Send new users a welcome message from .Ar file . Specifying a value of -.Ar no +.Dq no for .Ar file causes no message to be sent to new users. - .It Sy -noconfig Do not read the default configuration file. - .It Sy -shell Ar shell Specify the default shell for new users. - .It Sy -silent,-s,-quiet,-q Causes the program to print fewer warnings, questions, and bug reports. - .It Sy -uid Ar uid -Use uid's from +Use UIDs from .Ar uid -up when automatically generating uid's. - +up when automatically generating UIDs. .It Sy -verbose,-v Causes the program to print many warnings and questions. This option is recommended for novice users. - .\" .Sh FORMAT .\" .Bl -tag -width Ds -compact .\" .Ql Pa # .\" is a comment. - .\" .P .\" .It Sy config file -.\" .Nm Adduser +.\" .Nm adduser .\" reads and writes this file. .\" See /etc/adduser.conf for more details. .\" .It Sy message file .\" Eval variables in this file. See /etc/adduser.message for more .\" details. .\" .El - .Sh EXAMPLES -.Pp $ adduser .Pp -Start adduser in interactive mode. - +Start +.Nm adduser +in interactive mode. .Pp $ adduser -batch falken guest,staff,beer 'Prof. Falken' joshua .Pp -Create user 'falken' and login group 'falken'. Invite user -falken into groups guest, staff and beer. Realname (fullname) -is 'Prof. Falken'. Password is 'joshua' (don't use such a password!). Create -the HOME directory '/home/falken' and copy all files and directories -from /usr/share/skel to /home/falken. Send user falken +Create user +.Dq falken +and +login group +.Dq falken . +Invite user +.Dq falken +into groups +.Dq guest , +.Dq staff , +and +.Dq beer . +Realname (fullname) +is +.Dq Prof. Falken . +Password is +.Dq joshua +(don't use such a password!). +Create the HOME directory +.Pa /home/falken +and copy all files and directories +from +.Pa /usr/share/skel +to +.Pa /home/falken . +Send user falken a welcome message. - .Pp $ adduser -uid_start 5000 -group guest -message no -batch vehlefanz .Pp -Create user 'vehlefanz' in login group guest. Start the free +Create user +.Dq vehlefanz +in login group +.Dq guest . +Start the free UID search at 5000. No other groups, no realname, no password. Do not send a welcome message. - .Sh FILES .Bl -tag -width /etc/master.passwdxx -compact .It Pa /etc/master.passwd @@ -252,24 +271,21 @@ skeletal login directory .It Pa /var/log/adduser logfile for adduser .El - .Sh SEE ALSO .Xr chpass 1 , .Xr finger 1 , .Xr passwd 1 , .Xr setlogin 2 , .Xr aliases 5 , +.Xr group 5 , .Xr passwd 5 , .Xr passwd.conf 5 , -.Xr group 5 , .Xr shells 5 , .Xr adduser_proc 8 , .Xr pwd_mkdb 8 , .Xr vipw 8 , .Xr yp 8 - .\" .Sh BUGS - .Sh HISTORY This .Nm diff --git a/usr.sbin/adduser/adduser_proc.8 b/usr.sbin/adduser/adduser_proc.8 index 8d3c5b82a42..0f0c727090f 100644 --- a/usr.sbin/adduser/adduser_proc.8 +++ b/usr.sbin/adduser/adduser_proc.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: adduser_proc.8,v 1.1 1996/09/28 05:58:36 downsj Exp $ +.\" $OpenBSD: adduser_proc.8,v 1.2 1998/11/08 00:21:25 aaron Exp $ .\" $NetBSD: adduser.8,v 1.4 1994/11/30 19:36:21 jtc Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -53,20 +53,20 @@ the dot .Ql \&. character, as that tends to confuse mailers. An account can be added by editing a line into the passwd file; this -must be done with the password file locked e.g. by using +must be done with the password file locked, e.g. by using .Xr chpass 1 or .Xr vipw 8 . .Pp -A new user is given a group and user id. -Login and user id's should be unique across the system, and often across +A new user is given a group and user ID. +Login and user IDs should be unique across the system, and often across a group of systems, since they are used to control file access. Typically, users working on similar projects will be put in the same groups. At the University of California, Berkeley, we have groups for system staff, faculty, graduate students, and special groups for large projects. .Pp A skeletal account for a new user -\*(lqernie\*(rq +.Dq ernie might look like: .Bd -literal ernie::25:30::0:0:Ernie Kovacs,508 Evans Hall,x7925, @@ -105,9 +105,9 @@ skeletal login directory .Xr chpass 1 , .Xr finger 1 , .Xr passwd 1 , -.Xr adduser 8 , .Xr aliases 5 , .Xr passwd 5 , +.Xr adduser 8 , .Xr pwd_mkdb 8 , .Xr vipw 8 .Sh BUGS diff --git a/usr.sbin/adduser/rmgroup.8 b/usr.sbin/adduser/rmgroup.8 index 3504586c1e1..f2a45264703 100644 --- a/usr.sbin/adduser/rmgroup.8 +++ b/usr.sbin/adduser/rmgroup.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rmgroup.8,v 1.2 1998/07/16 16:48:24 millert Exp $ +.\" $OpenBSD: rmgroup.8,v 1.3 1998/11/08 00:21:25 aaron Exp $ .\" .\" Copyright (c) 1996 Wolfram Schneider <wosch@FreeBSD.org>. Berlin. .\" All rights reserved. @@ -33,15 +33,17 @@ .Nm rmgroup .Nd delete a Unix group .Sh SYNOPSIS -.Nm +.Nm .Ar group .Sh DESCRIPTION .Nm -delete a Unix group from group database. +deletes the specified Unix +.Ar group +from group database. .Nm -do not delete the system groups wheel, daemon, kmem, sys, tty, +will not delete the system groups wheel, daemon, kmem, sys, tty, operator, bin, nogroup, nobody, -and not groups with gid 0. +or groups with gid 0. Do not delete these groups. .Sh SEE ALSO .Xr group 5 , .Xr adduser 8 , diff --git a/usr.sbin/afs/afsd/afsd.8 b/usr.sbin/afs/afsd/afsd.8 index 6fd18ed9713..23404ddc844 100644 --- a/usr.sbin/afs/afsd/afsd.8 +++ b/usr.sbin/afs/afsd/afsd.8 @@ -1,11 +1,11 @@ -.\" $OpenBSD: afsd.8,v 1.2 1998/09/15 18:29:11 art Exp $ +.\" $OpenBSD: afsd.8,v 1.3 1998/11/08 00:21:25 aaron Exp $ .\" .Dd September 5, 1998 .Dt AFSD 8 .Os .Sh NAME .Nm afsd -.Nd AFS cache manager for xfs. +.Nd AFS cache manager for xfs .Sh SYNOPSIS .Nm .Op Fl t | Fl -test @@ -33,7 +33,7 @@ .Op Fl -cache-dir= Ns Ar string .Op Fl -version .Op Fl -help -.Ar [device] +.Op Ar device .Sh DESCRIPTION .Nm afsd runs on AFS client machines. It is used to manage the file cache, fetch files @@ -43,89 +43,100 @@ automatically started when .Nm mount_afs is run. .Pp -Supported options: +Available options are as follows: .Bl -tag -width Ds .It Xo .Fl t Ns , .Fl -test .Xc -run in test mode +Run in test mode. .It Xo .Fl c Ar string Ns , .Fl -conffile= Ns Ar string .Xc -path to configuration file (default: /etc/afs/afsd.conf) +Path to configuration file +.Po default: Pa /etc/afs/afsd.conf +.Pc . .It Xo .Fl l Ar string Ns , .Fl -log= Ns Ar string .Xc -where to write log [stderr|syslog|path] (default: stderr) +Where to write log [stderr|syslog|path] (default: stderr). .It Xo .Fl -debug= Ns Ar string .Xc -what to write in the log (default: none) +What to write in the log (default: none). .It Xo .Fl d Ar string Ns , .Fl -device= Ns Ar string .Xc -the XFS device to use (default: /dev/xfs0) +The XFS device to use +.Po default: Pa /dev/xfs0 +.Pc . .It Xo .Fl -connected-mode= Ns Ar string .Xc -initial connected mode [conncted|fetch-only|disconnected] +Initial connected mode [conncted|fetch-only|disconnected]. .It Xo .Fl n Ns , .Fl -no-fork .Xc -don't fork and daemonize +Don't fork and daemonize. .It Xo .Fl r Ar string Ns , .Fl -rxkad-level= Ns Ar string .Xc -the rxkad level to use [clear|auth|crypt] (default: auth) +The rxkad level to use [clear|auth|crypt] (default: auth). .It Xo .Fl s Ar string Ns , .Fl -sysname= Ns Ar string .Xc -set the sysname of this system +Set the sysname of this system. .It Xo .Fl -root-volume= Ns Ar string .Xc -name of the root volume +Name of the root volume. .It Xo .Fl -port= Ns Ar number .Xc -port number to use +Port number to use. .It Xo .Fl z Ns , .Fl -recover .Xc -don't recover state +Don't recover state. .It Xo .Fl -cache-dir= Ns Ar string .Xc -cache directory (default: /var/spool/afs) +Cache directory +.Po default: Pa /var/spool/afs +.Pc . .It Xo .Fl -version .Xc -print version information +Print version information. .It Xo .Fl -help .Xc -print usage information +Print usage information. .El .Sh FILES -/etc/afs/afsd.conf - default configuration for afsd. -.Pp -/etc/afs/CellServDB - The "database" with all known AFS servers. -.Pp -/etc/afs/ThisCell - Our default cell (where we get the root directory). +.Bl -tag -width /etc/afs/CellServDB -compact +.It Pa /etc/afs/afsd.conf +default configuration for afsd +.It Pa /etc/afs/CellServDB +database with all known AFS servers +.It Pa /etc/afs/ThisCell +our default cell (where we get the root directory) +.It Pa /var/spool/afs +default cache directory +.El .Pp -/var/spool/afs - default cache directory. It is highly recommended that this -directory is a separate filesystem. When enough memory is available this -could be a mfs to drastically improve performance. +It is highly recommended that the default cache directory be a separate +filesystem. When enough memory is available this could be a mfs to +drastically improve performance. .Sh SEE ALSO -.Xr mount_afs 8 . +.Xr mount_afs 8 .Sh BUGS This code is still in the experimental stage and some bugs are present. If .Nm afsd diff --git a/usr.sbin/amd/amd/amd.8 b/usr.sbin/amd/amd/amd.8 index 2353e36640f..65e073f5677 100644 --- a/usr.sbin/amd/amd/amd.8 +++ b/usr.sbin/amd/amd/amd.8 @@ -36,7 +36,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)amd.8 5.10 (Berkeley) 4/19/94 -.\" $Id: amd.8,v 1.5 1998/06/15 17:56:12 mickey Exp $ +.\" $Id: amd.8,v 1.6 1998/11/08 00:21:26 aaron Exp $ .\" .Dd April, 19, 1994 .Dt AMD 8 @@ -70,14 +70,14 @@ .Oc .Ar ... .Sh DESCRIPTION -.Nm Amd +.Nm amd is a daemon that automatically mounts filesystems whenever a file or directory within that filesystem is accessed. Filesystems are automatically unmounted when they appear to be quiescent. .Pp -.Nm Amd +.Nm amd operates by attaching itself as an .Tn NFS server to each of the specified @@ -119,16 +119,18 @@ the log messages will be sent to the system log daemon by Normalize hostnames. The name referred to by ${rhost} is normalized relative to the host database before being used. The effect is to translate -aliases into ``official'' names. +aliases into +.Dq official +names. .It Fl p Print .Em PID . -Outputs the process-id of +Outputs the process ID of .Nm amd to standard output where it can be saved into a file. .It Fl r Restart existing mounts. -.Nm Amd +.Nm amd will scan the mount file table to determine which filesystems are currently mounted. Whenever one of these would have been auto-mounted, @@ -169,7 +171,7 @@ list chosen from: fatal, error, user, warn, info, map, stats, all. .It Fl D Ar option Select from a variety of debug options. Prefixing an option with the string -.Em no +.Dq no reverses the effect of that option. Options are cumulative. The most useful option is .Ar all . @@ -215,12 +217,12 @@ number of process context switches. A weird imagination is most useful to gain full advantage of all the features. .Sh SEE ALSO +.Xr hostname 1 , .Xr amq 8 , .Xr fsinfo 8 , -.Xr hostname 1 , .Xr mk-amd-map 8 , .Xr mount 8 , -.Xr umount 8 . +.Xr umount 8 .Rs .%T Amd \- The 4.4 BSD Automounter .Re diff --git a/usr.sbin/amd/amq/amq.8 b/usr.sbin/amd/amq/amq.8 index be158deb628..801879a4e2c 100644 --- a/usr.sbin/amd/amq/amq.8 +++ b/usr.sbin/amd/amq/amq.8 @@ -36,7 +36,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)amq.8 8.3 (Berkeley) 4/18/94 -.\" $Id: amq.8,v 1.1 1995/10/18 08:47:13 deraadt Exp $ +.\" $Id: amq.8,v 1.2 1998/11/08 00:21:26 aaron Exp $ .\" .Dd March 16, 1991 .Dt AMQ 8 @@ -56,7 +56,7 @@ .Op Ar directory .Ar ... .Sh DESCRIPTION -.Nm Amq +.Nm amq provides a simple way of determining the current state of the .Xr amd 8 program. @@ -93,7 +93,7 @@ Request the automounter to unmount the named filesystems instead of providing information about them. Unmounts are requested, not forced. They merely cause the mounted filesystem to timeout, which will be picked up by -.Xr amd Ns \'s +.Nm amd Ns \'s main scheduler thus causing the normal timeout action to be taken. .It Fl v Request the automounter to provide version information. This is a subset @@ -109,10 +109,10 @@ trigger a mount request for it. .Bl -tag -width Ds .It Pa amq.x .Tn RPC -protocol description. +protocol description .El .Sh CAVEATS -.Nm Amq +.Nm amq uses a Sun registered .Tn RPC program number (300019 decimal) which may not @@ -125,5 +125,5 @@ database. .An Jan-Simon Pendry <jsp@doc.ic.ac.uk>, Department of Computing, Imperial College, London, UK. .\" .Sh HISTORY -.\" .Nm Amq +.\" .Nm amq .\" .At diff --git a/usr.sbin/amd/fsinfo/fsinfo.8 b/usr.sbin/amd/fsinfo/fsinfo.8 index ddf6d2a4785..63a5bd7379a 100644 --- a/usr.sbin/amd/fsinfo/fsinfo.8 +++ b/usr.sbin/amd/fsinfo/fsinfo.8 @@ -31,7 +31,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)fsinfo.8 8.1 (Berkeley) 6/28/93 -.\" $Id: fsinfo.8,v 1.2 1998/06/15 17:56:13 mickey Exp $ +.\" $Id: fsinfo.8,v 1.3 1998/11/08 00:21:26 aaron Exp $ .\" .Dd June 28, 1993 .Dt FSINFO 8 @@ -58,20 +58,20 @@ The .Nm fsinfo utility takes a set of system configuration information, and generates a co-ordinated set of -.Xr amd , -.Xr mount +.Xr amd 8 , +.Xr mount 8 and -.Xr mountd +.Xr mountd 8 configuration files. .Pp The .Nm fsinfo command is fully described in the document -.%T "Amd - The 4.4BSD Automounter" +.%T "Amd - The 4.4BSD Automounter" . .Sh "SEE ALSO" .Xr amd 8 , .Xr mount 8 , -.Xr mountd 8 . +.Xr mountd 8 .Sh HISTORY The .Nm fsinfo diff --git a/usr.sbin/apm/apm.8 b/usr.sbin/apm/apm.8 index f5627cf5d4a..472dd1255c8 100644 --- a/usr.sbin/apm/apm.8 +++ b/usr.sbin/apm/apm.8 @@ -24,7 +24,7 @@ .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.\" $Id: apm.8,v 1.4 1998/10/29 18:21:44 mickey Exp $ +.\" $Id: apm.8,v 1.5 1998/11/08 00:21:26 aaron Exp $ .\" .Dd March 18, 1996 .Dt APM 8 @@ -58,8 +58,9 @@ With no flags, .Nm displays the current power management state in verbose form. .Pp -Available command-line flags are: -.Bl -tag -width indent -compact +Available options are as follows: +.Pp +.Bl -tag -width indent .It Fl z Put the system into suspend (deep sleep) mode. .It Fl S @@ -97,17 +98,20 @@ This command does not wait for positive confirmation that the requested mode has been entered; to do so would mean the command does not return until the system resumes from its sleep state. .Sh FILES -.Pa /var/run/apmdev -is the default UNIX-domain socket used for communication with -.Xr apm 8 . +.Bl -tag -width /var/run/apmdev -compact +.It Pa /var/run/apmdev +default Unix domain socket used for communication with +.Xr apm 8 +.El +.Pp The .Fl f flag may be used to specify an alternate socket name. The protection modes on this socket govern which users may access the APM functions. .Sh SEE ALSO -.Xr apmd 8 , -.Xr apm 4 . +.Xr apm 4 , +.Xr apmd 8 .Sh REFERENCES Advanced Power Management (APM) BIOS Interface Specification (revision 1.1), Intel Corporation and Microsoft Corporation diff --git a/usr.sbin/apmd/apmd.8 b/usr.sbin/apmd/apmd.8 index 2cf423ec3a9..fc3444dfed2 100644 --- a/usr.sbin/apmd/apmd.8 +++ b/usr.sbin/apmd/apmd.8 @@ -24,7 +24,7 @@ .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.\" $Id: apmd.8,v 1.5 1998/07/21 04:06:29 marc Exp $ +.\" $Id: apmd.8,v 1.6 1998/11/08 00:21:26 aaron Exp $ .\" .Dd March 24, 1996 .Dt APMD 8 @@ -188,7 +188,7 @@ flag may be used to specify an alternate device file name. .Xr apm 4 , .Xr speaker 4 , .Xr apm 8 , -.Xr syslogd 8 . +.Xr syslogd 8 .Sh REFERENCES Advanced Power Management (APM) BIOS Interface Specification (revision 1.1), Intel Corporation and Microsoft Corporation. diff --git a/usr.sbin/arp/arp.4 b/usr.sbin/arp/arp.4 index acdad70294c..d98fb47e222 100644 --- a/usr.sbin/arp/arp.4 +++ b/usr.sbin/arp/arp.4 @@ -42,9 +42,9 @@ .Sh SYNOPSIS .Em "pseudo-device ether" .Sh DESCRIPTION -The Address Resolution Protocol (ARP) is a protocol used to dynamically +The Address Resolution Protocol (ARP) is used to dynamically map between Internet host addresses and 10Mb/s Ethernet addresses. -It is used by all the 10Mb/s Ethernet interface drivers. +It is used by all of the 10Mb/s Ethernet interface drivers. It is not specific to Internet protocols or to 10Mb/s Ethernet, but this implementation currently supports only that combination. .Pp @@ -56,7 +56,7 @@ If a response is provided, the new mapping is cached and any pending message is transmitted. ARP will queue at most one packet while waiting for a response to a mapping request; -only the most recently ``transmitted'' packet is kept. +only the most recently transmitted packet is kept. If the target host does not respond after several requests, the host is considered to be down for a short period (normally 20 seconds), allowing an error to be returned to transmission attempts during this diff --git a/usr.sbin/arp/arp.8 b/usr.sbin/arp/arp.8 index aee3aef0d75..b56505e422c 100644 --- a/usr.sbin/arp/arp.8 +++ b/usr.sbin/arp/arp.8 @@ -96,7 +96,9 @@ The entry will be permanent unless the word is given in the command. If the word .Ar pub -is given, the entry will be "published"; i.e., this system will +is given, the entry will be +.Dq published ; +i.e., this system will act as an .Tn ARP server, diff --git a/usr.sbin/bad144/bad144.8 b/usr.sbin/bad144/bad144.8 index 6eb1003b38c..b39af9f6554 100644 --- a/usr.sbin/bad144/bad144.8 +++ b/usr.sbin/bad144/bad144.8 @@ -30,14 +30,14 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)bad144.8 8.1 (Berkeley) 6/6/93 -.\" $Id: bad144.8,v 1.2 1996/07/08 22:09:45 ccappuc Exp $ +.\" $Id: bad144.8,v 1.3 1998/11/08 00:21:27 aaron Exp $ .\" .Dd June 6, 1993 .Dt BAD144 8 .Os BSD 4 .Sh NAME .Nm bad144 -.Nd read/write dec standard 144 bad sector information +.Nd read/write DEC standard 144 bad sector information .Sh SYNOPSIS .Nm bad144 .Op Fl c @@ -56,7 +56,7 @@ .Ar disk .Op Ar bad ... .Sh DESCRIPTION -.Nm Bad144 +.Nm bad144 can be used to inspect the information stored on a disk that is used by the disk drivers to implement bad sector forwarding. .Pp @@ -74,15 +74,16 @@ the new replacement sectors are cleared. Forces an attempt to copy the old sector to the replacement, and may be useful when replacing an unreliable sector. .It Fl f -For a RP06, RM03, RM05, Fujitsu Eagle, +For an RP06, RM03, RM05, Fujitsu Eagle, or .Tn SMD disk on a Massbus, the .Fl f -option may be used to mark the new bad sectors as ``bad'' +option may be used to mark the new bad sectors as +.Dq bad by reformatting them as unusable sectors. -This option is -.Em required unless +This option is required +.Em unless the sectors have already been marked bad, or the system will not be notified that it should use the replacement sector. This option may be used while running multiuser; it is no longer necessary @@ -100,7 +101,7 @@ standard 144, as follows. The bad sector information is located in the first 5 even numbered sectors of the last track of the disk pack. There are five identical copies of the information, described by the -.Ar dkbad +.Va dkbad structure. .Pp Replacement sectors are allocated starting with the first sector before @@ -111,7 +112,9 @@ sector to which it corresponds. The bad sectors must be listed in ascending order. .Pp The bad sector information and replacement sectors are conventionally -only accessible through the ``c'' file system partition of the disk. If +only accessible through the +.Dq c +file system partition of the disk. If that partition is used for a file system, the user is responsible for making sure that it does not overlap the bad sector information or any replacement sectors. @@ -132,17 +135,17 @@ struct dkbad { .Ed .Pp Unused slots in the -.Ar bt_bad +.Va bt_bad array are filled with all bits set, a putatively illegal value. .Pp -.Nm Bad144 +.Nm bad144 is invoked by giving a device name (e.g. hk0, hp1, etc.). With no optional arguments it reads the first sector of the last track of the corresponding disk and prints out the bad sector information. It issues a warning if the bad sectors are out of order. -.Nm Bad144 +.Nm bad144 may also be invoked with a serial number for the pack and a list of bad sectors. It will write the supplied information into all copies diff --git a/usr.sbin/catman/catman.8 b/usr.sbin/catman/catman.8 index eefc3435b45..c0b2e88aaf3 100644 --- a/usr.sbin/catman/catman.8 +++ b/usr.sbin/catman/catman.8 @@ -27,7 +27,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" $Id: catman.8,v 1.1 1995/10/18 08:47:29 deraadt Exp $ +.\" $Id: catman.8,v 1.2 1998/11/08 00:21:27 aaron Exp $ .\" .Dd July 30, 1993 .Dt CATMAN 8 @@ -41,7 +41,7 @@ .Op Fl M Ar directory .Op Ar sections .Sh DESCRIPTION -.Nm Catman +.Nm catman creates formatted versions of the on-line manual pages from their .Xr nroff 1 source. @@ -50,7 +50,7 @@ regenerated. If manual pages are regenerated, .Nm catman also regenerates the -.Nm whatis +.Xr whatis 1 database. .Pp The optional @@ -58,7 +58,9 @@ The optional argument is one word, and contains the section numbers of all the sections to be checked. For example, if .Ar sections -is ``138'', the +is +.Dq 138 , +the manual pages in sections 1, 3, and 8 will be checked and regenerated. If no .Ar sections @@ -69,10 +71,12 @@ will try to operate on all of the known manual sections. The options are as follows: .Bl -tag -width indent .It Fl k -Ignore errors from nroff when building manpages. +Ignore errors from +.Xr nroff +when building man pages. .It Fl n Do not create the -.Nm whatis +.Xr whatis 1 database. .It Fl p Display the commands that would have been executed, but do not actually @@ -81,14 +85,14 @@ execute them. Perform work silently; do not echo commands as they are executed. This flag is ignored if .Fl p -is specified. +is also specified. .It Fl w Only create the -.Nm whatis +.Xr whatis 1 database. .It Fl M Ar directory Update manual pages in -.Ar directory. +.Ar directory . .El .Sh SEE ALSO .Xr apropos 1 , diff --git a/usr.sbin/chown/chgrp.1 b/usr.sbin/chown/chgrp.1 index 55da5a5899a..0fc3ae2cdc1 100644 --- a/usr.sbin/chown/chgrp.1 +++ b/usr.sbin/chown/chgrp.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chgrp.1,v 1.2 1997/01/26 05:54:27 downsj Exp $ +.\" $OpenBSD: chgrp.1,v 1.3 1998/11/08 00:21:27 aaron Exp $ .\" .\" Copyright (c) 1983, 1990, 1993, 1994 .\" The Regents of the University of California. All rights reserved. @@ -51,7 +51,7 @@ .Op Fl f .Op Fl h .Ar group -.Ar files ... +.Ar file Op Ar ... .Sh DESCRIPTION The chgrp utility sets the group ID of the file named by each .Ar file @@ -113,17 +113,17 @@ or be the super-user. .Pp The .Nm chgrp -utility exits 0 on success, and >0 if an error occurs. +utility exits 0 on success or >0 if an error occurred. .Sh FILES .Bl -tag -width /etc/group -compact .It Pa /etc/group -Group ID file +group ID file .El .Sh SEE ALSO .Xr chown 2 , +.Xr fts 3 , .Xr group 5 , .Xr passwd 5 , -.Xr fts 3 , .Xr symlink 7 , .Xr chown 8 .Sh STANDARDS diff --git a/usr.sbin/chown/chown.8 b/usr.sbin/chown/chown.8 index ebc9d6be82c..77333ef5eb1 100644 --- a/usr.sbin/chown/chown.8 +++ b/usr.sbin/chown/chown.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chown.8,v 1.2 1997/01/26 05:54:28 downsj Exp $ +.\" $OpenBSD: chown.8,v 1.3 1998/11/08 00:21:27 aaron Exp $ .\" .\" Copyright (c) 1990, 1991, 1993, 1994 .\" The Regents of the University of California. All rights reserved. @@ -47,8 +47,8 @@ .Oc .Op Fl f .Op Fl h -.Ar owner Op Ar :group -.Ar file ... +.Ar ownerof Op Ar :group +.Ar file Op Ar ... .Nm chown .Oo .Fl R @@ -57,9 +57,9 @@ .Op Fl f .Op Fl h .Ar :group -.Ar file ... +.Ar file Op Ar ... .Sh DESCRIPTION -.Nm Chown +.Nm chown sets the user ID and/or the group ID of the specified files. .Pp The options are as follows: @@ -109,7 +109,9 @@ and operands are both optional, however, one must be specified. If the .Ar group -operand is specified, it must be preceded by a colon (``:'') character. +operand is specified, it must be preceded by a colon +.Pq Sq \&: +character. .Pp The .Ar owner @@ -127,12 +129,16 @@ obvious security reasons. .Pp The .Nm chown -utility exits 0 on success, and >0 if an error occurs. +utility exits 0 on success or >0 if an error occurred. .Sh COMPATIBILITY Previous versions of the .Nm chown -utility used the dot (``.'') character to distinguish the group name. -This has been changed to be a colon (``:'') character so that user and +utility used the dot +.Pq Sq \&. +character to distinguish the group name. +This has been changed to be a colon +.Pq Sq \&: +character so that user and group names may contain the dot character. .Sh SEE ALSO .Xr chgrp 1 , diff --git a/usr.sbin/chroot/chroot.8 b/usr.sbin/chroot/chroot.8 index 39c77f7e6ca..25146e491a9 100644 --- a/usr.sbin/chroot/chroot.8 +++ b/usr.sbin/chroot/chroot.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)chroot.8 5.3 (Berkeley) 3/16/91 -.\" $Id: chroot.8,v 1.1 1995/10/18 08:47:29 deraadt Exp $ +.\" $Id: chroot.8,v 1.2 1998/11/08 00:21:28 aaron Exp $ .\" .Dd March 16, 1991 .Dt CHROOT 8 @@ -47,13 +47,13 @@ The .Nm chroot command changes its root directory to the supplied directory .Ar newroot -and exec's +and executes .Ar command , if supplied, or an interactive copy of your shell. .Pp Note, .Ar command -or the shell are run as your real-user-id. +or the shell are run as your real user ID. .Sh ENVIRONMENT The following environment variable is referenced by .Nm chroot : @@ -63,7 +63,7 @@ If set, the string specified by .Ev SHELL is interpreted as the name of -the shell to exec. +the shell to execute. If the variable .Ev SHELL is not set, @@ -77,5 +77,5 @@ is used. .Sh HISTORY The .Nm -command +command is .Ud diff --git a/usr.sbin/config/config.8 b/usr.sbin/config/config.8 index cb12a1fb8f9..456d7e33b73 100644 --- a/usr.sbin/config/config.8 +++ b/usr.sbin/config/config.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: config.8,v 1.6 1998/03/16 07:46:04 deraadt Exp $ +.\" $OpenBSD: config.8,v 1.7 1998/11/08 00:21:28 aaron Exp $ .\" $NetBSD: config.8,v 1.10 1996/08/31 20:58:16 mycroft Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -47,8 +47,7 @@ .Op Fl p .Op Ar config-file .Sh DESCRIPTION -.Pp -.Nm Config +.Nm config creates a kernel build directory from the file .Ar config-file , which describes the system to configure. @@ -78,7 +77,7 @@ where .Pa SYSTEMNAME is the last path component of .Ar config-file . -.Nm Config +.Nm config will assume that the top-level kernel source directory is located four directories above the build directory. .Pp @@ -89,7 +88,7 @@ and run .Nm config from within the build directory without specifying a .Ar config-file . -.Nm Config +.Nm config will then by default create files in the current directory. If you run .Nm config @@ -160,7 +159,7 @@ it is wise to run .Dq Li make depend in the directory where the new makefile was created. -.Nm Config +.Nm config prints a reminder of this when it completes. .Pp If @@ -168,14 +167,14 @@ If stops due to errors, the problems reported should be corrected and .Nm config should be run again. -.Nm Config +.Nm config attempts to avoid changing the compilation directory if there are configuration errors, but this code is not well-tested, and some problems (such as running out of disk space) are unrecoverable. .Sh SEE ALSO -.Xr options 4 . +.Xr options 4 .Pp The SYNOPSIS portion of each device in section 4. .Rs diff --git a/usr.sbin/ctm/ctm/ctm.1 b/usr.sbin/ctm/ctm/ctm.1 index 208c85b44c0..a269b3df2eb 100644 --- a/usr.sbin/ctm/ctm/ctm.1 +++ b/usr.sbin/ctm/ctm/ctm.1 @@ -10,7 +10,7 @@ .\" .\" CTM and ctm(1) by <phk@login.dknet.dk> .\" -.\" $Id: ctm.1,v 1.2 1997/09/14 01:02:22 deraadt Exp $ +.\" $Id: ctm.1,v 1.3 1998/11/08 00:21:28 aaron Exp $ .\" .Dd Mar 25, 1995 .Os @@ -24,15 +24,15 @@ .Op Fl b Ar basedir .Op Fl T Ar tmpdir .Op Fl V Ar level -.Ar file Op ... +.Ar file Op Ar ... .Sh DESCRIPTION -.Nm Ctm +.Nm ctm was originally .Dq Cvs Through eMail , but now instead it seems more fitting to call it .Dq Current Through eMail . -.Nm Ctm +.Nm ctm is now meant to be the definitive way to make and apply a delta between two versions of a directory tree. @@ -40,22 +40,21 @@ There are two parts to this, making the delta and applying it. These are two entirely different things. .Ss Usage - To apply a CTM delta, you pass it to the .Nm ctm command. You can pass a CTM delta on stdin, or you can give the filename as an argument. If you do the latter, you make life a lot -easier for your self, since the program can accept gzip'ed files and +easier for yourself, since the program can accept gzip'ed files and since it will not have to make a temporary copy of your file. You can specify multiple deltas at one time, they will be proccessed one at a time. Deltas that are already applied will be ignored. - +.Pp The .Nm ctm command runs in a number of passes. It will process the entire input file in each pass, before commencing with the next pass. - -Before working one a file +.Pp +Before working on a file .Ar name .Nm ctm first checks for the existence of the file @@ -63,124 +62,99 @@ first checks for the existence of the file If this file exists, .Nm ctm works on it instead. - +.Pp Pass 1 will validate that the input file is OK. The syntax, the data and the global MD5 checksum will be checked. If any of these fail, .Nm ctm will never be able to do anything with the file, so it will simply reject it. - +.Pp Pass 2 will validate that the directory tree is in the state expected by the CTM delta. This is done by looking for files and directories which -should/should not exists and by checking the MD5 checksums of files. - +should/should not exist and by checking the MD5 checksums of files. +.Pp Pass 3 will actually apply the delta. - -.Nm Ctm +.Pp +.Nm ctm will extract the file hierarchy below its working directory. Absolute filenames or filenames containing references through -.Sq \&. -and -.Sq \&.\&. +.Dq \&. +or +.Dq \&.\&. are explicitly prohibited as a security measure. - +.Pp .Ss Options - -.Bl -tag -width indent -compact - +.Bl -tag -width indent .It Fl b Ar basedir Prepend the path .Ar basedir on every filename. - .It Fl c Check it out, don't do anything. - .It Fl F Force. - .It Fl p Less paranoid. - .It Fl P Paranoid. - .It Fl q Tell us less. - .It Fl T Ar tmpdir Put temporary files under .Ar tmpdir . - .It Fl u Set modification time of created and modified files to the CTM delta creation time. - .It Fl v Tell us more. - .It Fl V Ar level Tell us more. -.Ar Level +.Ar level is the level of verbosity. - .El - .Sh ENVIRONMENT .Ev TMPDIR, -if set to a pathname, will cause ctm to use that pathname +if set to a pathname, will cause +.Nm ctm +to use that pathname as the location of temporary file. See -.Xr tempnam 3 , +.Xr tempnam 3 for more details on this. The same effect may be achieved with the .Fl T flag. - .Sh FILES - .Pa .ctm_status -contains the sequence number of the last CTM delta applied. Changing +contains the sequence number of the last CTM delta applied; changing or removing this file will greatly confuse .Nm ctm . - .Sh EXAMPLES - .Bd -literal - cd ~cvs /usr/sbin/ctm ~ctm/cvs-* - .Ed - .Sh DIAGNOSTICS - -Numerous messages, hopefully self-explaining. The +Numerous messages, hopefully self-explanatory. The .Dq noise level can be adjusted with the .Fl q and .Fl v options. - .Sh SEE ALSO -.Xr ctm 5 , -.Xr ctm_rmail 1 - +.Xr ctm_rmail 1 , +.Xr ctm 5 .Sh HISTORY - Initial trials ran during the FreeBSD 1.1.5, and many bugs and methods were hashed out. - The .Nm ctm command appeared in FreeBSD 2.1. - .Sh AUTHORS - The CTM system has been designed and implemented by Poul-Henning Kamp .Aq phk@FreeBSD.org . - -Joerg Wunsch wrote this man-page. -.Aq joerg@FreeBSD.org . +Joerg Wunsch +.Aq joerg@FreeBSD.org +wrote this man page. diff --git a/usr.sbin/ctm/ctm/ctm.5 b/usr.sbin/ctm/ctm/ctm.5 index 877280ad2c8..505ece29305 100644 --- a/usr.sbin/ctm/ctm/ctm.5 +++ b/usr.sbin/ctm/ctm/ctm.5 @@ -10,7 +10,7 @@ .\" .\" CTM and ctm(1) by <phk@login.dknet.dk> .\" -.\" $Id: ctm.5,v 1.2 1998/09/27 02:49:25 aaron Exp $ +.\" $Id: ctm.5,v 1.3 1998/11/08 00:21:28 aaron Exp $ .\" .Dd March 25, 1995 .Os @@ -18,66 +18,63 @@ .Sh NAME .Nm ctm .Nd source code mirror system - .Sh DESCRIPTION The .Nm ctm transfers data in a specific file format, called a CTM delta. - +.Pp CTM deltas consist of control lines and data chunks. Each control line starts with the letters .Dq CTM , -followed by a CTM statement and control data, and ends with a '\en' +followed by a CTM statement and control data, and ends with a +newline +.Pq Sq \en character. - +.Pp Data chunks always belong to the preceding control line, and the last field on that control line is the number of bytes in the data chunk. -A trailing newline '\en' character follows each data chunk, this +A trailing newline +character follows each data chunk. This newline is not part of the chunk and isn't included in the count. - -The CTM statements are as follows. +.Pp +The CTM statements are as follows: .Bl -tag -width indent - .It _BEGIN Ar version name number timestamp prefix - This is the overall begin of a CTM delta file. The .Ar version field must match the program version .Pq currently 2.0 . -.Ar Name +.Ar name is the name and .Ar number -the sequence number of the CTM service, it is matched against the file +the sequence number of the CTM service; it is matched against the file .Pa .ctm_status to see if the delta has already been applied. -.Ar Timestamp +.Ar timestamp contains the year, month, day, hour, minute, and second of the time of delta creation for reference .Po followed by the letter -.Sq Z +.Dq Z , meaning this is a UTC timestamp .Pc . The .Ar prefix -This field is currently not implemented. - +field is currently not implemented. .It _END Ar md5 - -This statement ends the CTM delta, the global +This statement ends the CTM delta. The global .Ar md5 checksum is matched against the MD5 checksum of the entire delta, up to -and including the space (0x20) character following ``_END''. - +and including the space (0x20) character following +.Dq _END . .It \&FM Ar name uid gid mode md5 count - Make the file -.Ar name , -the original file had the uid +.Ar name . +The original file had the UID .Ar uid .Pq numerical, decimal , -the gid +the GID .Ar gid .Pq numerical, decimal , mode @@ -85,19 +82,16 @@ mode .Pq numerical, octal , and the MD5 checksum .Ar md5 . - The following .Ar count bytes data are the contents of the new file. - .It \&FS Ar name uid gid mode md5before md5after count - Substitute the contents of file -.Ar name , -the original file had the new uid +.Ar name . +The original file had the new UID .Ar uid .Pq numerical, decimal , -the new gid +the new GID .Ar gid .Pq numerical, decimal , new mode @@ -107,31 +101,23 @@ the old MD5 checksum .Ar md5before , and the new MD5 checksum .Ar md5after . - The following .Ar count bytes data are the contents of the new file. - File substitution is used if the commands to edit a file would exceed the total file length, so substituting it is more efficient. - .It \&FN Ar name uid gid mode md5before md5after count - Edit the file .Ar name . -The arguments are as above, but the data sections contains an +The arguments are as above, but the data sections contain a .Xr diff 1 -n script which should be applied to the file in question. - .It \&FR Ar name md5 - Remove the file .Ar name , which must match the MD5 checksum .Ar md5 . - .It \&AS Ar name uid gid mode - The original file .Ar name changed its owner to @@ -140,34 +126,25 @@ its group to .Ar gid , and/or its mode to .Ar mode . - .It \&DM Ar name uid gid mode - The directory .Ar name -is to be created, it had originally the owner +is to be created. It had originally the owner .Ar uid , group .Ar gid , and mode .Ar mode . - .It \&DR name - The directory .Ar name is to be removed. - .El - .Sh EXAMPLES - In the following example, long lines have been folded to make them printable .Pq marked by backslashes . - .Bd -literal - CTM_BEGIN 2.0 cvs-cur 485 19950324214652Z . CTMFR src/sys/gnu/i386/isa/scd.c,v 5225f13aa3c7e458f9dd0d4bb637b18d CTMFR src/sys/gnu/i386/isa/scdreg.h,v e5af42b8a06f2c8030b93a7d71afb223 @@ -175,36 +152,29 @@ CTMDM src/sys/gnu/i386/isa/Attic 0 552 775 CTMFS .ctm_status 545 552 664 d9ccd2a84a9dbb8db56ba85663adebf0 \\ e2a10c6f66428981782a0a18a789ee2e 12 cvs-cur 485 - +.Pp CTMFN CVSROOT/commitlogs/gnu 545 552 664 \\ 5d7bc3549140d860bd9641b5782c002d 7fb04ed84b48160c9b8eea84b4c0b6e3 394 a6936 21 ache 95/03/24 09:59:50 - +.Pp Modified: gnu/lib/libdialog kernel.c prgbox.c Log: [...] CTM_END 74ddd298d76215ae45a077a4b6a74e9c - .Ed - .Sh SEE ALSO - .Xr ctm 1 , .Xr ctm_rmail 1 , -.Xr ed 1 . - +.Xr ed 1 .Sh HISTORY - Initial trials ran during the FreeBSD 1.1.5, and many bugs and methods were hashed out. The CTM system has been made publically available in FreeBSD 2.1. - .Sh AUTHORS - The CTM system has been designed and implemented by Poul-Henning Kamp .Aq phk@FreeBSD.org . - -Joerg Wunsch wrote this man-page. -.Aq joerg@FreeBSD.org . +Joerg Wunsch +.Aq joerg@FreeBSD.org +wrote this man page. diff --git a/usr.sbin/ctm/ctm_rmail/ctm_rmail.1 b/usr.sbin/ctm/ctm_rmail/ctm_rmail.1 index 7b1dd3686d3..cc76f57f440 100644 --- a/usr.sbin/ctm/ctm_rmail/ctm_rmail.1 +++ b/usr.sbin/ctm/ctm_rmail/ctm_rmail.1 @@ -11,7 +11,7 @@ .Sh NAME .Nm ctm_smail, ctm_rmail .Nd send and receive -.Nm ctm +.Xr ctm 1 deltas via mail .Sh SYNOPSIS .Nm ctm_smail @@ -112,11 +112,11 @@ without the .Fl p flag. Deltas will not be applied if they do not match the -.Li .ctm_status +.Pa .ctm_status file in .Ar basedir (or if -.Li .ctm_status +.Pa .ctm_status does not exist). .It Fl D Delete deltas after successful application by @@ -252,9 +252,9 @@ and directories and .Pa /ctm/log file are writable by user -.Em daemon +.Dq daemon or group -.Em wheel ) : +.Dq wheel ) : .Bd -literal -offset indent receiver-dude: "|ctm_rmail -p /ctm/tmp -d /ctm/deltas -l /ctm/log" owner-receiver-dude: real_dude@wherever.you.like @@ -289,8 +289,7 @@ source recipients would be able to generate a fake delta, and they're such nice folk that they wouldn't even think of it! :-) .Pp Even this possibility could be removed by using cryptographic signatures. -A possible future enhancement would be to use -.Nm PGP +A possible future enhancement would be to use PGP to provide a secure wrapper. .\" This next request is for sections 1, 6, 7 & 8 only .Sh ENVIRONMENT @@ -301,14 +300,14 @@ and must be in your .Ev PATH . .Sh FILES -.Bl -tag -width indent +.Bl -tag -width BASEDIR/.ctm_status -compact .It Pa PIECEDIR/* -Pieces of deltas waiting for the rest. +pieces of deltas waiting for the rest .It Pa DELTADIR/* -Completed deltas. +completed deltas .It Pa BASEDIR/.ctm_status -File containing name and number of the next delta to be applied to this -source tree. +file containing name and number of the next delta to be applied to this +source tree .\" This next request is for sections 1, 6, 7 & 8 only .\" (command return values (to shell) and fprintf/stderr type diagnostics) .Sh DIAGNOSTICS diff --git a/usr.sbin/dev_mkdb/dev_mkdb.8 b/usr.sbin/dev_mkdb/dev_mkdb.8 index 61f86c080f3..d685f30bb59 100644 --- a/usr.sbin/dev_mkdb/dev_mkdb.8 +++ b/usr.sbin/dev_mkdb/dev_mkdb.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)dev_mkdb.8 8.1 (Berkeley) 6/6/93 -.\" $Id: dev_mkdb.8,v 1.1 1995/10/18 08:47:31 deraadt Exp $ +.\" $Id: dev_mkdb.8,v 1.2 1998/11/08 00:21:28 aaron Exp $ .\" .Dd June 6, 1993 .Os @@ -53,19 +53,25 @@ which contains the names of all of the character and block special files in the .Dq Pa /dev directory, using the file type and the -.Fa st_rdev +.Va st_rdev field as the key. .Pp -Keys are a structure containing a mode_t followed by a dev_t, -with any padding zero'd out. -The former is the type of the file (st_mode & S_IFMT), -the latter is the st_rdev field. +Keys are a structure containing a +.Tn mode_t +followed by a +.Tn dev_t , +with any padding zeroed out. +The former is the type of the file +.Pq st_mode & S_IFMT , +the latter is the +.Va st_rdev +field. .Sh FILES .Bl -tag -width /var/run/dev.db -compact .It Pa /dev -Device directory. +device directory .It Pa /var/run/dev.db -Database file. +database file .El .Sh SEE ALSO .Xr ps 1 , diff --git a/usr.sbin/edquota/edquota.8 b/usr.sbin/edquota/edquota.8 index 1a3e2c922dc..93821558ef2 100644 --- a/usr.sbin/edquota/edquota.8 +++ b/usr.sbin/edquota/edquota.8 @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)edquota.8 8.1 (Berkeley) 6/6/93 -.\" $Id: edquota.8,v 1.2 1998/03/22 21:22:57 millert Exp $ +.\" $Id: edquota.8,v 1.3 1998/11/08 00:21:29 aaron Exp $ .\" .Dd June 6, 1993 .Dt EDQUOTA 8 @@ -45,11 +45,11 @@ .Nm edquota .Op Fl u .Op Fl p Ar proto-username -.Ar username | uid ... +.Ar username | uid Op Ar ... .Nm edquota .Fl g .Op Fl p Ar proto-groupname -.Ar groupname | gid ... +.Ar groupname | gid Op Ar ... .Nm edquota .Fl t .Op Fl u @@ -57,15 +57,19 @@ .Fl t .Fl g .Sh DESCRIPTION -.Nm Edquota +.Nm edquota is a quota editor. By default, or if the .Fl u flag is specified, one or more users may be specified on the command line. -If a numeric id is given instead of a name that uid/gid -will be used even if there is not a corresponding id in -the passwd or group files. +If a numeric ID is given instead of a name that UID/GID +will be used even if there is not a corresponding ID in +the +.Pa /etc/passwd +or +.Pa /etc/group +files. For each user a temporary file is created with an ASCII representation of the current disk quotas for that user. @@ -145,7 +149,7 @@ grace period should be granted. .Pp Only the super-user may edit quotas. .Sh FILES -.Bl -tag -width 24n -compact +.Bl -tag -width quota.group -compact .It Pa quota.user at the filesystem root with user quotas .It Pa quota.group diff --git a/usr.sbin/eeprom/eeprom.8 b/usr.sbin/eeprom/eeprom.8 index fa4eda870d6..ce77db89c6b 100644 --- a/usr.sbin/eeprom/eeprom.8 +++ b/usr.sbin/eeprom/eeprom.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: eeprom.8,v 1.6 1998/07/13 02:04:44 jason Exp $ +.\" $OpenBSD: eeprom.8,v 1.7 1998/11/08 00:21:29 aaron Exp $ .\" $NetBSD: eeprom.8,v 1.2 1996/02/28 01:13:24 thorpej Exp $ .\" .\" Copyright (c) 1996 The NetBSD Foundation, Inc. @@ -66,7 +66,7 @@ .Oc ... .Oc .Sh DESCRIPTION -.Nm Eeprom +.Nm eeprom provides an interface for displaying and changing the contents of the EEPROM or OpenProm. Without any arguments, .Nm eeprom @@ -74,7 +74,7 @@ will list all of the known fields and their corresponding values. When given the name of a specific field, .Nm eeprom will display that value or set it if the field name is followed by -.Sq = +.Dq = and a value. Only the super-user may modify the contents of the EEPROM or OpenProm. .Pp @@ -83,7 +83,7 @@ The options are as follows: .It Fl Commands are taken from stdin and displayed on stdout. .It Fl c -.Nm Eeprom +.Nm eeprom will fix incorrect checksum values and exit. This flag is quietly ignored on systems with an OpenProm. .It Fl f Ar device @@ -144,15 +144,15 @@ If true, the system will use the boot device stored in .Pa bootdev . .It bootdev Specifies the default boot device in the form cc(x,x,x), where -.Sq cc +.Dq cc is a combination of two letters such as -.Sq sd +.Dq sd or -.Sq le +.Dq le and each -.Sq x +.Dq x is a hexadecimal number between 0 and ff, less the prepending -.Sq 0x . +.Dq 0x . .It kbdtype This value is .Dq 0 @@ -232,7 +232,7 @@ If true, enables the use of the bitmap stored in .Pa oem-logo rather than the default Sun logo. .It oem-banner -A string to use at power up, rather than the default Sun banner. +A string to use at power-up, rather than the default Sun banner. .It oem-banner? If true, enables the use of the banner stored in .Pa oem-banner @@ -243,25 +243,25 @@ A string of five comma separated fields in the format The first field is the baud rate. The second field is the number of data bits. The third field is the parity; acceptable values for parity are -.Sq n +.Dq n (none), -.Sq e +.Dq e (even), -.Sq o +.Dq o (odd), -.Sq m +.Dq m (mark), and -.Sq s +.Dq s (space). The fourth field is the number of stop bits. The fifth field is the -.Sq handshake +.Dq handshake field; acceptable values are -.Sq - +.Dq - (none), -.Sq h -(rts/cts), and -.Sq s -(xon/xoff). +.Dq h +(RTS/CTS), and +.Dq s +(XON/XOFF). .It ttya-rts-dtr-off If true, the system will ignore RTS/DTR. .It ttya-ignore-cd @@ -351,7 +351,7 @@ The date parser isn't very intelligent. .Sh FILES .Bl -tag -width "/dev/openprom " .It /dev/eeprom -The EEPROM device on systems with an EEPROM. +the EEPROM device on systems with an EEPROM .It /dev/openprom -The OpenProm device on systems with an OpenProm. +the OpenProm device on systems with an OpenProm .El diff --git a/usr.sbin/fdformat/fdformat.1 b/usr.sbin/fdformat/fdformat.1 index c3814fd0058..bfcfa683e0a 100644 --- a/usr.sbin/fdformat/fdformat.1 +++ b/usr.sbin/fdformat/fdformat.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: fdformat.1,v 1.5 1998/03/10 04:51:07 millert Exp $ +.\" $OpenBSD: fdformat.1,v 1.6 1998/11/08 00:21:29 aaron Exp $ .\" .\" Copyright (C) 1993, 1994 by Joerg Wunsch, Dresden .\" All rights reserved. @@ -47,15 +47,15 @@ .Bq Fl t Ar steps_per_track .Ar device_name .Sh DESCRIPTION -.Nm Fdformat +.Nm fdformat formats a floppy disk at device .Ar device_name . -.Ar Device_name +.Ar device_name should be a character device; it may be given either with a full path name of a raw device node for a floppy disk drive -.Pq e.\ g. Pa /dev/rfd0c , +.Pq e.g. Pa /dev/rfd0c , or default name in an abbreviated form -.Pq e.\ g. Em fd0 . +.Pq e.g. Em fd0 . Note that any geometry constraints of the device node .Pq minor device number are meaningless, since they're overridden by @@ -96,21 +96,21 @@ Unless has been specified, a single letter is printed to standard output to inform the user about the progress of work. First, an -.Sq Em F +.Dq F is printed when the track(s) is being formatted, then a -.Sq Em V +.Dq V while it's being verified, and if an error has been detected, it will finally change to -.Sq Em E . +.Dq E . .Pp An exit status of 0 is returned upon successful operation. Exit status 1 is returned on any errors during floppy formatting, and an exit status -of 2 reflects invalid arguments given to the program (along with an +of 2 reflects invalid arguments given to the program (along with appropriate information written to diagnostic output). .Sh SEE ALSO -.Xr fdc 4 . +.Xr fdc 4 .Sh HISTORY -.Nm Fdformat +.Nm fdformat was developed for 386BSD 0.1 and upgraded to the new .Xr fd 4 floppy disk driver. It later became part of diff --git a/usr.sbin/grfconfig/grfconfig.8 b/usr.sbin/grfconfig/grfconfig.8 index 08f2cfea7f9..e8cbe7ee51d 100644 --- a/usr.sbin/grfconfig/grfconfig.8 +++ b/usr.sbin/grfconfig/grfconfig.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: grfconfig.8,v 1.3 1997/09/18 22:03:45 niklas Exp $ +.\" $OpenBSD: grfconfig.8,v 1.4 1998/11/08 00:21:29 aaron Exp $ .\" $NetBSD: grfconfig.8,v 1.4 1997/07/29 17:40:47 veego Exp $ .\" .\" Copyright (c) 1997 The NetBSD Foundation, Inc. @@ -75,7 +75,9 @@ num clk wid hi dep hbs hss hse ht vbs vss vse vt flags .Pp .Bl -tag -width indent .It Ar num -The mode number or 'c' for the console mode. +The mode number or +.Dq c +for the console mode. .It Ar clk The pixel clock in Hz. .It Ar wid @@ -93,26 +95,26 @@ The vertical timing paramters for the mode in line values. All the values are relative to the end of vertical blank (beginning of the displayed area). .It Ar flags -By default every mode uses negative horizontal and vertical sync pulses, +By default every mode uses negative horizontal and vertical sync pulses; it is non-interlaced and does not use scandoubling. .Pp -.Bl -tag -width sync-on-green -offset indent +.Bl -tag -width sync-on-green -offset indent -compact .It default -Use the default flags: -hsync -vsync +use the default flags: -hsync -vsync .It doublescan -Doublescan mode +doublescan mode .It interlace -Interlace mode +interlace mode .It +hsync -Positive horizontal sync pulses +positive horizontal sync pulses .It -hsync -Negative horizontal sync pulses +negative horizontal sync pulses .It +vsync -Positive vertical sync pulses +positive vertical sync pulses .It -vsync -Negative vertical sync pulses +negative vertical sync pulses .It sync-on-green -Composite sync on green +composite sync on green .Pp .El .Pp @@ -200,6 +202,11 @@ hbe and vbe are computed in the grf drivers. .Pp .Sh BUGS .Nm -can not set the modes for /dev/grf1, /dev/grf2 and /dev/grf4 -and it will not work for /dev/grf0. +cannot set the modes for +.Pa /dev/grf1 , +.Pa /dev/grf2 , +or +.Pa /dev/grf4 +and it will not work for +.Pa /dev/grf0 . diff --git a/usr.sbin/grfinfo/grfinfo.1 b/usr.sbin/grfinfo/grfinfo.1 index 71d278cd720..4943fd16ae0 100644 --- a/usr.sbin/grfinfo/grfinfo.1 +++ b/usr.sbin/grfinfo/grfinfo.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: grfinfo.1,v 1.1 1997/02/03 05:10:57 downsj Exp $ +.\" $OpenBSD: grfinfo.1,v 1.2 1998/11/08 00:21:29 aaron Exp $ .\" $NetBSD: grfinfo.1,v 1.1 1997/01/31 23:06:53 carrel Exp $ .\" .\" Copyright (c) 1997 The NetBSD Foundation, Inc. @@ -62,9 +62,10 @@ Display only the type, even if an error occurs. .Sh DIAGNOSTICS The .Nm grfinfo -utility exits 0 on success, and >0 if an error occurs. If the +utility exits 0 on success or >0 if an error occurred. If the .Fl t option is used and an error occurs, no error message is displayed, and the -type is displayed as "none". +type is displayed as +.Dq none . .Sh SEE ALSO .Xr grf 4 diff --git a/usr.sbin/inetd/inetd.8 b/usr.sbin/inetd/inetd.8 index 12341b84f23..fe7859ca030 100644 --- a/usr.sbin/inetd/inetd.8 +++ b/usr.sbin/inetd/inetd.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)inetd.8 6.7 (Berkeley) 3/16/91 -.\" $Id: inetd.8,v 1.6 1997/11/14 03:46:00 deraadt Exp $ +.\" $Id: inetd.8,v 1.7 1998/11/08 00:21:30 aaron Exp $ .\" .Dd March 16, 1991 .Dt INETD 8 @@ -45,7 +45,7 @@ .Op Fl R Ar rate .Op Ar configuration file .Sh DESCRIPTION -.Nm Inetd +.Nm inetd should be run at boot time by .Pa /etc/rc (see @@ -78,7 +78,9 @@ file which, by default, is .Pa /etc/inetd.conf . There must be an entry for each field of the configuration file, with entries for each field separated by a tab or -a space. Comments are denoted by a ``#'' at the beginning +a space. Comments are denoted by a +.Dq # +at the beginning of a line. There must be an entry for each field. The fields of the configuration file are as follows: .Pp @@ -92,8 +94,7 @@ server program server program arguments .Ed .Pp -To specify an -.Em Sun-RPC +To specify a Sun-RPC based service, the entry would contain these fields. .Pp .Bd -unfilled -offset indent -compact @@ -106,7 +107,7 @@ server program server program arguments .Ed .Pp -For Internet services, the first field of the line may also have a host +For internet services, the first field of the line may also have a host address specifier prefixed to it, separated from the service name by a colon. If this is done, the string before the colon in the first field indiciates what local address @@ -114,7 +115,8 @@ indiciates what local address should use when listening for that service. Multiple local addresses can be specified on the same line, separated by commas. Numeric IP addresses in dotted-quad notation can be used as well as symbolic -hostnames. Symbolic hostnames are looked up using gethostbyname(). +hostnames. Symbolic hostnames are looked up using +.Fn gethostbyname . If a hostname has multiple address mappings, inetd creates a socket to listen on each address. .Pp @@ -123,7 +125,7 @@ The single character indicates .Dv INADDR_ANY , meaning -.Sq all local addresses . +.Dq all local addresses . To avoid repeating an address that occurs frequently, a line with a host address specifier and colon, but no further fields, causes the host address specifier to be remembered and used for all further lines @@ -147,8 +149,7 @@ name .Em must be the official name of the service (that is, the first entry in .Pa /etc/services ) . -When used to specify a -.Em Sun-RPC +When used to specify a Sun-RPC based service, this field is a valid RPC service name in the file .Pa /etc/rpc . @@ -179,7 +180,7 @@ Examples might be .Dq tcp or .Dq udp . -Rpc based services are specified with the +RPC based services are specified with the .Dq rpc/tcp or .Dq rpc/udp @@ -205,13 +206,13 @@ on a socket and eventually time out, the server is said to be and should use a .Dq wait entry. -.Xr Comsat 8 +.Xr comsat 8 .Pq Xr biff 1 and .Xr talkd 8 are both examples of the latter type of datagram server. -.Xr Tftpd 8 +.Xr tftpd 8 is an exception; it is a datagram server that establishes pseudo-connections. It must be listed as .Dq wait @@ -254,7 +255,7 @@ entry should contain the user name of the user as whom the server should run. This allows for servers to be given less permission than root. An optional group name can be specified by appending a dot to the user name followed by the group name. This allows for servers to run with -a different (primary) group id than specified in the password file. If a group +a different (primary) group ID than specified in the password file. If a group is specified and user is not root, the supplementary groups associated with that user will still be set. .Pp @@ -278,7 +279,7 @@ word .Dq internal should take the place of this entry. .Pp -.Nm Inetd +.Nm inetd provides several .Dq trivial services internally by use of @@ -292,17 +293,17 @@ routines within itself. These services are .Dq time (machine readable time, in the form of the number of seconds since midnight, January -1, 1900). All of these services are tcp based. For +1, 1900). All of these services are TCP based. For details of these services, consult the appropriate .Tn RFC from the Network Information Center. .Pp -.Nm Inetd +.Nm inetd rereads its configuration file when it receives a hangup signal, .Dv SIGHUP . Services may be added, deleted or modified when the configuration file is reread. -.Nm Inetd +.Nm inetd creates a file .Em /var/run/inetd.pid that contains its process identifier. @@ -328,8 +329,6 @@ The .Nm command appeared in .Bx 4.3 . -Support for -.Em Sun-RPC +Support for Sun-RPC based services is modeled after that -provided by -.Em Sun-OS 4.1 . +provided by SunOS 4.1. diff --git a/usr.sbin/iostat/iostat.8 b/usr.sbin/iostat/iostat.8 index c43e7b78378..028a420aee4 100644 --- a/usr.sbin/iostat/iostat.8 +++ b/usr.sbin/iostat/iostat.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: iostat.8,v 1.8 1998/09/05 17:41:48 deraadt Exp $ +.\" $OpenBSD: iostat.8,v 1.9 1998/11/08 00:21:30 aaron Exp $ .\" $NetBSD: iostat.8,v 1.10 1996/10/25 18:21:57 scottr Exp $ .\" .\" Copyright (c) 1985, 1991, 1993 @@ -51,10 +51,10 @@ statistics .Op Fl w Ar wait .Op Ar drives .Sh DESCRIPTION -.Nm Iostat +.Nm iostat displays kernel .Tn I/O -statistics on terminal, disk and cpu operations. By default, +statistics on terminal, disk and CPU operations. By default, .Nm iostat displays one line of statistics averaged over the machine's run time. The use of @@ -82,7 +82,7 @@ If no .Ar wait interval is specified, the default is 1 second. .It Fl C -Show cpu statistics. This is enabled by default unless the +Show CPU statistics. This is enabled by default unless the .Fl d, .Fl D, or @@ -91,7 +91,7 @@ flags are used. .It Fl d Show disk statistics. This is the default. Displays kilobytes per transfer, number of transfers, and megabytes transferred. Use of this -flag disables display of cpu and tty statistics. +flag disables display of CPU and tty statistics. .It Fl D Show alternate disk statistics. Displays kilobytes transfered, number of transfers, and time spent in transfers. Use of this flag disables the @@ -121,7 +121,7 @@ If no repeat is specified, the default is infinity. .El .Pp -.Nm Iostat +.Nm iostat displays its information in the following format: .Bl -tag -width flag .It tty @@ -165,23 +165,23 @@ Seconds spent in disk activity .It cpu .Bl -tag -width indent -compact .It \&us -% of cpu time in user mode +% of CPU time in user mode .It \&ni -% of cpu time in user mode running niced processes +% of CPU time in user mode running niced processes .It \&sy -% of cpu time in system mode +% of CPU time in system mode .It \&in -% of cpu time processing interrupts +% of CPU time processing interrupts .It \&id -% of cpu time in idle mode +% of CPU time in idle mode .El .El .Sh FILES .Bl -tag -width /dev/mem -compact .It Pa /bsd -Default kernel namelist. +default kernel namelist .It Pa /dev/mem -Default memory file. +default memory file .El .Sh SEE ALSO .Xr fstat 1 , @@ -192,5 +192,7 @@ Default memory file. .Xr pstat 8 , .Xr vmstat 8 .Pp -The sections starting with ``Interpreting system activity'' in +The sections starting with +.Dq Interpreting system activity +in .%T "Installing and Operating 4.3BSD" . diff --git a/usr.sbin/iteconfig/iteconfig_amiga.8 b/usr.sbin/iteconfig/iteconfig_amiga.8 index 2e74bb3fcb3..ac43cace6d4 100644 --- a/usr.sbin/iteconfig/iteconfig_amiga.8 +++ b/usr.sbin/iteconfig/iteconfig_amiga.8 @@ -49,7 +49,7 @@ .Op Fl y Ar offset .Op Ar color ... .Sh DESCRIPTION -.Nm Iteconfig +.Nm iteconfig is used to modify or examine the attributes of the .Tn Amiga's console bell and bitmapped console display. @@ -64,48 +64,48 @@ The following flags are interpreted by .It Fl i After processing all other arguments, print information about the console's state. -.It Fl f +.It Fl f Ar file Open and use the terminal named by .Ar file rather than the default console -.Nm "/dev/ttye0". -.It Fl v +.Pa /dev/ttye0 . +.It Fl v Ar volume Set the volume of the console bell to .Ar volume , which must be between 0 and 63, inclusive. -.It Fl p +.It Fl p Ar pitch Set the pitch of the console bell to .Ar pitch , which must be between 10 and 1399. -.It Fl t +.It Fl t Ar msec Set the duration of the beep to .Ar msec milliseconds which must be between 1 and 5000 (5 seconds). -.It Fl w +.It Fl w Ar width Set the width of the console display to .Ar width pixel columns. -.Ar Width +.Ar width must be a positive integer. -.It Fl h +.It Fl h Ar height Set the height of the console display to .Ar height pixel rows. -.Ar Height +.Ar height must be a positive integer. -.It Fl d +.It Fl d Ar depth Set the number of bitplanes the console view should use to .Ar depth . For example, if .Ar depth is 3 then 8 colors will be used. -.It Fl x +.It Fl x Ar offset Set the horizontal offset of the console view on the monitor to .Ar offset pixel columns. The horizontal offset may be a positive or a negative integer, positive being an offset to the right, negative to the left. -.It Fl y +.It Fl y Ar offset Set the vertical offset of the console view on the monitor to .Ar offset pixel rows. The vertical offset may be a positive or a negative @@ -129,7 +129,7 @@ formats: .Ar GG , and .Ar BB -are taken to be eight-bit values specifying the +are taken to be 8-bit values specifying the intensities of the red, green and blue components, respectively, of the color to be used. For example, .Li 0xff0000 @@ -140,7 +140,7 @@ is white, and is dark cyan. .It Ar 0xGG .Ar GG -is taken to be an eight-bit value specifying the intensity +is taken to be an 8-bit value specifying the intensity of grey to be used. A value of .Li 0x00 is black, a value of @@ -148,10 +148,10 @@ is black, a value of is white, and a value of .Li 0x80 is a grey -approximately half way in between. +approximately halfway in-between. .It Ar 0xM .Ar M -is taken to be the one-bit monochrome value to be used. +is taken to be the 1-bit monochrome value to be used. A value of .Li 0x1 is black, and a value of diff --git a/usr.sbin/iteconfig/iteconfig_atari.8 b/usr.sbin/iteconfig/iteconfig_atari.8 index 135fbf02970..90034d96ceb 100644 --- a/usr.sbin/iteconfig/iteconfig_atari.8 +++ b/usr.sbin/iteconfig/iteconfig_atari.8 @@ -49,7 +49,7 @@ .Op Fl y Ar offset .Op Ar color ... .Sh DESCRIPTION -.Nm Iteconfig +.Nm iteconfig is used to modify or examine the attributes of the .Tn Atari's console bell and bitmapped console display. @@ -64,48 +64,48 @@ The following flags are interpreted by .It Fl i After processing all other arguments, print information about the console's state. -.It Fl f +.It Fl f Ar file Open and use the terminal named by .Ar file rather than the default console -.Nm "/dev/ttye0". -.It Fl v +.Pa /dev/ttye0 . +.It Fl v Ar volume Set the volume of the console bell to .Ar volume , which must be between 0 and 63, inclusive. -.It Fl p +.It Fl p Ar pitch Set the pitch of the console bell to .Ar pitch , which must be between 10 and 1399. -.It Fl t +.It Fl t Ar msec Set the duration of the beep to .Ar msec milliseconds which must be between 1 and 5000 (5 seconds). -.It Fl w +.It Fl w Ar width Set the width of the console display to .Ar width pixel columns. -.Ar Width +.Ar width must be a positive integer. -.It Fl h +.It Fl h Ar height Set the height of the console display to .Ar height pixel rows. -.Ar Height +.Ar height must be a positive integer. -.It Fl d +.It Fl d Ar depth Set the number of bitplanes the console view should use to .Ar depth . For example, if .Ar depth is 3 then 8 colors will be used. -.It Fl x +.It Fl x Ar offset Set the horizontal offset of the console view on the monitor to .Ar offset pixel columns. The horizontal offset may be a positive or a negative integer, positive being an offset to the right, negative to the left. -.It Fl y +.It Fl y Ar offset Set the vertical offset of the console view on the monitor to .Ar offset pixel rows. The vertical offset may be a positive or a negative @@ -129,7 +129,7 @@ formats: .Ar GG , and .Ar BB -are taken to be eight-bit values specifying the +are taken to be 8-bit values specifying the intensities of the red, green and blue components, respectively, of the color to be used. For example, .Li 0xff0000 @@ -140,7 +140,7 @@ is white, and is dark cyan. .It Ar 0xGG .Ar GG -is taken to be an eight-bit value specifying the intensity +is taken to be an 8-bit value specifying the intensity of grey to be used. A value of .Li 0x00 is black, a value of @@ -148,10 +148,10 @@ is black, a value of is white, and a value of .Li 0x80 is a grey -approximately half way in between. +approximately halfway in-between. .It Ar 0xM .Ar M -is taken to be the one-bit monochrome value to be used. +is taken to be the 1-bit monochrome value to be used. A value of .Li 0x1 is black, and a value of |