1
0
mirror of https://git.FreeBSD.org/src.git synced 2024-12-24 11:29:10 +00:00

Assorted markup, grammar, and spelling fixes.

This commit is contained in:
Ruslan Ermilov 2004-05-17 08:35:43 +00:00
parent 44d907a2fc
commit d04b5dfe6c
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=129327
19 changed files with 166 additions and 137 deletions

View File

@ -40,30 +40,28 @@
.Sh SYNOPSIS
.Nm
.Op Fl A
.Op Fl f
.Ar disk/file
.Ar disk | Fl f Ar file
.Nm
.Fl w
.Op Fl \&An
.Op Fl B Op Fl b Ar boot
.Op Fl m Ar machine
.Op Fl f
.Ar disk/file
.Ar disk | Fl f Ar file
.Op Ar type
.Nm
.Fl e
.Op Fl \&An
.Op Fl B Op Fl b Ar boot
.Op Fl m Ar machine
.Op Fl f
.Ar disk/file
.Ar disk | Fl f Ar file
.Nm
.Fl R
.Op Fl \&An
.Op Fl B Op Fl b Ar boot
.Op Fl m Ar machine
.Op Fl f
.Ar disk/file protofile
.Ar disk | Fl f Ar file
.Ar protofile
.Sh DESCRIPTION
The
.Nm
@ -75,9 +73,9 @@ In addition,
.Nm
can install bootstrap code.
.Ss Disk Device Name
When specifying the device (i.e. when the
When specifying the device (i.e., when the
.Fl f
option is not used),
option is not used),
the
.Pa /dev/
path prefix may be omitted;

View File

@ -79,7 +79,9 @@ The device must support low-level console operations.
Adding a device will place it at the front of the list of console
devices; the first device is used for the high level console.
.Pp
The
.Ar console
argument
is the name of a console device in
.Pa /dev ;
the name of the directory may be omitted.

View File

@ -200,7 +200,7 @@ script string defined by
for the output device of each volume.
This child pipeline's
.Dv stdin
.Pa ( /dev/fd/0 )
.Pq Pa /dev/fd/0
is redirected from the
.Nm
output stream, and the environment variable
@ -230,19 +230,25 @@ To obtain a consistent dump image,
.Nm
takes a snapshot of the file system in the
.Pa .snap
directory in the root of the filesystem being dumped and
directory in the root of the file system being dumped and
then does a dump of the snapshot.
The snapshot is removed when the dump is complete.
This option is ignored for unmounted or read-only filesystems.
This option is ignored for unmounted or read-only file systems.
If the
.Pa .snap
directory does not exist in the root of the filesystem being dumped,
the dump will fail.
directory does not exist in the root of the file system being dumped,
the
.Nm
will fail.
This problem can be corrected by creating a
.Pa .snap
directory in the root of the filesystem to be dumped;
its owner should be root, its group should be operator,
and its mode should be 0770.
directory in the root of the file system to be dumped;
its owner should be
.Dq Li root ,
its group should be
.Dq Li operator ,
and its mode should be
.Dq Li 0770 .
.It Fl n
Whenever
.Nm
@ -439,7 +445,7 @@ Pathname of the remote
.Xr rmt 8
program.
.It Ev RSH
Pathname of remote shell program, if not
Pathname of a remote shell program, if not
.Xr rsh 1 .
.El
.Sh FILES
@ -473,14 +479,18 @@ abnormal termination is indicated with an exit code of 3.
Fewer than 32 read errors on the file system are ignored, though all
errors will generate a warning message.
This is a bit of a compromise.
In practice it is possible to generate read errors when doing dumps
In practice, it is possible to generate read errors when doing dumps
on mounted partitions if the file system is being modified while the
dump is running.
.Nm
is running.
Since dumps are often done in an unattended fashion using
.Xr cron 8
jobs asking for Operator intervention would result in the dump dying.
However there is nothing wrong with a dump tape written when this sort
of read error occurs and there is no reason to terminate the dump.
jobs asking for Operator intervention would result in the
.Nm
dying.
However, there is nothing wrong with a dump tape written when this sort
of read error occurs, and there is no reason to terminate the
.Nm .
.Pp
Each reel requires a new process, so parent processes for
reels already written just hang around until the entire tape

