← Back to branch summary

~ubuntu-branches/ubuntu/maverick/util-linux/maverick-security

« back to all changes in this revision

Viewing changes to mount/mount.8

Tags: 2.17-0ubuntu1
https://launchpad.net/bugs/383697
* Merge from Debian experimental, remaining changes:
  - Since udev is required in Ubuntu, the hwclock.sh init script is
    not called on startup and the hwclockfirst.sh init script is
    removed.
  - Remove /etc/adjtime on upgrade if it was not used.
  - Install custom blkid.conf to use /dev/.blkid.tab since we don't
    expect device names to survive a reboot
  - No lsb_release call in mount.preinst since we'd need Pre-Depends
    (LP: #383697).
  - Do not install initramfs hook, since our initramfs already handles
    including blkid.
  - Mention mountall(8) in fstab(5) manpages, along with its special
    options.

Show diffs side-by-side

added added

removed removed

Lines of Context:
mount/mount.8
41
41
.\"
42
42
.TH MOUNT 8 "2004-12-16" "Linux 2.6" "Linux Programmer's Manual"
43
43
.SH NAME
44
 
mount \- mount a file system
 
44
mount \- mount a filesystem
45
45
.SH SYNOPSIS
46
 
.BI "mount [\-lhV]"
47
 
.LP
48
 
.BI "mount \-a [\-fFnrsvw] [\-t " vfstype "] [\-O " optlist ]
49
 
.LP
50
 
.BI "mount [\-fnrsvw] [\-o " options " [,...]] " "device " | " dir"
51
 
.LP
52
 
.BI "mount [\-fnrsvw] [\-t " vfstype "] [\-o " options "] " "device dir"
 
46
.B mount
 
47
.RB [ \-lhV ]
 
48
.LP
 
49
.BI "mount \-a
 
50
.RB [ \-fFnrsvw ]
 
51
.RB [ \-t
 
52
.IR vfstype ]
 
53
.RB [ \-O
 
54
.IR optlist ]
 
55
.LP
 
56
.B mount
 
57
.RB [ \-fnrsvw ]
 
58
.RB [ \-o
 
59
.IR option [ \fB,\fPoption ]...]
 
60
.IR device | dir
 
61
.LP
 
62
.B mount
 
63
.RB [ \-fnrsvw ]
 
64
.RB [ \-t
 
65
.IB vfstype ]
 
66
.RB [ \-o
 
67
.IR options ]
 
68
.I device dir
53
69
.SH DESCRIPTION
54
70
All files accessible in a Unix system are arranged in one big
55
71
tree, the file hierarchy, rooted at
56
72
.BR / .
57
73
These files can be spread out over several devices. The
58
74
.B mount
59
 
command serves to attach the file system found on some device
 
75
command serves to attach the filesystem found on some device
60
76
to the big file tree. Conversely, the
61
77
.BR umount (8)
62
78
command will detach it again.
71
87
.br
72
88
 
73
89
.RE
74
 
This tells the kernel to attach the file system found on
 
90
This tells the kernel to attach the filesystem found on
75
91
.I device
76
92
(which is of type
77
93
.IR type )
79
95
.IR dir .
80
96
The previous contents (if any) and owner and mode of
81
97
.I dir
82
 
become invisible, and as long as this file system remains mounted,
 
98
become invisible, and as long as this filesystem remains mounted,
83
99
the pathname
84
100
.I dir
85
 
refers to the root of the file system on
 
101
refers to the root of the filesystem on
86
102
.IR device .
87
103
 
88
104
.B The listing and help.
95
111
.B "mount \-V"
96
112
prints a version string
97
113
.TP
98
 
.BI "mount [-l] [-t" " type" ]
99
 
lists all mounted file systems (of type
 
114
.BR "mount " [ -l "] [" "-t \fItype\fP" ]
 
115
lists all mounted filesystems (of type
100
116
.IR type ).
101
117
The option \-l adds the labels in this listing.
102
118
See below.
103
119
.RE
104
120
 
105
 
.B The bind mounts.
106
 
.RS
107
 
.\" In fact since 2.3.99. At first the syntax was mount -t bind.
108
 
Since Linux 2.4.0 it is possible to remount part of the
109
 
file hierarchy somewhere else. The call is
110
 
.RS
111
 
.br
112
 
.B "mount --bind olddir newdir"
113
 
.RE
114
 
or shortoption
115
 
.RS
116
 
.br
117
 
.B "mount -B olddir newdir"
118
 
.RE
119
 
or fstab entry is:
120
 
.RS
121
 
.br
122
 
.B "/olddir  /newdir  none  bind"
123
 
.RE
124
 
 
125
 
After this call the same contents is accessible in two places.
126
 
One can also remount a single file (on a single file).
127
 
 
128
 
This call attaches only (part of) a single filesystem, not possible
129
 
submounts. The entire file hierarchy including submounts is attached
130
 
a second place using
131
 
.RS
132
 
.br
133
 
.B "mount --rbind olddir newdir"
134
 
.RE
135
 
or shortoption
136
 
.RS
137
 
.br
138
 
.B "mount -R olddir newdir"
139
 
.RE
140
 
.\" available since Linux 2.4.11.
141
 
 
142
 
Note that the filesystem mount options will remain the same as those
143
 
on the original mount point, and cannot be changed by passing the -o
144
 
option along with --bind/--rbind.
145
 
.RE
146
 
 
147
 
.B The move operation.
148
 
.RS
149
 
Since Linux 2.5.1 it is possible to atomically move a mounted tree
150
 
to another place. The call is
151
 
.RS
152
 
.br
153
 
.B "mount --move olddir newdir"
154
 
.RE
155
 
or shortoption
156
 
.RS
157
 
.br
158
 
.B "mount -M olddir newdir"
159
 
.RE
160
 
.RE
161
 
 
162
 
.B The shared subtrees operations.
163
 
.RS
164
 
Since Linux 2.6.15 it is possible to mark a mount and its submounts as shared,
165
 
private, slave or unbindable. A shared mount provides ability to create mirrors
166
 
of that mount such that mounts and umounts within any of the mirrors propagate
167
 
to the other mirror. A slave mount receives propagation from its master, but
168
 
any not vice-versa.  A private mount carries no propagation abilities.  A
169
 
unbindable mount is a private mount which cannot cloned through a bind
170
 
operation. Detailed semantics is documented in Documentation/sharedsubtree.txt
171
 
file in the kernel source tree.
172
 
 
173
 
.RS
174
 
.nf
175
 
.B "mount --make-shared mountpoint"
176
 
.B "mount --make-slave mountpoint"
177
 
.B "mount --make-private mountpoint"
178
 
.B "mount --make-unbindable mountpoint"
179
 
.fi
180
 
.RE
181
 
 
182
 
The following commands allows one to recursively change the type of all the
183
 
mounts under a given mountpoint.
184
 
 
185
 
.RS
186
 
.nf
187
 
.B "mount --make-rshared mountpoint"
188
 
.B "mount --make-rslave mountpoint"
189
 
.B "mount --make-rprivate mountpoint"
190
 
.B "mount --make-runbindable mountpoint"
191
 
.fi
192
 
.RE
193
 
.RE
194
 
.RE
195
 
 
196
 
.B The device indication.
197
 
.RS
198
 
Most devices are indicated by a file name (of a block special device), like
199
 
.IR /dev/sda1 ,
200
 
but there are other possibilities. For example, in the case of an NFS mount,
201
 
.I device
202
 
may look like
203
 
.IR knuth.cwi.nl:/dir .
204
 
It is possible to indicate a block special device using its
205
 
volume
206
 
.B LABEL
207
 
or
208
 
.B UUID
209
 
(see the \-L and \-U options below).
210
 
 
211
 
.B The device indication.
212
 
.RS
213
 
Most devices are indicated by a file name (of a block special device), like
214
 
.IR /dev/sda1 ,
215
 
but there are other possibilities. For example, in the case of an NFS mount,
216
 
.I device
217
 
may look like
218
 
.IR knuth.cwi.nl:/dir .
219
 
It is possible to indicate a block special device using its
220
 
volume
221
 
.B LABEL
222
 
or
223
 
.B UUID
224
 
(see the \-L and \-U options below).
 
121
.B The device indication.
 
122
.RS
 
123
Most devices are indicated by a file name (of a block special device), like
 
124
.IR /dev/sda1 ,
 
125
but there are other possibilities. For example, in the case of an NFS mount,
 
126
.I device
 
127
may look like
 
128
.IR knuth.cwi.nl:/dir .
 
129
It is possible to indicate a block special device using its
 
130
volume
 
131
.B LABEL
 
132
or
 
133
.B UUID
 
134
(see the \-L and \-U options below).
 
135
 
 
136
The recommended setup is to use LABEL=<label> or UUID=<uuid> tags rather than
 
137
.B /dev/disk/by-{label,uuid}
 
138
udev symlinks in the /etc/fstab file. The tags are
 
139
more readable, robust and portable. The mount(8) command internally uses udev
 
140
symlinks, so use the symlinks in /etc/fstab is not advantage over LABEL=/UUID=.
 
141
For more details see libblkid(3).
225
142
 
226
143
The
227
144
.I proc
228
 
file system is not associated with a special device, and when
 
145
filesystem is not associated with a special device, and when
229
146
mounting it, an arbitrary keyword, such as
230
147
.I proc
231
148
can be used instead of a device specification.
248
165
The command
249
166
.RS
250
167
.sp
251
 
.BI "mount \-a [\-t " type "] [\-O " optlist ]
 
