path: root/sbin
diff options
authorJohn-Mark Gurney <jmg@FreeBSD.org>2013-10-26 15:05:27 +0000
committerJohn-Mark Gurney <jmg@FreeBSD.org>2013-10-26 15:05:27 +0000
commit8cde1e8a69fd5506948d93538ca101efd782845a (patch)
treec7d108c84cf97bff7e625786e489bd1474d43de6 /sbin
parenta4c821f9b25a2365a98fb2336bb0b17b91e6f9ea (diff)
Document that -a will output the device name when -u is not specified..
when -u is specified it is not... update the docs to say that you can use full device names w/ -u, and update the examples... Submitted by: #vbsdcon MFC after: 3 days
Notes: svn path=/head/; revision=257165
Diffstat (limited to 'sbin')
1 files changed, 12 insertions, 6 deletions
diff --git a/sbin/mdconfig/mdconfig.8 b/sbin/mdconfig/mdconfig.8
index 9e3089655ca6..b6bf7c3e7843 100644
--- a/sbin/mdconfig/mdconfig.8
+++ b/sbin/mdconfig/mdconfig.8
@@ -89,6 +89,9 @@ Options indicate an action to be performed:
Attach a memory disk.
This will configure and attach a memory disk with the
parameters specified and attach it to the system.
+If the
+.Fl u Ar unit
+option is not provided, the newly created device name will be printed on stdout.
.It Fl d
Detach a memory disk from the system and release all resources.
.It Fl r
@@ -209,9 +212,12 @@ that might adversely affect the system.
Enable/disable readonly mode.
.It Fl u Ar unit
-Request a specific unit number for the
+Request a specific unit number or device name for the
.Xr md 4
device instead of automatic allocation.
+If a device name is specified, it must be start with
+.Dq md
+followed by the unit number.
The last form,
@@ -237,19 +243,19 @@ with
.Pa /tmp/boot.flp
as backing storage:
-.Dl mdconfig -a -t vnode -f /tmp/boot.flp -u 4
+.Dl mdconfig -a -t vnode -f /tmp/boot.flp -u md4
Detach and free all resources used by
.Pa /dev/md4 :
-.Dl mdconfig -d -u 4
+.Dl mdconfig -d -u md4
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
+mdconfig -a -t swap -s 128M -u md10
newfs -U /dev/md10
mount /dev/md10 /tmp
chmod 1777 /tmp
@@ -263,7 +269,7 @@ are implied
.Pc :
.Bd -literal -offset indent
dd if=/dev/zero of=somebackingfile bs=1k count=5k
-mdconfig -f somebackingfile -u 0
+mdconfig -f somebackingfile -u md0
bsdlabel -w md0 auto
newfs md0c
mount /dev/md0c /mnt
@@ -290,7 +296,7 @@ is used to skip over the header information, positioning
.Pa md1.nop
to the start of the filesystem in the image.
.Bd -literal -offset indent
-mdconfig -f diskimage.img -u 1
+mdconfig -f diskimage.img -u md1
gnop create -o 512K md1
mount /dev/md1.nop /mnt