View File

@ -89,9 +89,9 @@ FAT (MS-DOS) file systems must always be cleaned in the foreground.
A non-zero exit code is always returned for this option.
.It Fl f
Force
.Nm
.Nm
to check
.Sq clean
.Dq clean
file systems when preening.
.It Fl n
Causes

View File

@ -172,8 +172,10 @@ To attach an encrypted device:
.Pp
.Dl "gbde attach ad0s1f -l /etc/ad0s1f.lock"
.Pp
The encrypted device has the suffix ``.bde'' so a typical
command to create and mount a filesystem would be:
The encrypted device has the suffix
.Pa .bde
so a typical
command to create and mount a file system would be:
.Pp
.Dl "newfs /dev/ad0s1f.bde"
.Dl "mount /dev/ad0s1f.bde /secret"
@ -183,7 +185,7 @@ To detach an encrypted device:
.Dl "gbde detach ad0s1f"
.Pp
Please notice that detaching an encrypted device corresponds to
physically removing it, do not forget to unmount the filesystem first.
physically removing it, do not forget to unmount the file system first.
.Pp
To initialize the second key using a detached lockfile and a trivial
pass-phrase:

View File

@ -286,10 +286,10 @@ interface might support the use of either
.Tn AUI
or twisted pair connectors.
Setting the media type to
.Dq 10base5/AUI
.Dq Li 10base5/AUI
would change the currently active connector to the AUI port.
Setting it to
.Dq 10baseT/UTP
.Dq Li 10baseT/UTP
would activate twisted pair.
Refer to the interfaces' driver
specific documentation or man page for a complete list of the
@ -312,11 +312,11 @@ operating mode on the interface to
.Ar mode .
For IEEE 802.11 wireless interfaces that support multiple operating modes
this directive is used to select between 802.11a
.Pq Dq 11a ,
.Pq Dq Li 11a ,
802.11b
.Pq Dq 11b ,
.Pq Dq Li 11b ,
and 802.11g
.Pq Dq 11g
.Pq Dq Li 11g
operating modes.
.It Cm name Ar name
Set the interface name to
@ -627,10 +627,10 @@ in infrastructure mode.
Not all adaptors support all modes.
The set of
valid modes is
.Dq none ,
.Dq open ,
.Dq Li none ,
.Dq Li open ,
and
.Dq shared .
.Dq Li shared .
Modes are case insensitive.
.It Cm powersave
For IEEE 802.11 wireless interfaces, enable powersave mode.
@ -641,26 +641,31 @@ For IEEE 802.11 wireless interfaces, set the desired max powersave sleep
time in milliseconds.
.It Cm protmode Ar technique
For IEEE 802.11 wireless interfaces operating in 11g, use the specified
technique for protecting OFDM frames in a mixed 11b/11g network.
.Ar technique
for protecting OFDM frames in a mixed 11b/11g network.
The set of valid techniques is
.Dq off ,
.Dq cts
.Dq Li off ,
.Dq Li cts
(CTS to self),
and
.Dq rtscts
.Dq Li rtscts
(RTS/CTS).
Technique names are case insensitive.
.It Cm rtsthreshold Ar length
For IEEE 802.11 wireless interfaces, set the threshold for which
For IEEE 802.11 wireless interfaces, set the threshold for which
transmitted frames are preceded by transmission of an
RTS
control frame.
.Ar Length
The
.Ar length
argument
is the frame size in bytes and must be in the range 1 to 2312.
Not all adaptors support setting the RTS threshold.
.It Cm txpower Ar power
For IEEE 802.11 wireless interfaces, set the power used to transmit frames.
.Ar Power
The
.Ar power
argument
is a unitless value in the range 0 to 100 that is interpreted
by drivers to derive a device-specific value.
Out of range values are truncated.
@ -671,20 +676,21 @@ Not all adaptors support changing the transmit power.
For IEEE 802.11 wireless interfaces, set the desired WEP mode.
Not all adaptors support all modes.
The set of valid modes is
.Dq off ,
.Dq on ,
.Dq Li off ,
.Dq Li on ,
and
.Dq mixed .
.Dq Mixed
.Dq Li mixed .
The
.Dq Li mixed
mode explicitly tells the adaptor to allow association with access
points which allow both encrypted and unencrypted traffic.
On these adaptors,
.Dq on
.Dq Li on
means that the access point must only allow encrypted connections.
On other adaptors,
.Dq on
.Dq Li on
is generally another name for
.Dq mixed .
.Dq Li mixed .
Modes are case insensitive.
.It Cm weptxkey Ar index
For IEEE 802.11 wireless interfaces, set the WEP key to be used for