168
.B mount \-a
 
169
.RB [ \-t
 
170
.IR type ]
 
171
.RB [ \-O
 
172
.IR optlist ]
252
173
.sp
253
174
.RE
254
 
(usually given in a bootscript) causes all file systems mentioned in
 
175
(usually given in a bootscript) causes all filesystems mentioned in
255
176
.I fstab
256
177
(of the proper type and/or having or not having the proper options)
257
178
to be mounted as indicated, except for those whose line contains the
261
182
option will make mount fork, so that the
262
183
filesystems are mounted simultaneously.
263
184
.LP
264
 
When mounting a file system mentioned in
265
 
.IR fstab ,
 
185
When mounting a filesystem mentioned in
 
186
.IR fstab
 
187
or
 
188
.IR mtab ,
266
189
it suffices to give only the device, or only the mount point.
267
190
 
268
191
 
270
193
.B mount
271
194
and
272
195
.B umount
273
 
maintain a list of currently mounted file systems in the file
 
196
maintain a list of currently mounted filesystems in the file
274
197
.IR /etc/mtab .
275
198
If no arguments are given to
276
199
.BR mount ,
295
218
and especially when you have very large numbers of mounts
296
219
things will be much faster with that symlink,
297
220
but some information is lost that way, and in particular
298
 
working with the loop device will be less convenient,
299
 
and using the "user" option will fail.
 
221
using the "user" option will fail.
300
222
.RE
301
223
 
302
224
.B The non-superuser mounts.
303
225
.RS
304
 
Normally, only the superuser can mount file systems.
 
226
Normally, only the superuser can mount filesystems.
305
227
However, when
306
228
.I fstab
307
229
contains the
314
236
.B "/dev/cdrom  /cd  iso9660  ro,user,noauto,unhide"
315
237
.sp
316
238
.RE
317
 
any user can mount the iso9660 file system found on his CDROM
 
239
any user can mount the iso9660 filesystem found on his CDROM
318
240
using the command
319
241
.RS
320
242
.sp
351
273
member of the group of the special file.
352
274
.RE
353
275
 
 
276
 
 
277
.B The bind mounts.
 
278
.RS
 
279
.\" In fact since 2.3.99. At first the syntax was mount -t bind.
 
280
Since Linux 2.4.0 it is possible to remount part of the
 
281
file hierarchy somewhere else. The call is
 
282
.RS
 
283
.br
 
284
.B mount --bind
 
285
.I olddir newdir
 
286
.RE
 
287
or shortoption
 
288
.RS
 
289
.br
 
290
.B mount -B
 
291
.I olddir newdir
 
292
.RE
 
293
or fstab entry is:
 
294
.RS
 
295
.br
 
296
.I /olddir
 
297
.I /newdir
 
298
.B  none  bind
 
299
.RE
 
300
 
 
301
After this call the same contents is accessible in two places.
 
302
One can also remount a single file (on a single file).
 
303
 
 
304
This call attaches only (part of) a single filesystem, not possible
 
305
submounts. The entire file hierarchy including submounts is attached
 
306
a second place using
 
307
.RS
 
308
.br
 
309
.B mount --rbind
 
310
.I olddir newdir
 
311
.RE
 
312
or shortoption
 
313
.RS
 
314
.br
 
315
.B mount -R
 
316
.I olddir newdir
 
317
.RE
 
318
.\" available since Linux 2.4.11.
 
319
 
 
320
Note that the filesystem mount options will remain the same as those
 
321
on the original mount point, and cannot be changed by passing the -o
 
322
option along with --bind/--rbind. The mount options can be
 
323
changed by a separate remount command, for example:
 
324
 
 
325
.RS
 
326
.br
 
327
.B mount --bind
 
328
.I olddir newdir
 
329
.br
 
330
.B mount -o remount,ro
 
331
.I newdir
 
332
.RE
 
333
 
 
334
.RE
 
335
 
 
336
.B The move operation.
 
337
.RS
 
338
Since Linux 2.5.1 it is possible to atomically move a mounted tree
 
339
to another place. The call is
 
340
.RS
 
341
.br
 
342
.B mount --move
 
343
.I olddir newdir
 
344
.RE
 
345
or shortoption
 
346
.RS
 
347
.br
 
348
.B mount -M
 
349
.I olddir newdir
 
350
.RE
 
351
This will cause the contents which previously appeared under olddir to be
 
352
accessed under newdir.  The physical location of the files is not changed.
 
353
.RE
 
354
 
 
355
.B The shared subtrees operations.
 
356
.RS
 
357
Since Linux 2.6.15 it is possible to mark a mount and its submounts as shared,
 
358
private, slave or unbindable. A shared mount provides ability to create mirrors
 
359
of that mount such that mounts and umounts within any of the mirrors propagate
 
360
to the other mirror. A slave mount receives propagation from its master, but
 
361
any not vice-versa.  A private mount carries no propagation abilities.  A
 
362
unbindable mount is a private mount which cannot cloned through a bind
 
363
operation. Detailed semantics is documented in Documentation/sharedsubtree.txt
 
364
file in the kernel source tree.
 
365
 
 
366
.RS
 
367
.nf
 
368
.BI "mount --make-shared " mountpoint
 
369
.BI "mount --make-slave " mountpoint
 
370
.BI "mount --make-private " mountpoint
 
371
.BI "mount --make-unbindable " mountpoint
 
372
.fi
 
373
.RE
 
374
 
 
375
The following commands allows one to recursively change the type of all the
 
376
mounts under a given mountpoint.
 
377
 
 
378
.RS
 
379
.nf
 
380
.BI "mount --make-rshared " mountpoint
 
381
.BI "mount --make-rslave " mountpoint
 
382
.BI "mount --make-rprivate " mountpoint
 
383
.BI "mount --make-runbindable " mountpoint
 
384
.fi
 
385
.RE
 
386
.RE
 
387
 
354
388
.SH COMMAND LINE OPTIONS
355
389
The full set of mount options used by an invocation of
356
390
.B mount
357
391
is determined by first extracting the
358
 
mount options for the file system from the
 
392
mount options for the filesystem from the
359
393
.I fstab
360
394
table, then applying any options specified by the
361
395
.B \-o
366
400
Command line options available for the
367
401
.B mount
368
402
command:
369
 
.TP
370
 
.B \-V
 
403
.IP "\fB\-V, \-\-version\fP"
371
404
Output version.
372
 
.TP
373
 
.B \-h
 
405
.IP "\fB\-h, \-\-help\fP"
374
406
Print a help message.
375
 
.TP
376
 
.B \-v
 
407
.IP "\fB\-v, \-\-verbose\fP"
377
408
Verbose mode.
378
 
.TP
379
 
.B \-a
 
409
.IP "\fB\-a, \-\-all\fP"
380
410
Mount all filesystems (of the given types) mentioned in
381
411
.IR fstab .
382
 
.TP
383
 
.B \-F
 
412
.IP "\fB\-F, \-\-fork\fP"
384
413
(Used in conjunction with
385
414
.BR \-a .)
386
415
Fork off a new incarnation of mount for each device.
392
421
.I /usr
393
422
and
394
423
.IR /usr/spool .
395
 
.TP
396
 
.B \-f
 
424
.IP "\fB\-f, \-\-fake\fP"
397
425
Causes everything to be done except for the actual system call; if it's not
398
 
obvious, this ``fakes'' mounting the file system.  This option is useful in
 
426
obvious, this ``fakes'' mounting the filesystem.  This option is useful in
399
427
conjunction with the
400
428
.B \-v
401
429
flag to determine what the
404
432
that were mounted earlier with the -n option. The -f option checks for
405
433
existing record in /etc/mtab and fails when the record already
406
434
exists (with regular non-fake mount, this check is done by kernel).
407
 
.TP
408
 
.B \-i
 
435
.IP "\fB\-i, \-\-internal\-only\fP"
409
436
Don't call the /sbin/mount.<filesystem> helper even if it exists.
410
 
.TP
411
 
.B \-l
 
