2 .\" Copyright (c) 2001 Dima Dorfman.
3 .\" All rights reserved.
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\" notice, this list of conditions and the following disclaimer in the
12 .\" documentation and/or other materials provided with the distribution.
14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 .Nd configure and mount an in-memory file system using the
41 .Op Fl b Ar block-size
42 .Op Fl c Ar blocks-per-cylinder-group
43 .Op Fl d Ar max-extent-size
44 .Op Fl E Ar path-mdconfig
49 .Op Fl m Ar percent-free
50 .Op Fl O Ar optimization
51 .Op Fl o Ar mount-options
52 .Op Fl p Ar permissions
56 .Op Fl w Ar user : Ns Ar group
62 utility is designed to be a work-alike and look-alike of the deprecated
64 The end result is essentially the same,
65 but is accomplished in a completely different way.
72 puts a UFS file system on it (unless
80 compressed disk images, as long as the kernel supports this GEOM class.
81 All the command line options are passed to the appropriate program
82 at the appropriate stage in order to achieve the desired effect.
88 disk with soft-updates enabled
102 auto-unit feature to automatically select an unused device.
103 Unless otherwise specified with one of the options below,
104 it uses the default arguments to all the helper programs.
106 The following options are available.
108 the option letter matches the one used by
111 .Bl -tag -width indent
112 .It Fl a Ar maxcontig
113 Specify the maximum number of contiguous blocks that will be laid
114 out before forcing a rotational delay
118 .It Fl b Ar block-size
119 The block size of the file system, in bytes.
120 .It Fl c Ar blocks-per-cylinder-group
121 The number of blocks per cylinder group in the file system.
123 If not using auto-unit,
126 to try to detach the unit before attaching it.
127 .It Fl d Ar max-extent-size
128 The file system may choose to store large files using extents.
129 This parameter specifies the largest extent size that may be
131 It is presently limited to its default value which is 16
132 times the file system blocksize.
133 .It Fl E Ar path-mdconfig
140 Indicate the maximum number of blocks any single file can allocate
141 out of a cylinder group before it is forced to begin allocating
142 blocks from another cylinder group.
144 Create a vnode-backed
146 memory disk backed by
148 .It Fl f Ar frag-size
149 The fragment size of the file system in bytes.
151 Number of bytes per inode.
153 Enable multilabel MAC on the new file system.
155 Show the output of the helper programs.
164 instead of a swap-backed disk.
165 .It Fl m Ar percent-free
166 The percentage of space reserved for the superuser.
168 Do not actually run the helper programs.
169 This is most useful in conjunction with
174 directory on the new file system.
175 .It Fl O Ar optimization
176 Select the optimization preference;
181 which will optimize for minimum space fragmentation and
182 minimum time spent allocating blocks,
184 .It Fl o Ar mount-options
185 Specify the mount options with which to mount the file system.
188 for more information.
190 Preserve the existing file system;
193 This only makes sense if
195 is specified to create a vnode-backed disk.
196 .It Fl p Ar permissions
197 Set the file (directory) permissions of the mount point
203 argument can be in any of the mode formats recognized by
205 If symbolic permissions are specified,
206 the operation characters
210 are interpreted relative to the initial permissions of
213 Do not enable soft-updates on the file system.
215 Specify the size of the disk to create.
216 This only makes sense if
222 this will work for the default swap-backed
231 Turn on the TRIM enable flag for
233 When used with a file system that issue BIO_DELETE bio requests,
235 returns deleted blocks to the system memory pool.
237 Specify a file system type for a vnode-backed memory disk.
238 Any file system supported by
240 command can be specified.
241 This option only makes sense when
247 Enable soft-updates on the file system.
248 This is the default, and is accepted only
250 It is only really useful to negate the
252 flag, should such a need occur.
254 Specify the UFS version number for use on the file system; it may be
259 The default is derived from the default of the
262 .It Fl w Ar user : Ns Ar group
263 Set the owner and group to
268 The arguments have the same semantics as with
270 but specifying just a
276 Print what command will be run before running it, and
277 other assorted debugging information.
284 options are passed to
292 .Fl a , b , c , d , e , f , i , m
295 options are passed to
297 with the same letter.
308 with the same letter.
315 For information on semantics, refer to the documentation of the programs
316 that the options are passed to.
318 Create and mount a 32 megabyte swap-backed file system on
321 .Dl "mdmfs -s 32m md /tmp"
323 The same file system created as an entry in
326 .Dl "md /tmp mfs rw,-s32m 2 0"
328 Create and mount a 16 megabyte malloc-backed file system on
334 do not use soft-updates on it and mount it
337 .Dl "mdmfs -M -S -o async -s 16m md1 /tmp"
341 based compressed disk image:
343 .Dl "mdmfs -P -F foo.uzip -oro md.uzip /tmp/"
345 Mount the same image, specifying the
349 .Dl "mdmfs -P -F foo.uzip -oro md1.uzip /tmp/"
351 Configure a vnode-backed file system and mount its first partition,
352 using automatic device numbering:
354 .Dl "mdmfs -P -F foo.img mds1a /tmp/"
356 Mount a vnode-backed cd9660 file system using automatic device numbering:
358 .Dl "mdmfs -T cd9660 -P -F foo.iso md /tmp"
362 utility, while designed to be compatible with
364 can be useful by itself.
367 had some silly defaults, a
369 mode is provided for the case where bug-to-bug compatibility is desired.
371 Compatibility is enabled by starting
378 .Xr getprogname 3 ) .
379 In this mode, the following behavior, as done by
382 .Bl -bullet -offset indent
390 was given on the command line.