View File

@ -153,7 +153,7 @@ variable to the required security level.
.Pp
If
.Nm
is run in a jail the security level of the
is run in a jail, the security level of the
.Dq host system
will not be effected.
Part of the information set up in the kernel to support a jail

View File

@ -70,7 +70,8 @@ Run a built-in test script.
.Sh DIAGNOSTICS
The
.Nm
program exits 0 on success, and 1 if at least one of the input files could not be read.
utility exits 0 on success,
and 1 if at least one of the input files could not be read.
.Sh SEE ALSO
.Xr cksum 1
.Rs

View File

@ -41,7 +41,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd December 31, 2000
.Dd March 10, 2004
.Dt MDCONFIG 8
.Os
.Sh NAME
@ -52,12 +52,9 @@
.Fl a
.Fl t Ar type
.Op Fl n
.Oo
.Fl o
.Oo Cm no Oc Ns Ar option
.Oc
.Op Fl s Ar size
.Oo Fl o Oo Cm no Oc Ns Ar option Oc ...
.Op Fl f Ar file
.Op Fl s Ar size
.Op Fl S Ar sectorsize
.Op Fl u Ar unit
.Op Fl x Ar sectors/track
@ -127,11 +124,15 @@ denotes kilobyte, megabyte and gigabyte respectively.
.It Fl S Ar sectorsize
Sectorsize to use for malloc backed device.
.It Fl x Ar sectors/track
See description of
.Fl y
below.
See the description of the
.Fl y
option below.
.It Fl y Ar heads/cylinder
For malloc or vnode backed devices, the
For
.Cm malloc
or
.Cm vnode
backed devices, the
.Fl x
and
.Fl y
@ -142,7 +143,11 @@ other devices.
Set or reset options.
.Bl -tag -width indent
.It Oo Cm no Oc Ns Cm async
For vnode backed devices: avoid IO_SYNC for increased performance but
For
.Cm vnode
backed devices: avoid
.Dv IO_SYNC
for increased performance but
at the risk of deadlocking the entire kernel.
.It Oo Cm no Oc Ns Cm reserve
Allocate and reserve all needed storage from the start, rather than as needed.

View File

@ -25,7 +25,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd August 5, 2001
.Dd February 26, 2004
.Dt MDMFS 8
.Os
.Sh NAME
@ -36,7 +36,7 @@
driver
.Sh SYNOPSIS
.Nm
.Op Fl DLMNSUX
.Op Fl DLlMNSUX
.Op Fl a Ar maxcontig
.Op Fl b Ar block-size
.Op Fl c Ar cylinders
@ -45,7 +45,6 @@ driver
.Op Fl F Ar file
.Op Fl f Ar frag-size
.Op Fl i Ar bytes
.Op Fl l
.Op Fl m Ar percent-free
.Op Fl n Ar rotational-positions
.Op Fl O Ar optimization
@ -58,7 +57,7 @@ driver
.Ar mount-point
.Nm
.Fl C
.Op Fl NU
.Op Fl lNU
.Op Fl a Ar maxcontig
.Op Fl b Ar block-size
.Op Fl c Ar cylinders
@ -164,7 +163,7 @@ The fragment size of the file system in bytes.
.It Fl i Ar bytes
Number of bytes per inode.
.It Fl l
Enables multilabel MAC on the new file system.
Enable multilabel MAC on the new file system.
.It Fl L
Show the output of the helper programs.
By default,

