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
55 .Op Fl w Ar user : Ns Ar group
61 utility is designed to be a work-alike and look-alike of the deprecated
63 The end result is essentially the same,
64 but is accomplished in a completely different way.
71 puts a UFS file system on it (unless
79 compressed disk images, as long as the kernel supports this GEOM class.
80 All the command line options are passed to the appropriate program
81 at the appropriate stage in order to achieve the desired effect.
87 disk with soft-updates enabled
101 auto-unit feature to automatically select an unused device.
102 Unless otherwise specified with one of the options below,
103 it uses the default arguments to all the helper programs.
105 The following options are available.
107 the option letter matches the one used by
110 .Bl -tag -width indent
111 .It Fl a Ar maxcontig
112 Specify the maximum number of contiguous blocks that will be laid
113 out before forcing a rotational delay
117 .It Fl b Ar block-size
118 The block size of the file system, in bytes.
119 .It Fl c Ar blocks-per-cylinder-group
120 The number of blocks per cylinder group in the file system.
122 If not using auto-unit,
125 to try to detach the unit before attaching it.
126 .It Fl d Ar max-extent-size
127 The file system may choose to store large files using extents.
128 This parameter specifies the largest extent size that may be
129 used. It is presently limited to its default value which is 16
130 times the file system blocksize.
131 .It Fl E Ar path-mdconfig
138 Indicate the maximum number of blocks any single file can allocate
139 out of a cylinder group before it is forced to begin allocating
140 blocks from another cylinder group.
142 Create a vnode-backed
144 memory disk backed by
146 .It Fl f Ar frag-size
147 The fragment size of the file system in bytes.
149 Number of bytes per inode.
151 Enable multilabel MAC on the new file system.
153 Show the output of the helper programs.
162 instead of a swap-backed disk.
163 .It Fl m Ar percent-free
164 The percentage of space reserved for the superuser.
166 Do not actually run the helper programs.
167 This is most useful in conjunction with
172 directory on the new file system.
173 .It Fl O Ar optimization
174 Select the optimization preference;
179 which will optimize for minimum space fragmentation and
180 minimum time spent allocating blocks,
182 .It Fl o Ar mount-options
183 Specify the mount options with which to mount the file system.
186 for more information.
188 Preserve the existing file system;
191 This only makes sense if
193 is specified to create a vnode-backed disk.
194 .It Fl p Ar permissions
195 Set the file (directory) permissions of the mount point
201 argument can be in any of the mode formats recognized by
203 If symbolic permissions are specified,
204 the operation characters
208 are interpreted relative to the initial permissions of
211 Do not enable soft-updates on the file system.
213 Specify the size of the disk to create.
214 This only makes sense if
220 this will work for the default swap-backed
229 Turn on the TRIM enable flag for
233 device supports the BIO_DELETE command, enabling the TRIM on created
234 filesystem allows return of freed memory to the system pool.
236 Enable soft-updates on the file system.
237 This is the default, and is accepted only
239 It is only really useful to negate the
241 flag, should such a need occur.
243 Specify the UFS version number for use on the file system; it may be
248 The default is derived from the default of the
251 .It Fl w Ar user : Ns Ar group
252 Set the owner and group to
257 The arguments have the same semantics as with
259 but specifying just a
265 Print what command will be run before running it, and
266 other assorted debugging information.
273 options are passed to
281 .Fl a , b , c , d , e , f , i , m
284 options are passed to
286 with the same letter;
297 with the same letter.
298 See the programs that the options are passed to for more information
301 Create and mount a 32 megabyte swap-backed file system on
304 .Dl "mdmfs -s 32m md /tmp"
306 The same file system created as an entry in
309 .Dl "md /tmp mfs rw,-s32m 2 0"
311 Create and mount a 16 megabyte malloc-backed file system on
317 do not use soft-updates on it and mount it
320 .Dl "mdmfs -M -S -o async -s 16m md1 /tmp"
324 based compressed disk image:
326 .Dl "mdmfs -P -F foo.uzip -oro md.uzip /tmp/"
328 Mount the same image, specifying the
332 .Dl "mdmfs -P -F foo.uzip -oro md1.uzip /tmp/"
334 Configure a vnode-backed file system and mount its first partition,
335 using automatic device numbering:
337 .Dl "mdmfs -P -F foo.img mds1a /tmp/"
341 utility, while designed to be compatible with
343 can be useful by itself.
346 had some silly defaults, a
348 mode is provided for the case where bug-to-bug compatibility is desired.
350 Compatibility is enabled by starting
357 .Xr getprogname 3 ) .
358 In this mode, the following behavior, as done by
361 .Bl -bullet -offset indent
369 was given on the command line.