1MOUNT(8)                   Linux Programmer's Manual                  MOUNT(8)
2
3
4

NAME

6       mount - mount a filesystem
7

SYNOPSIS

9       mount [-lhV]
10
11       mount -a [-fFnrsvw] [-t vfstype] [-O optlist]
12
13       mount [-fnrsvw] [-o option[,option]...]  device|dir
14
15       mount [-fnrsvw] [-t vfstype] [-o options] device dir
16

DESCRIPTION

18       All files accessible in a Unix system are arranged in one big tree, the
19       file hierarchy, rooted at /.  These files can be spread out  over  sev‐
20       eral  devices.  The mount command serves to attach the filesystem found
21       on some device to the big file tree. Conversely, the umount(8)  command
22       will detach it again.
23
24       The standard form of the mount command, is
25
26              mount -t type device dir
27
28       This  tells  the kernel to attach the filesystem found on device (which
29       is of type type) at the directory dir.  The previous contents (if  any)
30       and  owner  and  mode  of  dir  become  invisible,  and as long as this
31       filesystem remains mounted, the pathname dir refers to the root of  the
32       filesystem on device.
33
34       The listing and help.
35              Three forms of invocation do not actually mount anything:
36
37              mount -h
38                     prints a help message
39
40              mount -V
41                     prints a version string
42
43              mount [-l] [-t type]
44                     lists all mounted filesystems (of type type).  The option
45                     -l adds the labels in this listing.  See below.
46
47       The device indication.
48              Most devices are indicated by a file name (of  a  block  special
49              device),  like /dev/sda1, but there are other possibilities. For
50              example, in the case of an  NFS  mount,  device  may  look  like
51              knuth.cwi.nl:/dir.   It  is possible to indicate a block special
52              device using its volume LABEL or UUID (see the -L and -U options
53              below).
54
55              The  recommended  setup  is  to use LABEL=<label> or UUID=<uuid>
56              tags rather than /dev/disk/by-{label,uuid} udev symlinks in  the
57              /etc/fstab  file.  The tags are more readable, robust and porta‐
58              ble. The mount(8) command internally uses udev symlinks, so  use
59              the  symlinks  in /etc/fstab is not advantage over LABEL=/UUID=.
60              For more details see libblkid(3).
61
62              The proc filesystem is not associated with a special device, and
63              when mounting it, an arbitrary keyword, such as proc can be used
64              instead of a device specification.  (The customary  choice  none
65              is less fortunate: the error message `none busy' from umount can
66              be confusing.)
67
68       The /etc/fstab, /etc/mtab and /proc/mounts files.
69              The file /etc/fstab (see fstab(5)), may contain lines describing
70              what devices are usually mounted where, using which options.
71
72              The command
73
74                     mount -a [-t type] [-O optlist]
75
76              (usually given in a bootscript) causes all filesystems mentioned
77              in fstab (of the proper type and/or having  or  not  having  the
78              proper  options)  to  be  mounted as indicated, except for those
79              whose line contains the noauto keyword.  Adding  the  -F  option
80              will make mount fork, so that the filesystems are mounted simul‐
81              taneously.
82
83              When mounting a filesystem mentioned in fstab or mtab,  it  suf‐
84              fices to give only the device, or only the mount point.
85
86
87              The  programs  mount  and  umount  maintain  a list of currently
88              mounted filesystems in the file /etc/mtab.  If no arguments  are
89              given to mount, this list is printed.
90
91              The  mount  program  does not read the /etc/fstab file if device
92              (or LABEL/UUID) and dir are specified. For example:
93
94                     mount /dev/foo /dir
95
96              If you want to override mount options from /etc/fstab  you  have
97              to use:
98
99                     mount device|dir -o <options>
100
101              and then the mount options from command line will be appended to
102              the list of options from /etc/fstab.   The  usual  behaviour  is
103              that the last option wins if there is more duplicated options.
104
105              When  the  proc  filesystem is mounted (say at /proc), the files
106              /etc/mtab and /proc/mounts have very similar contents. The  for‐
107              mer  has  somewhat  more  information, such as the mount options
108              used, but is not  necessarily  up-to-date  (cf.  the  -n  option
109              below).  It  is possible to replace /etc/mtab by a symbolic link
110              to /proc/mounts, and especially when you have very large numbers
111              of mounts things will be much faster with that symlink, but some
112              information is lost that way, and in particular using the "user"
113              option will fail.
114
115       The non-superuser mounts.
116              Normally,  only  the  superuser can mount filesystems.  However,
117              when fstab contains the user option on a line, anybody can mount
118              the corresponding system.
119
120              Thus, given a line
121
122                     /dev/cdrom  /cd  iso9660  ro,user,noauto,unhide
123
124              any  user  can  mount  the iso9660 filesystem found on his CDROM
125              using the command
126
127                     mount /dev/cdrom
128
129              or
130
131                     mount /cd
132
133              For more details, see fstab(5).  Only the user  that  mounted  a
134              filesystem  can unmount it again.  If any user should be able to
135              unmount, then use users instead of user in the fstab line.   The
136              owner option is similar to the user option, with the restriction
137              that the user must be the owner of the special file. This may be
138              useful e.g. for /dev/fd if a login script makes the console user
139              owner of this device.  The group option  is  similar,  with  the
140              restriction  that  the  user  must be member of the group of the
141              special file.
142
143
144       The bind mounts.
145              Since Linux 2.4.0 it is possible to remount  part  of  the  file
146              hierarchy somewhere else. The call is
147                     mount --bind olddir newdir
148              or shortoption
149                     mount -B olddir newdir
150              or fstab entry is:
151                     /olddir /newdir none bind
152
153              After  this  call the same contents is accessible in two places.
154              One can also remount a single file (on a single file).
155
156              This call attaches only (part of) a single filesystem, not  pos‐
157              sible  submounts.  The entire file hierarchy including submounts
158              is attached a second place using
159                     mount --rbind olddir newdir
160              or shortoption
161                     mount -R olddir newdir
162
163              Note that the filesystem mount options will remain the  same  as
164              those  on  the  original  mount  point, and cannot be changed by
165              passing the -o  option  along  with  --bind/--rbind.  The  mount
166              options  can be changed by a separate remount command, for exam‐
167              ple:
168
169                     mount --bind olddir newdir
170                     mount -o remount,ro newdir
171
172
173       The move operation.
174              Since Linux 2.5.1 it is possible to atomically  move  a  mounted
175              tree to another place. The call is
176                     mount --move olddir newdir
177              or shortoption
178                     mount -M olddir newdir
179              This  will  cause  the  contents which previously appeared under
180              olddir to be accessed under newdir.  The  physical  location  of
181              the files is not changed.
182
183              Note  also  that moving a mount residing under a shared mount is
184              invalid and unsupported (in the other words the  parent  of  the
185              olddir    has   to   use   private   propagation   flag).    See
186              /proc/self/mountinfo for the current propagation flags.
187
188       The shared subtrees operations.
189              Since Linux 2.6.15 it is possible to mark a mount and  its  sub‐
190              mounts  as  shared, private, slave or unbindable. A shared mount
191              provides ability to create  mirrors  of  that  mount  such  that
192              mounts  and  umounts  within any of the mirrors propagate to the
193              other mirror. A slave mount receives propagation from  its  mas‐
194              ter,  but any not vice-versa.  A private mount carries no propa‐
195              gation abilities.  A unbindable mount is a private  mount  which
196              cannot  cloned  through  a bind operation. Detailed semantics is
197              documented in Documentation/sharedsubtree.txt file in the kernel
198              source tree.
199
200                     mount --make-shared mountpoint
201                     mount --make-slave mountpoint
202                     mount --make-private mountpoint
203                     mount --make-unbindable mountpoint
204
205              The following commands allows one to recursively change the type
206              of all the mounts under a given mountpoint.
207
208                     mount --make-rshared mountpoint
209                     mount --make-rslave mountpoint
210                     mount --make-rprivate mountpoint
211                     mount --make-runbindable mountpoint
212
213

COMMAND LINE OPTIONS

215       The full set of mount options used by an invocation of mount is  deter‐
216       mined by first extracting the mount options for the filesystem from the
217       fstab table, then applying any options specified by  the  -o  argument,
218       and finally applying a -r or -w option, when present.
219
220       Command line options available for the mount command:
221
222       -V, --version
223              Output version.
224
225       -h, --help
226              Print a help message.
227
228       -v, --verbose
229              Verbose mode.
230
231       -a, --all
232              Mount all filesystems (of the given types) mentioned in fstab.
233
234       -F, --fork
235              (Used  in  conjunction  with -a.)  Fork off a new incarnation of
236              mount for each device.  This will do  the  mounts  on  different
237              devices  or  different  NFS  servers  in parallel.  This has the
238              advantage that it is faster; also NFS timeouts go in parallel. A
239              disadvantage  is  that  the  mounts are done in undefined order.
240              Thus, you cannot use this option if you want to mount both  /usr
241              and /usr/spool.
242
243       -f, --fake
244              Causes  everything to be done except for the actual system call;
245              if it's not obvious, this  ``fakes''  mounting  the  filesystem.
246              This  option is useful in conjunction with the -v flag to deter‐
247              mine what the mount command is trying to do. It can also be used
248              to add entries for devices that were mounted earlier with the -n
249              option. The -f option checks for existing  record  in  /etc/mtab
250              and  fails when the record already exists (with regular non-fake
251              mount, this check is done by kernel).
252
253       -i, --internal-only
254              Don't  call  the  /sbin/mount.<filesystem>  helper  even  if  it
255              exists.
256
257       -l     Add  the  labels in the mount output. Mount must have permission
258              to read the disk device (e.g. be suid root) for  this  to  work.
259              One  can  set  such  a  label  for  ext2, ext3 or ext4 using the
260              e2label(8) utility, or for XFS using xfs_admin(8), or for  reis‐
261              erfs using reiserfstune(8).
262
263       -n, --no-mtab
264              Mount without writing in /etc/mtab.  This is necessary for exam‐
265              ple when /etc is on a read-only filesystem.
266
267       --no-canonicalize
268              Don't canonicalize paths. The mount  command  canonicalizes  all
269              paths  (from  command  line  or  fstab) and stores canonicalized
270              paths to the /etc/mtab file. This option can  be  used  together
271              with the -f flag for already canonicalized absolut paths.
272
273       -p, --pass-fd num
274              In  case  of  a  loop mount with encryption, read the passphrase
275              from file descriptor num instead of from the terminal.
276
277       -s     Tolerate sloppy mount options rather  than  failing.  This  will
278              ignore mount options not supported by a filesystem type. Not all
279              filesystems support this option. This option exists for  support
280              of the Linux autofs-based automounter.
281
282       -r, --read-only
283              Mount the filesystem read-only. A synonym is -o ro.
284
285              Note  that,  depending  on the filesystem type, state and kernel
286              behavior, the system may still write to the device. For example,
287              Ext3 or ext4 will replay its journal if the filesystem is dirty.
288              To prevent this kind of write access, you may want to mount ext3
289              or  ext4  filesystem  with  "ro,noload" mount options or set the
290              block device to read-only mode, see command blockdev(8).
291
292       -w, --rw
293              Mount the filesystem read/write. This is the default. A  synonym
294              is -o rw.
295
296       -L label
297              Mount the partition that has the specified label.
298
299       -U uuid
300              Mount  the  partition  that  has  the specified uuid.  These two
301              options require the file /proc/partitions (present  since  Linux
302              2.1.116) to exist.
303
304       -t, --types vfstype
305              The argument following the -t is used to indicate the filesystem
306              type.   The  filesystem  types  which  are  currently  supported
307              include:  adfs,  affs,  autofs,  cifs,  coda,  coherent, cramfs,
308              debugfs, devpts, efs, ext, ext2, ext3, ext4, hfs, hfsplus, hpfs,
309              iso9660,  jfs, minix, msdos, ncpfs, nfs, nfs4, ntfs, proc, qnx4,
310              ramfs, reiserfs, romfs, squashfs,  smbfs,  sysv,  tmpfs,  ubifs,
311              udf,  ufs,  umsdos,  usbfs,  vfat, xenix, xfs, xiafs.  Note that
312              coherent, sysv and xenix  are  equivalent  and  that  xenix  and
313              coherent  will be removed at some point in the future — use sysv
314              instead. Since kernel version 2.1.21 the types ext and xiafs  do
315              not  exist anymore. Earlier, usbfs was known as usbdevfs.  Note,
316              the real list of all supported filesystems depends on your  ker‐
317              nel.
318
319              The  programs mount and umount support filesystem subtypes.  The
320              subtype  is  defined  by   '.subtype'   suffix.    For   example
321              'fuse.sshfs'.  It's  recommended  to use subtype notation rather
322              than  add  any  prefix  to  the  mount   source   (for   example
323              'sshfs#example.com' is depreacated).
324
325              For most types all the mount program has to do is issue a simple
326              mount(2) system call, and no detailed knowledge of the  filesys‐
327              tem  type is required.  For a few types however (like nfs, nfs4,
328              cifs, smbfs, ncpfs) ad hoc code is  necessary.  The  nfs,  nfs4,
329              cifs,  smbfs,  and  ncpfs filesystems have a separate mount pro‐
330              gram. In order to make it possible to treat all types in a  uni‐
331              form  way,  mount  will execute the program /sbin/mount.TYPE (if
332              that exists) when called with type TYPE.  Since various versions
333              of  the  smbmount  program  have  different calling conventions,
334              /sbin/mount.smbfs may have to be a shell script that sets up the
335              desired call.
336
337              If  no  -t  option  is  given, or if the auto type is specified,
338              mount will try to guess the desired type.  Mount uses the  blkid
339              or  volume_id  library for guessing the filesystem type; if that
340              does not turn up anything that looks familiar, mount will try to
341              read  the  file  /etc/filesystems,  or,  if that does not exist,
342              /proc/filesystems.  All of the  filesystem  types  listed  there
343              will  be tried, except for those that are labeled "nodev" (e.g.,
344              devpts, proc and nfs).  If /etc/filesystems ends in a line  with
345              a single * only, mount will read /proc/filesystems afterwards.
346
347              The auto type may be useful for user-mounted floppies.  Creating
348              a file /etc/filesystems can be useful to change the probe  order
349              (e.g.,  to  try vfat before msdos or ext3 before ext2) or if you
350              use a kernel module autoloader.  Warning:  the  probing  uses  a
351              heuristic  (the presence of appropriate `magic'), and could rec‐
352              ognize the wrong filesystem  type,  possibly  with  catastrophic
353              consequences.  If  your  data  is  valuable,  don't ask mount to
354              guess.
355
356              More than one type may be specified in a comma  separated  list.
357              The  list of filesystem types can be prefixed with no to specify
358              the filesystem types on which no action should be taken.   (This
359              can be meaningful with the -a option.) For example, the command:
360
361                     mount -a -t nomsdos,ext
362
363              mounts all filesystems except those of type msdos and ext.
364
365       -O, --test-opts opts
366              Used  in conjunction with -a, to limit the set of filesystems to
367              which the -a is applied.  Like -t in this regard except that  it
368              is  useless  except in the context of -a.  For example, the com‐
369              mand:
370
371                     mount -a -O no_netdev
372
373              mounts all filesystems except those which have the option  _net‐
374              dev specified in the options field in the /etc/fstab file.
375
376              It  is different from -t in that each option is matched exactly;
377              a leading no at the beginning of one option does not negate  the
378              rest.
379
380              The  -t  and  -O  options are cumulative in effect; that is, the
381              command
382
383                     mount -a -t ext2 -O _netdev
384
385              mounts all ext2 filesystems with the  _netdev  option,  not  all
386              filesystems  that  are  either  ext2  or have the _netdev option
387              specified.
388
389       -o, --options opts
390              Options are specified with a -o flag followed by a  comma  sepa‐
391              rated string of options. For example:
392
393                     mount LABEL=mydisk -o noatime,nouser
394
395
396              For  more  details, see FILESYSTEM INDEPENDENT MOUNT OPTIONS and
397              FILESYSTEM SPECIFIC MOUNT OPTIONS sections.
398
399       -B, --bind
400              Remount a subtree somewhere  else  (so  that  its  contents  are
401              available in both places). See above.
402
403       -R, --rbind
404              Remount  a subtree and all possible submounts somewhere else (so
405              that its contents are available in both places). See above.
406
407       -M, --move
408              Move a subtree to some other place. See above.
409
410

FILESYSTEM INDEPENDENT MOUNT OPTIONS

412       Some of  these  options  are  only  useful  when  they  appear  in  the
413       /etc/fstab file.
414
415       Some  of  these  options could be enabled or disabled by default in the
416       system kernel.  To  check  the  current  setting  see  the  options  in
417       /proc/mounts.  Note  that filesystems also have per-filesystem specific
418       default mount options (see for  example  tune2fs  -l  output  for  extN
419       filesystems).
420
421       The  following  options  apply  to any filesystem that is being mounted
422       (but not every filesystem actually honors them - e.g., the sync  option
423       today has effect only for ext2, ext3, fat, vfat and ufs):
424
425
426       async  All  I/O  to  the filesystem should be done asynchronously. (See
427              also the sync option.)
428
429       atime  Do not use noatime feature, then the inode access time  is  con‐
430              trolled  by kernel defaults. See also the description for stric‐
431              tatime and relatime mount options.
432
433       noatime
434              Do not update inode access times on this  filesystem  (e.g,  for
435              faster access on the news spool to speed up news servers).
436
437       auto   Can be mounted with the -a option.
438
439       noauto Can  only  be  mounted  explicitly (i.e., the -a option will not
440              cause the filesystem to be mounted).
441
442       context=context,  fscontext=context,  defcontext=context  and  rootcon‐
443       text=context
444              The  context= option is useful when mounting filesystems that do
445              not support extended attributes, such as a floppy or  hard  disk
446              formatted  with  VFAT,  or systems that are not normally running
447              under SELinux, such as an ext3 formatted disk from a non-SELinux
448              workstation. You can also use context= on filesystems you do not
449              trust, such as a floppy. It also  helps  in  compatibility  with
450              xattr-supporting filesystems on earlier 2.4.<x> kernel versions.
451              Even where xattrs are supported, you can save time not having to
452              label  every file by assigning the entire disk one security con‐
453              text.
454
455              A commonly used  option  for  removable  media  is  context=sys‐
456              tem_u:object_r:removable_t.
457
458              Two  other options are fscontext= and defcontext=, both of which
459              are mutually exclusive of the context option. This means you can
460              use fscontext and defcontext with each other, but neither can be
461              used with context.
462
463              The fscontext= option works for all filesystems,  regardless  of
464              their  xattr  support. The fscontext option sets the overarching
465              filesystem label to a specific security context. This filesystem
466              label  is  separate  from the individual labels on the files. It
467              represents the entire filesystem for certain kinds of permission
468              checks,  such as during mount or file creation.  Individual file
469              labels are still obtained from the xattrs  on  the  files  them‐
470              selves.  The  context option actually sets the aggregate context
471              that fscontext provides, in addition to supplying the same label
472              for individual files.
473
474              You  can  set  the  default security context for unlabeled files
475              using defcontext= option. This overrides the value set for unla‐
476              beled  files  in  the policy and requires a filesystem that sup‐
477              ports xattr labeling.
478
479              The rootcontext= option allows you to explicitly label the  root
480              inode of a FS being mounted before that FS or inode because vis‐
481              able to userspace. This was found to be useful for  things  like
482              stateless linux.
483
484              For more details, see selinux(8)
485
486
487       defaults
488              Use  default  options: rw, suid, dev, exec, auto, nouser, async,
489              and relatime.
490
491              Note that the real set of the all default mount options  depends
492              on kernel and filesystem type. See the begin of this section for
493              more details.
494
495       dev    Interpret character or block special devices on the filesystem.
496
497       nodev  Do not interpret character or block special devices on the  file
498              system.
499
500       diratime
501              Update  directory inode access times on this filesystem. This is
502              the default.
503
504       nodiratime
505              Do not update directory inode access times on this filesystem.
506
507       dirsync
508              All directory updates within the filesystem should be done  syn‐
509              chronously.   This  affects  the  following system calls: creat,
510              link, unlink, symlink, mkdir, rmdir, mknod and rename.
511
512       exec   Permit execution of binaries.
513
514       noexec Do not allow direct execution of any  binaries  on  the  mounted
515              filesystem.   (Until  recently  it  was possible to run binaries
516              anyway using a command like /lib/ld*.so /mnt/binary. This  trick
517              fails since Linux 2.4.25 / 2.6.0.)
518
519       group  Allow  an ordinary (i.e., non-root) user to mount the filesystem
520              if one of his groups matches the  group  of  the  device.   This
521              option  implies  the options nosuid and nodev (unless overridden
522              by subsequent options, as in the option line group,dev,suid).
523
524       iversion
525              Every time the inode is modified, the i_version  field  will  be
526              incremented.
527
528       noiversion
529              Do not increment the i_version inode field.
530
531       mand   Allow mandatory locks on this filesystem. See fcntl(2).
532
533       nomand Do not allow mandatory locks on this filesystem.
534
535       _netdev
536              The  filesystem resides on a device that requires network access
537              (used to prevent the  system  from  attempting  to  mount  these
538              filesystems until the network has been enabled on the system).
539
540       nofail Do not report errors for this device if it does not exist.
541
542       relatime
543              Update  inode  access  times  relative to modify or change time.
544              Access time is only updated if the previous access time was ear‐
545              lier  than  the current modify or change time. (Similar to noat‐
546              ime, but doesn't break mutt or other applications that  need  to
547              know  if  a  file has been read since the last time it was modi‐
548              fied.)
549
550              Since Linux 2.6.30, the kernel defaults to the behavior provided
551              by this option (unless noatime was  specified), and the stricta‐
552              time option is required  to  obtain  traditional  semantics.  In
553              addition,  since  Linux  2.6.30,  the file's last access time is
554              always  updated  if  it  is more than 1 day old.
555
556       norelatime
557              Do not use relatime feature.  See  also  the  strictatime  mount
558              option.
559
560       strictatime
561              Allows  to  explicitly requesting full atime updates. This makes
562              it possible for kernel to defaults to relatime  or  noatime  but
563              still allow userspace to override it. For more details about the
564              default system mount options see /proc/mounts.
565
566       nostrictatime
567              Use  the  kernel's  default  behaviour  for  inode  access  time
568              updates.
569
570       suid   Allow  set-user-identifier  or set-group-identifier bits to take
571              effect.
572
573       nosuid Do not allow set-user-identifier or set-group-identifier bits to
574              take  effect.  (This seems safe, but is in fact rather unsafe if
575              you have suidperl(1) installed.)
576
577       owner  Allow an ordinary (i.e., non-root) user to mount the  filesystem
578              if  he  is  the  owner  of  the device.  This option implies the
579              options  nosuid  and  nodev  (unless  overridden  by  subsequent
580              options, as in the option line owner,dev,suid).
581
582       remount
583              Attempt  to remount an already-mounted filesystem.  This is com‐
584              monly used to change the mount flags  for  a  filesystem,  espe‐
585              cially  to  make  a  readonly  filesystem writeable. It does not
586              change device or mount point.
587
588              The remount functionality follows the standard way how the mount
589              command  works  with options from fstab. It means the mount com‐
590              mand doesn't read fstab (or mtab) only when a device and dir are
591              fully specified.
592
593              mount -o remount,rw /dev/foo /dir
594
595              After this call all old mount options are replaced and arbitrary
596              stuff from fstab is ignored, except the loop=  option  which  is
597              internally generated and maintained by the mount command.
598
599              mount -o remount,rw  /dir
600
601              After  this  call  mount  reads fstab (or mtab) and merges these
602              options with options from command line ( -o ).
603
604       ro     Mount the filesystem read-only.
605
606       _rnetdev
607              Like _netdev, except "fsck -a"  checks  this  filesystem  during
608              rc.sysinit.
609
610       rw     Mount the filesystem read-write.
611
612       sync   All  I/O to the filesystem should be done synchronously. In case
613              of media with limited number of write cycles  (e.g.  some  flash
614              drives) "sync" may cause life-cycle shortening.
615
616       user   Allow an ordinary user to mount the filesystem.  The name of the
617              mounting user is written to mtab so  that  he  can  unmount  the
618              filesystem  again.   This  option  implies  the  options noexec,
619              nosuid, and nodev (unless overridden by subsequent  options,  as
620              in the option line user,exec,dev,suid).
621
622       nouser Forbid  an  ordinary (i.e., non-root) user to mount the filesys‐
623              tem.  This is the default.
624
625       users  Allow every user to mount  and  unmount  the  filesystem.   This
626              option  implies  the  options  noexec, nosuid, and nodev (unless
627              overridden  by  subsequent  options,  as  in  the  option   line
628              users,exec,dev,suid).
629
630

FILESYSTEM SPECIFIC MOUNT OPTIONS

632       The  following options apply only to certain filesystems.  We sort them
633       by filesystem. They all follow the -o flag.
634
635       What options are supported depends a bit on the running  kernel.   More
636       info  may  be  found  in  the  kernel  source  subdirectory  Documenta‐
637       tion/filesystems.
638
639

Mount options for adfs

641       uid=value and gid=value
642              Set the owner and group of the files in the filesystem (default:
643              uid=gid=0).
644
645       ownmask=value and othmask=value
646              Set the permission mask for ADFS 'owner' permissions and 'other'
647              permissions,  respectively  (default:  0700  and  0077,  respec‐
648              tively).     See    also   /usr/src/linux/Documentation/filesys‐
649              tems/adfs.txt.
650

Mount options for affs

652       uid=value and gid=value
653              Set the owner and group of the root of the filesystem  (default:
654              uid=gid=0,  but  with option uid or gid without specified value,
655              the uid and gid of the current process are taken).
656
657       setuid=value and setgid=value
658              Set the owner and group of all files.
659
660       mode=value
661              Set the mode of all files to value & 0777 disregarding the orig‐
662              inal  permissions.   Add  search  permission to directories that
663              have read permission.  The value is given in octal.
664
665       protect
666              Do not allow any changes to the protection bits on the  filesys‐
667              tem.
668
669       usemp  Set uid and gid of the root of the filesystem to the uid and gid
670              of the mount point upon the first sync or umount, and then clear
671              this option. Strange...
672
673       verbose
674              Print an informational message for each successful mount.
675
676       prefix=string
677              Prefix used before volume name, when following a link.
678
679       volume=string
680              Prefix  (of  length at most 30) used before '/' when following a
681              symbolic link.
682
683       reserved=value
684              (Default: 2.) Number of  unused  blocks  at  the  start  of  the
685              device.
686
687       root=value
688              Give explicitly the location of the root block.
689
690       bs=value
691              Give blocksize. Allowed values are 512, 1024, 2048, 4096.
692
693       grpquota|noquota|quota|usrquota
694              These  options are accepted but ignored.  (However, quota utili‐
695              ties may react to such strings in /etc/fstab.)
696
697

Mount options for cifs

699       See the options section of the mount.cifs(8) man page (cifs-utils pack‐
700       age must be installed).
701
702

Mount options for coherent

704       None.
705
706

Mount options for debugfs

708       The debugfs filesystem is a pseudo filesystem, traditionally mounted on
709       /sys/kernel/debug.  There are no mount options.
710
711

Mount options for devpts

713       The devpts filesystem is a pseudo filesystem, traditionally mounted  on
714       /dev/pts.   In  order  to  acquire  a  pseudo terminal, a process opens
715       /dev/ptmx; the number of the pseudo terminal is then made available  to
716       the   process  and  the  pseudo  terminal  slave  can  be  accessed  as
717       /dev/pts/<number>.
718
719       uid=value and gid=value
720              This sets the owner or the group of newly created  PTYs  to  the
721              specified values. When nothing is specified, they will be set to
722              the UID and GID of the creating process.  For example, if  there
723              is  a  tty group with GID 5, then gid=5 will cause newly created
724              PTYs to belong to the tty group.
725
726       mode=value
727              Set the mode of newly created PTYs to the specified value.   The
728              default  is  0600.  A value of mode=620 and gid=5 makes "mesg y"
729              the default on newly created PTYs.
730
731       newinstance
732              Create a  private  instance  of  devpts  filesystem,  such  that
733              indices  of  ptys allocated in this new instance are independent
734              of indices created in other instances of devpts.
735
736              All mounts of devpts without this newinstance option  share  the
737              same set of pty indices (i.e legacy mode).  Each mount of devpts
738              with the newinstance option has a private set of pty indices.
739
740              This option is mainly used to support containers  in  the  linux
741              kernel. It is implemented in linux kernel versions starting with
742              2.6.29.  Further, this  mount  option  is  valid  only  if  CON‐
743              FIG_DEVPTS_MULTIPLE_INSTANCES  is enabled in the kernel configu‐
744              ration.
745
746              To use this option effectively, /dev/ptmx  must  be  a  symbolic
747              link  to  pts/ptmx.  See Documentation/filesystems/devpts.txt in
748              the linux kernel source tree for details.
749
750       ptmxmode=value
751
752              Set the mode for the new ptmx device node in the devpts filesys‐
753              tem.
754
755              With  the  support  for multiple instances of devpts (see newin‐
756              stance option above), each instance has a private ptmx  node  in
757              the root of the devpts filesystem (typically /dev/pts/ptmx).
758
759              For compatibility with older versions of the kernel, the default
760              mode of the new ptmx node is 0000.  ptmxmode=value  specifies  a
761              more  useful  mode  for  the ptmx node and is highly recommended
762              when the newinstance option is specified.
763
764              This option is only implemented in linux kernel versions  start‐
765              ing  with  2.6.29.  Further  this  option  is valid only if CON‐
766              FIG_DEVPTS_MULTIPLE_INSTANCES is enabled in the kernel  configu‐
767              ration.
768
769

Mount options for ext

771       None.  Note that the `ext' filesystem is obsolete. Don't use it.  Since
772       Linux version 2.1.21 extfs is no longer part of the kernel source.
773
774

Mount options for ext2

776       The `ext2' filesystem is the standard Linux  filesystem.   Since  Linux
777       2.5.46,  for  most  mount  options  the  default  is  determined by the
778       filesystem superblock. Set them with tune2fs(8).
779
780       acl|noacl
781              Support POSIX Access Control Lists (or not).
782
783       bsddf|minixdf
784              Set the behaviour for the statfs system call. The minixdf behav‐
785              iour  is  to  return  in  the f_blocks field the total number of
786              blocks of the filesystem, while the bsddf  behaviour  (which  is
787              the default) is to subtract the overhead blocks used by the ext2
788              filesystem and not available for file storage. Thus
789
790              % mount /k -o minixdf; df /k; umount /k
791              Filesystem   1024-blocks  Used Available Capacity Mounted on
792              /dev/sda6      2630655   86954  2412169      3%   /k
793              % mount /k -o bsddf; df /k; umount /k
794              Filesystem   1024-blocks  Used Available Capacity Mounted on
795              /dev/sda6      2543714      13  2412169      0%   /k
796
797              (Note that this example shows that  one  can  add  command  line
798              options to the options given in /etc/fstab.)
799
800
801       check={none|nocheck}
802              No  checking is done at mount time. This is the default. This is
803              fast.  It is wise to invoke e2fsck(8) every now and  then,  e.g.
804              at boot time.
805
806       debug  Print debugging info upon each (re)mount.
807
808       errors={continue|remount-ro|panic}
809              Define  the  behaviour  when  an  error is encountered.  (Either
810              ignore errors and just mark the filesystem  erroneous  and  con‐
811              tinue,  or  remount  the filesystem read-only, or panic and halt
812              the system.)  The default is set in the  filesystem  superblock,
813              and can be changed using tune2fs(8).
814
815       grpid|bsdgroups and nogrpid|sysvgroups
816              These  options  define  what group id a newly created file gets.
817              When grpid is set, it takes the group id  of  the  directory  in
818              which  it is created; otherwise (the default) it takes the fsgid
819              of the current process, unless the directory has the setgid  bit
820              set,  in  which case it takes the gid from the parent directory,
821              and also gets the setgid bit set if it is a directory itself.
822
823       grpquota|noquota|quota|usrquota
824              These options are accepted but ignored.
825
826       nobh   Do not attach buffer_heads to file pagecache. (Since 2.5.49.)
827
828       nouid32
829              Disables 32-bit UIDs and GIDs.   This  is  for  interoperability
830              with older kernels which only store and expect 16-bit values.
831
832       oldalloc or orlov
833              Use  old  allocator  or Orlov allocator for new inodes. Orlov is
834              default.
835
836       resgid=n and resuid=n
837              The ext2 filesystem reserves a certain percentage of the  avail‐
838              able space (by default 5%, see mke2fs(8) and tune2fs(8)).  These
839              options determine who can use the  reserved  blocks.   (Roughly:
840              whoever  has  the  specified  uid,  or  belongs to the specified
841              group.)
842
843       sb=n   Instead of block 1, use block n as  superblock.  This  could  be
844              useful  when  the filesystem has been damaged.  (Earlier, copies
845              of the superblock would be made every 8192 blocks: in  block  1,
846              8193,  16385,  ...  (and  one  got  thousands of copies on a big
847              filesystem).  Since  version  1.08,  mke2fs  has  a  -s  (sparse
848              superblock)  option  to reduce the number of backup superblocks,
849              and since version 1.15 this is the default. Note that  this  may
850              mean  that ext2 filesystems created by a recent mke2fs cannot be
851              mounted r/w under Linux 2.0.*.)  The block number here  uses  1k
852              units.  Thus,  if  you  want  to  use  logical  block 32768 on a
853              filesystem with 4k blocks, use "sb=131072".
854
855       user_xattr|nouser_xattr
856              Support "user." extended attributes (or not).
857
858
859

Mount options for ext3

861       The ext3 filesystem is a version of the ext2 filesystem which has  been
862       enhanced  with  journalling.   It  supports the same options as ext2 as
863       well as the following additions:
864
865       journal=update
866              Update the ext3 filesystem's journal to the current format.
867
868       journal=inum
869              When a journal already exists, this option  is  ignored.  Other‐
870              wise,  it specifies the number of the inode which will represent
871              the ext3 filesystem's journal file;   ext3  will  create  a  new
872              journal,  overwriting  the  old contents of the file whose inode
873              number is inum.
874
875       journal_dev=devnum
876              When the external  journal  device's  major/minor  numbers  have
877              changed,  this option allows the user to specify the new journal
878              location.  The journal device  is  identified  through  its  new
879              major/minor numbers encoded in devnum.
880
881       norecovery/noload
882              Don't load the journal on mounting.  Note that if the filesystem
883              was not unmounted cleanly, skipping the journal replay will lead
884              to  the  filesystem  containing inconsistencies that can lead to
885              any number of problems.
886
887       data={journal|ordered|writeback}
888              Specifies the journalling  mode  for  file  data.   Metadata  is
889              always  journaled.   To use modes other than ordered on the root
890              filesystem, pass the mode to the kernel as boot parameter,  e.g.
891              rootflags=data=journal.
892
893              journal
894                     All  data  is  committed  into the journal prior to being
895                     written into the main filesystem.
896
897              ordered
898                     This is the default mode.  All data  is  forced  directly
899                     out  to  the main file system prior to its metadata being
900                     committed to the journal.
901
902              writeback
903                     Data ordering is not preserved - data may be written into
904                     the main filesystem after its metadata has been committed
905                     to the journal.  This is  rumoured  to  be  the  highest-
906                     throughput  option.   It  guarantees  internal filesystem
907                     integrity, however it can allow old  data  to  appear  in
908                     files after a crash and journal recovery.
909
910       barrier=0 / barrier=1
911              This  enables/disables  barriers.   barrier=0  disables it, bar‐
912              rier=1 enables it.  Write barriers enforce proper on-disk order‐
913              ing  of  journal commits, making volatile disk write caches safe
914              to use,  at  some  performance  penalty.   The  ext3  filesystem
915              enables  write  barriers by default.  Be sure to enable barriers
916              unless your disks are battery-backed one way or another.  Other‐
917              wise you risk filesystem corruption in case of power failure.
918
919       commit=nrsec
920              Sync  all  data  and  metadata  every nrsec seconds. The default
921              value is 5 seconds. Zero means default.
922
923       user_xattr
924              Enable Extended User Attributes. See the attr(5) manual page.
925
926       acl    Enable POSIX Access Control Lists. See the acl(5) manual page.
927
928

Mount options for ext4

930       The ext4 filesystem is an an advanced  level  of  the  ext3  filesystem
931       which  incorporates  scalability  and reliability enhancements for sup‐
932       porting large filesystem.
933
934       The  options  journal_dev,  noload,  data,  commit,  orlov,   oldalloc,
935       [no]user_xattr [no]acl, bsddf, minixdf, debug, errors, data_err, grpid,
936       bsdgroups, nogrpid sysvgroups,  resgid,  resuid,  sb,  quota,  noquota,
937       grpquota,  usrquota  and  [no]bh are backwardly compatible with ext3 or
938       ext2.
939
940       journal_checksum
941              Enable checksumming of  the  journal  transactions.   This  will
942              allow  the recovery code in e2fsck and the kernel to detect cor‐
943              ruption in the kernel.  It is a compatible change  and  will  be
944              ignored by older kernels.
945
946       journal_async_commit
947              Commit block can be written to disk without waiting for descrip‐
948              tor blocks. If enabled older kernels cannot  mount  the  device.
949              This will enable
950
951       journal=update
952              Update the ext4 filesystem's journal to the current format.
953
954       barrier=0 / barrier=1 / barrier / nobarrier
955              This enables/disables the use of write barriers in the jbd code.
956              barrier=0 disables, barrier=1 enables.  This also requires an IO
957              stack  which can support barriers, and if jbd gets an error on a
958              barrier write, it will disable again with a warning.  Write bar‐
959              riers enforce proper on-disk ordering of journal commits, making
960              volatile disk write caches safe  to  use,  at  some  performance
961              penalty.   If  your  disks  are  battery-backed  in  one  way or
962              another, disabling barriers may safely improve performance.  The
963              mount  options  "barrier"  and  "nobarrier"  can also be used to
964              enable or disable barriers,  for  consistency  with  other  ext4
965              mount options.
966
967              The ext4 filesystem enables write barriers by default.
968
969       inode_readahead_blks=n
970              This tuning parameter controls the maximum number of inode table
971              blocks that ext4's inode table readahead algorithm will pre-read
972              into  the  buffer  cache.   The  value must be a power of 2. The
973              default value is 32 blocks.
974
975       stripe=n
976              Number of filesystem blocks that mballoc will  try  to  use  for
977              allocation  size  and alignment. For RAID5/6 systems this should
978              be the number of data disks *  RAID  chunk  size  in  filesystem
979              blocks.
980
981       delalloc
982              Deferring block allocation until write-out time.
983
984       nodelalloc
985              Disable  delayed  allocation. Blocks are allocation when data is
986              copied from user to page cache.
987
988       max_batch_time=usec
989              Maximum amount of time ext4 should wait for additional  filesys‐
990              tem  operations  to  be  batch together with a synchronous write
991              operation. Since a synchronous write operation is going to force
992              a  commit  and then a wait for the I/O complete, it doesn't cost
993              much, and can be a huge throughput win,  we  wait  for  a  small
994              amount of time to see if any other transactions can piggyback on
995              the synchronous write. The algorithm used is designed  to  auto‐
996              matically  tune  for  the  speed  of  the disk, by measuring the
997              amount of time (on average) that it takes to finish committing a
998              transaction. Call this time the "commit time".  If the time that
999              the transactoin has been running is less than the  commit  time,
1000              ext4 will try sleeping for the commit time to see if other oper‐
1001              ations will join the transaction. The commit time is  capped  by
1002              the max_batch_time, which defaults to 15000us (15ms). This opti‐
1003              mization can be turned off entirely by setting max_batch_time to
1004              0.
1005
1006       min_batch_time=usec
1007              This  parameter  sets the commit time (as described above) to be
1008              at least  min_batch_time.  It  defaults  to  zero  microseconds.
1009              Increasing  this  parameter may improve the throughput of multi-
1010              threaded, synchronous workloads on very fast disks, at the  cost
1011              of increasing latency.
1012
1013       journal_ioprio=prio
1014              The  I/O  priority (from 0 to 7, where 0 is the highest priorty)
1015              which should be used for I/O operations submitted by  kjournald2
1016              during  a  commit  operation.   This  defaults  to 3, which is a
1017              slightly higher priority than the default I/O priority.
1018
1019       abort  Simulate the effects of calling ext4_abort() for debugging  pur‐
1020              poses.   This  is  normally  used  while remounting a filesystem
1021              which is already mounted.
1022
1023       auto_da_alloc|noauto_da_alloc
1024              Many broken applications don't use fsync() when  noauto_da_alloc
1025              replacing existing files via patterns such as
1026
1027              fd  =  open("foo.new")/write(fd,..)/close(fd)/ rename("foo.new",
1028              "foo")
1029
1030              or worse yet
1031
1032              fd = open("foo", O_TRUNC)/write(fd,..)/close(fd).
1033
1034              If auto_da_alloc is enabled, ext4 will detect  the  replace-via-
1035              rename  and  replace-via-truncate  patterns  and  force that any
1036              delayed allocation blocks are allocated such that  at  the  next
1037              journal  commit,  in  the  default  data=ordered  mode, the data
1038              blocks of the new file are forced to disk  before  the  rename()
1039              operation  is commited.  This provides roughly the same level of
1040              guarantees as ext3, and avoids the  "zero-length"  problem  that
1041              can  happen  when a system crashes before the delayed allocation
1042              blocks are forced to disk.
1043
1044       discard/nodiscard
1045              Controls whether ext4 should issue discard/TRIM commands to  the
1046              underlying  block  device when blocks are freed.  This is useful
1047              for SSD devices and sparse/thinly-provisioned LUNs,  but  it  is
1048              off by default until sufficient testing has been done.
1049
1050       nouid32
1051              Disables  32-bit  UIDs  and  GIDs.  This is for interoperability
1052              with  older kernels which only store and expect 16-bit values.
1053
1054       resize Allows to resize filesystem to the  end  of  the  last  existing
1055              block group, further resize has to be done with resize2fs either
1056              online, or offline. It can be used only  with  conjunction  with
1057              remount.
1058
1059       block_validity/noblock_validity
1060              This  options  allows to enables/disables the in-kernel facility
1061              for tracking filesystem metadata  blocks  within  internal  data
1062              structures.  This  allows  multi- block allocator and other rou‐
1063              tines  to  quickly  locate  extents  which  might  overlap  with
1064              filesystem  metadata  blocks. This option is intended for debug‐
1065              ging purposes and since it negatively affects  the  performance,
1066              it is off by default.
1067
1068       dioread_lock/dioread_nolock
1069              Controls whether or not ext4 should use the DIO read locking. If
1070              the dioread_nolock option is specified ext4 will allocate unini‐
1071              tialized  extent  before  buffer write and convert the extent to
1072              initialized after IO completes.  This approach allows ext4  code
1073              to  avoid  using inode mutex, which improves scalability on high
1074              speed storages. However this does not work with nobh option  and
1075              the  mount  will fail. Nor does it work with data journaling and
1076              dioread_nolock option will be ignored with kernel warning.  Note
1077              that  dioread_nolock  code  path  is  only used for extent-based
1078              files.  Because of the restrictions this options comprises it is
1079              off by default (e.g. dioread_lock).
1080
1081       i_version
1082              Enable  64-bit  inode  version  support.  This  option is off by
1083              default.
1084
1085

Mount options for fat

1087       (Note: fat is not a separate filesystem,  but  a  common  part  of  the
1088       msdos, umsdos and vfat filesystems.)
1089
1090       blocksize={512|1024|2048}
1091              Set blocksize (default 512). This option is obsolete.
1092
1093       uid=value and gid=value
1094              Set the owner and group of all files.  (Default: the uid and gid
1095              of the current process.)
1096
1097       umask=value
1098              Set the umask (the bitmask  of  the  permissions  that  are  not
1099              present).  The default is the umask of the current process.  The
1100              value is given in octal.
1101
1102       dmask=value
1103              Set the umask applied to directories only.  The default  is  the
1104              umask of the current process.  The value is given in octal.
1105
1106       fmask=value
1107              Set the umask applied to regular files only.  The default is the
1108              umask of the current process.  The value is given in octal.
1109
1110       allow_utime=value
1111              This option controls the permission check of mtime/atime.
1112
1113              20     If current process is in group of file's  group  ID,  you
1114                     can change timestamp.
1115
1116              2      Other users can change timestamp.
1117
1118              The  default  is  set  from `dmask' option. (If the directory is
1119              writable, utime(2) is also allowed. I.e. ~dmask & 022)
1120
1121              Normally utime(2) checks current process is owner of  the  file,
1122              or  it  has  CAP_FOWNER  capability.  But FAT filesystem doesn't
1123              have uid/gid on disk, so normal check is  too  unflexible.  With
1124              this option you can relax it.
1125
1126       check=value
1127              Three different levels of pickyness can be chosen:
1128
1129              r[elaxed]
1130                     Upper  and  lower  case are accepted and equivalent, long
1131                     name  parts  are  truncated  (e.g.    verylongname.foobar
1132                     becomes  verylong.foo),  leading  and embedded spaces are
1133                     accepted in each name part (name and extension).
1134
1135              n[ormal]
1136                     Like "relaxed", but many special  characters  (*,  ?,  <,
1137                     spaces, etc.) are rejected.  This is the default.
1138
1139              s[trict]
1140                     Like  "normal",  but names may not contain long parts and
1141                     special characters that are sometimes used on Linux,  but
1142                     are  not  accepted by MS-DOS are rejected. (+, =, spaces,
1143                     etc.)
1144
1145       codepage=value
1146              Sets the codepage for converting to shortname characters on  FAT
1147              and VFAT filesystems. By default, codepage 437 is used.
1148
1149       conv={b[inary]|t[ext]|a[uto]}
1150              The fat filesystem can perform CRLF<-->NL (MS-DOS text format to
1151              UNIX text format) conversion in the kernel. The  following  con‐
1152              version modes are available:
1153
1154              binary no translation is performed.  This is the default.
1155
1156              text   CRLF<-->NL translation is performed on all files.
1157
1158              auto   CRLF<-->NL  translation  is  performed  on all files that
1159                     don't have a "well-known binary" extension. The  list  of
1160                     known  extensions  can  be  found  at  the  beginning  of
1161                     fs/fat/misc.c (as of 2.0, the list  is:  exe,  com,  bin,
1162                     app,  sys,  drv,  ovl, ovr, obj, lib, dll, pif, arc, zip,
1163                     lha, lzh, zoo, tar, z, arj, tz, taz, tzp, tpz,  gz,  tgz,
1164                     deb,  gif,  bmp, tif, gl, jpg, pcx, tfm, vf, gf, pk, pxl,
1165                     dvi).
1166
1167              Programs that do computed lseeks won't like in-kernel text  con‐
1168              version.   Several  people  have  had  their data ruined by this
1169              translation. Beware!
1170
1171              For filesystems mounted in binary mode, a conversion tool (from‐
1172              dos/todos) is available. This option is obsolete.
1173
1174       cvf_format=module
1175              Forces the driver to use the CVF (Compressed Volume File) module
1176              cvf_module instead of auto-detection.  If  the  kernel  supports
1177              kmod, the cvf_format=xxx option also controls on-demand CVF mod‐
1178              ule loading.  This option is obsolete.
1179
1180       cvf_option=option
1181              Option passed to the CVF module. This option is obsolete.
1182
1183       debug  Turn on the debug flag.  A version string and a list of filesys‐
1184              tem  parameters  will be printed (these data are also printed if
1185              the parameters appear to be inconsistent).
1186
1187       fat={12|16|32}
1188              Specify a 12, 16 or 32 bit fat.  This  overrides  the  automatic
1189              FAT type detection routine.  Use with caution!
1190
1191       iocharset=value
1192              Character set to use for converting between 8 bit characters and
1193              16 bit Unicode characters. The default is iso8859-1.  Long file‐
1194              names are stored on disk in Unicode format.
1195
1196       tz=UTC This  option disables the conversion of timestamps between local
1197              time (as used by Windows on  FAT)  and  UTC  (which  Linux  uses
1198              internally).   This is particularly useful when mounting devices
1199              (like digital cameras) that are set to UTC in order to avoid the
1200              pitfalls of local time.
1201
1202       quiet  Turn on the quiet flag.  Attempts to chown or chmod files do not
1203              return errors, although they fail. Use with caution!
1204
1205       showexec
1206              If set, the execute permission bits of the file will be  allowed
1207              only  if  the extension part of the name is .EXE, .COM, or .BAT.
1208              Not set by default.
1209
1210       sys_immutable
1211              If set, ATTR_SYS attribute on FAT is handled as  IMMUTABLE  flag
1212              on Linux.  Not set by default.
1213
1214       flush  If set, the filesystem will try to flush to disk more early than
1215              normal.  Not set by default.
1216
1217       usefree
1218              Use the "free clusters" value stored on FSINFO. It'll be used to
1219              determine  number  of  free  clusters without scanning disk. But
1220              it's not used by default, because recent Windows don't update it
1221              correctly  in  some case. If you are sure the "free clusters" on
1222              FSINFO is correct, by this option you can avoid scanning disk.
1223
1224       dots, nodots, dotsOK=[yes|no]
1225              Various misguided attempts to force Unix or DOS conventions onto
1226              a FAT filesystem.
1227
1228

Mount options for hfs

1230       creator=cccc, type=cccc
1231              Set  the  creator/type  values as shown by the MacOS finder used
1232              for creating new files.  Default values: '????'.
1233
1234       uid=n, gid=n
1235              Set the owner and group of all files.  (Default: the uid and gid
1236              of the current process.)
1237
1238       dir_umask=n, file_umask=n, umask=n
1239              Set  the  umask  used for all directories, all regular files, or
1240              all files and directories.  Defaults to the umask of the current
1241              process.
1242
1243       session=n
1244              Select  the  CDROM  session  to mount.  Defaults to leaving that
1245              decision to the CDROM driver.  This option will fail  with  any‐
1246              thing but a CDROM as underlying device.
1247
1248       part=n Select partition number n from the device.  Only makes sense for
1249              CDROMS.  Defaults to not parsing the partition table at all.
1250
1251       quiet  Don't complain about invalid mount options.
1252
1253

Mount options for hpfs

1255       uid=value and gid=value
1256              Set the owner and group of all files. (Default: the uid and  gid
1257              of the current process.)
1258
1259       umask=value
1260              Set  the  umask  (the  bitmask  of  the permissions that are not
1261              present). The default is the umask of the current process.   The
1262              value is given in octal.
1263
1264       case={lower|asis}
1265              Convert all files names to lower case, or leave them.  (Default:
1266              case=lower.)
1267
1268       conv={binary|text|auto}
1269              For conv=text, delete some random CRs (in particular,  all  fol‐
1270              lowed by NL) when reading a file.  For conv=auto, choose more or
1271              less  at  random  between  conv=binary   and   conv=text.    For
1272              conv=binary, just read what is in the file. This is the default.
1273
1274       nocheck
1275              Do not abort mounting when certain consistency checks fail.
1276
1277

Mount options for iso9660

1279       ISO  9660 is a standard describing a filesystem structure to be used on
1280       CD-ROMs. (This filesystem type is also seen on some DVDs. See also  the
1281       udf filesystem.)
1282
1283       Normal  iso9660  filenames  appear  in  a  8.3  format  (i.e., DOS-like
1284       restrictions on filename length), and in addition all characters are in
1285       upper  case.   Also  there  is no field for file ownership, protection,
1286       number of links, provision for block/character devices, etc.
1287
1288       Rock Ridge is an extension to iso9660 that provides all of  these  unix
1289       like features.  Basically there are extensions to each directory record
1290       that supply all of the additional information, and when Rock  Ridge  is
1291       in use, the filesystem is indistinguishable from a normal UNIX filesys‐
1292       tem (except that it is read-only, of course).
1293
1294       norock Disable the use of Rock Ridge extensions, even if available. Cf.
1295              map.
1296
1297       nojoliet
1298              Disable  the  use of Microsoft Joliet extensions, even if avail‐
1299              able. Cf. map.
1300
1301       check={r[elaxed]|s[trict]}
1302              With check=relaxed, a filename is first converted to lower  case
1303              before  doing  the  lookup.   This  is  probably only meaningful
1304              together with norock and map=normal.  (Default: check=strict.)
1305
1306       uid=value and gid=value
1307              Give all files in the filesystem the indicated user or group id,
1308              possibly  overriding  the  information  found  in the Rock Ridge
1309              extensions.  (Default: uid=0,gid=0.)
1310
1311       map={n[ormal]|o[ff]|a[corn]}
1312              For non-Rock Ridge volumes, normal name translation  maps  upper
1313              to  lower case ASCII, drops a trailing `;1', and converts `;' to
1314              `.'.  With map=off no name  translation  is  done.  See  norock.
1315              (Default:  map=normal.)   map=acorn  is like map=normal but also
1316              apply Acorn extensions if present.
1317
1318       mode=value
1319              For non-Rock Ridge volumes, give all files the  indicated  mode.
1320              (Default:  read  permission  for everybody.)  Since Linux 2.1.37
1321              one no longer needs to specify the mode in  decimal.  (Octal  is
1322              indicated by a leading 0.)
1323
1324       unhide Also  show  hidden and associated files.  (If the ordinary files
1325              and the associated or hidden files have the same filenames, this
1326              may make the ordinary files inaccessible.)
1327
1328       block={512|1024|2048}
1329              Set   the   block   size  to  the  indicated  value.   (Default:
1330              block=1024.)
1331
1332       conv={a[uto]|b[inary]|m[text]|t[ext]}
1333              (Default: conv=binary.)  Since Linux 1.3.54 this option  has  no
1334              effect  anymore.   (And non-binary settings used to be very dan‐
1335              gerous, possibly leading to silent data corruption.)
1336
1337       cruft  If the high byte of the file length contains other garbage,  set
1338              this  mount  option  to  ignore  the high order bits of the file
1339              length.  This implies that a file cannot be larger than 16MB.
1340
1341       session=x
1342              Select number of session on multisession CD. (Since 2.3.4.)
1343
1344       sbsector=xxx
1345              Session begins from sector xxx. (Since 2.3.4.)
1346
1347       The following options are the same as for vfat and specifying them only
1348       makes  sense  when  using discs encoded using Microsoft's Joliet exten‐
1349       sions.
1350
1351       iocharset=value
1352              Character set to use for converting 16 bit Unicode characters on
1353              CD to 8 bit characters. The default is iso8859-1.
1354
1355       utf8   Convert 16 bit Unicode characters on CD to UTF-8.
1356
1357

Mount options for jfs

1359       iocharset=name
1360              Character  set to use for converting from Unicode to ASCII.  The
1361              default is to do no conversion.   Use  iocharset=utf8  for  UTF8
1362              translations.   This  requires  CONFIG_NLS_UTF8 to be set in the
1363              kernel .config file.
1364
1365       resize=value
1366              Resize the volume to value blocks. JFS only supports  growing  a
1367              volume,  not  shrinking  it.  This option is only valid during a
1368              remount, when the volume is mounted read-write. The resize  key‐
1369              word  with no value will grow the volume to the full size of the
1370              partition.
1371
1372       nointegrity
1373              Do not write to the journal.  The primary use of this option  is
1374              to  allow  for  higher  performance when restoring a volume from
1375              backup media. The integrity of the volume is not  guaranteed  if
1376              the system abnormally abends.
1377
1378       integrity
1379              Default.   Commit  metadata  changes  to  the journal.  Use this
1380              option to remount a volume where the nointegrity option was pre‐
1381              viously specified in order to restore normal behavior.
1382
1383       errors={continue|remount-ro|panic}
1384              Define  the  behaviour  when  an  error is encountered.  (Either
1385              ignore errors and just mark the filesystem  erroneous  and  con‐
1386              tinue,  or  remount  the filesystem read-only, or panic and halt
1387              the system.)
1388
1389       noquota|quota|usrquota|grpquota
1390              These options are accepted but ignored.
1391
1392

Mount options for minix

1394       None.
1395
1396

Mount options for msdos

1398       See mount options for fat.  If the msdos filesystem detects  an  incon‐
1399       sistency,  it  reports an error and sets the file system read-only. The
1400       filesystem can be made writeable again by remounting it.
1401
1402

Mount options for ncpfs

1404       Just like nfs, the ncpfs implementation expects a  binary  argument  (a
1405       struct  ncp_mount_data) to the mount system call. This argument is con‐
1406       structed by ncpmount(8) and the current version of  mount  (2.12)  does
1407       not know anything about ncpfs.
1408
1409

Mount options for nfs and nfs4

1411       See  the options section of the nfs(5) man page (nfs-utils package must
1412       be installed).
1413
1414       The nfs and nfs4 implementation expects a  binary  argument  (a  struct
1415       nfs_mount_data)  to the mount system call. This argument is constructed
1416       by mount.nfs(8) and the current version of mount (2.13) does  not  know
1417       anything about nfs and nfs4.
1418
1419

Mount options for ntfs

1421       iocharset=name
1422              Character  set  to  use when returning file names.  Unlike VFAT,
1423              NTFS suppresses names  that  contain  unconvertible  characters.
1424              Deprecated.
1425
1426       nls=name
1427              New name for the option earlier called iocharset.
1428
1429       utf8   Use UTF-8 for converting file names.
1430
1431       uni_xlate={0|1|2}
1432              For  0  (or  `no'  or  `false'), do not use escape sequences for
1433              unknown Unicode characters.  For 1 (or `yes' or  `true')  or  2,
1434              use vfat-style 4-byte escape sequences starting with ":". Here 2
1435              give a little-endian encoding  and  1  a  byteswapped  bigendian
1436              encoding.
1437
1438       posix=[0|1]
1439              If enabled (posix=1), the filesystem distinguishes between upper
1440              and lower case. The 8.3 alias names are presented as hard  links
1441              instead of being suppressed. This option is obsolete.
1442
1443       uid=value, gid=value and umask=value
1444              Set  the  file permission on the filesystem.  The umask value is
1445              given in octal.  By default, the files are owned by root and not
1446              readable by somebody else.
1447
1448

Mount options for proc

1450       uid=value and gid=value
1451              These options are recognized, but have no effect as far as I can
1452              see.
1453
1454

Mount options for ramfs

1456       Ramfs is a memory based filesystem. Mount it and you have  it.  Unmount
1457       it  and it is gone. Present since Linux 2.3.99pre4.  There are no mount
1458       options.
1459
1460

Mount options for reiserfs

1462       Reiserfs is a journaling filesystem.
1463
1464       conv   Instructs version 3.6 reiserfs software to mount a  version  3.5
1465              filesystem, using the 3.6 format for newly created objects. This
1466              filesystem will no longer be compatible with reiserfs 3.5 tools.
1467
1468       hash={rupasov|tea|r5|detect}
1469              Choose which hash function  reiserfs  will  use  to  find  files
1470              within directories.
1471
1472              rupasov
1473                     A hash invented by Yury Yu. Rupasov.  It is fast and pre‐
1474                     serves locality,  mapping  lexicographically  close  file
1475                     names  to  close  hash values.  This option should not be
1476                     used, as it causes a high probability of hash collisions.
1477
1478              tea    A   Davis-Meyer   function    implemented    by    Jeremy
1479                     Fitzhardinge.   It  uses hash permuting bits in the name.
1480                     It gets high randomness and, therefore,  low  probability
1481                     of hash collisions at some CPU cost.  This may be used if
1482                     EHASHCOLLISION errors are experienced with the r5 hash.
1483
1484              r5     A modified version of the rupasov hash.  It  is  used  by
1485                     default  and is the best choice unless the filesystem has
1486                     huge directories and unusual file-name patterns.
1487
1488              detect Instructs mount to detect which hash function is  in  use
1489                     by  examining the filesystem being mounted,  and to write
1490                     this information into the reiserfs  superblock.  This  is
1491                     only  useful on the first mount of an old format filesys‐
1492                     tem.
1493
1494       hashed_relocation
1495              Tunes the block allocator. This may provide performance improve‐
1496              ments in some situations.
1497
1498       no_unhashed_relocation
1499              Tunes the block allocator. This may provide performance improve‐
1500              ments in some situations.
1501
1502       noborder
1503              Disable the border allocator  algorithm  invented  by  Yury  Yu.
1504              Rupasov.  This may provide performance improvements in some sit‐
1505              uations.
1506
1507       nolog  Disable  journalling.  This  will  provide  slight   performance
1508              improvements in some situations at the cost of losing reiserfs's
1509              fast recovery from crashes.  Even with this  option  turned  on,
1510              reiserfs  still  performs  all  journalling operations, save for
1511              actual writes into  its  journalling  area.   Implementation  of
1512              nolog is a work in progress.
1513
1514       notail By  default,  reiserfs  stores  small  files  and  `file  tails'
1515              directly into its tree. This confuses  some  utilities  such  as
1516              LILO(8).   This  option is used to disable packing of files into
1517              the tree.
1518
1519       replayonly
1520              Replay the transactions which are in the  journal,  but  do  not
1521              actually mount the filesystem. Mainly used by reiserfsck.
1522
1523       resize=number
1524              A remount option which permits online expansion of reiserfs par‐
1525              titions.  Instructs reiserfs to assume that the device has  num‐
1526              ber  blocks.  This option is designed for use with devices which
1527              are under logical volume management (LVM).  There is  a  special
1528              resizer     utility     which     can     be    obtained    from
1529              ftp://ftp.namesys.com/pub/reiserfsprogs.
1530
1531       user_xattr
1532              Enable Extended User Attributes. See the attr(5) manual page.
1533
1534       acl    Enable POSIX Access Control Lists. See the acl(5) manual page.
1535
1536       barrier=none / barrier=flush
1537              This enables/disables the use of write barriers in the  journal‐
1538              ing  code.   barrier=none disables it, barrier=flush enables it.
1539              Write barriers enforce proper on-disk ordering of  journal  com‐
1540              mits,  making  volatile  disk  write caches safe to use, at some
1541              performance penalty. The reiserfs  filesystem  does  not  enable
1542              write  barriers  by  default.  Be sure to enable barriers unless
1543              your disks are battery-backed one way or another. Otherwise  you
1544              risk filesystem corruption in case of power failure.
1545
1546

Mount options for romfs

1548       None.
1549
1550

Mount options for squashfs

1552       None.
1553
1554

Mount options for smbfs

1556       Just  like  nfs,  the smbfs implementation expects a binary argument (a
1557       struct smb_mount_data) to the mount system call. This argument is  con‐
1558       structed  by  smbmount(8)  and the current version of mount (2.12) does
1559       not know anything about smbfs.
1560
1561

Mount options for sysv

1563       None.
1564
1565

Mount options for tmpfs

1567       size=nbytes
1568              Override default maximum size of the filesystem.   The  size  is
1569              given  in bytes, and rounded up to entire pages.  The default is
1570              half of the memory. The size parameter also accepts a  suffix  %
1571              to limit this tmpfs instance to that percentage of your physical
1572              RAM: the default, when neither size nor nr_blocks is  specified,
1573              is size=50%
1574
1575       nr_blocks=
1576              The same as size, but in blocks of PAGE_CACHE_SIZE
1577
1578       nr_inodes=
1579              The  maximum  number of inodes for this instance. The default is
1580              half of the number of your physical RAM pages, or (on a  machine
1581              with  highmem)  the number of lowmem RAM pages, whichever is the
1582              lower.
1583
1584       The tmpfs mount options for sizing ( size,  nr_blocks,  and  nr_inodes)
1585       accept  a  suffix k, m or g for Ki, Mi, Gi (binary kilo, mega and giga)
1586       and can be changed on remount.
1587
1588
1589       mode=  Set initial permissions of the root directory.
1590
1591       uid=   The user id.
1592
1593       gid=   The group id.
1594
1595       mpol=[default|prefer:Node|bind:NodeList|interleave|interleave:NodeList]
1596              Set the NUMA memory allocation policy  for  all  files  in  that
1597              instance  (if  the kernel CONFIG_NUMA is enabled) - which can be
1598              adjusted on the fly via 'mount -o remount ...'
1599
1600              default
1601                     prefers to allocate memory from the local node
1602
1603              prefer:Node
1604                     prefers to allocate memory from the given Node
1605
1606              bind:NodeList
1607                     allocates memory only from nodes in NodeList
1608
1609              interleave
1610                     prefers to allocate from each node in turn
1611
1612              interleave:NodeList
1613                     allocates from each node of NodeList in turn.
1614
1615              The NodeList format is a comma-separated list of decimal numbers
1616              and  ranges, a range being two hyphen-separated decimal numbers,
1617              the smallest and largest node numbers in the range.   For  exam‐
1618              ple, mpol=bind:0-3,5,7,9-15
1619
1620              Note  that trying to mount a tmpfs with an mpol option will fail
1621              if the running kernel does not support NUMA; and  will  fail  if
1622              its nodelist specifies a node which is not online.  If your sys‐
1623              tem relies on that tmpfs being mounted, but from  time  to  time
1624              runs  a  kernel  built  without  NUMA capability (perhaps a safe
1625              recovery kernel), or with fewer nodes online, then it is  advis‐
1626              able  to  omit the mpol option from automatic mount options.  It
1627              can be added later, when the tmpfs is already mounted on  Mount‐
1628              Point, by 'mount -o remount,mpol=Policy:NodeList MountPoint'.
1629
1630

Mount options for ubifs

1632       UBIFS  is  a  flash file system which works on top of UBI volumes. Note
1633       that atime is not supported and is always turned off.
1634
1635       The device name may be specified as
1636              ubiX_Y UBI device number X, volume number Y
1637
1638              ubiY   UBI device number 0, volume number Y
1639
1640              ubiX:NAME
1641                     UBI device number X, volume with name NAME
1642
1643              ubi:NAME
1644                     UBI device number 0, volume with name NAME
1645       Alternative !  separator may be used instead of :.
1646
1647       The following mount options are available:
1648
1649       bulk_read
1650              Enable bulk-read. VFS read-ahead is disabled  because  it  slows
1651              down  the  file  system.  Bulk-Read is an internal optimization.
1652              Some flashes may read faster if the data are  read  at  one  go,
1653              rather  than  at several read requests. For example, OneNAND can
1654              do "read-while-load" if it reads more than one NAND page.
1655
1656       no_bulk_read
1657              Do not bulk-read. This is the default.
1658
1659       chk_data_crc
1660              Check data CRC-32 checksums. This is the default.
1661
1662       no_chk_data_crc.
1663              Do not check  data  CRC-32  checksums.  With  this  option,  the
1664              filesystem  does not check CRC-32 checksum for data, but it does
1665              check it for the internal indexing information. This option only
1666              affects  reading,  not writing. CRC-32 is always calculated when
1667              writing the data.
1668
1669       compr={none|lzo|zlib}
1670              Select the default compressor which is used when new  files  are
1671              written.  It  is  still  possible  to  read  compressed files if
1672              mounted with the none option.
1673
1674

Mount options for udf

1676       udf is the "Universal Disk Format" filesystem defined  by  the  Optical
1677       Storage  Technology  Association,  and  is often used for DVD-ROM.  See
1678       also iso9660.
1679
1680       gid=   Set the default group.
1681
1682       umask= Set the default umask.  The value is given in octal.
1683
1684       uid=   Set the default user.
1685
1686       unhide Show otherwise hidden files.
1687
1688       undelete
1689              Show deleted files in lists.
1690
1691       nostrict
1692              Unset strict conformance.
1693
1694       iocharset
1695              Set the NLS character set.
1696
1697       bs=    Set the block size. (May not work unless 2048.)
1698
1699       novrs  Skip volume sequence recognition.
1700
1701       session=
1702              Set the CDROM session counting from 0. Default: last session.
1703
1704       anchor=
1705              Override standard anchor location. Default: 256.
1706
1707       volume=
1708              Override the VolumeDesc location. (unused)
1709
1710       partition=
1711              Override the PartitionDesc location. (unused)
1712
1713       lastblock=
1714              Set the last block of the filesystem.
1715
1716       fileset=
1717              Override the fileset block location. (unused)
1718
1719       rootdir=
1720              Override the root directory location. (unused)
1721
1722

Mount options for ufs

1724       ufstype=value
1725              UFS is a filesystem widely used in different operating  systems.
1726              The  problem  are differences among implementations. Features of
1727              some implementations are undocumented, so its hard to  recognize
1728              the type of ufs automatically.  That's why the user must specify
1729              the type of ufs by mount option.  Possible values are:
1730
1731              old    Old format of  ufs,  this  is  the  default,  read  only.
1732                     (Don't forget to give the -r option.)
1733
1734              44bsd  For  filesystems  created  by  a  BSD-like  system  (Net‐
1735                     BSD,FreeBSD,OpenBSD).
1736
1737              sun    For filesystems created by SunOS or Solaris on Sparc.
1738
1739              sunx86 For filesystems created by Solaris on x86.
1740
1741              hp     For filesystems created by HP-UX, read-only.
1742
1743              nextstep
1744                     For filesystems created by  NeXTStep  (on  NeXT  station)
1745                     (currently read only).
1746
1747              nextstep-cd
1748                     For NextStep CDROMs (block_size == 2048), read-only.
1749
1750              openstep
1751                     For  filesystems  created  by  OpenStep  (currently  read
1752                     only).  The same filesystem type is also used by  Mac  OS
1753                     X.
1754
1755
1756       onerror=value
1757              Set behaviour on error:
1758
1759              panic  If an error is encountered, cause a kernel panic.
1760
1761              [lock|umount|repair]
1762                     These mount options don't do anything at present; when an
1763                     error is encountered only a console message is printed.
1764
1765

Mount options for umsdos

1767       See mount options for msdos.  The dotsOK option is explicitly killed by
1768       umsdos.
1769
1770

Mount options for vfat

1772       First  of  all,  the  mount options for fat are recognized.  The dotsOK
1773       option is explicitly killed by vfat.  Furthermore, there are
1774
1775       uni_xlate
1776              Translate  unhandled  Unicode  characters  to  special   escaped
1777              sequences.   This lets you backup and restore filenames that are
1778              created with any Unicode characters. Without this option, a  '?'
1779              is used when no translation is possible. The escape character is
1780              ':' because it is otherwise illegal on the vfat filesystem.  The
1781              escape  sequence  that gets used, where u is the unicode charac‐
1782              ter, is: ':', (u & 0x3f), ((u>>6) & 0x3f), (u>>12).
1783
1784       posix  Allow two files with names  that  only  differ  in  case.   This
1785              option is obsolete.
1786
1787       nonumtail
1788              First  try  to make a short name without sequence number, before
1789              trying name~num.ext.
1790
1791       utf8   UTF8 is the filesystem safe 8-bit encoding of  Unicode  that  is
1792              used  by  the  console.  It can be be enabled for the filesystem
1793              with this option or disabled with utf8=0, utf8=no or utf8=false.
1794              If `uni_xlate' gets set, UTF8 gets disabled.
1795
1796       shortname={lower|win95|winnt|mixed}
1797
1798              Defines  the  behaviour  for  creation  and display of filenames
1799              which fit into 8.3 characters. If a long name for a file exists,
1800              it will always be preferred display. There are four modes: :
1801
1802              lower  Force  the short name to lower case upon display; store a
1803                     long name when the short name is not all upper case. This
1804                     mode is the default.
1805
1806              win95  Force  the short name to upper case upon display; store a
1807                     long name when the short name is not all upper case.
1808
1809              winnt  Display the shortname as is; store a long name  when  the
1810                     short name is not all lower case or all upper case.
1811
1812              mixed  Display  the short name as is; store a long name when the
1813                     short name is not all upper case.
1814
1815
1816

Mount options for usbfs

1818       devuid=uid and devgid=gid and devmode=mode
1819              Set the owner and group and mode of  the  device  files  in  the
1820              usbfs  filesystem  (default:  uid=gid=0, mode=0644). The mode is
1821              given in octal.
1822
1823       busuid=uid and busgid=gid and busmode=mode
1824              Set the owner and group and mode of the bus directories  in  the
1825              usbfs  filesystem  (default:  uid=gid=0, mode=0555). The mode is
1826              given in octal.
1827
1828       listuid=uid and listgid=gid and listmode=mode
1829              Set the owner and group and mode of the file  devices  (default:
1830              uid=gid=0, mode=0444). The mode is given in octal.
1831
1832

Mount options for xenix

1834       None.
1835
1836

Mount options for xfs

1838       allocsize=size
1839              Sets  the buffered I/O end-of-file preallocation size when doing
1840              delayed allocation writeout.  Valid values for this  option  are
1841              page size (typically 4KiB) through to 1GiB, inclusive, in power-
1842              of-2 increments.
1843
1844              The default behavior is for  dynamic  end-of-file  preallocation
1845              size,  which uses a set of heuristics to optimise the prealloca‐
1846              tion size based on the current allocation  patterns  within  the
1847              file  and  the  access patterns to the file.  Specifying a fixed
1848              allocsize value turns off the dynamic behavior.
1849
1850       attr2|noattr2
1851              The options enable/disable an "opportunistic" improvement to  be
1852              made  in  the way inline extended attributes are stored on-disk.
1853              When the new form is used for  the  first  time  when  attr2  is
1854              selected  (either  when setting or removing extended attributes)
1855              the on-disk superblock feature bit  field  will  be  updated  to
1856              reflect this format being in use.
1857
1858              The  default  behavior  is determined by the on-disk feature bit
1859              indicating that attr2  behavior  is  active.   If  either  mount
1860              option  it  set,  then  that becomes the new default used by the
1861              filesystem.
1862
1863              CRC enabled filesystems always use the attr2 format, and so will
1864              reject the noattr2 mount option if it is set.
1865
1866       barrier|nobarrier
1867              Enables/disables  the  use  of  block  layer  write barriers for
1868              writes into the journal and for data integrity operations.  This
1869              allows  for drive level write caching to be enabled, for devices
1870              that support write barriers.
1871
1872       discard|nodiscard
1873              Enable/disable the issuing of commands to let the  block  device
1874              reclaim  space  freed by the filesystem.  This is useful for SSD
1875              devices, thinly provisioned LUNs and virtual machine images, but
1876              may have a performance impact.
1877
1878              Note: It is currently recommended that you use the fstrim appli‐
1879              cation to discard unused blocks rather than  the  discard  mount
1880              option  because  the  performance impact of this option is quite
1881              severe.
1882
1883       grpid|bsdgroups|nogrpid|sysvgroups
1884              These options define what group ID a newly  created  file  gets.
1885              When  grpid  is  set,  it takes the group ID of the directory in
1886              which it is created; otherwise it takes the fsgid of the current
1887              process,  unless  the directory has the setgid bit set, in which
1888              case it takes the gid from the parent directory, and  also  gets
1889              the setgid bit set if it is a directory itself.
1890
1891       filestreams
1892              Make  the  data  allocator  use  the filestreams allocation mode
1893              across the entire filesystem rather  than  just  on  directories
1894              configured to use it.
1895
1896       ikeep|noikeep
1897              When  ikeep  is specified, XFS does not delete empty inode clus‐
1898              ters and keeps them around on disk.  When noikeep is  specified,
1899              empty inode clusters are returned to the free space pool.
1900
1901       inode32|inode64
1902              When  inode32  is  specified, it indicates that XFS limits inode
1903              creation to locations which will not  result  in  inode  numbers
1904              with more than 32 bits of significance.
1905
1906              When  inode64  is specified, it indicates that XFS is allowed to
1907              create inodes at any location in the filesystem, including those
1908              which  will  result in inode numbers occupying more than 32 bits
1909              of significance.
1910
1911              inode32 is provided for backwards compatibility with older  sys‐
1912              tems  and  applications, since 64 bits inode numbers might cause
1913              problems for some applications that cannot  handle  large  inode
1914              numbers.   If  applications are in use which do not handle inode
1915              numbers bigger than 32 bits, the inode32 option should be speci‐
1916              fied.
1917
1918       largeio|nolargeio
1919              If "nolargeio" is specified, the optimal I/O reported in st_blk‐
1920              size by stat(2) will be as  small  as  possible  to  allow  user
1921              applications  to  avoid inefficient read/modify/write I/O.  This
1922              is typically the page size of the machine, as this is the granu‐
1923              larity of the page cache.
1924
1925              If  "largeio"  specified,  a  filesystem that was created with a
1926              "swidth" specified will return the "swidth" value (in bytes)  in
1927              st_blksize.   If  the filesystem does not have a "swidth" speci‐
1928              fied but does specify an "allocsize" then "allocsize" (in bytes)
1929              will be returned instead.  Otherwise the behavior is the same as
1930              if "nolargeio" was specified.
1931
1932       logbufs=value
1933              Set the number of in-memory log buffers.   Valid  numbers  range
1934              from 2–8 inclusive.
1935
1936              The default value is 8 buffers.
1937
1938              If  the  memory  cost of 8 log buffers is too high on small sys‐
1939              tems, then it may be reduced at  some  cost  to  performance  on
1940              metadata  intensive  workloads.   The logbsize option below con‐
1941              trols the size of each buffer and so is also  relevant  to  this
1942              case.
1943
1944       logbsize=value
1945              Set  the  size  of  each  in-memory log buffer.  The size may be
1946              specified in bytes, or in kibibytes (KiB)  with  a  "k"  suffix.
1947              Valid  sizes  for  version  1  and  version  2  logs  are  16384
1948              (value=16k) and 32768 (value=32k).  Valid sizes  for  version  2
1949              logs  also  include  65536  (value=64k), 131072 (value=128k) and
1950              262144 (value=256k).  The logbsize must be an  integer  multiple
1951              of the log stripe unit configured at mkfs time.
1952
1953              The default value for version 1 logs is 32768, while the default
1954              value for version 2 logs is MAX(32768, log_sunit).
1955
1956       logdev=device and rtdev=device
1957              Use an external log (metadata journal) and/or real-time  device.
1958              An  XFS  filesystem has up to three parts: a data section, a log
1959              section, and a real-time  section.   The  real-time  section  is
1960              optional, and the log section can be separate from the data sec‐
1961              tion or contained within it.
1962
1963       noalign
1964              Data allocations will not be aligned at stripe unit  boundaries.
1965              This  is only relevant to filesystems created with non-zero data
1966              alignment parameters (sunit, swidth) by mkfs.
1967
1968       norecovery
1969              The filesystem will be mounted without running log recovery.  If
1970              the  filesystem  was  not  cleanly unmounted, it is likely to be
1971              inconsistent when mounted in "norecovery" mode.  Some  files  or
1972              directories  may not be accessible because of this.  Filesystems
1973              mounted "norecovery" must be mounted read-only or the mount will
1974              fail.
1975
1976       nouuid Don't  check for double mounted file systems using the file sys‐
1977              tem uuid.  This is useful to mount  LVM  snapshot  volumes,  and
1978              often  used  in combination with "norecovery" for mounting read-
1979              only snapshots.
1980
1981       noquota
1982              Forcibly turns off all quota accounting and  enforcement  within
1983              the filesystem.
1984
1985       uquota/usrquota/uqnoenforce/quota
1986              User  disk  quota  accounting  enabled,  and limits (optionally)
1987              enforced.  Refer to xfs_quota(8) for further details.
1988
1989       gquota/grpquota/gqnoenforce
1990              Group disk quota  accounting  enabled  and  limits  (optionally)
1991              enforced.  Refer to xfs_quota(8) for further details.
1992
1993       pquota/prjquota/pqnoenforce
1994              Project  disk  quota  accounting enabled and limits (optionally)
1995              enforced.  Refer to xfs_quota(8) for further details.
1996
1997       sunit=value and swidth=value
1998              Used to specify the stripe unit and width for a RAID device or a
1999              stripe  volume.   "value"  must  be  specified in 512-byte block
2000              units.  These options are only relevant to filesystems that were
2001              created with non-zero data alignment parameters.
2002
2003              The  sunit  and  swidth  parameters specified must be compatible
2004              with the existing filesystem alignment characteristics.  In gen‐
2005              eral,  that means the only valid changes to sunit are increasing
2006              it by a power-of-2 multiple.  Valid swidth values are any  inte‐
2007              ger multiple of a valid sunit value.
2008
2009              Typically  the  only  time  these mount options are necessary if
2010              after an underlying RAID device has had it's geometry  modified,
2011              such as adding a new disk to a RAID5 lun and reshaping it.
2012
2013       swalloc
2014              Data  allocations  will be rounded up to stripe width boundaries
2015              when the current end of file is being extended and the file size
2016              is larger than the stripe width size.
2017
2018       wsync  When specified, all filesystem namespace operations are executed
2019              synchronously.  This ensures that when the  namespace  operation
2020              (create,  unlink, etc) completes, the change to the namespace is
2021              on stable storage.  This is useful in HA setups  where  failover
2022              must not result in clients seeing inconsistent namespace presen‐
2023              tation during or after a failover event.
2024
2025

Mount options for xiafs

2027       None. Although nothing is wrong with xiafs, it is not used much, and is
2028       not  maintained.  Probably  one  shouldn't use it.  Since Linux version
2029       2.1.21 xiafs is no longer part of the kernel source.
2030
2031

THE LOOP DEVICE

2033       One further possible type is a mount via the loop device. For  example,
2034       the command
2035
2036         mount /tmp/fdimage /mnt -t vfat -o loop=/dev/loop3
2037
2038       will  set  up  the  loop  device  /dev/loop3  to correspond to the file
2039       /tmp/fdimage, and then mount this device on /mnt.
2040
2041       This type of mount knows about four options, namely loop, offset, size‐
2042       limit  and  encryption,  that are really options to losetup(8).  (These
2043       options can be used in addition to those  specific  to  the  filesystem
2044       type.)
2045
2046       If  no  explicit loop device is mentioned (but just an option `-o loop'
2047       is given), then mount will try to find some unused loop device and  use
2048       that.
2049
2050       Since  Linux  2.6.25  is supported auto-destruction of loop devices and
2051       then any loop device allocated by mount will be freed by  umount  inde‐
2052       pendently on /etc/mtab.
2053
2054       You  can also free a loop device by hand, using `losetup -d' or `umount
2055       -d`.
2056
2057

RETURN CODES

2059       mount has the following return codes (the bits can be ORed):
2060
2061       0      success
2062
2063       1      incorrect invocation or permissions
2064
2065       2      system error (out of memory, cannot fork, no more loop devices)
2066
2067       4      internal mount bug
2068
2069       8      user interrupt
2070
2071       16     problems writing or locking /etc/mtab
2072
2073       32     mount failure
2074
2075       64     some mount succeeded
2076
2077

NOTES

2079       The syntax of external mount helpers is:
2080
2081              /sbin/mount.<suffix> spec dir [-sfnv] [-o options] [-t type.sub‐
2082              type]
2083
2084       where  the <type> is filesystem type and -sfnvo options have same mean‐
2085       ing like standard mount options. The -t option is used  for filesystems
2086       with subtypes support (for example /sbin/mount.fuse -t fuse.sshfs).
2087
2088

FILES

2090       /etc/fstab        filesystem table
2091
2092       /etc/mtab         table of mounted filesystems
2093
2094       /etc/mtab~        lock file
2095
2096       /etc/mtab.tmp     temporary file
2097
2098       /etc/filesystems  a list of filesystem types to try
2099
2100

SEE ALSO

2102       mount(2),  umount(2),  fstab(5),  umount(8), swapon(8), nfs(5), xfs(5),
2103       e2label(8), xfs_admin(8), mountd(8),  nfsd(8),  mke2fs(8),  tune2fs(8),
2104       losetup(8)
2105

BUGS

2107       It is possible for a corrupted filesystem to cause a crash.
2108
2109       Some  Linux filesystems don't support -o sync and -o dirsync (the ext2,
2110       ext3, fat and vfat filesystems do support  synchronous  updates  (a  la
2111       BSD) when mounted with the sync option).
2112
2113       The  -o remount may not be able to change mount parameters (all ext2fs-
2114       specific parameters, except sb, are  changeable  with  a  remount,  for
2115       example, but you can't change gid or umask for the fatfs).
2116
2117       Mount  by  label  or uuid will work only if your devices have the names
2118       listed in /proc/partitions.  In particular, it may  well  fail  if  the
2119       kernel was compiled with devfs but devfs is not mounted.
2120
2121       It  is  possible that files /etc/mtab and /proc/mounts don't match. The
2122       first file is based only on the mount command options, but the  content
2123       of the second file also depends on the kernel and others settings (e.g.
2124       remote NFS server. In particular case the  mount  command  may  reports
2125       unreliable  information  about  a  NFS mount point and the /proc/mounts
2126       file usually contains more reliable information.)
2127
2128       Checking files on NFS filesystem referenced by file  descriptors  (i.e.
2129       the  fcntl  and  ioctl  families of functions) may lead to inconsistent
2130       result due to the lack of consistency check in kernel even if  noac  is
2131       used.
2132

HISTORY

2134       A mount command existed in Version 5 AT&T UNIX.
2135

AVAILABILITY

2137       The mount command is part of the util-linux-ng package and is available
2138       from ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.
2139
2140
2141
2142
2143Linux 2.6                         2004-12-16                          MOUNT(8)
Impressum