View File

@ -28,7 +28,7 @@
.\" @(#)mknod.8 8.2 (Berkeley) 12/11/93
.\" $FreeBSD$
.\"
.Dd December 11, 1993
.Dd December 29, 2003
.Dt MKNOD 8
.Os
.Sh NAME
@ -102,15 +102,15 @@ will cause the number to be interpreted as octal.
.Pp
The
.Nm
tool can be used to recreate deleted device nodes under a
.Xr devfs 5 ,
mount point by invoking it using dummy arguments. Example:
.Bd -literal -offset indent
mknod cd0 c 0 0
.Ed
utility can be used to recreate deleted device nodes under a
.Xr devfs 5
mount point by invoking it using dummy arguments.
Example:
.Pp
Where
.Fa cd0
.Dl "mknod cd0 c 0 0"
.Pp
where
.Dq Li cd0
is the name of the deleted device node.
.Sh COMPATIBILITY
The

View File

@ -148,8 +148,8 @@ system.
If the file system supports multilabel operation, individual labels will
be maintained for each object in the file system, rather than using a
single label for all obejcts.
An alternative to
.Em -l
An alternative to the
.Fl l
flag in
.Xr tunefs 8 .
See

View File

@ -32,7 +32,7 @@
.\" @(#)mount_cd9660.8 8.3 (Berkeley) 3/27/94
.\" $FreeBSD$
.\"
.Dd March 27, 1994
.Dd September 26, 2003
.Dt MOUNT_CD9660 8
.Os
.Sh NAME
@ -41,9 +41,9 @@
.Sh SYNOPSIS
.Nm
.Op Fl begjrv
.Op Fl C Ar charset
.Op Fl o Ar options
.Op Fl s Ar startsector
.Op Fl C Ar charset
.Ar special | node
.Sh DESCRIPTION
The
@ -152,6 +152,6 @@ The
utility first appeared in
.Bx 4.4 .
.Pp
The unicode conversion routine was added by
The Unicode conversion routine was added by
.An Ryuichiro Imura Aq imura@ryu16.org
at 2003.
in 2003.

View File

@ -157,8 +157,10 @@ This forces
.Fl s .
.\".It Fl G
.\"This option causes the file system to be interpreted as an Atari-Gemdos
.\"file system. The differences to the MS-DOS file system are minimal and
.\"limited to the boot block. This option enforces
.\"file system.
.\"The differences to the MS-DOS file system are minimal and
.\"limited to the boot block.
.\"This option enforces
.\".Fl s .
.It Fl L Ar locale
Specify locale name used for file name conversions
@ -168,22 +170,25 @@ By default ISO 8859-1 assumed as local character set.
Specify the MS-DOS code page (aka IBM/OEM code page) name used for
file name conversions for DOS names.
.It Fl W Ar table
This option is remained for backward compatibility purpose, and will be
removed in the future. Please do not use this option.
.Bf Em
This option is preserved for backward compatibility purpose only,
and will be removed in the future.
Please avoid using this option.
.Ef
.Pp
Specify text file name with conversion table: iso22dos, iso72dos, koi2dos,
koi8u2dos.
Specify text file name with conversion table:
.Pa iso22dos , iso72dos , koi2dos , koi8u2dos .
.El
.Sh EXAMPLES
To mount a Russian msdos file system located in /dev/ad1s1:
.Bd -literal -offset indent
# mount_msdosfs -L ru_RU.KOI8-R -D CP866 /dev/ad1s1 /mnt
.Ed
To mount a Russian MS-DOS file system located in
.Pa /dev/ad1s1 :
.Pp
To mount a Japanese msdos file system located in /dev/ad1s1:
.Bd -literal -offset indent
# mount_msdosfs -L ja_JP.eucJP -D CP932 /dev/ad1s1 /mnt
.Ed
.Dl "mount_msdosfs -L ru_RU.KOI8-R -D CP866 /dev/ad1s1 /mnt"
.Pp
To mount a Japanese MS-DOS file system located in
.Pa /dev/ad1s1 :
.Pp
.Dl "mount_msdosfs -L ja_JP.eucJP -D CP932 /dev/ad1s1 /mnt"
.Sh SEE ALSO
.Xr mount 2 ,
.Xr unmount 2 ,