437
.IP "\fB\-l\fP"
412
438
Add the labels in the mount output. Mount must have
413
439
permission to read the disk device (e.g. be suid root) for this to work.
414
440
One can set such a label for ext2, ext3 or ext4 using the
417
443
.BR xfs_admin (8),
418
444
or for reiserfs using
419
445
.BR reiserfstune (8).
420
 
.TP
421
 
.B \-n
 
446
.IP "\fB\-n, \-\-no\-mtab\fP"
422
447
Mount without writing in
423
448
.IR /etc/mtab .
424
449
This is necessary for example when
425
450
.I /etc
426
 
is on a read-only file system.
427
 
.TP
428
 
.BI \-p " num"
 
451
is on a read-only filesystem.
 
452
.IP "\fB\-\-no\-canonicalize\fP"
 
453
Don't canonicalize paths. The mount command canonicalizes all paths 
 
454
(from command line or fstab) and stores canonicalized paths to the 
 
455
.IR /etc/mtab
 
456
file. This option can be used together with the
 
457
.B \-f
 
458
flag for already canonicalized absolut paths.
 
459
.IP "\fB\-p, \-\-pass\-fd \fInum\fP"
429
460
In case of a loop mount with encryption, read the passphrase from
430
461
file descriptor
431
462
.I num
432
463
instead of from the terminal.
433
 
.TP
434
 
.B \-s
 
464
.IP "\fB\-s\fP"
435
465
Tolerate sloppy mount options rather than failing. This will ignore
436
466
mount options not supported by a filesystem type. Not all filesystems
437
467
support this option. This option exists for support of the Linux
438
468
autofs\-based automounter.
439
 
.TP
440
 
.B \-r
441
 
Mount the file system read-only. A synonym is
 
469
.IP "\fB\-r, \-\-read\-only\fP"
 
470
Mount the filesystem read-only. A synonym is
442
471
.BR "\-o ro" .
443
472
 
444
473
Note that, depending on the filesystem type, state and kernel behavior, the
446
475
journal if the filesystem is dirty. To prevent this kind of write access, you
447
476
may want to mount ext3 or ext4 filesystem with "ro,noload" mount options or
448
477
set the block device to read-only mode, see command
449
 
.BR blockdev (8)
450
 
.
451
 
.TP
452
 
.B \-w
453
 
Mount the file system read/write. This is the default. A synonym is
 
478
.BR blockdev (8).
 
479
.IP "\fB\-w, \-\-rw\fP"
 
480
Mount the filesystem read/write. This is the default. A synonym is
454
481
.BR "\-o rw" .
455
 
.TP
456
 
.BI \-L " label"
 
482
.IP "\fB\-L \fIlabel\fP"
457
483
Mount the partition that has the specified
458
484
.IR label .
459
 
.TP
460
 
.BI \-U " uuid"
 
485
.IP "\fB\-U \fIuuid\fP"
461
486
Mount the partition that has the specified
462
487
.IR uuid .
463
488
These two options require the file
464
489
.I /proc/partitions
465
490
(present since Linux 2.1.116) to exist.
466
 
.TP
467
 
.BI \-t " vfstype"
 
491
.IP "\fB\-t, \-\-types \fIvfstype\fP"
468
492
The argument following the
469
493
.B \-t
470
 
is used to indicate the file system type.  The file system types which are
 
494
is used to indicate the filesystem type.  The filesystem types which are
471
495
currently supported include:
472
496
.IR adfs ,
473
497
.IR affs ,
499
523
.IR ramfs ,
500
524
.IR reiserfs ,
501
525
.IR romfs ,
 
526
.IR squashfs ,
502
527
.IR smbfs ,
503
528
.IR sysv ,
504
529
.IR tmpfs ,
 
530
.IR ubifs ,
505
531
.IR udf ,
506
532
.IR ufs ,
507
533
.IR umsdos ,
533
559
.IR mount (2)
534
560
system call, and no detailed knowledge of the filesystem type is required.
535
561
For a few types however (like nfs, nfs4, cifs, smbfs, ncpfs) ad hoc code is
536
 
necessary. The nfs, nfs4, cifs, smbfs, and ncpfs
 
562
necessary. The nfs, nfs4, cifs, smbfs, and ncpfs filesystems
537
563
have a separate mount program. In order to make it possible to
538
564
treat all types in a uniform way, mount will execute the program
539
 
.I /sbin/mount.TYPE
 
565
.BI /sbin/mount. TYPE
540
566
(if that exists) when called with type
541
567
.IR TYPE .
542
568
Since various versions of the
543
 
.I smbmount
 
569
.B smbmount
544
570
program have different calling conventions,
545
 
.I /sbin/mount.smbfs
 
571
.B /sbin/mount.smbfs
546
572
may have to be a shell script that sets up the desired call.
547
573
 
548
574
If no
582
608
to guess.
583
609
 
584
610
More than one type may be specified in a comma separated
585
 
list.  The list of file system types can be prefixed with
 
611
list.  The list of filesystem types can be prefixed with
586
612
.B no
587
 
to specify the file system types on which no action should be taken.
 
613
to specify the filesystem types on which no action should be taken.
588
614
(This can be meaningful with the
589
615
.B \-a
590
 
option.)
591
 
 
592
 
For example, the command:
593
 
.RS
 
616
option.) For example, the command:
 
617
.RS
 
618
.RS
 
619
.sp
594
620
.B "mount \-a \-t nomsdos,ext"
 
621
.sp
595
622
.RE
596
 
mounts all file systems except those of type
 
623
mounts all filesystems except those of type
597
624
.I msdos
598
625
and
599
626
.IR ext .
600
 
.TP
601
 
.B \-O
 
627
.RE
 
628
.IP "\fB\-O, \-\-test-opts \fIopts\fP"
602
629
Used in conjunction with
603
630
.BR \-a ,
604
631
to limit the set of filesystems to which the
609
636
.BR \-a .
610
637
For example, the command:
611
638
.RS
 
639
.RS
612
640
.sp
613
641
.B "mount \-a \-O no_netdev"
614
642
.sp
615
643
.RE
616
 
mounts all file systems except those which have the option
 
644
mounts all filesystems except those which have the option
617
645
.I _netdev
618
646
specified in the options field in the
619
647
.I /etc/fstab
637
665
.RE
638
666
mounts all ext2 filesystems with the _netdev option, not all filesystems
639
667
that are either ext2 or have the _netdev option specified.
640
 
.TP
641
 
.B \-o
 
668
.RE
 
669
.IP "\fB\-o, \-\-options \fIopts\fP"
642
670
Options are specified with a
643
671
.B \-o
644
672
flag followed by a comma separated string of options. For example:
645
673
.RS
646
674
.RS
 
675
.sp
647
676
.B "mount LABEL=mydisk \-o noatime,nouser"
 
677
.sp
648
678
.RE
649
679
 
650
680
For more details, see
653
683
.B FILESYSTEM SPECIFIC MOUNT OPTIONS
654
684
sections.
655
685
.RE
656
 
.TP
657
 
.B \-B, \-\-bind
 
686
.IP "\fB\-B, \-\-bind\fP"
658
687
Remount a subtree somewhere else (so that its contents are available
659
688
in both places). See above.
660
 
.TP
661
 
.B \-R, \-\-rbind
 
689
.IP "\fB\-R, \-\-rbind\fP"
662
690
Remount a subtree and all possible submounts somewhere else (so that its
663
691
contents are available in both places). See above.
664
 
.TP
665
 
.B \-M, \-\-move
 
692
.IP "\fB\-M, \-\-move\fP"
666
693
Move a subtree to some other place. See above.
667
 
.RE
668
694
 
669
695
.SH FILESYSTEM INDEPENDENT MOUNT OPTIONS
670
696
Some of these options are only useful when they appear in the
675
701
in the system kernel. To check the current setting see the options
676
702
in /proc/mounts.
677
703
 
678
 
The following options apply to any file system that is being
679
 
