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
48 .Op Fl m Ar percent-free
49 .Op Fl n Ar rotational-positions
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
62 .Op Fl b Ar block-size
69 .Op Fl m Ar percent-free
70 .Op Fl n Ar rotational-positions
71 .Op Fl O Ar optimization
72 .Op Fl o Ar mount-options
80 utility is designed to be a work-alike and look-alike of the deprecated
82 The end result is essentially the same,
83 but is accomplished in a completely different way.
90 puts a UFS file system on it using
94 All the command line options are passed to the appropriate program
95 at the appropriate stage in order to achieve the desired effect.
101 disk with soft-updates enabled
115 auto-unit feature to automatically select an unused device.
116 Unless otherwise specified with one of the options below,
117 it uses the default arguments to all the helper programs.
119 The following options are available.
121 the option letter matches the one used by
124 .Bl -tag -width indent
125 .It Fl a Ar maxcontig
126 Specify the maximum number of contiguous blocks that will be laid
127 out before forcing a rotational delay
131 .It Fl b Ar block-size
132 The block size of the file system, in bytes.
134 Enable full compatibility mode with
138 section for more information.
139 .It Fl c Ar cylinders
140 The number of cylinders per cylinder group in the file system.
142 If not using auto-unit,
145 to try to detach the unit before attaching it.
147 Specify the minimum time in milliseconds required to initiate another
148 disk transfer on the same cylinder.
149 Modern disks with read/write-behind achieve higher performance without
151 so it is best to leave it at 0 milliseconds.
153 Indicate the maximum number of blocks any single file can allocate
154 out of a cylinder group before it is forced to begin allocating
155 blocks from another cylinder group.
157 Create a vnode-backed
159 memory disk backed by
161 .It Fl f Ar frag-size
162 The fragment size of the file system in bytes.
164 Number of bytes per inode.
166 Enable multilabel MAC on the new file system.
168 Show the output of the helper programs.
177 instead of a swap-backed disk.
178 .It Fl m Ar percent-free
179 The percentage of space reserved for the superuser.
181 Do not actually run the helper programs.
182 This is most useful in conjunction with
184 .It Fl n Ar rotational-positions
185 The default number of rotational positions to distinguish.
186 .It Fl O Ar optimization
187 Select the optimization preference;
192 which will optimize for minimum space fragmentation and
193 minimum time spent allocating blocks,
195 .It Fl o Ar mount-options
196 Specify the mount options with which to mount the file system.
199 for more information.
201 Preserve the existing filesystem;
204 This only makes sense if
206 is specified to create a vnode-backed disk.
207 .It Fl p Ar permissions
208 Set the file (directory) permissions of the mount point
214 argument can be in any of the mode formats recognized by
216 If symbolic permissions are specified,
217 the operation characters
221 are interpreted relative to the initial permissions of
224 Do not enable soft-updates on the file system.
226 Specify the size of the disk to create.
227 This only makes sense if
233 this will work for the default swap-backed
242 Enable soft-updates on the file system.
243 This is the default, even in compatibility mode, and is accepted only
245 It is only really useful to negate the
247 flag, should such a need occur.
249 Specify the UFS version number for use on the file system; it may be
254 The default is derived from the default of the
257 .It Fl w Ar user : Ns Ar group
258 Set the owner and group to
263 The arguments have the same semantics as with
265 but specifying just a
271 Print what command will be run before running it, and
272 other assorted debugging information.
279 options are passed to
287 .Fl a , b , c , d , e , f , i , m
290 options are passed to
292 with the same letter;
303 with the same letter.
304 See the programs that the options are passed to for more information
307 Create and mount a 32 megabyte swap-backed file system on
310 .Dl "mdmfs -s 32m md /tmp"
312 The same file system created as an entry in
315 .Dl "md /tmp mfs rw,-s32m 2 0"
317 Create and mount a 16 megabyte malloc-backed file system on
323 do not use soft-updates on it and mount it
326 .Dl "mdmfs -M -S -o async -s 16m md1 /tmp"
330 utility, while designed to be fully compatible with
332 can be useful by itself.
335 had some silly defaults, a
336 .Dq full compatibility
337 mode is provided for the case where bug-to-bug compatibility is desired.
339 Full compatibility is enabled with the
349 .Xr getprogname 3 ) .
350 In this mode, only the options which would be accepted by
353 Furthermore, the following behavior, as done by
356 .Bl -bullet -offset indent
364 was given on the command line.