View File

@ -97,9 +97,11 @@ translation table.
See
.Xr mount_msdosfs 8
for the description of this option.
This option is remained for backward compatibility purpose, so
please do not use this option. This option will be removed in
the future.
.Bf Em
This option is preserved for backward compatibility purpose only,
and will be removed in the future.
Please do not use this option.
.Ef
.El
.Sh FEATURES
NTFS file attributes are accessed in following way:
@ -115,28 +117,23 @@ Default is $DATA.
is an attribute name.
Default is none.
.Sh EXAMPLES
To mount an ntfs volume located in
To mount an NTFS volume located in
.Pa /dev/ad1s1 :
.Bd -literal -offset indent
# mount_ntfs /dev/ad1s1 /mnt
.Ed
.Pp
.Dl "mount_ntfs /dev/ad1s1 /mnt"
.Pp
To get the volume name (in Unicode):
.Bd -literal -offset indent
# cat /mnt/\\$Volume:\\$VOLUME_NAME
.Ed
.Pp
.Dl "cat /mnt/\e$Volume:\e$VOLUME_NAME"
.Pp
To read directory raw data:
.Bd -literal -offset indent
# cat /mnt/foodir:\\$INDEX_ROOT:\\$I30
.Ed
.Pp
To mount a
.Pa Japanese
ntfs volume located in /dev/ad0s1:
.Bd -literal -offset indent
# mount_ntfs -C eucJP /dev/ad0s1 /mnt
.Ed
.Dl "cat /mnt/foodir:\e$INDEX_ROOT:\e$I30"
.Pp
To mount a Japanese NTFS volume located in
.Pa /dev/ad0s1 :
.Pp
.Dl "mount_ntfs -C eucJP /dev/ad0s1 /mnt"
.Sh WRITING
There is limited writing ability.
Limitations: file must be nonresident
@ -160,9 +157,9 @@ The
utility first appeared in
.Fx 3.0 .
.Pp
The unicode conversion routine was added by
The Unicode conversion routine was added by
.An Ryuichiro Imura Aq imura@ryu16.org
at 2003.
in 2003.
.Sh AUTHORS
The NTFS kernel implementation,
.Nm

View File

@ -89,7 +89,7 @@ The default format is UFS2.
.It Fl T Ar disktype
For backward compatibility.
.It Fl U
Enables soft updates on the new file system.
Enable soft updates on the new file system.
.It Fl a Ar maxcontig
Specify the maximum number of contiguous blocks that will be
laid out before forcing a rotational delay.
@ -146,7 +146,7 @@ to create more inodes a smaller number should be given.
One inode is required for each distinct file, so this value effectively
specifies the average file size on the file system.
.It Fl l
Enables multilabel MAC on the new file system.
Enable multilabel MAC on the new file system.
.It Fl m Ar free-space
The percentage of space reserved from normal users; the minimum free
space threshold.
@ -217,8 +217,8 @@ on file systems that contain many small files.
.Xr fdformat 1 ,
.Xr disktab 5 ,
.Xr fs 5 ,
.Xr camcontrol 8 ,
.Xr bsdlabel 8 ,
.Xr camcontrol 8 ,
.Xr dumpfs 8 ,
.Xr fsck 8 ,
.Xr mount 8 ,