mounted (but not every file system actually honors them - e.g., the
 
704
The following options apply to any filesystem that is being
 
705
mounted (but not every filesystem actually honors them - e.g., the
680
706
.B sync
681
707
option today has effect only for ext2, ext3, fat, vfat and ufs):
682
708
 
683
709
.TP
684
710
.B async
685
 
All I/O to the file system should be done asynchronously. (See also the
 
711
All I/O to the filesystem should be done asynchronously. (See also the
686
712
.B sync
687
713
option.)
688
714
.TP
689
715
.B atime
690
 
Update inode access time for each access. This is the default.
 
716
Update inode access time for each access. See also the
 
717
.B strictatime
 
718
mount option.
691
719
.TP
692
720
.B noatime
693
 
Do not update inode access times on this file system (e.g, for faster
 
721
Do not update inode access times on this filesystem (e.g, for faster
694
722
access on the news spool to speed up news servers).
695
723
.TP
696
724
.B auto
701
729
.B noauto
702
730
Can only be mounted explicitly (i.e., the
703
731
.B \-a
704
 
option will not cause the file system to be mounted).
 
732
option will not cause the filesystem to be mounted).
705
733
.TP
706
734
\fBcontext=\fP\fIcontext\fP, \fBfscontext=\fP\fIcontext\fP, \fBdefcontext=\fP\fIcontext\fP and \fBrootcontext=\fP\fIcontext\fP
707
735
The
742
770
You can set the default security context for unlabeled files using
743
771
.BR defcontext=
744
772
option. This overrides the value set for unlabeled files in the policy and requires a
745
 
file system that supports xattr labeling.
 
773
filesystem that supports xattr labeling.
746
774
 
747
775
The
748
776
.BR rootcontext=
759
787
.BR rw ", " suid ", " dev ", " exec ", " auto ", " nouser ", and " async.
760
788
.TP
761
789
.B dev
762
 
Interpret character or block special devices on the file system.
 
790
Interpret character or block special devices on the filesystem.
763
791
.TP
764
792
.B nodev
765
793
Do not interpret character or block special devices on the file
772
800
Do not update directory inode access times on this filesystem.
773
801
.TP
774
802
.B dirsync
775
 
All directory updates within the file system should be done synchronously.
 
803
All directory updates within the filesystem should be done synchronously.
776
804
This affects the following system calls: creat, link, unlink, symlink,
777
805
mkdir, rmdir, mknod and rename.
778
806
.TP
780
808
Permit execution of binaries.
781
809
.TP
782
810
.B noexec
783
 
Do not allow direct execution of any binaries on the mounted file system.
 
811
Do not allow direct execution of any binaries on the mounted filesystem.
784
812
(Until recently it was possible to run binaries anyway using a command like
785
813
/lib/ld*.so /mnt/binary. This trick fails since Linux 2.4.25 / 2.6.0.)
786
814
.TP
787
815
.B group
788
 
Allow an ordinary (i.e., non-root) user to mount the file system if one
 
816
Allow an ordinary (i.e., non-root) user to mount the filesystem if one
789
817
of his groups matches the group of the device.
790
818
This option implies the options
791
819
.BR nosuid " and " nodev
833
861
.B norelatime
834
862
Do not use
835
863
.B relatime
836
 
feature (e.g, for systems where the feature is enabled by default, for
837
 
more details see mount options in /proc/mounts).
 
864
feature. See also the
 
865
.B strictatime
 
866
mount option.
838
867
.TP
839
868
.B strictatime
840
 
Update inode access times whenever a file is accessed. Disables noatime and
841
 
.B relatime.
 
869
Allows to explicitly requesting full atime updates. This makes it
 
870
possible for kernel to defaults to
 
871
.B relatime
 
872
or
 
873
.B noatime
 
874
but still allow userspace to override it. For more details about the default
 
875
system mount options see /proc/mounts.
842
876
.TP
843
877
.B nostrictatime
844
878
Use the kernel's default behaviour for inode access time updates.
853
887
suidperl(1) installed.)
854
888
.TP
855
889
.B owner
856
 
Allow an ordinary (i.e., non-root) user to mount the file system if he
 
890
Allow an ordinary (i.e., non-root) user to mount the filesystem if he
857
891
is the owner of the device.
858
892
This option implies the options
859
893
.BR nosuid " and " nodev
861
895
.BR owner,dev,suid ).
862
896
.TP
863
897
.B remount
864
 
Attempt to remount an already-mounted file system.  This is commonly
865
 
used to change the mount flags for a file system, especially to make a
866
 
readonly file system writeable. It does not change device or mount point.
 
898
Attempt to remount an already-mounted filesystem.  This is commonly
 
899
used to change the mount flags for a filesystem, especially to make a
 
900
readonly filesystem writeable. It does not change device or mount point.
867
901
 
868
902
The remount functionality follows the standard way how the mount command works
869
903
with options from fstab. It means the mount command doesn't read fstab (or
887
921
).
888
922
.TP
889
923
.B ro
890
 
Mount the file system read-only.
 
924
Mount the filesystem read-only.
891
925
.TP
892
926
.B rw
893
 
Mount the file system read-write.
 
927
Mount the filesystem read-write.
894
928
.TP
895
929
.B sync
896
 
All I/O to the file system should be done synchronously. In case of media with limited number of write cycles 
 
930
All I/O to the filesystem should be done synchronously. In case of media with limited number of write cycles
897
931
(e.g. some flash drives) "sync" may cause life-cycle shortening.
898
932
.TP
899
933
.B user
900
 
Allow an ordinary user to mount the file system.
 
934
Allow an ordinary user to mount the filesystem.
901
935
The name of the mounting user is written to mtab so that he can unmount
902
 
the file system again.
 
936
the filesystem again.
903
937
This option implies the options
904
938
.BR noexec ", " nosuid ", and " nodev
905
939
(unless overridden by subsequent options, as in the option line
906
940
.BR user,exec,dev,suid ).
907
941
.TP
908
942
.B nouser
909
 
Forbid an ordinary (i.e., non-root) user to mount the file system.
 
943
Forbid an ordinary (i.e., non-root) user to mount the filesystem.
910
944
This is the default.
911
945
.TP
912
946
.B users
913
 
Allow every user to mount and unmount the file system.
 
947
Allow every user to mount and unmount the filesystem.
914
948
This option implies the options
915
949
.BR noexec ", " nosuid ", and " nodev
916
950
(unless overridden by subsequent options, as in the option line
917
951
.BR users,exec,dev,suid ).
918
952
 
919
953
.SH "FILESYSTEM SPECIFIC MOUNT OPTIONS"
920
 
The following options apply only to certain file systems.
921
 
We sort them by file system. They all follow the
 
954
The following options apply only to certain filesystems.
 
955
We sort them by filesystem. They all follow the
922
956
.B \-o
923
957
flag.
924
958
 
929
963
.SH "Mount options for adfs"
930
964
.TP
931
965
\fBuid=\fP\fIvalue\fP and \fBgid=\fP\fIvalue\fP
932
 
Set the owner and group of the files in the file system (default: uid=gid=0).
 
966
Set the owner and group of the files in the filesystem (default: uid=gid=0).
933
967
.TP
934
968
\fBownmask=\fP\fIvalue\fP and \fBothmask=\fP\fIvalue\fP
935
969
Set the permission mask for ADFS 'owner' permissions and 'other' permissions,
939
973
.SH "Mount options for affs"
940
974
.TP
941
975
\fBuid=\fP\fIvalue\fP and \fBgid=\fP\fIvalue\fP
942
 
