From ea31070695b2e513fcf660fbcc7f05a829839c35 Mon Sep 17 00:00:00 2001 From: ru Date: Mon, 20 Nov 2000 16:52:27 +0000 Subject: mdoc(7) police: use the new features of the Nm macro. --- sbin/adjkerntz/adjkerntz.8 | 4 +- sbin/badsect/badsect.8 | 4 +- sbin/bsdlabel/bsdlabel.8 | 44 ++++++++-------- sbin/camcontrol/camcontrol.8 | 88 ++++++++++++++++---------------- sbin/ccdconfig/ccdconfig.8 | 12 ++--- sbin/clri/clri.8 | 2 +- sbin/comcontrol/comcontrol.8 | 2 +- sbin/cxconfig/cxconfig.8 | 2 +- sbin/disklabel/disklabel.8 | 44 ++++++++-------- sbin/dmesg/dmesg.8 | 2 +- sbin/dump/dump.8 | 8 +-- sbin/dumpfs/dumpfs.8 | 2 +- sbin/dumpon/dumpon.8 | 4 +- sbin/fdisk/fdisk.8 | 4 +- sbin/fdisk_pc98/fdisk.8 | 4 +- sbin/fsck/fsck.8 | 2 +- sbin/fsck_ffs/fsck_ffs.8 | 10 ++-- sbin/fsck_ifs/fsck_ifs.8 | 10 ++-- sbin/fsdb/fsdb.8 | 2 +- sbin/fsirand/fsirand.8 | 2 +- sbin/i386/cxconfig/cxconfig.8 | 2 +- sbin/i386/fdisk/fdisk.8 | 4 +- sbin/i386/nextboot/nextboot.8 | 4 +- sbin/ifconfig/ifconfig.8 | 12 ++--- sbin/init/init.8 | 4 +- sbin/ip6fw/ip6fw.8 | 12 ++--- sbin/ipfw/ipfw.8 | 22 ++++---- sbin/kget/kget.8 | 2 +- sbin/kldload/kldload.8 | 2 +- sbin/kldstat/kldstat.8 | 2 +- sbin/kldunload/kldunload.8 | 4 +- sbin/ldconfig/ldconfig.8 | 4 +- sbin/md5/md5.1 | 2 +- sbin/mknod/mknod.8 | 4 +- sbin/mount/getmntopts.3 | 8 +-- sbin/mount/mount.8 | 8 +-- sbin/mount_cd9660/mount_cd9660.8 | 2 +- sbin/mount_ext2fs/mount_ext2fs.8 | 2 +- sbin/mount_hpfs/mount_hpfs.8 | 2 +- sbin/mount_ifs/getmntopts.3 | 8 +-- sbin/mount_ifs/mount.8 | 8 +-- sbin/mount_msdos/mount_msdos.8 | 4 +- sbin/mount_msdosfs/mount_msdosfs.8 | 4 +- sbin/mount_nfs/mount_nfs.8 | 4 +- sbin/mount_ntfs/mount_ntfs.8 | 2 +- sbin/mount_null/mount_null.8 | 2 +- sbin/mount_nullfs/mount_nullfs.8 | 2 +- sbin/mount_nwfs/mount_nwfs.8 | 4 +- sbin/mount_portal/mount_portal.8 | 2 +- sbin/mount_portalfs/mount_portalfs.8 | 2 +- sbin/mount_std/mount_std.8 | 4 +- sbin/mount_umap/mount_umap.8 | 2 +- sbin/mount_umapfs/mount_umapfs.8 | 2 +- sbin/mount_union/mount_union.8 | 2 +- sbin/mount_unionfs/mount_unionfs.8 | 2 +- sbin/mountd/exports.5 | 4 +- sbin/mountd/mountd.8 | 2 +- sbin/mountd/netgroup.5 | 2 +- sbin/natd/natd.8 | 10 ++-- sbin/newfs/newfs.8 | 6 +-- sbin/newfs_msdos/newfs_msdos.8 | 2 +- sbin/nextboot/nextboot.8 | 4 +- sbin/nfsd/nfsd.8 | 14 ++--- sbin/nfsiod/nfsiod.8 | 2 +- sbin/nologin/nologin.8 | 2 +- sbin/nos-tun/nos-tun.8 | 2 +- sbin/pc98/fdisk/fdisk.8 | 4 +- sbin/ping/ping.8 | 4 +- sbin/ping6/ping6.8 | 4 +- sbin/quotacheck/quotacheck.8 | 4 +- sbin/reboot/reboot.8 | 2 +- sbin/restore/restore.8 | 42 +++++++-------- sbin/route/route.8 | 11 ++-- sbin/routed/routed.8 | 8 +-- sbin/routed/rtquery/rtquery.8 | 4 +- sbin/savecore/savecore.8 | 4 +- sbin/shutdown/shutdown.8 | 2 +- sbin/slattach/slattach.8 | 8 +-- sbin/spppcontrol/spppcontrol.8 | 2 +- sbin/startslip/startslip.1 | 6 +-- sbin/swapon/swapon.8 | 4 +- sbin/sysctl/sysctl.8 | 6 +-- sbin/tunefs/tunefs.8 | 2 +- sbin/umount/umount.8 | 4 +- sbin/vinum/vinum.8 | 35 +++++++------ share/examples/mdoc/example.1 | 2 +- share/examples/mdoc/example.4 | 2 +- usr.sbin/mount_nwfs/mount_nwfs.8 | 4 +- usr.sbin/mount_portalfs/mount_portalfs.8 | 2 +- usr.sbin/mountd/exports.5 | 4 +- usr.sbin/mountd/mountd.8 | 2 +- usr.sbin/mountd/netgroup.5 | 2 +- usr.sbin/nfsd/nfsd.8 | 14 ++--- usr.sbin/nologin/nologin.8 | 2 +- 94 files changed, 328 insertions(+), 320 deletions(-) diff --git a/sbin/adjkerntz/adjkerntz.8 b/sbin/adjkerntz/adjkerntz.8 index 15a99e2..512b4cc 100644 --- a/sbin/adjkerntz/adjkerntz.8 +++ b/sbin/adjkerntz/adjkerntz.8 @@ -31,9 +31,9 @@ .Nm adjkerntz .Nd "adjust local time CMOS clock to reflect time zone changes and keep current timezone offset for the kernel" .Sh SYNOPSIS -.Nm adjkerntz +.Nm .Fl i -.Nm adjkerntz +.Nm .Fl a Op Fl s .Sh DESCRIPTION .Nm Adjkerntz diff --git a/sbin/badsect/badsect.8 b/sbin/badsect/badsect.8 index a67767b..a1e4924 100644 --- a/sbin/badsect/badsect.8 +++ b/sbin/badsect/badsect.8 @@ -39,7 +39,7 @@ .Nm badsect .Nd create files to contain bad sectors .Sh SYNOPSIS -.Nm badsect +.Nm .Ar bbdir sector ... .Sh DESCRIPTION .Nm Badsect @@ -120,7 +120,7 @@ A warning is issued if the block is already in use. .Sh BUGS If more than one sector which comprise a file system fragment are bad, you should specify only one of them to -.Nm Ns , +.Nm , as the blocks in the bad sector files actually cover all the sectors in a file system fragment. .Sh HISTORY diff --git a/sbin/bsdlabel/bsdlabel.8 b/sbin/bsdlabel/bsdlabel.8 index 13aa183..109bc08 100644 --- a/sbin/bsdlabel/bsdlabel.8 +++ b/sbin/bsdlabel/bsdlabel.8 @@ -42,27 +42,27 @@ .Nm disklabel .Nd read and write disk pack label .Sh SYNOPSIS -.Nm disklabel +.Nm .Op Fl r .Ar disk -.Nm disklabel +.Nm .Fl w .Op Fl r .Ar disk Ar disktype/auto .Oo Ar packid Oc -.Nm disklabel +.Nm .Fl e .Op Fl r .Ar disk -.Nm disklabel +.Nm .Fl R .Op Fl r .Ar disk Ar protofile -.Nm disklabel +.Nm .Op Fl NW .Ar disk .Pp -.Nm disklabel +.Nm .Fl B .Oo .Fl b Ar boot1 @@ -70,7 +70,7 @@ .Oc .Ar disk .Oo Ar disktype/auto Oc -.Nm disklabel +.Nm .Fl w .Fl B .Oo @@ -79,7 +79,7 @@ .Oc .Ar disk Ar disktype/auto .Oo Ar packid Oc -.Nm disklabel +.Nm .Fl R .Fl B .Oo @@ -114,7 +114,7 @@ is described under each command. .Ss Disk device name .Pp All -.Nm disklabel +.Nm forms require a disk device name, which should always be the raw device name representing the disk or slice. For example .Pa da0 @@ -140,7 +140,7 @@ To examine or save the label on a disk drive, use .Nm without options: .Pp -.Nm disklabel +.Nm .Op Fl r .Ar disk .Pp @@ -167,13 +167,13 @@ is corrupt. .Pp To write a standard label, use the form .Pp -.Nm disklabel +.Nm .Fl w .Op Fl r .Ar disk Ar disktype/auto .Oo Ar packid Oc .Pp -.Nm disklabel +.Nm .Fl w .Op Fl r .Ar disk @@ -241,7 +241,7 @@ described later on in this manual page. .Pp To edit an existing disk label, use the form .Pp -.Nm disklabel +.Nm .Fl e .Op Fl r .Ar disk @@ -262,7 +262,7 @@ was specified. .Pp To restore a disk label from a file, use the form .Pp -.Nm disklabel +.Nm .Fl R .Op Fl r .Ar disk Ar protofile @@ -283,14 +283,14 @@ By default, it is not possible to write to the disk label area at the beginning of a disk. The disk driver silently ignores any attempt to do so. If you need to write to this area (for example, to obliterate the label), use the form .Pp -.Nm disklabel +.Nm .Op Fl W .Ar disk .Pp To disallow writing to the label area after previously allowing it, use the command .Pp -.Nm disklabel +.Nm .Op Fl N .Ar disk .Ss Installing bootstraps @@ -311,7 +311,7 @@ then install the .Fx bootblocks in the slice. .Pp -.Nm disklabel +.Nm .Fl B .Oo .Fl b Ar boot1 @@ -328,7 +328,7 @@ disk, such as This command is typically run on a slice such as .Ar da0s1 . .Pp -.Nm disklabel +.Nm .Fl w .Fl B .Oo @@ -346,7 +346,7 @@ If run on a base disk this command will create a .Dq dangerously-dedicated label. This command is normally run on a slice rather then a base disk. .Pp -.Nm disklabel +.Nm .Fl R .Fl B .Oo @@ -454,9 +454,9 @@ partition for /home (usally all remaining space). Your mileage may vary. .El .Pp -.Nm fdisk -BI da0 +.Nm fdisk Fl BI Ar da0 .Pp -.Nm disklabel +.Nm .Fl w .Fl r .Fl B @@ -464,7 +464,7 @@ Your mileage may vary. auto .Pp .Pp -.Nm disklabel +.Nm .Fl e .Ar da0s1 .Pp diff --git a/sbin/camcontrol/camcontrol.8 b/sbin/camcontrol/camcontrol.8 index cdd26ee..3c89925 100644 --- a/sbin/camcontrol/camcontrol.8 +++ b/sbin/camcontrol/camcontrol.8 @@ -34,56 +34,56 @@ .Nm camcontrol .Nd CAM control program .Sh SYNOPSIS -.Nm camcontrol +.Nm .Aq Ar command .Op device id .Op generic args .Op command args -.Nm camcontrol +.Nm .Ic devlist .Op Fl v -.Nm camcontrol +.Nm .Ic periphlist .Op device id .Op Fl n Ar dev_name .Op Fl u Ar unit_number -.Nm camcontrol +.Nm .Ic tur .Op device id .Op generic args -.Nm camcontrol +.Nm .Ic inquiry .Op device id .Op generic args .Op Fl D .Op Fl S .Op Fl R -.Nm camcontrol +.Nm .Ic start .Op device id .Op generic args -.Nm camcontrol +.Nm .Ic stop .Op device id .Op generic args -.Nm camcontrol +.Nm .Ic eject .Op device id .Op generic args -.Nm camcontrol +.Nm .Ic rescan .Aq bus Ns Op :target:lun -.Nm camcontrol +.Nm .Ic reset .Aq bus Ns Op :target:lun -.Nm camcontrol +.Nm .Ic defects .Op device id .Op generic args .Aq Fl f Ar format .Op Fl P .Op Fl G -.Nm camcontrol +.Nm .Ic modepage .Op device id .Op generic args @@ -91,7 +91,7 @@ .Op Fl P Ar pgctl .Op Fl b | Fl e .Op Fl d -.Nm camcontrol +.Nm .Ic cmd .Op device id .Op generic args @@ -100,21 +100,21 @@ .Bk -words .Op Fl o Ar len Ar fmt Op args .Ek -.Nm camcontrol +.Nm .Ic debug .Op Fl I .Op Fl T .Op Fl S .Op Fl c .Aq all|off|bus Ns Op :target Ns Op :lun -.Nm camcontrol +.Nm .Ic tags .Op device id .Op generic args .Op Fl N Ar tags .Op Fl q .Op Fl v -.Nm camcontrol +.Nm .Ic negotiate .Op device id .Op generic args @@ -127,27 +127,27 @@ .Op Fl U .Op Fl W Ar bus_width .Op Fl v -.Nm camcontrol +.Nm .Ic format .Op device id .Op generic args .Op Fl q .Op Fl w .Op Fl y -.Nm camcontrol +.Nm .Ic help .Sh DESCRIPTION -.Nm camcontrol +.Nm is a utility designed to provide a way for users to access and control the .Fx CAM subsystem. .Pp -.Nm camcontrol +.Nm can cause a loss of data and/or system crashes if used improperly. Even expert users are encouraged to exercise caution when using this command. Novice users should stay away from this utility. .Pp -.Nm camcontrol +.Nm has a number of primary functions, many of which support an optional device identifier. A device identifier can take one of three forms: .Bl -tag -width 01234567890123 @@ -182,7 +182,7 @@ arguments will override a specified bus:target or bus:target:lun, however. .Pp Most of the -.Nm camcontrol +.Nm primary functions support these generic arguments: .Bl -tag -width 01234567890123 .It Fl C Ar count @@ -226,11 +226,11 @@ List all peripheral drivers attached to a given physical device (logical unit). .It Ic tur Send the SCSI test unit ready (0x00) command to the given device. -.Nm camcontrol +.Nm will report whether the device is ready or not. .It Ic inquiry Send a SCSI inquiry command (0x12) to a device. By default, -.Nm camcontrol +.Nm will print out the standard inquiry data, device serial number, and transfer rate information. The user can specify that only certain types of inquiry data be printed: @@ -239,7 +239,7 @@ inquiry data be printed: Get the standard inquiry data. .It Fl S Print out the serial number. If this flag is the only one specified, -.Nm camcontrol +.Nm will not print out "Serial Number" before the value returned by the drive. This is to aid in script writing. .It Fl R @@ -283,11 +283,11 @@ required. Most drives support the physical sector format. Some drives support the logical block format. Many drives, if they don't support the requested format, return the data in an alternate format, along with sense information indicating that the requested data format isn't supported. -.Nm camcontrol +.Nm attempts to detect this, and print out whatever format the drive returns. If the drive uses a non-standard sense code to report that it doesn't support the requested format, -.Nm camcontrol +.Nm will probably see the error as a failure to complete the request. .It Fl G Print out the grown defect list. This is a list of bad blocks that have @@ -301,7 +301,7 @@ If neither nor .Fl G is specified, -.Nm camcontrol +.Nm will print out the number of defects given in the READ DEFECT DATA header returned from the drive. .It Ic modepage @@ -325,9 +325,9 @@ either edit mode page values with the text editor pointed to by his .Ev EDITOR environment variable, or supply mode page values via standard input, using the same format that -.Nm camcontrol +.Nm uses to display mode page values. The editor will be invoked if -.Nm camcontrol +.Nm detects that standard input is terminal. .It Fl l Lists all available mode pages. @@ -428,7 +428,7 @@ determined by using the switch. The meaning of the .Fl v switch for this -.Nm camcontrol +.Nm subcommand is described below. .It Fl q Be quiet, and don't report the number of tags. This is generally used when @@ -437,7 +437,7 @@ setting the number of tags. The verbose flag has special functionality for the .Em tags argument. It causes -.Nm camcontrol +.Nm to print out the tagged queueing related fields of the XPT_GDEV_TYPE CCB: .Bl -tag -width 0123456789012 .It dev_openings @@ -480,7 +480,7 @@ Show or negotiate various communication parameters. Some controllers may not support setting or changing some of these values. For instance, the Adaptec 174x controllers do not support changing a device's sync rate or offset. -.Nm camcontrol +.Nm will not attempt to set the parameter if the controller indicates that it does not support setting the parameter. To find out what the controller supports, use the @@ -522,7 +522,7 @@ current negotiation settings. The verbose switch has special meaning for the .Ic negotiate subcommand. It causes -.Nm camcontrol +.Nm to print out the contents of a Path Inquiry (XPT_PATH_INQ) CCB sent to the controller driver. .It Fl W Ar bus_width @@ -578,24 +578,24 @@ the questions, however. To disable questions, use the argument, below. .It Fl w Issue a non-immediate format command. By default, -.Nm camcontrol +.Nm issues the FORMAT UNIT command with the immediate bit set. This tells the device to immediately return the format command, before the format has actually completed. Then, -.Nm camcontrol +.Nm gathers .Tn SCSI sense information from the device every second to determine how far along in the format process it is. If the .Fl w argument is specified, -.Nm camcontrol +.Nm will issue a non-immediate format command, and will be unable to print any information to let the user know what percentage of the disk has been formatted. .It Fl y Don't ask any questions. By default, -.Nm camcontrol +.Nm will ask the user if he/she really wants to format the disk in question, and also if the default format command timeout is acceptable. The user will not be asked about the timeout if a timeout is specified on the @@ -612,7 +612,7 @@ variable allows the user to specify an alternate mode page format file. The .Ev EDITOR variable determines which text editor -.Nm camcontrol +.Nm starts when editing mode pages. .Sh FILES .Bl -tag -width /usr/share/misc/scsi_modes -compact @@ -632,7 +632,7 @@ fails. .Dl camcontrol tur da0 .Pp Send the SCSI test unit ready command to da0. -.Nm camcontrol +.Nm will report whether the disk is ready, but will not display sense information if the command fails since the .Fl v @@ -648,7 +648,7 @@ printing (with the .Fl v flag) if the command fails. Since error recovery is turned on, the disk will be spun up if it is not currently spinning. -.Nm camcontrol +.Nm will report whether the disk is ready. .Bd -literal -offset indent camcontrol cmd -n cd -u 1 -v -c "3C 00 00 00 00 00 00 00 0e 00" \e @@ -710,7 +710,7 @@ Test Unit Ready command to make the settings take effect. .Xr xpt 4 .Sh HISTORY The -.Nm camcontrol +.Nm command first appeared in .Fx 3.0 . .Pp @@ -739,7 +739,7 @@ The sense information from the test unit ready command would not get printed out, since the first .Xr getopt 3 call in -.Nm camcontrol +.Nm bails out when it sees the second argument to .Fl c .Po @@ -749,5 +749,5 @@ above. Fixing this behavior would take some gross code, or changes to the .Xr getopt 3 interface. The best way to circumvent this problem is to always make sure to specify generic -.Nm camcontrol +.Nm arguments before any command-specific arguments. diff --git a/sbin/ccdconfig/ccdconfig.8 b/sbin/ccdconfig/ccdconfig.8 index d5e9243..9fd3551 100644 --- a/sbin/ccdconfig/ccdconfig.8 +++ b/sbin/ccdconfig/ccdconfig.8 @@ -39,27 +39,27 @@ .Nm ccdconfig .Nd configuration utility for the concatenated disk driver .Sh SYNOPSIS -.Nm ccdconfig +.Nm .Op Fl cv .Ar ccd .Ar ileave .Op Ar flags .Ar dev .Op Ar -.Nm ccdconfig +.Nm .Fl C .Op Fl v .Op Fl f Ar config_file -.Nm ccdconfig +.Nm .Fl u .Op Fl v .Ar ccd .Op Ar -.Nm ccdconfig +.Nm .Fl U .Op Fl v .Op Fl f Ar config_file -.Nm ccdconfig +.Nm .Fl g .Op Fl M Ar core .Op Fl N Ar system @@ -77,7 +77,7 @@ The options are as follows: .Bl -tag -width indent .It Fl c Configure a ccd. This is the default behavior of -.Nm Ns . +.Nm . .It Fl C Configure all ccd devices listed in the ccd configuration file. .It Fl f Ar config_file diff --git a/sbin/clri/clri.8 b/sbin/clri/clri.8 index 7f66ecc..3ea8e8e 100644 --- a/sbin/clri/clri.8 +++ b/sbin/clri/clri.8 @@ -39,7 +39,7 @@ .Nm clri .Nd clear an inode .Sh SYNOPSIS -.Nm clri +.Nm .Ar special_device inode_number ... .Sh DESCRIPTION .Bf -symbolic diff --git a/sbin/comcontrol/comcontrol.8 b/sbin/comcontrol/comcontrol.8 index 4175520..c39928b 100644 --- a/sbin/comcontrol/comcontrol.8 +++ b/sbin/comcontrol/comcontrol.8 @@ -6,7 +6,7 @@ .Nm comcontrol .Nd control a special tty device .Sh SYNOPSIS -.Nm comcontrol +.Nm .Ar special_device .Op dtrwait Ar number .Op drainwait Ar number diff --git a/sbin/cxconfig/cxconfig.8 b/sbin/cxconfig/cxconfig.8 index 5b6d7cb..913e758 100644 --- a/sbin/cxconfig/cxconfig.8 +++ b/sbin/cxconfig/cxconfig.8 @@ -6,7 +6,7 @@ .Nm cxconfig .Nd channel options management utility for Cronyx-Sigma adapter .Sh SYNOPSIS -.Nm cxconfig +.Nm .Op Fl a .Op Ar Op Ar