View File

@ -316,7 +316,7 @@ script string defined by
as the input for every volume in the backup.
This child pipeline's
.Dv stdout
.Pa ( /dev/fd/1 )
.Pq Pa /dev/fd/1
is redirected to the
.Nm
input stream, and the environment variable

View File

@ -28,7 +28,7 @@
.\" @(#)route.8 8.3 (Berkeley) 3/19/94
.\" $FreeBSD$
.\"
.Dd June 8, 2001
.Dd November 10, 2003
.Dt ROUTE 8
.Os
.Sh NAME

View File

@ -112,7 +112,7 @@ The
packet generated contains a list of known routes, each marked
with a "hop count" metric (a count of 16 or greater is
considered "infinite").
Th advertised metric for a route reflects the metrics associated
The advertised metric for a route reflects the metrics associated
with interfaces
(see
.Xr ifconfig 8 )
@ -228,7 +228,9 @@ is received), there is a single default route and a variable number of
redirected host routes in the kernel table.
On a host with more than one network interface,
this default route will be via only one of the interfaces.
Thus, multi-homed hosts running with \f3\-q\f1 might need
Thus, multi-homed hosts running with
.Fl q
might need
.Cm no_rdisc
described below.
.Pp
@ -514,16 +516,15 @@ a line starting with
.Cm if=remote(Hname) ,
etc. should be used.
.Ss Parameters
.Pp
Lines that start with neither "net" nor "host" must consist of one
or more of the following parameter settings, separated by commas or
blanks:
.Bl -tag -width Ds
.It Cm if Ns \&= Ns Ar ifname
.Bl -tag -width indent
.It Cm if Ns = Ns Ar ifname
indicates that the other parameters on the line apply to the interface
name
.Ar ifname .
.It Cm subnet Ns \&= Ns Ar nname[/mask][,metric]
.It Cm subnet Ns = Ns Ar nname Ns Oo / Ns Ar mask Oc Ns Op , Ns Ar metric
advertises a route to network
.Ar nname
with mask
@ -535,17 +536,20 @@ The network number must specify a full, 32-bit value, as in 192.0.2.0
instead of 192.0.2.
.Pp
Do not use this feature unless necessary. It is dangerous.
.It Cm ripv1_mask Ns \&= Ns Ar nname/mask1,mask2
.It Cm ripv1_mask Ns = Ns Ar nname Ns / Ns Ar mask1 , Ns Ar mask2
specifies that netmask of the network of which
.Cm nname/mask1\f1
.Ar nname Ns / Ns Ar mask1
is
a subnet should be
.Cm mask2 .
For example \f2ripv1_mask=192.0.2.16/28,27\f1 marks 192.0.2.16/28
.Ar mask2 .
For example,
.Dq Li ripv1_mask=192.0.2.16/28,27
marks 192.0.2.16/28
as a subnet of 192.0.2.0/27 instead of 192.0.2.0/24.
It is better to turn on RIPv2 instead of using this facility, for example
with \f2ripv2_out\f1.
.It Cm passwd Ns \&= Ns Ar XXX[|KeyID[start|stop]]
with
.Cm ripv2_out .
.It Cm passwd Ns = Ns Ar XXX[|KeyID[start|stop]]
specifies a RIPv2 cleartext password that will be included on
all RIPv2 responses sent, and checked on all RIPv2 responses received.
Any blanks, tab characters, commas, or '#', '|', or NULL characters in the
@ -720,5 +724,5 @@ The
.Nm
utility appeared in
.Bx 4.2 .
\" LocalWords: loopback ICMP rtquery ifconfig multicasting Solicitations RIPv
\" LocalWords: netstat rdisc
.\" LocalWords: loopback ICMP rtquery ifconfig multicasting Solicitations RIPv
.\" LocalWords: netstat rdisc