Set the owner and group of the root of the file system (default: uid=gid=0,
 
976
Set the owner and group of the root of the filesystem (default: uid=gid=0,
943
977
but with option
944
978
.B uid
945
979
or
957
991
The value is given in octal.
958
992
.TP
959
993
.B protect
960
 
Do not allow any changes to the protection bits on the file system.
 
994
Do not allow any changes to the protection bits on the filesystem.
961
995
.TP
962
996
.B usemp
963
 
Set uid and gid of the root of the file system to the uid and gid
 
997
Set uid and gid of the root of the filesystem to the uid and gid
964
998
of the mount point upon the first sync or umount, and then
965
999
clear this option. Strange...
966
1000
.TP
982
1016
.BI bs= value
983
1017
Give blocksize. Allowed values are 512, 1024, 2048, 4096.
984
1018
.TP
985
 
.BR grpquota " / " noquota " / " quota " / " usrquota
 
1019
.BR grpquota | noquota | quota | usrquota
986
1020
These options are accepted but ignored.
987
1021
(However, quota utilities may react to such strings in
988
1022
.IR /etc/fstab .)
996
1030
None.
997
1031
 
998
1032
.SH "Mount options for debugfs"
999
 
The debugfs file system is a pseudo file system, traditionally mounted on
 
1033
The debugfs filesystem is a pseudo filesystem, traditionally mounted on
1000
1034
.IR /sys/kernel/debug .
1001
1035
.\" or just /debug
1002
1036
.\" present since 2.6.11
1003
1037
There are no mount options.
1004
1038
 
1005
1039
.SH "Mount options for devpts"
1006
 
The devpts file system is a pseudo file system, traditionally mounted on
 
1040
The devpts filesystem is a pseudo filesystem, traditionally mounted on
1007
1041
.IR /dev/pts .
1008
1042
In order to acquire a pseudo terminal, a process opens
1009
1043
.IR /dev/ptmx ;
1022
1056
.BI mode= value
1023
1057
Set the mode of newly created PTYs to the specified value.
1024
1058
The default is 0600.
1025
 
A value of 
 
1059
A value of
1026
1060
.B mode=620
1027
 
and 
 
1061
and
1028
1062
.B gid=5
1029
1063
makes "mesg y" the default on newly created PTYs.
1030
1064
.TP
1085
1119
 
1086
1120
.SH "Mount options for ext"
1087
1121
None.
1088
 
Note that the `ext' file system is obsolete. Don't use it.
 
1122
Note that the `ext' filesystem is obsolete. Don't use it.
1089
1123
Since Linux version 2.1.21 extfs is no longer part of the kernel source.
1090
1124
 
1091
1125
.SH "Mount options for ext2"
1092
 
The `ext2' file system is the standard Linux file system.
 
1126
The `ext2' filesystem is the standard Linux filesystem.
1093
1127
.\" Due to a kernel bug, it may be mounted with random mount options
1094
1128
.\" (fixed in Linux 2.0.4).
1095
1129
Since Linux 2.5.46, for most mount options the default
1096
1130
is determined by the filesystem superblock. Set them with
1097
1131
.BR tune2fs (8).
1098
1132
.TP
1099
 
.BR acl " / " noacl
 
1133
.BR acl | noacl
1100
1134
Support POSIX Access Control Lists (or not).
1101
1135
.\" requires CONFIG_EXT2_FS_POSIX_ACL
1102
1136
.TP
1103
 
.BR bsddf " / " minixdf
 
1137
.BR bsddf | minixdf
1104
1138
Set the behaviour for the
1105
1139
.I statfs
1106
1140
system call. The
1107
1141
.B minixdf
1108
1142
behaviour is to return in the
1109
1143
.I f_blocks
1110
 
field the total number of blocks of the file system, while the
 
1144
field the total number of blocks of the filesystem, while the
1111
1145
.B bsddf
1112
1146
behaviour (which is the default) is to subtract the overhead blocks
1113
 
used by the ext2 file system and not available for file storage. Thus
 
1147
used by the ext2 filesystem and not available for file storage. Thus
1114
1148
.nf
1115
1149
 
1116
1150
% mount /k -o minixdf; df /k; umount /k
1126
1160
.IR /etc/fstab .)
1127
1161
 
1128
1162
.TP
1129
 
.BR check=none " / " nocheck
 
1163
.BR check= { none | nocheck }
1130
1164
No checking is done at mount time. This is the default. This is fast.
1131
1165
It is wise to invoke
1132
1166
.BR e2fsck (8)
1135
1169
.B debug
1136
1170
Print debugging info upon each (re)mount.
1137
1171
.TP
1138
 
.BR errors=continue " / " errors=remount-ro " / " errors=panic
 
1172
.BR errors= { continue | remount-ro | panic }
1139
1173
Define the behaviour when an error is encountered.
1140
 
(Either ignore errors and just mark the file system erroneous and continue,
1141
 
or remount the file system read-only, or panic and halt the system.)
 
1174
(Either ignore errors and just mark the filesystem erroneous and continue,
 
1175
or remount the filesystem read-only, or panic and halt the system.)
1142
1176
The default is set in the filesystem superblock, and can be
1143
1177
changed using
1144
1178
.BR tune2fs (8).
1145
1179
.TP
1146
 
.BR grpid " or " bsdgroups " / " nogrpid " or " sysvgroups
 
1180
.BR grpid | bsdgroups " and " nogrpid | sysvgroups
1147
1181
These options define what group id a newly created file gets.
1148
1182
When
1149
1183
.BR grpid
1153
1187
from the parent directory, and also gets the setgid bit set
1154
1188
if it is a directory itself.
1155
1189
.TP
1156
 
.BR grpquota " / " noquota " / " quota " / " usrquota
 
1190
.BR grpquota | noquota | quota | usrquota
1157
1191
These options are accepted but ignored.
1158
1192
.TP
1159
1193
.BR nobh
1167
1201
Use old allocator or Orlov allocator for new inodes. Orlov is default.
1168
1202
.TP
1169
1203
\fBresgid=\fP\fIn\fP and \fBresuid=\fP\fIn\fP
1170
 
The ext2 file system reserves a certain percentage of the available
 
1204
The ext2 filesystem reserves a certain percentage of the available
1171
1205
space (by default 5%, see
1172
1206
.BR mke2fs (8)
1173
1207
and
1191
1225
The block number here uses 1k units. Thus, if you want to use logical
1192
1226
block 32768 on a filesystem with 4k blocks, use "sb=131072".
1193
1227
.TP
1194
 
.BR user_xattr " / " nouser_xattr
 
1228
.BR user_xattr | nouser_xattr
1195
1229
Support "user." extended attributes (or not).
1196
1230
.\" requires CONFIG_EXT2_FS_XATTR
1197
1231
 
1198
1232
 
1199
1233
.SH "Mount options for ext3"
1200
 
The `ext3' file system is a version of the ext2 file system which has been
 
1234
The ext3 filesystem is a version of the ext2 filesystem which has been
1201
1235
enhanced with journalling.  It supports the same options as ext2 as
1202
1236
well as the following additions:
1203
1237
.\" .TP
1204
1238
.\" .BR abort
1205
 
.\" Mount the file system in abort mode, as if a fatal error has occurred.
 
1239
.\" Mount the filesystem in abort mode, as if a fatal error has occurred.
1206
1240
.TP
1207
1241
.BR journal=update
1208
 
Update the ext3 file system's journal to the current format.
 
1242
Update the ext3 filesystem's journal to the current format.
1209
1243
.TP
1210
1244
.BR journal=inum
1211
1245
When a journal already exists, this option is ignored. Otherwise, it
1212
 
specifies the number of the inode which will represent the ext3 file system's
 
1246
specifies the number of the inode which will represent the ext3 filesystem's
1213
1247
journal file;  ext3 will create a new journal, overwriting the old contents
1214
1248
of the file whose inode number is
1215
1249
.IR inum .
1216
1250
.TP
1217
1251
.BR noload
1218
 
Do not load the ext3 file system's journal on mounting.
 
1252
Do not load the ext3 filesystem's journal on mounting.
1219
1253
.TP
1220
 
.BR data=journal " / " data=ordered " / " data=writeback
 
1254
.BR data= { journal | ordered | writeback }
1221
1255
Specifies the journalling mode for file data.  Metadata is always journaled.
1222
1256
To use modes other than
1223
1257
.B ordered
1224
 
on the root file system, pass the mode to the kernel as boot parameter, e.g.
 
1258
on the root filesystem, pass the mode to the kernel as boot parameter, e.g.
1225
1259
.IR rootflags=data=journal .
1226
1260
.RS
1227
1261
.TP
1228
1262
.B journal
1229
1263
All data is committed into the journal prior to being written into the
1230
 
main file system.
 
1264
main filesystem.
1231
1265
.TP
1232
1266
.B ordered
1233
1267
This is the default mode.  All data is forced directly out to the main file
1235
1269
.TP
1236
1270
.B writeback
1237
1271
Data ordering is not preserved - data may be written into the main
1238
 
file system after its metadata has been committed to the journal.
 
1272
filesystem after its metadata has been committed to the journal.
1239
1273
This is rumoured to be the highest-throughput option.  It guarantees
1240
 
internal file system integrity, however it can allow old data to appear
 
1274
internal filesystem integrity, however it can allow old data to appear
1241
1275
in files after a crash and journal recovery.
1242
1276
.RE
1243
1277
.TP
 
1278
.BR barrier=0 " / "  barrier=1 "
 
1279
This enables/disables barriers.  barrier=0 disables it, barrier=1 enables it.
 
1280
Write barriers enforce proper on-disk ordering of journal commits, making
 
1281
volatile disk write caches safe to use, at some performance penalty.  The ext3
 
1282
filesystem does not enable write barriers by default.  Be sure to enable
 
1283
barriers unless your disks are battery-backed one way or another.  Otherwise
 
1284
you risk filesystem corruption in case of power failure.
 
1285
.TP
1244
1286
.BI commit= nrsec
1245
1287
Sync all data and metadata every
1246
1288
.I nrsec
1257
1299
manual page.
1258
1300
 
1259
1301
.SH "Mount options for ext4"
1260
 
The `ext4' is an an advanced level of the ext3 filesystem which incorporates
1261
 
scalability and reliability enhancements for supporting large filesystem.
 
1302
The ext4 filesystem is an an advanced level of the ext3 filesystem which
 
1303
incorporates scalability and reliability enhancements for supporting large
 
1304
filesystem.
1262
1305
 
1263
1306
The options
1264
1307
.B journal_dev, noload, data, commit, orlov, oldalloc, [no]user_xattr
1279
1322
'journal_checksum' internally.
1280
1323
.TP
1281
1324
.BR journal=update
1282
 
Update the ext4 file system's journal to the current format.
 
1325
Update the ext4 filesystem's journal to the current format.
1283
1326
.TP
1284
1327
.BR barrier=0 " / "  barrier=1 " / " barrier " / " nobarrier
1285
1328
This enables/disables the use of write barriers in the jbd code.  barrier=0
1291
1334
barriers may safely improve performance.  The mount options "barrier" and
1292
1335
"nobarrier" can also be used to enable or disable barriers, for consistency
1293
1336
with other ext4 mount options.
 
1337
 
 
1338
The ext4 filesystem enables write barriers by default.
1294
1339
.TP
1295
1340
.BI inode_readahead= n
1296
1341
This tuning parameter controls the maximum number of inode table blocks that
1300
1345
.BI stripe= n
1301
1346
Number of filesystem blocks that mballoc will try to use for allocation size
1302
1347
and alignment. For RAID5/6 systems this should be the number of data disks *
1303
 
RAID chunk size in file system blocks.
 
1348
RAID chunk size in filesystem blocks.
1304
1349
.TP
1305
1350
.BR delalloc
1306
1351
Deferring block allocation until write-out time.
1336
1381
This defaults to 3, which is a slightly higher priority than the default I/O
1337
1382
priority.
1338
1383
.TP
1339
 
.BR auto_da_alloc " / " noauto_da_alloc
 
1384
.BR auto_da_alloc | noauto_da_alloc
1340
1385
Many broken applications don't use fsync() when noauto_da_alloc
1341
1386
replacing existing files via patterns such as
1342
1387
 
1364
1409
.I vfat
1365
1410
filesystems.)
1366
1411
.TP
1367
 
.BR blocksize=512 " / " blocksize=1024 " / " blocksize=2048
 
1412
.BR blocksize= { 512 | 1024 | 2048 }
1368
1413
Set blocksize (default 512). This option is obsolete.
1369
1414
.TP
1370
1415
\fBuid=\fP\fIvalue\fP and \fBgid=\fP\fIvalue\fP
1414
1459
Three different levels of pickyness can be chosen:
1415
1460
.RS
1416
1461
.TP
1417
 
.B r[elaxed]
 
1462
.BR r [ elaxed ]
1418
1463
Upper and lower case are accepted and equivalent, long name parts are
1419
1464
truncated (e.g.
1420
1465
.I verylongname.foobar
1422
1467
.IR verylong.foo ),
1423
1468
leading and embedded spaces are accepted in each name part (name and extension).
1424
1469
.TP
1425
 
.B n[ormal]
 
1470
.BR n [ ormal ]
1426
1471
Like "relaxed", but many special characters (*, ?, <, spaces, etc.) are
1427
1472
rejected.  This is the default.
1428
1473
.TP
1429
 
.B s[trict]
 
1474
.BR s [ trict ]
1430
1475
Like "normal", but names may not contain long parts and special characters
1431
1476
that are sometimes used on Linux, but are not accepted by MS-DOS are
1432
1477
rejected. (+, =, spaces, etc.)
1436
1481
Sets the codepage for converting to shortname characters on FAT
1437
1482
and VFAT filesystems. By default, codepage 437 is used.
1438
1483
.TP
1439
 
.BR conv=b[inary] " / " conv=t[ext] " / " conv=a[uto]
 
1484
.BR conv= {b [ inary ]| t [ ext ]| a [ uto ]}
1440
1485
The
1441
1486
.I fat
1442
 
file system can perform CRLF<-->NL (MS-DOS text format to UNIX text
 
1487
filesystem can perform CRLF<-->NL (MS-DOS text format to UNIX text
1443
1488
format) conversion in the kernel. The following conversion modes are
1444
1489
available:
1445
1490
.RS
1462
1507
Programs that do computed lseeks won't like in-kernel text conversion.
1463
1508
Several people have had their data ruined by this translation. Beware!
1464
1509
 
1465
 
For file systems mounted in binary mode, a conversion tool
 
1510
For filesystems mounted in binary mode, a conversion tool
1466
1511
(fromdos/todos) is available. This option is obsolete.
1467
1512
.RE
1468
1513
.TP
1479
1524
.B debug
1480
1525
Turn on the
1481
1526
.I debug
1482
 
flag.  A version string and a list of file system parameters will be
 
1527
flag.  A version string and a list of filesystem parameters will be
1483
1528
printed (these data are also printed if the parameters appear to be
1484
1529
inconsistent).
1485
1530
.TP
1486
 
.BR fat=12 " / " fat=16 " / " fat=32
 
1531
.BR fat= {12 | 16 | 32 }
1487
1532
Specify a 12, 16 or 32 bit fat.  This overrides
1488
1533
the automatic FAT type detection routine.  Use with caution!
1489
1534
.TP
1495
1540
.BI tz=UTC
1496
1541
This option disables the conversion of timestamps
1497
1542
between local time (as used by Windows on FAT) and UTC
1498
 
(which Linux uses internally).  This is particuluarly
 
1543
(which Linux uses internally).  This is particularly
1499
1544
useful when mounting devices (like digital cameras)
1500
1545
that are set to UTC in order to avoid the pitfalls of
1501
1546
local time.
1526
1571
case. If you are sure the "free clusters" on FSINFO is
1527
1572
correct, by this option you can avoid scanning disk.
1528
1573
.TP
1529
 
.B "dots, nodots, dotsOK=[yes|no]"
 
1574
.BR dots ", " nodots ", " dotsOK= [ yes | no ]
1530
1575
Various misguided attempts to force Unix or DOS conventions
1531
 
onto a FAT file system.
 
1576
onto a FAT filesystem.
1532
1577
 
1533
1578
.SH "Mount options for hfs"
1534
1579
.TP
1569
1614
present). The default is the umask of the current process.
1570
1615
The value is given in octal.
1571
1616
.TP
1572
 
.BR case=lower " / " case=asis
 
1617
.BR case= { lower | asis }
1573
1618
Convert all files names to lower case, or leave them.
1574
1619
(Default:
1575
1620
.BR case=lower .)
1576
1621
.TP
1577
 
.BR conv=binary " / " conv=text " / " conv=auto
 
1622
.BR conv= { binary | text | auto }
1578
1623
For
1579
1624
.BR conv=text ,
1580
1625
delete some random CRs (in particular, all followed by NL)
1606
1651
Rock Ridge is an extension to iso9660 that provides all of these unix like
1607
1652
features.  Basically there are extensions to each directory record that
1608
1653
supply all of the additional information, and when Rock Ridge is in use,
1609
 
the filesystem is indistinguishable from a normal UNIX file system (except
 
1654
the filesystem is indistinguishable from a normal UNIX filesystem (except
1610
1655
that it is read-only, of course).
1611
1656
.TP
1612
1657
.B norock
1617
1662
Disable the use of Microsoft Joliet extensions, even if available. Cf.\&
1618
1663
.BR map .
1619
1664
.TP
1620
 
.BR check=r[elaxed] " / " check=s[trict]
 
1665
.BR check= { r [ elaxed ]| s [ trict ]}
1621
1666
With
1622
1667
.BR check=relaxed ,
1623
1668
a filename is first converted to lower case before doing the lookup.
1629
1674
.BR check=strict .)
1630
1675
.TP
1631
1676
\fBuid=\fP\fIvalue\fP and \fBgid=\fP\fIvalue\fP
1632
 
Give all files in the file system the indicated user or group id,
 
1677
Give all files in the filesystem the indicated user or group id,
1633
1678
possibly overriding the information found in the Rock Ridge extensions.
1634
1679
(Default:
1635
1680
.BR uid=0,gid=0 .)
1636
1681
.TP
1637
 
.BR map=n[ormal] " / " map=o[ff] " / " map=a[corn]
 
1682
.BR map= { n [ ormal ]| o [ ff ]| a [ corn ]}
1638
1683
For non-Rock Ridge volumes, normal name translation maps upper
1639
1684
to lower case ASCII, drops a trailing `;1', and converts `;' to `.'.
1640
1685
With
1659
1704
(If the ordinary files and the associated or hidden files have
1660
1705
the same filenames, this may make the ordinary files inaccessible.)
1661
1706
.TP
1662
 
.B block=[512|1024|2048]
 
1707
.BR block= { 512 | 1024 | 2048 }
1663
1708
Set the block size to the indicated value.
1664
1709
(Default:
1665
1710
.BR block=1024 .)
1666
1711
.TP
1667
 
.BR conv=a[uto] " / " conv=b[inary] " / " conv=m[text] " / " conv=t[ext]
 
1712
.BR conv= { a [ uto ]| b [ inary ]| m [ text ]| t [ ext ]}
1668
1713
(Default:
1669
1714
.BR conv=binary .)
1670
1715
Since Linux 1.3.54 this option has no effect anymore.
1722
1767
.B nointegrity
1723
1768
option was previously specified in order to restore normal behavior.
1724
1769
.TP
1725
 
.BR errors=continue " / " errors=remount-ro " / " errors=panic
 
1770
.BR errors= { continue | remount-ro | panic }
1726
1771
Define the behaviour when an error is encountered.
1727
 
(Either ignore errors and just mark the file system erroneous and continue,
1728
 
or remount the file system read-only, or panic and halt the system.)
 
1772
(Either ignore errors and just mark the filesystem erroneous and continue,
 
1773
or remount the filesystem read-only, or panic and halt the system.)
1729
1774
.TP
1730
 
.BR noquota " / " quota " / " usrquota " / " grpquota
 
1775
.BR noquota | quota | usrquota | grpquota
1731
1776
These options are accepted but ignored.
1732
1777
 
1733
1778
.SH "Mount options for minix"
1737
1782
See mount options for fat.
1738
1783
If the
1739
1784
.I msdos
1740
 
file system detects an inconsistency, it reports an error and sets the file
1741
 
system read-only. The file system can be made writeable again by remounting
 
1785
filesystem detects an inconsistency, it reports an error and sets the file
 
1786
system read-only. The filesystem can be made writeable again by remounting
1742
1787
it.
1743
1788
 
1744
1789
.SH "Mount options for ncpfs"
1783
1828
.BR utf8
1784
1829
Use UTF-8 for converting file names.
1785
1830
.TP
1786
 
.B uni_xlate=[0|1|2]
 
1831
.BR uni_xlate= { 0 | 1 | 2 }
1787
1832
For 0 (or `no' or `false'), do not use escape sequences
1788
1833
for unknown Unicode characters.
1789
1834
For 1 (or `yes' or `true') or 2, use vfat-style 4-byte escape sequences
1791
1836
and 1 a byteswapped bigendian encoding.
1792
1837
.TP
1793
1838
.B posix=[0|1]
1794
 
If enabled (posix=1), the file system distinguishes between
 
1839
If enabled (posix=1), the filesystem distinguishes between
1795
1840
upper and lower case. The 8.3 alias names are presented as
1796
1841
hard links instead of being suppressed. This option is obsolete.
1797
1842
.TP
1814
1859
Reiserfs is a journaling filesystem.
1815
1860
.TP
1816
1861
.BR conv
1817
 
Instructs version 3.6 reiserfs software to mount a version 3.5 file system,
1818
 
using the 3.6 format for newly created objects. This file system will no
 
1862
Instructs version 3.6 reiserfs software to mount a version 3.5 filesystem,
 
1863
using the 3.6 format for newly created objects. This filesystem will no
1819
1864
longer be compatible with reiserfs 3.5 tools.
1820
1865
.TP
1821
 
.BR hash=rupasov " / " hash=tea " / " hash=r5 " / " hash=detect
 
1866
.BR hash= { rupasov | tea | r5 | detect }
1822
1867
Choose which hash function reiserfs will use to find files within directories.
1823
1868
.RS
1824
1869
.TP
1826
1871
A hash invented by Yury Yu. Rupasov.  It is fast and preserves locality,
1827
1872
mapping lexicographically close file names to close hash values.
1828
1873
This option should not be used, as it causes a high probability of hash
1829
 
collisions. 
 
1874
collisions.
1830
1875
.TP
1831
1876
.B tea
1832
1877
A Davis-Meyer function implemented by Jeremy Fitzhardinge.
1833
1878
It uses hash permuting bits in the name.  It gets high randomness
1834
1879
and, therefore, low probability of hash collisions at some CPU cost.
1835
 
This may be used if EHASHCOLLISION errors are experienced with the r5 hash. 
 
1880
This may be used if EHASHCOLLISION errors are experienced with the r5 hash.
1836
1881
.TP
1837
1882
.B r5
1838
1883
A modified version of the rupasov hash. It is used by default and is
1839
 
the best choice unless the file system has huge directories and
1840
 
unusual file-name patterns. 
 
1884
the best choice unless the filesystem has huge directories and
 
1885
unusual file-name patterns.
1841
1886
.TP
1842
1887
.B detect
1843
1888
Instructs
1844
1889
.IR mount
1845
1890
to detect which hash function is in use by examining
1846
 
the file system being mounted,  and to write this information into
 
1891
the filesystem being mounted,  and to write this information into
1847
1892
the reiserfs superblock. This is only useful on the first mount of
1848
 
an old format file system. 
 
1893
an old format filesystem.
1849
1894
.RE
1850
1895
.TP
1851
1896
.BR hashed_relocation
1852
1897
Tunes the block allocator. This may provide performance improvements
1853
 
in some situations. 
 
1898
in some situations.
1854
1899
.TP
1855
1900
.BR no_unhashed_relocation
1856
1901
Tunes the block allocator. This may provide performance improvements
1872
1917
.BR notail
1873
1918
By default, reiserfs stores small files and `file tails' directly into its
1874
1919
tree. This confuses some utilities such as
1875
 
.BR LILO (8) .
1876
 
This option is used to disable packing of files into the tree. 
 
1920
.BR LILO (8).
 
1921
This option is used to disable packing of files into the tree.
1877
1922
.TP
1878
1923
.BR replayonly
1879
1924
Replay the transactions which are in the journal, but do not actually
1880
 
mount the file system. Mainly used by
 
1925
mount the filesystem. Mainly used by
1881
1926
.IR reiserfsck .
1882
1927
.TP
1883
1928
.BI resize= number
1901
1946
Enable POSIX Access Control Lists. See the
1902
1947
.BR acl (5)
1903
1948
manual page.
 
1949
.TP
 
1950
.BR barrier=none " / "  barrier=flush "
 
1951
This enables/disables the use of write barriers in the journaling code.
 
1952
barrier=none disables it, barrier=flush enables it. Write barriers enforce
 
1953
proper on-disk ordering of journal commits, making volatile disk write caches
 
1954
safe to use, at some performance penalty. The reiserfs filesystem does not
 
1955
enable write barriers by default. Be sure to enable barriers unless your disks
 
1956
are battery-backed one way or another. Otherwise you risk filesystem
 
1957
corruption in case of power failure.
1904
1958
 
1905
1959
.SH "Mount options for romfs"
1906
1960
None.
1907
1961
 
 
1962
.SH "Mount options for squashfs"
 
1963
None.
 
1964
 
1908
1965
.SH "Mount options for smbfs"
1909
1966
Just like
1910
1967
.IR nfs ", the " smbfs
1923
1980
.TP
1924
1981
.BI size= nbytes
1925
1982
Override default maximum size of the filesystem.
1926
 
The size is given in bytes, and rounded down to entire pages.
 
1983
The size is given in bytes, and rounded up to entire pages.
1927
1984
The default is half of the memory. The size parameter also accepts a suffix %
1928
1985
to limit this tmpfs instance to that percentage of your physical RAM:
1929
1986
the default, when neither size nor nr_blocks is specified, is size=50%
1994
2051
on MountPoint, by 'mount -o remount,mpol=Policy:NodeList MountPoint'.
1995
2052
.PE
1996
2053
 
 
2054
.SH "Mount options for ubifs"
 
2055
UBIFS is a flash file system which works on top of UBI volumes. Note that
 
2056
.B
 
2057
atime
 
2058
is not supported and is always turned off.
 
2059
.TP
 
2060
The device name may be specified as
 
2061
.RS
 
2062
.B ubiX_Y
 
2063
UBI device number
 
2064
.BR X ,
 
2065
volume number
 
2066
.B Y
 
2067
.TP
 
2068
.B ubiY
 
2069
UBI device number
 
2070
.BR 0 ,
 
2071
volume number
 
2072
.B Y
 
2073
.TP
 
2074
.B ubiX:NAME
 
2075
UBI device number
 
2076
.BR X ,
 
2077
volume with name
 
2078
.B NAME
 
2079
.TP
 
2080
.B ubi:NAME
 
2081
UBI device number
 
2082
.BR 0 ,
 
2083
volume with name
 
2084
.B NAME
 
2085
.RE
 
2086
Alternative
 
2087
.B !
 
2088
separator may be used instead of
 
2089
.BR : .
 
2090
.TP
 
2091
The following mount options are available:
 
2092
.TP
 
2093
.BR bulk_read
 
2094
Enable bulk-read. VFS read-ahead is disabled because it slows down the file
 
2095
system. Bulk-Read is an internal optimization. Some flashes may read faster if
 
2096
the data are read at one go, rather than at several read requests. For
 
2097
example, OneNAND can do "read-while-load" if it reads more than one NAND page.
 
2098
.TP
 
2099
.BR no_bulk_read
 
2100
Do not bulk-read. This is the default.
 
2101
.TP
 
2102
.BR chk_data_crc
 
2103
Check data CRC-32 checksums. This is the default.
 
2104
.TP
 
2105
.BR no_chk_data_crc.
 
2106
Do not check data CRC-32 checksums. With this option, the filesystem does not
 
2107
check CRC-32 checksum for data, but it does check it for the internal indexing
 
2108
information. This option only affects reading, not writing. CRC-32 is always
 
2109
calculated when writing the data.
 
2110
.TP
 
2111
.BR compr= { none | lzo | zlib }
 
2112
Select the default compressor which is used when new files are written. It is
 
2113
still possible to read compressed files if mounted with the
 
2114
.B none
 
2115
option.
 
2116
 
1997
2117
.SH "Mount options for udf"
1998
2118
udf is the "Universal Disk Format" filesystem defined by the Optical
1999
2119
Storage Technology Association, and is often used for DVD-ROM.
2055
2175
.SH "Mount options for ufs"
2056
2176
.TP
2057
2177
.BI ufstype= value
2058
 
UFS is a file system widely used in different operating systems.
 
2178
UFS is a filesystem widely used in different operating systems.
2059
2179
The problem are differences among implementations. Features of some
2060
2180
implementations are undocumented, so its hard to recognize the
2061
2181
type of ufs automatically.
2098
2218
.B panic
2099
2219
If an error is encountered, cause a kernel panic.
2100
2220
.TP
2101
 
.B [lock|umount|repair]
 
2221
.RB [ lock | umount | repair ]
2102
2222
These mount options don't do anything at present;
2103
2223
when an error is encountered only a console message is printed.
2104
2224
.RE
2143
2263
with utf8=0, utf8=no or utf8=false. If `uni_xlate' gets set, UTF8 gets
2144
2264
disabled.
2145
2265
.TP
2146
 
.B shortname=[lower|win95|winnt|mixed]
 
2266
.BR shortname= { lower | win95 | winnt | mixed }
2147
2267
 
2148
2268
Defines the behaviour for creation and display of filenames which fit into
2149
2269
8.3 characters. If a long name for a file exists, it will always be
2167
2287
Display the short name as is; store a long name when the short name is not
2168
2288
all upper case.
2169
2289
.RE
2170
 
.TP
2171
2290
 
2172
2291
 
2173
2292
.SH "Mount options for usbfs"
2174
2293
.TP
2175
2294
\fBdevuid=\fP\fIuid\fP and \fBdevgid=\fP\fIgid\fP and \fBdevmode=\fP\fImode\fP
2176
 
Set the owner and group and mode of the device files in the usbfs file system
 
2295
Set the owner and group and mode of the device files in the usbfs filesystem
2177
2296
(default: uid=gid=0, mode=0644). The mode is given in octal.
2178
2297
.TP
2179
2298
\fBbusuid=\fP\fIuid\fP and \fBbusgid=\fP\fIgid\fP and \fBbusmode=\fP\fImode\fP
2180
2299
Set the owner and group and mode of the bus directories in the usbfs
2181
 
file system (default: uid=gid=0, mode=0555). The mode is given in octal.
 
2300
filesystem (default: uid=gid=0, mode=0555). The mode is given in octal.
2182
2301
.TP
2183
2302
\fBlistuid=\fP\fIuid\fP and \fBlistgid=\fP\fIgid\fP and \fBlistmode=\fP\fImode\fP
2184
2303
Set the owner and group and mode of the file
2196
2315
Valid values for this option are page size (typically 4KiB)
2197
2316
through to 1GiB, inclusive, in power-of-2 increments.
2198
2317
.TP
2199
 
.BR attr2 " / " noattr2
2200
 
The options enable/disable (default is disabled for backward
2201
 
compatibility on-disk) an "opportunistic" improvement to be
2202
 
made in the way inline extended attributes are stored on-disk.
 
2318
.BR attr2 | noattr2
 
2319
The options enable/disable (default is enabled) an "opportunistic"
 
2320
improvement to be made in the way inline extended attributes are
 
2321
stored on-disk.
2203
2322
When the new form is used for the first time (by setting or
2204
2323
removing extended attributes) the on-disk superblock feature
2205
2324
bit field will be updated to reflect this format being in use.
2216
2335
.B mtpt
2217
2336
option.
2218
2337
.TP
2219
 
\fBgrpid\fP / \fBbsdgroups\fP and \fBnogrpid\fP / \fBsysvgroups\fP
 
2338
.BR grpid | bsdgroups " and " nogrpid | sysvgroups
2220
2339
These options define what group ID a newly created file gets.
2221
2340
When grpid is set, it takes the group ID of the directory in
2222
2341
which it is created; otherwise (the default) it takes the fsgid
2231
2350
will be displayed in
2232
2351
.IR /proc/mounts .
2233
2352
.TP
2234
 
.BR ikeep " / " noikeep
 
2353
.BR ikeep | noikeep
2235
2354
When inode clusters are emptied of inodes, keep them around
2236
2355
on the disk (ikeep) - this is the traditional XFS behaviour
2237
2356
and is still the default for now.  Using the noikeep option,
2244
2363
provided for backwards compatibility, but causes problems for
2245
2364
backup applications that cannot handle large inode numbers.
2246
2365
.TP
2247
 
.BR largeio " / " nolargeio
 
2366
.BR largeio | nolargeio
2248
2367
If
2249
2368
.B nolargeio
2250
2369
is specified, the optimal I/O reported in
2328
2447
must be mounted read-only or the mount will fail.
2329
2448
.TP
2330
2449
.B nouuid
2331
 
Don't check for double mounted file systems using the file system uuid.
 
2450
Don't check for double mounted filesystems using the filesystem uuid.
2332
2451
This is useful to mount LVM snapshot volumes.
2333
2452
.TP
2334
2453
.B osyncisosync
2346
2465
.B osyncisosync
2347
2466
option.
2348
2467
.TP
2349
 
.BR uquota " / " usrquota " / " uqnoenforce " / " quota
 
2468
.BR uquota | usrquota | uqnoenforce | quota
2350
2469
User disk quota accounting enabled, and limits (optionally)
2351
2470
enforced.  Refer to
2352
2471
.BR xfs_quota (8)
2353
2472
for further details.
2354
2473
.TP
2355
 
.BR gquota " / " grpquota " / " gqnoenforce
 
2474
.BR gquota | grpquota | gqnoenforce
2356
2475
Group disk quota accounting enabled and limits (optionally)
2357
2476
enforced. Refer to
2358
2477
.BR xfs_quota (8)
2359
2478
for further details.
2360
2479
.TP
2361
 
.BR pquota " / " prjquota " / " pqnoenforce
 
2480
.BR pquota | prjquota | pqnoenforce
2362
2481
Project disk quota accounting enabled and limits (optionally)
2363
2482
enforced. Refer to
2364
2483
.BR xfs_quota (8)
2426
2545
.B mount
2427
2546
will try to find some unused loop device and use that.
2428
2547
 
2429
 
Since Linux 2.6.25 is supported auto-destruction of loop devices and 
 
2548
Since Linux 2.6.25 is supported auto-destruction of loop devices and
2430
2549
then any loop device allocated by
2431
2550
.B mount
2432
2551
will be freed by
2433
2552
.B umount
2434
2553
independently on
2435
 
.I /etc/mtab .
 
2554
.IR /etc/mtab .
2436
2555
 
2437
2556
You can also free a loop device by hand, using `losetup -d' or `umount -d`.
2438
2557
 
2470
2589
The syntax of external mount helpers is:
2471
2590
 
2472
2591
.RS
2473
 
.B "/sbin/mount.<suffix> spec dir [\-sfnv] [\-o options]
 
2592
.BI /sbin/mount. <suffix>
 
2593
.I spec dir
 
2594
.RB [ \-sfnv ]
 
2595
.RB [ \-o
 
2596
.IR options ]
2474
2597
.RE
2475
2598
 
2476
2599
where the <suffix> is filesystem type and \-sfnvo options have same meaning like
2479
2602
.SH FILES
2480
2603
.TP 18n
2481
2604
.I /etc/fstab
2482
 
file system table
 
2605
filesystem table
2483
2606
.TP
2484
2607
.I /etc/mtab
2485
 
table of mounted file systems
 
2608
table of mounted filesystems
2486
2609
.TP
2487
2610
.I /etc/mtab~
2488
2611
lock file
2509
2632
.BR tune2fs (8),
2510
2633
.BR losetup (8)
2511
2634
.SH BUGS
2512
 
It is possible for a corrupted file system to cause a crash.
 
2635
It is possible for a corrupted filesystem to cause a crash.
2513
2636
.PP
2514
 
Some Linux file systems don't support
 
2637
Some Linux filesystems don't support
2515
2638
.B "\-o sync and \-o dirsync"
2516
 
(the ext2, ext3, fat and vfat file systems
 
2639
(the ext2, ext3, fat and vfat filesystems
2517
2640
.I do
2518
2641
support synchronous updates (a la BSD) when mounted with the
2519
2642
.B sync
2520
 
option). 
 
2643
option).
2521
2644
.PP
2522
2645
The
2523
2646
.B "\-o remount"