summaryrefslogtreecommitdiffstats
path: root/sbin/mdconfig
diff options
context:
space:
mode:
authorbjk <bjk@FreeBSD.org>2012-04-09 01:20:50 +0000
committerbjk <bjk@FreeBSD.org>2012-04-09 01:20:50 +0000
commitee116ad85c6fac2cea158c7afcccf60835267977 (patch)
tree0682e6edcfe4be9d4003fcc8f167bf2a85380002 /sbin/mdconfig
parent7e7e5aed30ce08546c841f9c606c4c9e6f11d8cc (diff)
downloadFreeBSD-src-ee116ad85c6fac2cea158c7afcccf60835267977.zip
FreeBSD-src-ee116ad85c6fac2cea158c7afcccf60835267977.tar.gz
Fix a couple of style issues. Tweak grammar and markup while here.
Approved by: hrs (mentor)
Diffstat (limited to 'sbin/mdconfig')
-rw-r--r--sbin/mdconfig/mdconfig.849
1 files changed, 27 insertions, 22 deletions
diff --git a/sbin/mdconfig/mdconfig.8 b/sbin/mdconfig/mdconfig.8
index 95fdfe8..e4fa956 100644
--- a/sbin/mdconfig/mdconfig.8
+++ b/sbin/mdconfig/mdconfig.8
@@ -41,7 +41,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd June 21, 2008
+.Dd March 21, 2012
.Dt MDCONFIG 8
.Os
.Sh NAME
@@ -87,7 +87,7 @@ parameters specified and attach it to the system.
Detach a memory disk from the system and release all resources.
.It Fl t Ar type
Select the type of the memory disk.
-.Bl -tag -width "preload"
+.Bl -tag -width "malloc"
.It Cm malloc
Storage for this type of memory disk is allocated with
.Xr malloc 9 .
@@ -104,31 +104,35 @@ becomes the backing store for this memory disk.
.It Cm swap
Storage for this type of memory disk is allocated from buffer
memory.
-Pages get pushed out to the swap when the system is under memory
+Pages get pushed out to swap when the system is under memory
pressure, otherwise they stay in the operating memory.
Using
.Cm swap
-backing is generally preferable over
+backing is generally preferred instead of using
.Cm malloc
backing.
.El
.It Fl f Ar file
-Filename to use for the vnode type memory disk. Options
+Filename to use for the vnode type memory disk.
+The
.Fl a
and
.Fl t Ar vnode
-are implied if not specified.
+options are implied if not specified.
.It Fl l
List configured devices.
If given with
.Fl u ,
display details about that particular device.
-If
+If the
.Fl v
-option specified, show all details.
+option is specified, show all details.
.It Fl n
-When printing md device names, print only the unit number without the
-md prefix.
+When printing
+.Xr md 4
+device names, print only the unit number without the
+.Xr md 4
+prefix.
.It Fl s Ar size
Size of the memory disk.
.Ar Size
@@ -137,11 +141,12 @@ is the number of 512 byte sectors unless suffixed with a
or
.Cm t
which
-denotes byte, kilobyte, megabyte, gigabyte and terabyte respectively. Options
+denotes byte, kilobyte, megabyte, gigabyte and terabyte respectively.
+The
.Fl a
and
.Fl t Ar swap
-are implied if not specified.
+options are implied if not specified.
.It Fl S Ar sectorsize
Sectorsize to use for malloc backed device.
.It Fl x Ar sectors/track
@@ -175,12 +180,12 @@ Allocate and reserve all needed storage from the start, rather than as needed.
.It Oo Cm no Oc Ns Cm cluster
Enable clustering on this disk.
.It Oo Cm no Oc Ns Cm compress
-Enable/Disable compression features to reduce memory usage.
+Enable/disable compression features to reduce memory usage.
.It Oo Cm no Oc Ns Cm force
-Disable/Enable extra sanity checks to prevent the user from doing something
+Disable/enable extra sanity checks to prevent the user from doing something
that might adversely affect the system.
.It Oo Cm no Oc Ns Cm readonly
-Enable/Disable readonly mode.
+Enable/disable readonly mode.
.El
.It Fl u Ar unit
Request a specific unit number for the
@@ -197,15 +202,15 @@ is provided for convenience as an abbreviation of
.Fl t Ar vnode
.Fl f Ar file .
.Sh EXAMPLES
-To create a 4 megabyte
+Create a 4 megabyte
.Xr malloc 9
backed memory disk.
-The name of the allocated unit will be output on stdout like
+The name of the allocated unit will be printed on stdout, such as
.Dq Li md3 :
.Pp
.Dl mdconfig -a -t malloc -s 4m
.Pp
-To create a disk named
+Create a disk named
.Pa /dev/md4
with
.Pa /tmp/boot.flp
@@ -213,12 +218,12 @@ as backing storage:
.Pp
.Dl mdconfig -a -t vnode -f /tmp/boot.flp -u 4
.Pp
-To detach and free all resources used by
+Detach and free all resources used by
.Pa /dev/md4 :
.Pp
.Dl mdconfig -d -u 4
.Pp
-To create a 128MByte swap backed disk, initialize an
+Create a 128MByte swap backed disk, initialize an
.Xr ffs 7
file system on it, and mount it on
.Pa /tmp :
@@ -229,7 +234,7 @@ mount /dev/md10 /tmp
chmod 1777 /tmp
.Ed
.Pp
-To create a 5MB file-backed disk
+Create a 5MB file-backed disk
.Ns ( Fl a
and
.Fl t Ar vnode
@@ -242,7 +247,7 @@ newfs md0c
mount /dev/md0c /mnt
.Ed
.Pp
-To create an
+Create an
.Xr md 4
device out of an ISO 9660 CD image file
.Ns ( Fl a
OpenPOWER on IntegriCloud