1MOUNT(8)                     System Administration                    MOUNT(8)
2
3
4

NAME

6       mount - mount a filesystem
7

SYNOPSIS

9       mount [-h|-V]
10
11       mount [-l] [-t fstype]
12
13       mount -a [-fFnrsvw] [-t fstype] [-O optlist]
14
15       mount [-fnrsvw] [-o options] device|mountpoint
16
17       mount [-fnrsvw] [-t fstype] [-o options] device mountpoint
18
19       mount --bind|--rbind|--move olddir newdir
20
21       mount      --make-{shared|slave|private|unbindable|rshared|rslave|rpri‐
22       vate|runbindable} mountpoint
23

DESCRIPTION

25       All files accessible in a Unix system are arranged in one big tree, the
26       file  hierarchy,  rooted at /.  These files can be spread out over sev‐
27       eral devices.  The mount command serves to attach the filesystem  found
28       on some device to the big file tree.  Conversely, the umount(8) command
29       will detach it again.  The filesystem is used to control  how  data  is
30       stored  on  the device or provided in a virtual way by network or other
31       services.
32
33       The standard form of the mount command is:
34
35              mount -t type device dir
36
37       This tells the kernel to attach the filesystem found on  device  (which
38       is of type type) at the directory dir.  The option -t type is optional.
39       The mount command is usually able to detect  a  filesystem.   The  root
40       permissions  are  necessary to mount a filesystem by default.  See sec‐
41       tion "Non-superuser mounts" below for more details.  The previous  con‐
42       tents  (if any) and owner and mode of dir become invisible, and as long
43       as this filesystem remains mounted, the pathname dir refers to the root
44       of the filesystem on device.
45
46       If only the directory or the device is given, for example:
47
48              mount /dir
49
50       then  mount looks for a mountpoint (and if not found then for a device)
51       in the /etc/fstab file.  It's possible to use the --target or  --source
52       options  to  avoid ambiguous interpretation of the given argument.  For
53       example:
54
55              mount --target /mountpoint
56
57
58       The same filesystem may be mounted more than once, and  in  some  cases
59       (e.g.,  network  filesystems) the same filesystem may be mounted on the
60       same mountpoint multiple times. The mount command  does  not  implement
61       any  policy to control this behavior. All behavior is controlled by the
62       kernel and it is usually specific to the filesystem driver. The  excep‐
63       tion  is  --all,  in  this case already mounted filesystems are ignored
64       (see --all below for more details).
65
66
67   Listing the mounts
68       The listing mode is maintained for backward compatibility only.
69
70       For more robust and customizable output use findmnt(8),  especially  in
71       your  scripts.  Note that control characters in the mountpoint name are
72       replaced with '?'.
73
74       The following command lists all mounted filesystems (of type type):
75
76              mount [-l] [-t type]
77
78       The option -l adds labels to this listing.  See below.
79
80
81   Indicating the device and filesystem
82       Most devices are indicated by a filename (of a block  special  device),
83       like /dev/sda1, but there are other possibilities.  For example, in the
84       case of an NFS mount, device may look like knuth.cwi.nl:/dir.
85
86       The device names of disk partitions are unstable; hardware reconfigura‐
87       tion, and adding or removing a device can cause changes in names.  This
88       is the reason why it's strongly recommended to use filesystem or parti‐
89       tion  identifiers  like  UUID or LABEL. Currently supported identifiers
90       (tags):
91
92              LABEL=label
93                     Human readable filesystem identifier. See also -L.
94
95              UUID=uuid
96                     Filesystem universally unique identifier. The  format  of
97                     the  UUID  is usually a series of hex digits separated by
98                     hyphens. See also -U.
99
100                     Note that mount(8) uses UUIDs as strings.  The UUIDs from
101                     the  command  line  or from fstab(5) are not converted to
102                     internal binary representation.  The  string  representa‐
103                     tion  of  the  UUID should be based on lower case charac‐
104                     ters.
105
106              PARTLABEL=label
107                     Human readable partition identifier.  This identifier  is
108                     independent  on filesystem and does not change by mkfs or
109                     mkswap operations It's supported  for  example  for  GUID
110                     Partition Tables (GPT).
111
112              PARTUUID=uuid
113                     Partition universally unique identifier.  This identifier
114                     is independent on filesystem and does not change by  mkfs
115                     or mkswap operations  It's supported for example for GUID
116                     Partition Tables (GPT).
117
118              ID=id  Hardware block device ID as  generated  by  udevd.   This
119                     identifier  is usually based on WWN (unique storage iden‐
120                     tifier) and assigned by the hardware  manufacturer.   See
121                     ls  /dev/disk/by-id  for more details, this directory and
122                     running udevd is required.  This identifier is not recom‐
123                     mended  for generic use as the identifier is not strictly
124                     defined and it depends on udev, udev rules and hardware.
125
126       The command lsblk --fs provides an overview of filesystems, LABELs  and
127       UUIDs  on  available block devices.  The command blkid -p <device> pro‐
128       vides details about a filesystem on the specified device.
129
130       Don't forget that there is no guarantee that UUIDs and labels  are  re‐
131       ally unique, especially if you move, share or copy the device.  Use ls‐
132       blk -o +UUID,PARTUUID to verify that the UUIDs  are  really  unique  in
133       your system.
134
135       The  recommended  setup  is  to  use  tags (e.g. UUID=uuid) rather than
136       /dev/disk/by-{label,uuid,id,partuuid,partlabel} udev  symlinks  in  the
137       /etc/fstab  file.   Tags  are  more readable, robust and portable.  The
138       mount(8) command internally uses udev symlinks, so the use of  symlinks
139       in  /etc/fstab  has  no advantage over tags.  For more details see lib‐
140       blkid(3).
141
142       The proc filesystem is not associated with a special device,  and  when
143       mounting it, an arbitrary keyword—for example, proc—can be used instead
144       of a device specification.  (The customary choice none is  less  fortu‐
145       nate:  the  error message `none already mounted' from mount can be con‐
146       fusing.)
147
148
149   The files /etc/fstab, /etc/mtab and /proc/mounts
150       The file /etc/fstab (see fstab(5)), may contain lines  describing  what
151       devices  are  usually  mounted where, using which options.  The default
152       location of the fstab(5) file can be overridden with the  --fstab  path
153       command-line option (see below for more details).
154
155       The command
156
157              mount -a [-t type] [-O optlist]
158
159       (usually  given  in  a  bootscript) causes all filesystems mentioned in
160       fstab (of the proper type and/or having or not having  the  proper  op‐
161       tions) to be mounted as indicated, except for those whose line contains
162       the noauto keyword.  Adding the -F option will make mount fork, so that
163       the filesystems are mounted in parallel.
164
165       When  mounting  a filesystem mentioned in fstab or mtab, it suffices to
166       specify on the command line only the device, or only the mount point.
167
168       The programs mount and umount traditionally maintained a list  of  cur‐
169       rently mounted filesystems in the file /etc/mtab.  The support for reg‐
170       ular classic /etc/mtab is completely disabled at compile  time  by  de‐
171       fault,  because on current Linux systems it is better to make /etc/mtab
172       a symlink to /proc/mounts instead. The regular mtab file maintained  in
173       userspace  cannot  reliably  work with namespaces, containers and other
174       advanced Linux features.  If the regular mtab support is enabled,  then
175       it's possible to use the file as well as the symlink.
176
177       If  no arguments are given to mount, the list of mounted filesystems is
178       printed.
179
180       If you want to override mount options from /etc/fstab, you have to  use
181       the -o option:
182
183              mount device|dir -o options
184
185       and  then  the  mount options from the command line will be appended to
186       the list of options from /etc/fstab.  This  default  behaviour  can  be
187       changed using the --options-mode command-line option.  The usual behav‐
188       ior is that the last option wins if there are conflicting ones.
189
190       The mount program does not read the /etc/fstab file if both device  (or
191       LABEL, UUID, ID, PARTUUID or PARTLABEL) and dir are specified.  For ex‐
192       ample, to mount device foo at /dir:
193
194              mount /dev/foo /dir
195
196       This  default  behaviour  can   be   changed   by   using   the   --op‐
197       tions-source-force  command-line  option  to  always read configuration
198       from fstab.  For non-root users mount always reads the fstab configura‐
199       tion.
200
201
202   Non-superuser mounts
203       Normally,  only  the  superuser  can  mount filesystems.  However, when
204       fstab contains the user option on a line, anybody can mount the  corre‐
205       sponding filesystem.
206
207       Thus, given a line
208
209              /dev/cdrom  /cd  iso9660  ro,user,noauto,unhide
210
211       any  user  can  mount the iso9660 filesystem found on an inserted CDROM
212       using the command:
213
214              mount /cd
215
216       Note that mount is very strict about non-root users and all paths spec‐
217       ified  on  command line are verified before fstab is parsed or a helper
218       program is executed. It's strongly recommended to use  a  valid  mount‐
219       point to specify filesystem, otherwise mount may fail. For example it's
220       a bad idea to use NFS or CIFS source on command line.
221
222       Since util-linux 2.35, mount does not exit when  user  permissions  are
223       inadequate  according  to libmount's internal security rules.  Instead,
224       it drops suid permissions and continues as regular non-root user.  This
225       behavior  supports  use-cases  where root permissions are not necessary
226       (e.g., fuse filesystems, user namespaces, etc).
227
228       For more details, see fstab(5).  Only the user that mounted a  filesys‐
229       tem  can  unmount  it again.  If any user should be able to unmount it,
230       then use users instead of user in the fstab line.  The owner option  is
231       similar  to the user option, with the restriction that the user must be
232       the owner of the special file.  This may be useful e.g. for /dev/fd  if
233       a  login script makes the console user owner of this device.  The group
234       option is similar, with the restriction that the user must be a  member
235       of the group of the special file.
236
237
238   Bind mount operation
239       Remount part of the file hierarchy somewhere else.  The call is:
240
241              mount --bind olddir newdir
242
243       or by using this fstab entry:
244
245              /olddir /newdir none bind
246
247       After this call the same contents are accessible in two places.
248
249       It  is  important to understand that "bind" does not create any second-
250       class or special node in the kernel VFS. The "bind" is just another op‐
251       eration  to  attach  a  filesystem. There is nowhere stored information
252       that the filesystem has been attached by a "bind" operation. The olddir
253       and newdir are independent and the olddir may be unmounted.
254
255       One  can also remount a single file (on a single file).  It's also pos‐
256       sible to use a bind mount to create a mountpoint from a regular  direc‐
257       tory, for example:
258
259              mount --bind foo foo
260
261       The  bind  mount  call attaches only (part of) a single filesystem, not
262       possible submounts.  The entire file hierarchy including submounts  can
263       be attached a second place by using:
264
265              mount --rbind olddir newdir
266
267       Note  that  the  filesystem mount options maintained by the kernel will
268       remain the same as those on the original mount  point.   The  userspace
269       mount options (e.g., _netdev) will not be copied by mount and it's nec‐
270       essary to explicitly specify the options on the mount command line.
271
272       Since util-linux 2.27 mount(8) permits changing the  mount  options  by
273       passing the relevant options along with --bind.  For example:
274
275              mount -o bind,ro foo foo
276
277       This feature is not supported by the Linux kernel; it is implemented in
278       userspace by an additional mount(2) remounting system call.  This solu‐
279       tion is not atomic.
280
281       The  alternative  (classic)  way to create a read-only bind mount is to
282       use the remount operation, for example:
283
284              mount --bind olddir newdir
285              mount -o remount,bind,ro olddir newdir
286
287       Note that a read-only bind will create a read-only mountpoint (VFS  en‐
288       try),  but  the  original filesystem superblock will still be writable,
289       meaning that the olddir will be writable, but the newdir will be  read-
290       only.
291
292       It's also possible to change nosuid, nodev, noexec, noatime, nodiratime
293       and relatime VFS entry flags via a "remount,bind" operation.  The other
294       flags  (for  example  filesystem-specific  flags) are silently ignored.
295       It's impossible to change mount options recursively (for  example  with
296       -o rbind,ro).
297
298       Since util-linux 2.31, mount ignores the bind flag from /etc/fstab on a
299       remount operation (if "-o remount" is specified on command line).  This
300       is necessary to fully control mount options on remount by command line.
301       In previous versions the bind flag has been always applied and  it  was
302       impossible to re-define mount options without interaction with the bind
303       semantic. This mount(8) behavior does not affect situations  when  "re‐
304       mount,bind" is specified in the /etc/fstab file.
305
306
307   The move operation
308       Move a mounted tree to another place (atomically).  The call is:
309
310              mount --move olddir newdir
311
312       This  will cause the contents which previously appeared under olddir to
313       now be accessible under newdir.  The physical location of the files  is
314       not changed.  Note that olddir has to be a mountpoint.
315
316       Note  also that moving a mount residing under a shared mount is invalid
317       and unsupported.  Use findmnt -o TARGET,PROPAGATION to see the  current
318       propagation flags.
319
320
321   Shared subtree operations
322       Since  Linux 2.6.15 it is possible to mark a mount and its submounts as
323       shared, private, slave or unbindable.   A  shared  mount  provides  the
324       ability  to  create mirrors of that mount such that mounts and unmounts
325       within any of the mirrors propagate to the other mirror.  A slave mount
326       receives  propagation  from  its master, but not vice versa.  A private
327       mount carries no propagation abilities.  An unbindable mount is a  pri‐
328       vate  mount  which  cannot be cloned through a bind operation.  The de‐
329       tailed semantics are documented in Documentation/filesystems/sharedsub‐
330       tree.txt file in the kernel source tree; see also mount_namespaces(7).
331
332       Supported operations are:
333
334              mount --make-shared mountpoint
335              mount --make-slave mountpoint
336              mount --make-private mountpoint
337              mount --make-unbindable mountpoint
338
339       The  following commands allow one to recursively change the type of all
340       the mounts under a given mountpoint.
341
342              mount --make-rshared mountpoint
343              mount --make-rslave mountpoint
344              mount --make-rprivate mountpoint
345              mount --make-runbindable mountpoint
346
347       mount(8) does not read fstab(5) when a --make-* operation is requested.
348       All necessary information has to be specified on the command line.
349
350       Note that the Linux kernel does not allow changing multiple propagation
351       flags with a single mount(2) system call, and the flags cannot be mixed
352       with other mount options and operations.
353
354       Since util-linux 2.23 the mount command can be used to do more propaga‐
355       tion (topology) changes by one mount(8) call and do  it  also  together
356       with other mount operations.  This feature is EXPERIMENTAL.  The propa‐
357       gation flags are applied by additional mount(2) system calls  when  the
358       preceding mount operations were successful.  Note that this use case is
359       not atomic.  It  is  possible  to  specify  the  propagation  flags  in
360       fstab(5)  as  mount  options (private, slave, shared, unbindable, rpri‐
361       vate, rslave, rshared, runbindable).
362
363       For example:
364
365              mount --make-private --make-unbindable /dev/sda1 /foo
366
367       is the same as:
368
369              mount /dev/sda1 /foo
370              mount --make-private /foo
371              mount --make-unbindable /foo
372
373

COMMAND-LINE OPTIONS

375       The full set of mount options used by an invocation of mount is  deter‐
376       mined by first extracting the mount options for the filesystem from the
377       fstab table, then applying any options specified by  the  -o  argument,
378       and finally applying a -r or -w option, when present.
379
380       The  mount  command  does  not  pass  all  command-line  options to the
381       /sbin/mount.suffix mount helpers.  The interface between mount and  the
382       mount helpers is described below in the section EXTERNAL HELPERS.
383
384       Command-line options available for the mount command are:
385
386       -a, --all
387              Mount  all  filesystems  (of the given types) mentioned in fstab
388              (except for those whose line contains the noauto keyword).   The
389              filesystems  are  mounted  following  their order in fstab.  The
390              mount command compares filesystem source, target  (and  fs  root
391              for  bind mount or btrfs) to detect already mounted filesystems.
392              The kernel table with already mounted filesystems is cached dur‐
393              ing  mount  --all.  This means that all duplicated fstab entries
394              will be mounted.
395
396              The option --all is possible to use for remount  operation  too.
397              In this case all filters (-t and -O) are applied to the table of
398              already mounted filesystems.
399
400              Since version 2.35 is possible to use the command line option -o
401              to alter mount options from fstab (see also --options-mode).
402
403              Note  that it is a bad practice to use mount -a for fstab check‐
404              ing. The recommended solution is findmnt --verify.
405
406       -B, --bind
407              Remount a subtree somewhere  else  (so  that  its  contents  are
408              available in both places).  See above, under Bind mounts.
409
410       -c, --no-canonicalize
411              Don't  canonicalize  paths.  The mount command canonicalizes all
412              paths (from the command line or fstab) by default.  This  option
413              can  be used together with the -f flag for already canonicalized
414              absolute paths.  The option is designed for mount helpers  which
415              call  mount -i.  It is strongly recommended to not use this com‐
416              mand-line option for normal mount operations.
417
418              Note  that  mount(8)  does  not  pass   this   option   to   the
419              /sbin/mount.type helpers.
420
421       -F, --fork
422              (Used  in  conjunction  with -a.)  Fork off a new incarnation of
423              mount for each device.  This will do the mounts on different de‐
424              vices or different NFS servers in parallel.  This has the advan‐
425              tage that it is faster; also NFS timeouts proceed  in  parallel.
426              A  disadvantage is that the order of the mount operations is un‐
427              defined.  Thus, you cannot use this option if you want to  mount
428              both /usr and /usr/spool.
429
430       -f, --fake
431              Causes  everything to be done except for the actual system call;
432              if it's not obvious, this  ``fakes''  mounting  the  filesystem.
433              This  option is useful in conjunction with the -v flag to deter‐
434              mine what the mount command is trying to do.   It  can  also  be
435              used  to  add entries for devices that were mounted earlier with
436              the -n option.  The -f option checks for an existing  record  in
437              /etc/mtab and fails when the record already exists (with a regu‐
438              lar non-fake mount, this check is done by the kernel).
439
440       -i, --internal-only
441              Don't call the /sbin/mount.filesystem helper even if it exists.
442
443       -L, --label label
444              Mount the partition that has the specified label.
445
446       -l, --show-labels
447              Add the labels in the mount output.  mount must have  permission
448              to  read  the disk device (e.g. be set-user-ID root) for this to
449              work.  One can set such a label for ext2, ext3 or ext4 using the
450              e2label(8)  utility, or for XFS using xfs_admin(8), or for reis‐
451              erfs using reiserfstune(8).
452
453       -M, --move
454              Move a subtree to some other place.  See above,  the  subsection
455              The move operation.
456
457       -n, --no-mtab
458              Mount without writing in /etc/mtab.  This is necessary for exam‐
459              ple when /etc is on a read-only filesystem.
460
461       -N, --namespace ns
462              Perform the mount operation in the mount namespace specified  by
463              ns.   ns  is  either PID of process running in that namespace or
464              special file representing that namespace.
465
466              mount(8)  switches  to  the  mount  namespace  when   it   reads
467              /etc/fstab, writes /etc/mtab (or writes to /run/mount) and calls
468              the mount(2) system call, otherwise  it  runs  in  the  original
469              mount  namespace.  This means that the target namespace does not
470              have to contain any libraries or other requirements necessary to
471              execute the mount(2) call.
472
473              See mount_namespaces(7) for more information.
474
475       -O, --test-opts opts
476              Limit the set of filesystems to which the -a option applies.  In
477              this regard it is like the -t option except that -O  is  useless
478              without -a.  For example, the command:
479
480                     mount -a -O no_netdev
481
482              mounts  all filesystems except those which have the option _net‐
483              dev specified in the options field in the /etc/fstab file.
484
485              It is different from -t in that each option is matched  exactly;
486              a  leading no at the beginning of one option does not negate the
487              rest.
488
489              The -t and -O options are cumulative in  effect;  that  is,  the
490              command
491
492                     mount -a -t ext2 -O _netdev
493
494              mounts  all  ext2  filesystems  with the _netdev option, not all
495              filesystems that are either ext2  or  have  the  _netdev  option
496              specified.
497
498       -o, --options opts
499              Use  the specified mount options.  The opts argument is a comma-
500              separated list.  For example:
501
502                     mount LABEL=mydisk -o noatime,nodev,nosuid
503
504
505              For more details, see the FILESYSTEM-INDEPENDENT  MOUNT  OPTIONS
506              and FILESYSTEM-SPECIFIC MOUNT OPTIONS sections.
507
508
509       --options-mode mode
510              Controls  how  to  combine  options from fstab/mtab with options
511              from the command line.  mode  can  be  one  of  ignore,  append,
512              prepend or replace.  For example, append means that options from
513              fstab are appended to options from the command  line.   The  de‐
514              fault  value  is  prepend  --  it means command line options are
515              evaluated after fstab options.  Note that the last  option  wins
516              if there are conflicting ones.
517
518
519       --options-source source
520              Source  of default options.  source is a comma-separated list of
521              fstab, mtab and disable.  disable disables fstab  and  mtab  and
522              disables   --options-source-force.    The   default   value   is
523              fstab,mtab.
524
525
526       --options-source-force
527              Use options from fstab/mtab even if  both  device  and  dir  are
528              specified.
529
530
531       -R, --rbind
532              Remount  a subtree and all possible submounts somewhere else (so
533              that its contents are available in both places).  See above, the
534              subsection Bind mounts.
535
536       -r, --read-only
537              Mount the filesystem read-only.  A synonym is -o ro.
538
539              Note  that,  depending  on the filesystem type, state and kernel
540              behavior, the system may still write to the device.   For  exam‐
541              ple,  ext3 and ext4 will replay the journal if the filesystem is
542              dirty.  To prevent this kind of write access, you  may  want  to
543              mount  an  ext3  or ext4 filesystem with the ro,noload mount op‐
544              tions or set the block device itself to read-only mode, see  the
545              blockdev(8) command.
546
547       -s     Tolerate  sloppy  mount  options rather than failing.  This will
548              ignore mount options not supported by a  filesystem  type.   Not
549              all  filesystems  support this option.  Currently it's supported
550              by the mount.nfs mount helper only.
551
552       --source device
553              If only one argument for the mount command is  given,  then  the
554              argument  might  be  interpreted  as  the target (mountpoint) or
555              source (device).  This option allows you  to  explicitly  define
556              that the argument is the mount source.
557
558       --target directory
559              If  only  one  argument for the mount command is given, then the
560              argument might be interpreted  as  the  target  (mountpoint)  or
561              source  (device).   This  option allows you to explicitly define
562              that the argument is the mount target.
563
564       --target-prefix directory
565              Prepend the specified directory to all mount targets.  This  op‐
566              tion  can be used to follow fstab, but mount operations are done
567              in another place, for example:
568
569                     mount --all --target-prefix /chroot -o X-mount.mkdir
570
571              mounts all from system fstab to /chroot, all missing  mountpoint
572              are  created (due to X-mount.mkdir).  See also --fstab to use an
573              alternative fstab.
574
575       -T, --fstab path
576              Specifies an alternative fstab file.  If path  is  a  directory,
577              then  the  files  in  the directory are sorted by strverscmp(3);
578              files that start with "." or without an .fstab extension are ig‐
579              nored.  The option can be specified more than once.  This option
580              is mostly designed for initramfs or chroot scripts  where  addi‐
581              tional configuration is specified beyond standard system config‐
582              uration.
583
584              Note that mount(8) does not  pass  the  option  --fstab  to  the
585              /sbin/mount.type  helpers,  meaning  that  the alternative fstab
586              files will be invisible for the helpers.  This is no problem for
587              normal  mounts,  but user (non-root) mounts always require fstab
588              to verify the user's rights.
589
590       -t, --types fstype
591              The argument following the -t is used to indicate the filesystem
592              type.  The filesystem types which are currently supported depend
593              on the running  kernel.   See  /proc/filesystems  and  /lib/mod‐
594              ules/$(uname  -r)/kernel/fs  for a complete list of the filesys‐
595              tems.  The most common are ext2, ext3, ext4, xfs,  btrfs,  vfat,
596              sysfs, proc, nfs and cifs.
597
598              The  programs mount and umount support filesystem subtypes.  The
599              subtype  is  defined  by  a  '.subtype'  suffix.   For   example
600              'fuse.sshfs'.   It's  recommended to use subtype notation rather
601              than add any prefix to the mount source (for example  'sshfs#ex‐
602              ample.com' is deprecated).
603
604              If  no  -t  option  is  given, or if the auto type is specified,
605              mount will try to guess the desired type.  Mount uses the  blkid
606              library  for guessing the filesystem type; if that does not turn
607              up anything that looks familiar, mount will try to read the file
608              /etc/filesystems, or, if that does not exist, /proc/filesystems.
609              All of the filesystem types listed there will be  tried,  except
610              for  those that are labeled "nodev" (e.g. devpts, proc and nfs).
611              If /etc/filesystems ends in a line with a single *,  mount  will
612              read /proc/filesystems afterwards.  While trying, all filesystem
613              types will be mounted with the mount option silent.
614
615              The auto type may be useful for user-mounted floppies.  Creating
616              a  file /etc/filesystems can be useful to change the probe order
617              (e.g., to try vfat before msdos or ext3 before ext2) or  if  you
618              use a kernel module autoloader.
619
620              More  than  one type may be specified in a comma-separated list,
621              for the -t option as well as in an /etc/fstab entry.   The  list
622              of filesystem types for the -t option can be prefixed with no to
623              specify the filesystem types on which no action should be taken.
624              The  prefix no has no effect when specified in an /etc/fstab en‐
625              try.
626
627              The prefix no can be meaningful with the -a option.   For  exam‐
628              ple, the command
629
630                     mount -a -t nomsdos,smbfs
631
632              mounts all filesystems except those of type msdos and smbfs.
633
634              For most types all the mount program has to do is issue a simple
635              mount(2) system call, and no detailed knowledge of the  filesys‐
636              tem  type is required.  For a few types however (like nfs, nfs4,
637              cifs, smbfs, ncpfs) an ad hoc code is necessary.  The nfs, nfs4,
638              cifs,  smbfs,  and  ncpfs filesystems have a separate mount pro‐
639              gram.  In order to make it possible to treat all types in a uni‐
640              form  way,  mount  will execute the program /sbin/mount.type (if
641              that exists) when called with type type.  Since  different  ver‐
642              sions  of  the  smbmount  program have different calling conven‐
643              tions, /sbin/mount.smbfs may have to be a shell script that sets
644              up the desired call.
645
646       -U, --uuid uuid
647              Mount the partition that has the specified uuid.
648
649       -v, --verbose
650              Verbose mode.
651
652       -w, --rw, --read-write
653              Mount  the  filesystem read/write.  Read-write is the kernel de‐
654              fault and the mount default is to try read-only if the  previous
655              mount  syscall  with read-write flags on write-protected devices
656              of filesystems failed.
657
658              A synonym is -o rw.
659
660              Note that specifying -w on the  command  line  forces  mount  to
661              never  try read-only mount on write-protected devices or already
662              mounted read-only filesystems.
663
664       -V, --version
665              Display version information and exit.
666
667       -h, --help
668              Display help text and exit.
669
670

FILESYSTEM-INDEPENDENT MOUNT OPTIONS

672       Some of  these  options  are  only  useful  when  they  appear  in  the
673       /etc/fstab file.
674
675       Some  of  these  options could be enabled or disabled by default in the
676       system kernel.  To  check  the  current  setting  see  the  options  in
677       /proc/mounts.   Note that filesystems also have per-filesystem specific
678       default mount options (see for  example  tune2fs  -l  output  for  extN
679       filesystems).
680
681       The  following  options  apply  to any filesystem that is being mounted
682       (but not every filesystem actually honors them – e.g., the sync  option
683       today has an effect only for ext2, ext3, ext4, fat, vfat, ufs and xfs):
684
685
686       async  All  I/O  to the filesystem should be done asynchronously.  (See
687              also the sync option.)
688
689       atime  Do not use the noatime feature, so the inode access time is con‐
690              trolled  by  kernel  defaults.  See also the descriptions of the
691              relatime and strictatime mount options.
692
693       noatime
694              Do not update inode access times on this  filesystem  (e.g.  for
695              faster access on the news spool to speed up news servers).  This
696              works for all inode  types  (directories  too),  so  it  implies
697              nodiratime.
698
699       auto   Can be mounted with the -a option.
700
701       noauto Can  only  be  mounted  explicitly (i.e., the -a option will not
702              cause the filesystem to be mounted).
703
704       context=context, fscontext=context, defcontext=context, and
705       rootcontext=context
706              The  context= option is useful when mounting filesystems that do
707              not support extended attributes, such as a floppy or  hard  disk
708              formatted  with  VFAT,  or systems that are not normally running
709              under SELinux, such as an ext3 or ext4  formatted  disk  from  a
710              non-SELinux  workstation.  You can also use context= on filesys‐
711              tems you do not trust, such as a floppy.  It also helps in  com‐
712              patibility  with xattr-supporting filesystems on earlier 2.4.<x>
713              kernel versions.  Even where xattrs are supported, you can  save
714              time not having to label every file by assigning the entire disk
715              one security context.
716
717              A   commonly   used    option    for    removable    media    is
718              context="system_u:object_r:removable_t".
719
720              Two  other options are fscontext= and defcontext=, both of which
721              are mutually exclusive of the context= option.  This  means  you
722              can  use  fscontext  and defcontext with each other, but neither
723              can be used with context.
724
725              The fscontext= option works for all filesystems,  regardless  of
726              their  xattr support.  The fscontext option sets the overarching
727              filesystem label to a specific security context.  This  filesys‐
728              tem  label  is separate from the individual labels on the files.
729              It represents the entire filesystem for certain kinds of permis‐
730              sion  checks, such as during mount or file creation.  Individual
731              file labels are still obtained from  the  xattrs  on  the  files
732              themselves.  The context option actually sets the aggregate con‐
733              text that fscontext provides, in addition to supplying the  same
734              label for individual files.
735
736              You can set the default security context for unlabeled files us‐
737              ing defcontext= option.  This overrides the value set for  unla‐
738              beled  files  in  the policy and requires a filesystem that sup‐
739              ports xattr labeling.
740
741              The rootcontext= option allows you to explicitly label the  root
742              inode of a FS being mounted before that FS or inode becomes vis‐
743              ible to userspace.  This was found to be useful for things  like
744              stateless Linux.
745
746              Note  that  the kernel rejects any remount request that includes
747              the context option, even when unchanged from  the  current  con‐
748              text.
749
750              Warning:  the  context value might contain commas, in which case
751              the value has to be properly quoted, otherwise mount(8) will in‐
752              terpret  the  comma as a separator between mount options.  Don't
753              forget that the shell strips off quotes and thus double  quoting
754              is required.  For example:
755
756                     mount -t tmpfs none /mnt -o \
757                       'context="system_u:object_r:tmp_t:s0:c127,c456",noexec'
758
759              For more details, see selinux(8).
760
761
762       defaults
763              Use  the default options: rw, suid, dev, exec, auto, nouser, and
764              async.
765
766              Note that the real set of all default mount options  depends  on
767              the  kernel and filesystem type.  See the beginning of this sec‐
768              tion for more details.
769
770       dev    Interpret character or block special devices on the filesystem.
771
772       nodev  Do not interpret character  or  block  special  devices  on  the
773              filesystem.
774
775       diratime
776              Update directory inode access times on this filesystem.  This is
777              the default.  (This option is ignored when noatime is set.)
778
779       nodiratime
780              Do not update directory inode access times on  this  filesystem.
781              (This option is implied when noatime is set.)
782
783       dirsync
784              All  directory updates within the filesystem should be done syn‐
785              chronously.  This affects the  following  system  calls:  creat,
786              link, unlink, symlink, mkdir, rmdir, mknod and rename.
787
788       exec   Permit execution of binaries.
789
790       noexec Do  not  permit  direct execution of any binaries on the mounted
791              filesystem.
792
793       group  Allow an ordinary user to mount the filesystem if  one  of  that
794              user's  groups matches the group of the device.  This option im‐
795              plies the options nosuid and nodev (unless overridden by  subse‐
796              quent options, as in the option line group,dev,suid).
797
798       iversion
799              Every  time  the  inode is modified, the i_version field will be
800              incremented.
801
802       noiversion
803              Do not increment the i_version inode field.
804
805       mand   Allow mandatory locks on this filesystem.  See fcntl(2).
806
807       nomand Do not allow mandatory locks on this filesystem.
808
809       _netdev
810              The filesystem resides on a device that requires network  access
811              (used  to  prevent  the  system  from  attempting to mount these
812              filesystems until the network has been enabled on the system).
813
814       nofail Do not report errors for this device if it does not exist.
815
816       relatime
817              Update inode access times relative to  modify  or  change  time.
818              Access time is only updated if the previous access time was ear‐
819              lier than the  current  modify  or  change  time.   (Similar  to
820              noatime,  but  it  doesn't break mutt or other applications that
821              need to know if a file has been read since the last time it  was
822              modified.)
823
824              Since Linux 2.6.30, the kernel defaults to the behavior provided
825              by  this  option  (unless  noatime  was  specified),   and   the
826              strictatime  option is required to obtain traditional semantics.
827              In addition, since Linux 2.6.30, the file's last access time  is
828              always updated if it is more than 1 day old.
829
830       norelatime
831              Do not use the relatime feature.  See also the strictatime mount
832              option.
833
834       strictatime
835              Allows to explicitly request full atime updates.  This makes  it
836              possible  for  the  kernel to default to relatime or noatime but
837              still allow userspace to override it.  For  more  details  about
838              the default system mount options see /proc/mounts.
839
840       nostrictatime
841              Use the kernel's default behavior for inode access time updates.
842
843       lazytime
844              Only update times (atime, mtime, ctime) on the in-memory version
845              of the file inode.
846
847              This mount option significantly reduces writes to the inode  ta‐
848              ble  for workloads that perform frequent random writes to preal‐
849              located files.
850
851              The on-disk timestamps are updated only when:
852
853              - the inode needs to be updated for  some  change  unrelated  to
854                file timestamps
855
856              - the application employs fsync(2), syncfs(2), or sync(2)
857
858              - an undeleted inode is evicted from memory
859
860              - more  than 24 hours have passed since the inode was written to
861                disk.
862
863
864       nolazytime
865              Do not use the lazytime feature.
866
867       suid   Honor set-user-ID and set-group-ID  bits  or  file  capabilities
868              when executing programs from this filesystem.
869
870       nosuid Do not honor set-user-ID and set-group-ID bits or file capabili‐
871              ties when executing programs from this filesystem.
872
873       silent Turn on the silent flag.
874
875       loud   Turn off the silent flag.
876
877       owner  Allow an ordinary user to mount the filesystem if that  user  is
878              the owner of the device.  This option implies the options nosuid
879              and nodev (unless overridden by subsequent options,  as  in  the
880              option line owner,dev,suid).
881
882       remount
883              Attempt  to remount an already-mounted filesystem.  This is com‐
884              monly used to change the mount flags  for  a  filesystem,  espe‐
885              cially  to  make  a  readonly  filesystem writable.  It does not
886              change device or mount point.
887
888              The remount operation together with the bind  flag  has  special
889              semantics. See above, the subsection Bind mounts.
890
891              The  remount  functionality  follows  the standard way the mount
892              command works with options from fstab.  This  means  that  mount
893              does  not read fstab (or mtab) only when both device and dir are
894              specified.
895
896                  mount -o remount,rw /dev/foo /dir
897
898              After this call all old mount options are replaced and arbitrary
899              stuff  from  fstab (or mtab) is ignored, except the loop= option
900              which is internally generated and maintained by the  mount  com‐
901              mand.
902
903                  mount -o remount,rw  /dir
904
905              After this call, mount reads fstab and merges these options with
906              the options from the command line (-o).   If  no  mountpoint  is
907              found  in  fstab,  then a remount with unspecified source is al‐
908              lowed.
909
910              mount allows the use of --all to  remount  all  already  mounted
911              filesystems which match a specified filter (-O and -t).  For ex‐
912              ample:
913
914                  mount --all -o remount,ro -t vfat
915
916              remounts all already mounted vfat filesystems in read-only mode.
917              Each  of  the  filesystems  is remounted by "mount -o remount,ro
918              /dir" semantic.  This means the mount  command  reads  fstab  or
919              mtab  and merges these options with the options from the command
920              line.
921
922       ro     Mount the filesystem read-only.
923
924       rw     Mount the filesystem read-write.
925
926       sync   All I/O to the filesystem should be done synchronously.  In  the
927              case  of  media with a limited number of write cycles (e.g. some
928              flash drives), sync may cause life-cycle shortening.
929
930       user   Allow an ordinary user to mount the filesystem.  The name of the
931              mounting  user  is  written  to the mtab file (or to the private
932              libmount file in /run/mount on systems without a  regular  mtab)
933              so  that  this same user can unmount the filesystem again.  This
934              option implies the options noexec,  nosuid,  and  nodev  (unless
935              overridden   by  subsequent  options,  as  in  the  option  line
936              user,exec,dev,suid).
937
938       nouser Forbid an ordinary user to mount the filesystem.   This  is  the
939              default; it does not imply any other options.
940
941       users  Allow any user to mount and to unmount the filesystem, even when
942              some other ordinary user mounted it.  This  option  implies  the
943              options  noexec,  nosuid, and nodev (unless overridden by subse‐
944              quent options, as in the option line users,exec,dev,suid).
945
946       X-*    All options prefixed with "X-" are interpreted as comments or as
947              userspace  application-specific  options.  These options are not
948              stored in  user  space  (e.g.,  mtab  file),  nor  sent  to  the
949              mount.type  helpers  nor  to the mount(2) system call.  The sug‐
950              gested format is X-appname.option.
951
952       x-*    The same as X-* options, but stored permanently in  user  space.
953              This  means  the  options are also available for umount or other
954              operations.  Note that maintaining  mount options in user  space
955              is  tricky,  because it's necessary use libmount-based tools and
956              there is no guarantee that the options will be always  available
957              (for  example  after a move mount operation or in unshared name‐
958              space).
959
960              Note that before util-linux v2.30 the x-* options have not  been
961              maintained  by  libmount and stored in user space (functionality
962              was the same as for X-* now), but due to the growing  number  of
963              use-cases  (in  initrd, systemd etc.) the functionality has been
964              extended to keep existing fstab configurations usable without  a
965              change.
966
967       X-mount.mkdir[=mode]
968              Allow  to  make  a  target directory (mountpoint) if it does not
969              exit yet.  The optional argument mode specifies  the  filesystem
970              access  mode  used  for mkdir(2) in octal notation.  The default
971              mode is 0755.  This functionality is  supported  only  for  root
972              users  or when mount executed without suid permissions.  The op‐
973              tion is also supported as x-mount.mkdir, this notation is depre‐
974              cated since v2.30.
975
976       nosymfollow
977              Do not follow symlinks when resolving paths.  Symlinks can still
978              be created, and readlink(1), readlink(2), realpath(1) and  real‐
979              path(3) all still work properly.
980
981

FILESYSTEM-SPECIFIC MOUNT OPTIONS

983       This section lists options that are specific to particular filesystems.
984       Where possible, you should  first  consult  filesystem-specific  manual
985       pages for details.  Some of those pages are listed in the following ta‐
986       ble.
987
988       Filesystem(s)      Manual page
989       btrfs              btrfs(5)
990       cifs               mount.cifs(8)
991       ext2, ext3, ext4   ext4(5)
992       fuse               fuse(8)
993       nfs                nfs(5)
994       tmpfs              tmpfs(5)
995       xfs                xfs(5)
996
997       Note that some of the pages listed above might be available only  after
998       you install the respective userland tools.
999
1000       The  following options apply only to certain filesystems.  We sort them
1001       by filesystem.  All options follow the -o flag.
1002
1003       What options are supported depends a bit on the running  kernel.   Fur‐
1004       ther  information  may be available in filesystem-specific files in the
1005       kernel source subdirectory Documentation/filesystems.
1006
1007   Mount options for adfs
1008       uid=value and gid=value
1009              Set the owner and group of the files in the filesystem (default:
1010              uid=gid=0).
1011
1012       ownmask=value and othmask=value
1013              Set the permission mask for ADFS 'owner' permissions and 'other'
1014              permissions,  respectively  (default:  0700  and  0077,  respec‐
1015              tively).     See    also   /usr/src/linux/Documentation/filesys‐
1016              tems/adfs.rst.
1017
1018
1019   Mount options for affs
1020       uid=value and gid=value
1021              Set the owner and group of the root of the filesystem  (default:
1022              uid=gid=0,  but  with option uid or gid without specified value,
1023              the UID and GID of the current process are taken).
1024
1025       setuid=value and setgid=value
1026              Set the owner and group of all files.
1027
1028       mode=value
1029              Set the mode of all files to value & 0777 disregarding the orig‐
1030              inal  permissions.   Add  search  permission to directories that
1031              have read permission.  The value is given in octal.
1032
1033       protect
1034              Do not allow any changes to the protection bits on the  filesys‐
1035              tem.
1036
1037       usemp  Set UID and GID of the root of the filesystem to the UID and GID
1038              of the mount point upon the first sync or umount, and then clear
1039              this option.  Strange...
1040
1041       verbose
1042              Print an informational message for each successful mount.
1043
1044       prefix=string
1045              Prefix used before volume name, when following a link.
1046
1047       volume=string
1048              Prefix  (of  length at most 30) used before '/' when following a
1049              symbolic link.
1050
1051       reserved=value
1052              (Default: 2.) Number of unused blocks at the start  of  the  de‐
1053              vice.
1054
1055       root=value
1056              Give explicitly the location of the root block.
1057
1058       bs=value
1059              Give blocksize.  Allowed values are 512, 1024, 2048, 4096.
1060
1061       grpquota|noquota|quota|usrquota
1062              These  options are accepted but ignored.  (However, quota utili‐
1063              ties may react to such strings in /etc/fstab.)
1064
1065
1066   Mount options for debugfs
1067       The debugfs filesystem is a pseudo filesystem, traditionally mounted on
1068       /sys/kernel/debug.  As of kernel version 3.4, debugfs has the following
1069       options:
1070
1071       uid=n, gid=n
1072              Set the owner and group of the mountpoint.
1073
1074       mode=value
1075              Sets the mode of the mountpoint.
1076
1077
1078   Mount options for devpts
1079       The devpts filesystem is a pseudo filesystem, traditionally mounted  on
1080       /dev/pts.   In  order  to  acquire  a  pseudo terminal, a process opens
1081       /dev/ptmx; the number of the pseudo terminal is then made available  to
1082       the   process  and  the  pseudo  terminal  slave  can  be  accessed  as
1083       /dev/pts/<number>.
1084
1085       uid=value and gid=value
1086              This sets the owner or the group of newly created pseudo  termi‐
1087              nals  to  the specified values.  When nothing is specified, they
1088              will be set to the UID and GID of the creating process.  For ex‐
1089              ample, if there is a tty group with GID 5, then gid=5 will cause
1090              newly created pseudo terminals to belong to the tty group.
1091
1092       mode=value
1093              Set the mode of newly created pseudo terminals to the  specified
1094              value.   The  default  is  0600.   A value of mode=620 and gid=5
1095              makes "mesg y" the default on newly created pseudo terminals.
1096
1097       newinstance
1098              Create a private instance of the devpts  filesystem,  such  that
1099              indices  of  pseudo terminals allocated in this new instance are
1100              independent of indices created in other instances of devpts.
1101
1102              All mounts of devpts without this newinstance option  share  the
1103              same  set  of pseudo terminal indices (i.e., legacy mode).  Each
1104              mount of devpts with the newinstance option has a private set of
1105              pseudo terminal indices.
1106
1107              This  option  is  mainly used to support containers in the Linux
1108              kernel.  It is implemented in  Linux  kernel  versions  starting
1109              with  2.6.29.   Further, this mount option is valid only if CON‐
1110              FIG_DEVPTS_MULTIPLE_INSTANCES is enabled in the kernel  configu‐
1111              ration.
1112
1113              To  use  this  option  effectively, /dev/ptmx must be a symbolic
1114              link to pts/ptmx.  See  Documentation/filesystems/devpts.txt  in
1115              the Linux kernel source tree for details.
1116
1117       ptmxmode=value
1118
1119              Set the mode for the new ptmx device node in the devpts filesys‐
1120              tem.
1121
1122              With the support for multiple instances of  devpts  (see  newin‐
1123              stance  option  above), each instance has a private ptmx node in
1124              the root of the devpts filesystem (typically /dev/pts/ptmx).
1125
1126              For compatibility with older versions of the kernel, the default
1127              mode  of  the new ptmx node is 0000.  ptmxmode=value specifies a
1128              more useful mode for the ptmx node  and  is  highly  recommended
1129              when the newinstance option is specified.
1130
1131              This  option is only implemented in Linux kernel versions start‐
1132              ing with 2.6.29.  Further, this option is  valid  only  if  CON‐
1133              FIG_DEVPTS_MULTIPLE_INSTANCES  is enabled in the kernel configu‐
1134              ration.
1135
1136
1137   Mount options for fat
1138       (Note: fat is not a separate filesystem, but a common part of  the  ms‐
1139       dos, umsdos and vfat filesystems.)
1140
1141       blocksize={512|1024|2048}
1142              Set blocksize (default 512).  This option is obsolete.
1143
1144       uid=value and gid=value
1145              Set the owner and group of all files.  (Default: the UID and GID
1146              of the current process.)
1147
1148       umask=value
1149              Set the umask (the bitmask  of  the  permissions  that  are  not
1150              present).  The default is the umask of the current process.  The
1151              value is given in octal.
1152
1153       dmask=value
1154              Set the umask applied to directories only.  The default  is  the
1155              umask of the current process.  The value is given in octal.
1156
1157       fmask=value
1158              Set the umask applied to regular files only.  The default is the
1159              umask of the current process.  The value is given in octal.
1160
1161       allow_utime=value
1162              This option controls the permission check of mtime/atime.
1163
1164              20     If current process is in group of file's  group  ID,  you
1165                     can change timestamp.
1166
1167              2      Other users can change timestamp.
1168
1169              The  default  is  set  from `dmask' option. (If the directory is
1170              writable, utime(2) is also allowed.  I.e. ~dmask & 022)
1171
1172              Normally utime(2) checks that the current process  is  owner  of
1173              the  file,  or  that  it has the CAP_FOWNER capability.  But FAT
1174              filesystems don't have UID/GID on disk, so the normal  check  is
1175              too inflexible.  With this option you can relax it.
1176
1177       check=value
1178              Three different levels of pickiness can be chosen:
1179
1180              r[elaxed]
1181                     Upper  and  lower  case are accepted and equivalent, long
1182                     name parts are truncated  (e.g.  verylongname.foobar  be‐
1183                     comes  verylong.foo), leading and embedded spaces are ac‐
1184                     cepted in each name part (name and extension).
1185
1186              n[ormal]
1187                     Like "relaxed", but many special  characters  (*,  ?,  <,
1188                     spaces, etc.) are rejected.  This is the default.
1189
1190              s[trict]
1191                     Like  "normal", but names that contain long parts or spe‐
1192                     cial characters that are sometimes used on Linux but  are
1193                     not accepted by MS-DOS (+, =, etc.) are rejected.
1194
1195       codepage=value
1196              Sets  the codepage for converting to shortname characters on FAT
1197              and VFAT filesystems.  By default, codepage 437 is used.
1198
1199       conv=mode
1200              This option is obsolete and may fail or be ignored.
1201
1202       cvf_format=module
1203              Forces the driver to use the CVF (Compressed Volume File) module
1204              cvf_module  instead  of  auto-detection.  If the kernel supports
1205              kmod, the cvf_format=xxx option also controls on-demand CVF mod‐
1206              ule loading.  This option is obsolete.
1207
1208       cvf_option=option
1209              Option passed to the CVF module.  This option is obsolete.
1210
1211       debug  Turn on the debug flag.  A version string and a list of filesys‐
1212              tem parameters will be printed (these data are also  printed  if
1213              the parameters appear to be inconsistent).
1214
1215       discard
1216              If  set,  causes discard/TRIM commands to be issued to the block
1217              device when blocks are freed.  This is useful  for  SSD  devices
1218              and sparse/thinly-provisioned LUNs.
1219
1220       dos1xfloppy
1221              If  set,  use a fallback default BIOS Parameter Block configura‐
1222              tion, determined by backing device size.  These  static  parame‐
1223              ters match defaults assumed by DOS 1.x for 160 kiB, 180 kiB, 320
1224              kiB, and 360 kiB floppies and floppy images.
1225
1226       errors={panic|continue|remount-ro}
1227              Specify FAT behavior on critical errors: panic, continue without
1228              doing  anything, or remount the partition in read-only mode (de‐
1229              fault behavior).
1230
1231       fat={12|16|32}
1232              Specify a 12, 16 or 32 bit fat.  This  overrides  the  automatic
1233              FAT type detection routine.  Use with caution!
1234
1235       iocharset=value
1236              Character set to use for converting between 8 bit characters and
1237              16 bit Unicode characters.   The  default  is  iso8859-1.   Long
1238              filenames are stored on disk in Unicode format.
1239
1240       nfs={stale_rw|nostale_ro}
1241              Enable  this  only if you want to export the FAT filesystem over
1242              NFS.
1243
1244              stale_rw: This option maintains an index  (cache)  of  directory
1245              inodes  which  is  used by the nfs-related code to improve look-
1246              ups.  Full file operations (read/write) over NFS  are  supported
1247              but with cache eviction at NFS server, this could result in spu‐
1248              rious ESTALE errors.
1249
1250              nostale_ro: This option bases the inode number and  file  handle
1251              on  the  on-disk  location of a file in the FAT directory entry.
1252              This ensures that ESTALE will not be returned after  a  file  is
1253              evicted from the inode cache.  However, it means that operations
1254              such as rename, create and unlink could cause file handles  that
1255              previously pointed at one file to point at a different file, po‐
1256              tentially causing data corruption.  For this reason, this option
1257              also mounts the filesystem readonly.
1258
1259              To  maintain  backward compatibility, '-o nfs' is also accepted,
1260              defaulting to stale_rw.
1261
1262       tz=UTC This option disables the conversion of timestamps between  local
1263              time  (as  used by Windows on FAT) and UTC (which Linux uses in‐
1264              ternally).  This is particularly useful  when  mounting  devices
1265              (like digital cameras) that are set to UTC in order to avoid the
1266              pitfalls of local time.
1267
1268       time_offset=minutes
1269              Set offset for conversion of timestamps from local time used  by
1270              FAT  to  UTC.   I.e., minutes will be subtracted from each time‐
1271              stamp to convert it to UTC used internally by  Linux.   This  is
1272              useful  when the time zone set in the kernel via settimeofday(2)
1273              is not the time zone used by the filesystem.  Note that this op‐
1274              tion  still does not provide correct time stamps in all cases in
1275              presence of DST - time stamps in a different DST setting will be
1276              off by one hour.
1277
1278       quiet  Turn on the quiet flag.  Attempts to chown or chmod files do not
1279              return errors, although they fail.  Use with caution!
1280
1281       rodir  FAT has the ATTR_RO  (read-only)  attribute.   On  Windows,  the
1282              ATTR_RO  of the directory will just be ignored, and is used only
1283              by applications as a flag (e.g.  it's  set  for  the  customized
1284              folder).
1285
1286              If you want to use ATTR_RO as read-only flag even for the direc‐
1287              tory, set this option.
1288
1289       showexec
1290              If set, the execute permission bits of the file will be  allowed
1291              only  if  the extension part of the name is .EXE, .COM, or .BAT.
1292              Not set by default.
1293
1294       sys_immutable
1295              If set, ATTR_SYS attribute on FAT is handled as  IMMUTABLE  flag
1296              on Linux.  Not set by default.
1297
1298       flush  If set, the filesystem will try to flush to disk more early than
1299              normal.  Not set by default.
1300
1301       usefree
1302              Use the "free clusters" value stored on FSINFO.  It'll  be  used
1303              to determine number of free clusters without scanning disk.  But
1304              it's not used by default, because recent Windows don't update it
1305              correctly  in some case.  If you are sure the "free clusters" on
1306              FSINFO is correct, by this option you can avoid scanning disk.
1307
1308       dots, nodots, dotsOK=[yes|no]
1309              Various misguided attempts to force Unix or DOS conventions onto
1310              a FAT filesystem.
1311
1312
1313   Mount options for hfs
1314       creator=cccc, type=cccc
1315              Set  the  creator/type  values as shown by the MacOS finder used
1316              for creating new files.  Default values: '????'.
1317
1318       uid=n, gid=n
1319              Set the owner and group of all files.  (Default: the UID and GID
1320              of the current process.)
1321
1322       dir_umask=n, file_umask=n, umask=n
1323              Set  the  umask  used for all directories, all regular files, or
1324              all files and directories.  Defaults to the umask of the current
1325              process.
1326
1327       session=n
1328              Select the CDROM session to mount.  Defaults to leaving that de‐
1329              cision to the CDROM driver.  This option will fail with anything
1330              but a CDROM as underlying device.
1331
1332       part=n Select partition number n from the device.  Only makes sense for
1333              CDROMs.  Defaults to not parsing the partition table at all.
1334
1335       quiet  Don't complain about invalid mount options.
1336
1337
1338   Mount options for hpfs
1339       uid=value and gid=value
1340              Set the owner and group of all files. (Default: the UID and  GID
1341              of the current process.)
1342
1343       umask=value
1344              Set  the  umask  (the  bitmask  of  the permissions that are not
1345              present).  The default is the umask of the current process.  The
1346              value is given in octal.
1347
1348       case={lower|asis}
1349              Convert all files names to lower case, or leave them.  (Default:
1350              case=lower.)
1351
1352       conv=mode
1353              This option is obsolete and may fail or being ignored.
1354
1355       nocheck
1356              Do not abort mounting when certain consistency checks fail.
1357
1358
1359   Mount options for iso9660
1360       ISO 9660 is a standard describing a filesystem structure to be used  on
1361       CD-ROMs. (This filesystem type is also seen on some DVDs.  See also the
1362       udf filesystem.)
1363
1364       Normal iso9660 filenames appear in an 8.3 format  (i.e.,  DOS-like  re‐
1365       strictions  on  filename length), and in addition all characters are in
1366       upper case.  Also there is no field  for  file  ownership,  protection,
1367       number of links, provision for block/character devices, etc.
1368
1369       Rock  Ridge is an extension to iso9660 that provides all of these UNIX-
1370       like features.  Basically there are extensions to each directory record
1371       that  supply  all of the additional information, and when Rock Ridge is
1372       in use, the filesystem is indistinguishable from a normal UNIX filesys‐
1373       tem (except that it is read-only, of course).
1374
1375       norock Disable  the  use  of  Rock Ridge extensions, even if available.
1376              Cf. map.
1377
1378       nojoliet
1379              Disable the use of Microsoft Joliet extensions, even  if  avail‐
1380              able.  Cf. map.
1381
1382       check={r[elaxed]|s[trict]}
1383              With  check=relaxed, a filename is first converted to lower case
1384              before doing the lookup.  This is probably only  meaningful  to‐
1385              gether with norock and map=normal.  (Default: check=strict.)
1386
1387       uid=value and gid=value
1388              Give all files in the filesystem the indicated user or group id,
1389              possibly overriding the information found in the Rock Ridge  ex‐
1390              tensions.  (Default: uid=0,gid=0.)
1391
1392       map={n[ormal]|o[ff]|a[corn]}
1393              For  non-Rock  Ridge volumes, normal name translation maps upper
1394              to lower case ASCII, drops a trailing `;1', and converts `;'  to
1395              `.'.   With  map=off  no  name translation is done.  See norock.
1396              (Default: map=normal.)  map=acorn is like  map=normal  but  also
1397              apply Acorn extensions if present.
1398
1399       mode=value
1400              For  non-Rock  Ridge volumes, give all files the indicated mode.
1401              (Default: read and execute  permission  for  everybody.)   Octal
1402              mode values require a leading 0.
1403
1404       unhide Also  show  hidden and associated files.  (If the ordinary files
1405              and the associated or hidden files have the same filenames, this
1406              may make the ordinary files inaccessible.)
1407
1408       block={512|1024|2048}
1409              Set   the   block   size  to  the  indicated  value.   (Default:
1410              block=1024.)
1411
1412       conv=mode
1413              This option is obsolete and may fail or being ignored.
1414
1415       cruft  If the high byte of the file length contains other garbage,  set
1416              this  mount  option  to  ignore  the high order bits of the file
1417              length.  This implies that a file cannot be larger than 16 MB.
1418
1419       session=x
1420              Select number of session on multisession CD.
1421
1422       sbsector=xxx
1423              Session begins from sector xxx.
1424
1425       The following options are the same as for vfat and specifying them only
1426       makes  sense  when  using discs encoded using Microsoft's Joliet exten‐
1427       sions.
1428
1429       iocharset=value
1430              Character set to use for converting 16 bit Unicode characters on
1431              CD to 8 bit characters.  The default is iso8859-1.
1432
1433       utf8   Convert 16 bit Unicode characters on CD to UTF-8.
1434
1435
1436   Mount options for jfs
1437       iocharset=name
1438              Character  set to use for converting from Unicode to ASCII.  The
1439              default is to do no conversion.   Use  iocharset=utf8  for  UTF8
1440              translations.   This  requires  CONFIG_NLS_UTF8 to be set in the
1441              kernel .config file.
1442
1443       resize=value
1444              Resize the volume to value blocks.  JFS only supports growing  a
1445              volume,  not  shrinking  it.  This option is only valid during a
1446              remount, when the volume is mounted read-write.  The resize key‐
1447              word  with no value will grow the volume to the full size of the
1448              partition.
1449
1450       nointegrity
1451              Do not write to the journal.  The primary use of this option  is
1452              to  allow  for  higher  performance when restoring a volume from
1453              backup media.  The integrity of the volume is not guaranteed  if
1454              the system abnormally ends.
1455
1456       integrity
1457              Default.   Commit metadata changes to the journal.  Use this op‐
1458              tion to remount a volume where the nointegrity option was previ‐
1459              ously specified in order to restore normal behavior.
1460
1461       errors={continue|remount-ro|panic}
1462              Define  the  behavior when an error is encountered.  (Either ig‐
1463              nore errors and just mark the filesystem erroneous and continue,
1464              or  remount the filesystem read-only, or panic and halt the sys‐
1465              tem.)
1466
1467       noquota|quota|usrquota|grpquota
1468              These options are accepted but ignored.
1469
1470
1471   Mount options for msdos
1472       See mount options for fat.  If the msdos filesystem detects  an  incon‐
1473       sistency,  it reports an error and sets the file system read-only.  The
1474       filesystem can be made writable again by remounting it.
1475
1476
1477   Mount options for ncpfs
1478       Just like nfs, the ncpfs implementation expects a  binary  argument  (a
1479       struct ncp_mount_data) to the mount system call.  This argument is con‐
1480       structed by ncpmount(8) and the current version of  mount  (2.12)  does
1481       not know anything about ncpfs.
1482
1483
1484   Mount options for ntfs
1485       iocharset=name
1486              Character  set  to  use when returning file names.  Unlike VFAT,
1487              NTFS suppresses names that  contain  nonconvertible  characters.
1488              Deprecated.
1489
1490       nls=name
1491              New name for the option earlier called iocharset.
1492
1493       utf8   Use UTF-8 for converting file names.
1494
1495       uni_xlate={0|1|2}
1496              For  0 (or `no' or `false'), do not use escape sequences for un‐
1497              known Unicode characters.  For 1 (or `yes' or `true') or 2,  use
1498              vfat-style  4-byte  escape  sequences starting with ":".  Here 2
1499              give a little-endian encoding and 1 a byteswapped bigendian  en‐
1500              coding.
1501
1502       posix=[0|1]
1503              If enabled (posix=1), the filesystem distinguishes between upper
1504              and lower case.  The 8.3 alias names are presented as hard links
1505              instead of being suppressed.  This option is obsolete.
1506
1507       uid=value, gid=value and umask=value
1508              Set  the  file permission on the filesystem.  The umask value is
1509              given in octal.  By default, the files are owned by root and not
1510              readable by somebody else.
1511
1512
1513   Mount options for overlay
1514       Since Linux 3.18 the overlay pseudo filesystem implements a union mount
1515       for other filesystems.
1516
1517       An overlay filesystem combines two filesystems -  an  upper  filesystem
1518       and  a  lower  filesystem.  When a name exists in both filesystems, the
1519       object in the upper filesystem is visible while the object in the lower
1520       filesystem is either hidden or, in the case of directories, merged with
1521       the upper object.
1522
1523       The lower filesystem can be any filesystem supported by Linux and  does
1524       not  need  to  be  writable.   The lower filesystem can even be another
1525       overlayfs.  The upper filesystem will normally be writable and if it is
1526       it must support the creation of trusted.* extended attributes, and must
1527       provide a valid d_type in readdir responses, so NFS is not suitable.
1528
1529       A read-only overlay of two read-only filesystems may use any filesystem
1530       type.  The options lowerdir and upperdir are combined into a merged di‐
1531       rectory by using:
1532
1533              mount -t overlay  overlay  \
1534                -olowerdir=/lower,upperdir=/upper,workdir=/work  /merged
1535
1536
1537       lowerdir=directory
1538              Any filesystem, does not need to be on a writable filesystem.
1539
1540       upperdir=directory
1541              The upperdir is normally on a writable filesystem.
1542
1543       workdir=directory
1544              The workdir needs to be an empty directory on the same  filesys‐
1545              tem as upperdir.
1546
1547
1548   Mount options for reiserfs
1549       Reiserfs is a journaling filesystem.
1550
1551       conv   Instructs  version  3.6 reiserfs software to mount a version 3.5
1552              filesystem, using the 3.6  format  for  newly  created  objects.
1553              This  filesystem  will no longer be compatible with reiserfs 3.5
1554              tools.
1555
1556       hash={rupasov|tea|r5|detect}
1557              Choose which hash function  reiserfs  will  use  to  find  files
1558              within directories.
1559
1560              rupasov
1561                     A hash invented by Yury Yu. Rupasov.  It is fast and pre‐
1562                     serves locality,  mapping  lexicographically  close  file
1563                     names  to  close  hash values.  This option should not be
1564                     used, as it causes a high probability of hash collisions.
1565
1566              tea    A   Davis-Meyer   function    implemented    by    Jeremy
1567                     Fitzhardinge.   It  uses hash permuting bits in the name.
1568                     It gets high randomness and, therefore,  low  probability
1569                     of hash collisions at some CPU cost.  This may be used if
1570                     EHASHCOLLISION errors are experienced with the r5 hash.
1571
1572              r5     A modified version of the rupasov hash.  It  is  used  by
1573                     default  and is the best choice unless the filesystem has
1574                     huge directories and unusual file-name patterns.
1575
1576              detect Instructs mount to detect which hash function is  in  use
1577                     by  examining  the filesystem being mounted, and to write
1578                     this information into the reiserfs superblock.   This  is
1579                     only  useful on the first mount of an old format filesys‐
1580                     tem.
1581
1582       hashed_relocation
1583              Tunes the block allocator.  This  may  provide  performance  im‐
1584              provements in some situations.
1585
1586       no_unhashed_relocation
1587              Tunes  the  block  allocator.   This may provide performance im‐
1588              provements in some situations.
1589
1590       noborder
1591              Disable the border allocator algorithm invented by Yury Yu.  Ru‐
1592              pasov.  This may provide performance improvements in some situa‐
1593              tions.
1594
1595       nolog  Disable journaling.  This will provide  slight  performance  im‐
1596              provements  in  some situations at the cost of losing reiserfs's
1597              fast recovery from crashes.  Even with this  option  turned  on,
1598              reiserfs  still performs all journaling operations, save for ac‐
1599              tual writes into its journaling area.  Implementation  of  nolog
1600              is a work in progress.
1601
1602       notail By  default,  reiserfs  stores  small files and `file tails' di‐
1603              rectly into its tree.  This  confuses  some  utilities  such  as
1604              LILO(8).   This  option is used to disable packing of files into
1605              the tree.
1606
1607       replayonly
1608              Replay the transactions which are in the journal, but do not ac‐
1609              tually mount the filesystem.  Mainly used by reiserfsck.
1610
1611       resize=number
1612              A remount option which permits online expansion of reiserfs par‐
1613              titions.  Instructs reiserfs to assume that the device has  num‐
1614              ber  blocks.  This option is designed for use with devices which
1615              are under logical volume management (LVM).  There is  a  special
1616              resizer     utility     which     can     be    obtained    from
1617              ftp://ftp.namesys.com/pub/reiserfsprogs.
1618
1619       user_xattr
1620              Enable Extended User Attributes.  See the attr(1) manual page.
1621
1622       acl    Enable POSIX Access Control Lists.  See the acl(5) manual page.
1623
1624       barrier=none / barrier=flush
1625              This disables / enables the use of write barriers in  the  jour‐
1626              naling  code.  barrier=none disables, barrier=flush enables (de‐
1627              fault).  This also requires an IO stack which can support barri‐
1628              ers,  and  if reiserfs gets an error on a barrier write, it will
1629              disable barriers again with a warning.  Write  barriers  enforce
1630              proper on-disk ordering of journal commits, making volatile disk
1631              write caches safe to use, at some performance penalty.  If  your
1632              disks are battery-backed in one way or another, disabling barri‐
1633              ers may safely improve performance.
1634
1635
1636   Mount options for ubifs
1637       UBIFS is a flash filesystem which works on top of  UBI  volumes.   Note
1638       that atime is not supported and is always turned off.
1639
1640       The device name may be specified as
1641
1642              ubiX_Y UBI device number X, volume number Y
1643
1644              ubiY   UBI device number 0, volume number Y
1645
1646              ubiX:NAME
1647                     UBI device number X, volume with name NAME
1648
1649              ubi:NAME
1650                     UBI device number 0, volume with name NAME
1651
1652       Alternative !  separator may be used instead of :.
1653
1654       The following mount options are available:
1655
1656       bulk_read
1657              Enable  bulk-read.   VFS read-ahead is disabled because it slows
1658              down the filesystem.  Bulk-Read  is  an  internal  optimization.
1659              Some  flashes  may  read  faster if the data are read at one go,
1660              rather than at several read requests.  For example, OneNAND  can
1661              do "read-while-load" if it reads more than one NAND page.
1662
1663       no_bulk_read
1664              Do not bulk-read.  This is the default.
1665
1666       chk_data_crc
1667              Check data CRC-32 checksums.  This is the default.
1668
1669       no_chk_data_crc.
1670              Do  not  check  data  CRC-32  checksums.   With this option, the
1671              filesystem does not check CRC-32 checksum for data, but it  does
1672              check  it  for  the  internal indexing information.  This option
1673              only affects reading, not writing.  CRC-32 is always  calculated
1674              when writing the data.
1675
1676       compr={none|lzo|zlib}
1677              Select  the  default compressor which is used when new files are
1678              written.  It is still  possible  to  read  compressed  files  if
1679              mounted with the none option.
1680
1681
1682   Mount options for udf
1683       UDF  is the "Universal Disk Format" filesystem defined by OSTA, the Op‐
1684       tical Storage Technology Association, and is often  used  for  DVD-ROM,
1685       frequently in the form of a hybrid UDF/ISO-9660 filesystem. It is, how‐
1686       ever, perfectly usable by itself on disk drives, flash drives and other
1687       block devices.  See also iso9660.
1688
1689       uid=   Make  all  files  in  the  filesystem  belong to the given user.
1690              uid=forget can be specified independently of (or usually in  ad‐
1691              dition to) uid=<user> and results in UDF not storing uids to the
1692              media. In fact the recorded uid is the 32-bit overflow uid -1 as
1693              defined  by  the  UDF  standard.   The  value is given as either
1694              <user> which is a valid user name or the  corresponding  decimal
1695              user id, or the special string "forget".
1696
1697       gid=   Make  all  files  in  the  filesystem belong to the given group.
1698              gid=forget can be specified independently of (or usually in  ad‐
1699              dition  to)  gid=<group>  and results in UDF not storing gids to
1700              the media. In fact the recorded gid is the 32-bit  overflow  gid
1701              -1 as defined by the UDF standard.  The value is given as either
1702              <group> which is a valid group name or the corresponding decimal
1703              group id, or the special string "forget".
1704
1705       umask= Mask  out  the  given  permissions from all inodes read from the
1706              filesystem.  The value is given in octal.
1707
1708       mode=  If mode= is set the permissions of all non-directory inodes read
1709              from  the filesystem will be set to the given mode. The value is
1710              given in octal.
1711
1712       dmode= If dmode= is set the permissions of all  directory  inodes  read
1713              from the filesystem will be set to the given dmode. The value is
1714              given in octal.
1715
1716       bs=    Set the block size. Default value prior to kernel version 2.6.30
1717              was  2048.  Since 2.6.30 and prior to 4.11 it was logical device
1718              block size with fallback to 2048. Since 4.11 it is logical block
1719              size  with  fallback to any valid block size between logical de‐
1720              vice block size and 4096.
1721
1722              For other details see the mkudffs(8) 2.0+ manpage, sections COM‐
1723              PATIBILITY and BLOCK SIZE.
1724
1725       unhide Show otherwise hidden files.
1726
1727       undelete
1728              Show deleted files in lists.
1729
1730       adinicb
1731              Embed data in the inode. (default)
1732
1733       noadinicb
1734              Don't embed data in the inode.
1735
1736       shortad
1737              Use short UDF address descriptors.
1738
1739       longad Use long UDF address descriptors. (default)
1740
1741       nostrict
1742              Unset strict conformance.
1743
1744       iocharset=
1745              Set  the  NLS  character set. This requires kernel compiled with
1746              CONFIG_UDF_NLS option.
1747
1748       utf8   Set the UTF-8 character set.
1749
1750   Mount options for debugging and disaster recovery
1751       novrs  Ignore the Volume Recognition Sequence and attempt to mount any‐
1752              way.
1753
1754       session=
1755              Select the session number for multi-session recorded optical me‐
1756              dia. (default= last session)
1757
1758       anchor=
1759              Override standard anchor location. (default= 256)
1760
1761       lastblock=
1762              Set the last block of the filesystem.
1763
1764   Unused historical mount options that may be encountered and should  be  re‐
1765       moved
1766       uid=ignore
1767              Ignored, use uid=<user> instead.
1768
1769       gid=ignore
1770              Ignored, use gid=<group> instead.
1771
1772       volume=
1773              Unimplemented and ignored.
1774
1775       partition=
1776              Unimplemented and ignored.
1777
1778       fileset=
1779              Unimplemented and ignored.
1780
1781       rootdir=
1782              Unimplemented and ignored.
1783
1784
1785   Mount options for ufs
1786       ufstype=value
1787              UFS  is a filesystem widely used in different operating systems.
1788              The problem are differences among implementations.  Features  of
1789              some  implementations are undocumented, so its hard to recognize
1790              the type of ufs automatically.  That's why the user must specify
1791              the type of ufs by mount option.  Possible values are:
1792
1793              old    Old  format  of  ufs,  this  is  the  default, read only.
1794                     (Don't forget to give the -r option.)
1795
1796              44bsd  For filesystems created by  a  BSD-like  system  (NetBSD,
1797                     FreeBSD, OpenBSD).
1798
1799              ufs2   Used in FreeBSD 5.x supported as read-write.
1800
1801              5xbsd  Synonym for ufs2.
1802
1803              sun    For filesystems created by SunOS or Solaris on Sparc.
1804
1805              sunx86 For filesystems created by Solaris on x86.
1806
1807              hp     For filesystems created by HP-UX, read-only.
1808
1809              nextstep
1810                     For  filesystems  created  by  NeXTStep (on NeXT station)
1811                     (currently read only).
1812
1813              nextstep-cd
1814                     For NextStep CDROMs (block_size == 2048), read-only.
1815
1816              openstep
1817                     For  filesystems  created  by  OpenStep  (currently  read
1818                     only).   The  same filesystem type is also used by Mac OS
1819                     X.
1820
1821
1822       onerror=value
1823              Set behavior on error:
1824
1825              panic  If an error is encountered, cause a kernel panic.
1826
1827              [lock|umount|repair]
1828                     These mount options don't do anything at present; when an
1829                     error is encountered only a console message is printed.
1830
1831
1832   Mount options for umsdos
1833       See mount options for msdos.  The dotsOK option is explicitly killed by
1834       umsdos.
1835
1836
1837   Mount options for vfat
1838       First of all, the mount options for fat are recognized.  The dotsOK op‐
1839       tion is explicitly killed by vfat.  Furthermore, there are
1840
1841       uni_xlate
1842              Translate  unhandled  Unicode  characters to special escaped se‐
1843              quences.  This lets you backup and restore  filenames  that  are
1844              created with any Unicode characters.  Without this option, a '?'
1845              is used when no translation is possible.  The  escape  character
1846              is  ':'  because it is otherwise invalid on the vfat filesystem.
1847              The escape sequence that gets used, where u is the Unicode char‐
1848              acter, is: ':', (u & 0x3f), ((u>>6) & 0x3f), (u>>12).
1849
1850       posix  Allow  two  files with names that only differ in case.  This op‐
1851              tion is obsolete.
1852
1853       nonumtail
1854              First try to make a short name without sequence  number,  before
1855              trying name~num.ext.
1856
1857       utf8   UTF8  is  the  filesystem safe 8-bit encoding of Unicode that is
1858              used by the console.  It can be enabled for the filesystem  with
1859              this  option or disabled with utf8=0, utf8=no or utf8=false.  If
1860              `uni_xlate' gets set, UTF8 gets disabled.
1861
1862       shortname=mode
1863              Defines the behavior for creation and display of filenames which
1864              fit  into  8.3 characters.  If a long name for a file exists, it
1865              will always be the preferred one for display.   There  are  four
1866              modes:
1867
1868              lower  Force  the short name to lower case upon display; store a
1869                     long name when the short name is not all upper case.
1870
1871              win95  Force the short name to upper case upon display; store  a
1872                     long name when the short name is not all upper case.
1873
1874              winnt  Display  the short name as is; store a long name when the
1875                     short name is not all lower case or all upper case.
1876
1877              mixed  Display the short name as is; store a long name when  the
1878                     short  name  is not all upper case.  This mode is the de‐
1879                     fault since Linux 2.6.32.
1880
1881
1882   Mount options for usbfs
1883       devuid=uid and devgid=gid and devmode=mode
1884              Set the owner and group and mode of the device files in the  us‐
1885              bfs  filesystem  (default:  uid=gid=0,  mode=0644).  The mode is
1886              given in octal.
1887
1888       busuid=uid and busgid=gid and busmode=mode
1889              Set the owner and group and mode of the bus directories  in  the
1890              usbfs  filesystem  (default: uid=gid=0, mode=0555).  The mode is
1891              given in octal.
1892
1893       listuid=uid and listgid=gid and listmode=mode
1894              Set the owner and group and mode of the file  devices  (default:
1895              uid=gid=0, mode=0444).  The mode is given in octal.
1896
1897

DM-VERITY SUPPORT (experimental)

1899       The  device-mapper  verity target provides read-only transparent integ‐
1900       rity checking of block devices using kernel crypto API.  The mount com‐
1901       mand  can  open  the dm-verity device and do the integrity verification
1902       before on the device filesystem  is  mounted.   Requires  libcryptsetup
1903       with  in  libmount  (optionally via dlopen).  If libcryptsetup supports
1904       extracting the root hash of an already mounted device, existing devices
1905       will be automatically reused in case of a match.  Mount options for dm-
1906       verity:
1907
1908       verity.hashdevice=path
1909              Path to the hash tree device associated with the  source  volume
1910              to pass to dm-verity.
1911
1912       verity.roothash=hex
1913              Hex-encoded  hash  of the root of verity.hashdevice Mutually ex‐
1914              clusive with verity.roothashfile.
1915
1916       verity.roothashfile=path
1917              Path to file containing the hex-encoded hash of the root of ver‐
1918              ity.hashdevice.  Mutually exclusive with verity.roothash.
1919
1920       verity.hashoffset=offset
1921              If the hash tree device is embedded in the source volume, offset
1922              (default: 0) is used by dm-verity to get to the tree.
1923
1924       verity.fecdevice=path
1925              Path to the Forward Error  Correction  (FEC)  device  associated
1926              with the source volume to pass to dm-verity.  Optional. Requires
1927              kernel built with CONFIG_DM_VERITY_FEC.
1928
1929       verity.fecoffset=offset
1930              If the FEC device is embedded in the source volume, offset  (de‐
1931              fault: 0) is used by dm-verity to get to the FEC area. Optional.
1932
1933       verity.fecroots=value
1934              Parity bytes for FEC (default: 2). Optional.
1935
1936       verity.roothashsig=path
1937              Path  to  pkcs7  signature  of  root  hash  hex string. Requires
1938              crypt_activate_by_signed_key() from cryptsetup and kernel  built
1939              with  CONFIG_DM_VERITY_VERIFY_ROOTHASH_SIG.  For  device  reuse,
1940              signatures have to be either used by all mounts of a  device  or
1941              by none. Optional.
1942
1943       Supported since util-linux v2.35.
1944
1945       For example commands:
1946
1947              mksquashfs /etc /tmp/etc.squashfs
1948              dd if=/dev/zero of=/tmp/etc.hash bs=1M count=10
1949              veritysetup format /tmp/etc.squashfs /tmp/etc.hash
1950              openssl smime -sign -in <hash> -nocerts -inkey private.key \
1951              -signer private.crt -noattr -binary -outform der -out /tmp/etc.p7
1952              mount -o verity.hashdevice=/tmp/etc.hash,verity.roothash=<hash>,\
1953              verity.roothashsig=/tmp/etc.p7 /tmp/etc.squashfs /mnt
1954
1955       create squashfs image from /etc directory, verity hash device and mount
1956       verified filesystem image to /mnt.  The kernel  will  verify  that  the
1957       root  hash is signed by a key from the kernel keyring if roothashsig is
1958       used.
1959
1960

LOOP-DEVICE SUPPORT

1962       One further possible type is a mount via the loop device.  For example,
1963       the command
1964
1965              mount /tmp/disk.img /mnt -t vfat -o loop=/dev/loop3
1966
1967       will  set  up  the  loop  device  /dev/loop3  to correspond to the file
1968       /tmp/disk.img, and then mount this device on /mnt.
1969
1970       If no explicit loop device is mentioned (but just an option  `-o  loop'
1971       is  given), then mount will try to find some unused loop device and use
1972       that, for example
1973
1974              mount /tmp/disk.img /mnt -o loop
1975
1976       The mount command automatically creates a loop device  from  a  regular
1977       file  if  a filesystem type is not specified or the filesystem is known
1978       for libblkid, for example:
1979
1980              mount /tmp/disk.img /mnt
1981
1982              mount -t ext4 /tmp/disk.img /mnt
1983
1984       This type of mount knows about three options, namely loop,  offset  and
1985       sizelimit,  that  are really options to losetup(8).  (These options can
1986       be used in addition to those specific to the filesystem type.)
1987
1988       Since Linux 2.6.25 auto-destruction of loop devices is supported, mean‐
1989       ing that any loop device allocated by mount will be freed by umount in‐
1990       dependently of /etc/mtab.
1991
1992       You can also free a loop device by hand, using losetup -d or umount -d.
1993
1994       Since util-linux v2.29, mount re-uses the loop device rather than  ini‐
1995       tializing  a  new  device  if the same backing file is already used for
1996       some loop device with the same offset and sizelimit. This is  necessary
1997       to avoid a filesystem corruption.
1998
1999

EXIT STATUS

2001       mount has the following exit status values (the bits can be ORed):
2002
2003       0      success
2004
2005       1      incorrect invocation or permissions
2006
2007       2      system error (out of memory, cannot fork, no more loop devices)
2008
2009       4      internal mount bug
2010
2011       8      user interrupt
2012
2013       16     problems writing or locking /etc/mtab
2014
2015       32     mount failure
2016
2017       64     some mount succeeded
2018
2019              The command mount -a returns 0 (all succeeded), 32 (all failed),
2020              or 64 (some failed, some succeeded).
2021
2022

EXTERNAL HELPERS

2024       The syntax of external mount helpers is:
2025
2026           /sbin/mount.suffix spec dir [-sfnv] [-N namespace] [-o options] [-t
2027           type.subtype]
2028
2029       where  the  suffix  is the filesystem type and the -sfnvoN options have
2030       the same meaning as the normal mount options.  The -t  option  is  used
2031       for  filesystems with subtypes support (for example /sbin/mount.fuse -t
2032       fuse.sshfs).
2033
2034       The command mount does not pass the mount options unbindable,  runbind‐
2035       able,  private, rprivate, slave, rslave, shared, rshared, auto, noauto,
2036       comment, x-*, loop, offset and sizelimit to the mount.<suffix> helpers.
2037       All  other options are used in a comma-separated list as an argument to
2038       the -o option.
2039
2040

ENVIRONMENT

2042       LIBMOUNT_FSTAB=<path>
2043              overrides the default location of the fstab  file  (ignored  for
2044              suid)
2045
2046       LIBMOUNT_MTAB=<path>
2047              overrides  the  default  location  of the mtab file (ignored for
2048              suid)
2049
2050       LIBMOUNT_DEBUG=all
2051              enables libmount debug output
2052
2053       LIBBLKID_DEBUG=all
2054              enables libblkid debug output
2055
2056       LOOPDEV_DEBUG=all
2057              enables loop device setup debug output
2058

FILES

2060       See also "The files /etc/fstab,  /etc/mtab  and  /proc/mounts"  section
2061       above.
2062
2063       /etc/fstab        filesystem table
2064
2065       /run/mount        libmount private runtime directory
2066
2067       /etc/mtab         table   of   mounted   filesystems   or   symlink  to
2068                         /proc/mounts
2069
2070       /etc/mtab~        lock file (unused on systems with mtab symlink)
2071
2072       /etc/mtab.tmp     temporary file (unused on systems with mtab symlink)
2073
2074       /etc/filesystems  a list of filesystem types to try
2075

HISTORY

2077       A mount command existed in Version 5 AT&T UNIX.
2078

BUGS

2080       It is possible for a corrupted filesystem to cause a crash.
2081
2082       Some Linux filesystems don't support -o sync and -o dirsync (the  ext2,
2083       ext3,  ext4, fat and vfat filesystems do support synchronous updates (a
2084       la BSD) when mounted with the sync option).
2085
2086       The -o remount may not be able to change mount parameters (all  ext2fs-
2087       specific  parameters, except sb, are changeable with a remount, for ex‐
2088       ample, but you can't change gid or umask for the fatfs).
2089
2090       It is possible that the files /etc/mtab and /proc/mounts don't match on
2091       systems  with a regular mtab file.  The first file is based only on the
2092       mount command options, but the content of the second file also  depends
2093       on  the  kernel  and others settings (e.g. on a remote NFS server -- in
2094       certain cases the mount command may report unreliable information about
2095       an NFS mount point and the /proc/mount file usually contains more reli‐
2096       able information.)  This is another reason to  replace  the  mtab  file
2097       with a symlink to the /proc/mounts file.
2098
2099       Checking  files on NFS filesystems referenced by file descriptors (i.e.
2100       the fcntl and ioctl families of functions) may lead to inconsistent re‐
2101       sults  due to the lack of a consistency check in the kernel even if the
2102       noac mount option is used.
2103
2104       The loop option with the offset or sizelimit options used may fail when
2105       using older kernels if the mount command can't confirm that the size of
2106       the block device has been configured as requested.  This situation  can
2107       be  worked  around by using the losetup command manually before calling
2108       mount with the configured loop device.
2109

AUTHORS

2111       Karel Zak <kzak@redhat.com>
2112

SEE ALSO

2114       lsblk(1), mount(2), umount(2), filesystems(5), fstab(5), nfs(5),
2115       xfs(5), mount_namespaces(7) xattr(7) e2label(8), findmnt(8), los‐
2116       etup(8), mke2fs(8), mountd(8), nfsd(8), swapon(8), tune2fs(8),
2117       umount(8), xfs_admin(8)
2118

AVAILABILITY

2120       The  mount  command  is part of the util-linux package and is available
2121       from https://www.kernel.org/pub/linux/utils/util-linux/.
2122
2123
2124
2125util-linux                        August 2015                         MOUNT(8)
Impressum