svn commit: r187264 - stable/7/sbin/mdconfig

[Giorgos Keramidas]

Author: keramida (doc committer)
Date: Thu Jan 15 02:57:07 2009
New Revision: 187264
URL: http://svn.freebsd.org/changeset/base/187264

Log:
  MFC 173539 from /head
  
  * Expand the example descriptions, fix mdoc-bugs in "(-a and -t
    vnode are implied)" and reuse it near the cd9660 example.
  * Spell 'backing store' as two words.

Modified:
  stable/7/sbin/mdconfig/   (props changed)
  stable/7/sbin/mdconfig/mdconfig.8

Modified: stable/7/sbin/mdconfig/mdconfig.8
==============================================================================
--- stable/7/sbin/mdconfig/mdconfig.8	Thu Jan 15 02:54:40 2009	(r187263)
+++ stable/7/sbin/mdconfig/mdconfig.8	Thu Jan 15 02:57:07 2009	(r187264)
@@ -41,7 +41,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd November 9, 2007
+.Dd November 11, 2007
 .Dt MDCONFIG 8
 .Os
 .Sh NAME
@@ -97,7 +97,7 @@ panic a system.
 .It Cm vnode
 A file specified with
 .Fl f Ar file
-becomes the backingstore for this memory disk.
+becomes the backing store for this memory disk.
 .It Cm swap
 Storage for this type of memory disk is allocated from buffer
 memory.
@@ -197,7 +197,7 @@ To create a disk named
 .Pa /dev/md4
 with
 .Pa /tmp/boot.flp
-as backing:
+as backing storage:
 .Pp
 .Dl mdconfig -a -t vnode -f /tmp/boot.flp -u 4
 .Pp
@@ -206,7 +206,9 @@ To detach and free all resources used by
 .Pp
 .Dl mdconfig -d -u 4
 .Pp
-To create and mount a 128MByte swap backed file system on
+To create a 128MByte swap backed disk, initialize an
+.Xr ffs 7
+file system on it, and mount it on
 .Pa /tmp :
 .Bd -literal -offset indent
 mdconfig -a -t swap -s 128M -u 10
@@ -215,10 +217,10 @@ mount /dev/md10 /tmp
 chmod 1777 /tmp
 .Ed
 .Pp
-To create a 5MB file-backed disk (
-.Fl -a
+To create a 5MB file-backed disk
+.Ns ( Fl a
 and
-.Fl -t Ar vnode
+.Fl t Ar vnode
 are implied):
 .Bd -literal -offset indent
 dd if=/dev/zero of=somebackingfile bs=1k count=5k
@@ -228,12 +230,21 @@ newfs md0c
 mount /dev/md0c /mnt
 .Ed
 .Pp
-To mount an ISO 9660 CD image file:
+To create an
+.Xr md 4
+device out of an ISO 9660 CD image file
+.Ns ( Fl a
+and
+.Fl t Ar vnode
+are implied), using the first available
+.Xr md 4
+device, and then mount the new memory disk:
 .Bd -literal -offset indent
-mount -t cd9660 /dev/`mdconfig -a -t vnode -f cdimage.iso` /mnt
+mount -t cd9660 /dev/`mdconfig -f cdimage.iso` /mnt
 .Ed
 .Sh SEE ALSO
 .Xr md 4 ,
+.Xr ffs 7 ,
 .Xr bsdlabel 8 ,
 .Xr fdisk 8 ,
 .Xr mdmfs 8 ,