2006-12-06 17:25:32 -06:00
|
|
|
.\" Copyright (c) 1980, 1989, 1991 The Regents of the University of California.
|
|
|
|
.\" All rights reserved.
|
|
|
|
.\"
|
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
.\" are met:
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
|
|
.\" must display the following acknowledgement:
|
|
|
|
.\" This product includes software developed by the University of
|
|
|
|
.\" California, Berkeley and its contributors.
|
|
|
|
.\" 4. Neither the name of the University nor the names of its contributors
|
|
|
|
.\" may be used to endorse or promote products derived from this software
|
|
|
|
.\" without specific prior written permission.
|
|
|
|
.\"
|
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
|
|
.\" SUCH DAMAGE.
|
|
|
|
.\"
|
|
|
|
.\" @(#)fstab.5 6.5 (Berkeley) 5/10/91
|
|
|
|
.\"
|
2015-02-24 20:40:41 -06:00
|
|
|
.TH FSTAB 5 "February 2015" "util-linux" "File Formats"
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH NAME
|
|
|
|
fstab \- static information about the filesystems
|
|
|
|
.SH SYNOPSIS
|
2016-12-03 14:13:59 -06:00
|
|
|
.I /etc/fstab
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH DESCRIPTION
|
|
|
|
The file
|
2012-01-24 04:04:18 -06:00
|
|
|
.B fstab
|
2015-02-24 20:40:41 -06:00
|
|
|
contains descriptive information about the filesystems the system can mount.
|
2006-12-06 17:25:32 -06:00
|
|
|
.B fstab
|
|
|
|
is only read by programs, and not written; it is the duty of the system
|
2015-02-24 20:40:41 -06:00
|
|
|
administrator to properly create and maintain this file. The order of records in
|
2006-12-06 17:25:32 -06:00
|
|
|
.B fstab
|
|
|
|
is important because
|
2006-12-06 17:25:35 -06:00
|
|
|
.BR fsck (8),
|
|
|
|
.BR mount (8),
|
2009-07-22 04:29:05 -05:00
|
|
|
and
|
2006-12-06 17:25:35 -06:00
|
|
|
.BR umount (8)
|
2006-12-06 17:25:32 -06:00
|
|
|
sequentially iterate through
|
|
|
|
.B fstab
|
|
|
|
doing their thing.
|
|
|
|
|
2015-02-24 20:40:41 -06:00
|
|
|
Each filesystem is described on a separate line.
|
|
|
|
Fields on each line are separated by tabs or spaces.
|
|
|
|
Lines starting with '#' are comments. Blank lines are ignored.
|
|
|
|
.PP
|
|
|
|
The following is a typical example of an
|
|
|
|
.B fstab
|
|
|
|
entry:
|
|
|
|
.sp
|
|
|
|
.RS 7
|
|
|
|
LABEL=t-home2 /home ext4 defaults,auto_da_alloc 0 2
|
|
|
|
.RE
|
|
|
|
|
2010-08-30 04:43:41 -05:00
|
|
|
.B The first field
|
|
|
|
.RI ( fs_spec ).
|
|
|
|
.RS
|
|
|
|
This field describes the block special device or
|
2006-12-06 17:25:32 -06:00
|
|
|
remote filesystem to be mounted.
|
2006-12-06 17:25:39 -06:00
|
|
|
.LP
|
2015-02-24 20:40:41 -06:00
|
|
|
For ordinary mounts, it will hold (a link to) a block special
|
2006-12-06 17:25:39 -06:00
|
|
|
device node (as created by
|
|
|
|
.BR mknod (8))
|
|
|
|
for the device to be mounted, like `/dev/cdrom' or `/dev/sdb7'.
|
2015-02-24 20:40:41 -06:00
|
|
|
For NFS mounts, this field is <host>:<dir>, e.g., `knuth.aeb.nl:/'.
|
|
|
|
For filesystems with no storage, any string can be used, and will show up in
|
|
|
|
.BR df (1)
|
|
|
|
output, for example. Typical usage is `proc' for procfs; `mem', `none',
|
|
|
|
or `tmpfs' for tmpfs. Other special filesystems, like udev and sysfs,
|
|
|
|
are typically not listed in
|
|
|
|
.BR fstab .
|
2006-12-06 17:25:39 -06:00
|
|
|
.LP
|
2015-02-24 20:40:41 -06:00
|
|
|
LABEL=<label> or UUID=<uuid> may be given instead of a device name.
|
|
|
|
This is the recommended method, as device names are often a coincidence
|
|
|
|
of hardware detection order, and can change when other disks are added or removed.
|
|
|
|
For example, `LABEL=Boot' or `UUID=3e6be9de\%-8139\%-11d1\%-9106\%-a43f08d823a6'.
|
|
|
|
(Use a filesystem-specific tool like
|
|
|
|
.BR e2label (8),
|
|
|
|
.BR xfs_admin (8),
|
2006-12-06 17:25:46 -06:00
|
|
|
or
|
2015-02-24 20:40:41 -06:00
|
|
|
.BR fatlabel (8)
|
|
|
|
to set LABELs on filesystems).
|
2012-04-19 07:48:40 -05:00
|
|
|
|
|
|
|
It's also possible to use PARTUUID= and PARTLABEL=. These partitions identifiers
|
2013-09-26 08:42:54 -05:00
|
|
|
are supported for example for GUID Partition Table (GPT).
|
2012-04-19 07:48:40 -05:00
|
|
|
|
|
|
|
See
|
2013-09-26 08:42:54 -05:00
|
|
|
.BR mount (8),
|
2012-04-19 07:48:40 -05:00
|
|
|
.BR blkid (8)
|
|
|
|
or
|
|
|
|
.BR lsblk (8)
|
2015-02-24 20:40:41 -06:00
|
|
|
for more details about device identifiers.
|
2012-04-19 07:48:40 -05:00
|
|
|
|
2010-09-13 04:43:14 -05:00
|
|
|
.LP
|
|
|
|
Note that
|
|
|
|
.BR mount (8)
|
|
|
|
uses UUIDs as strings. The string representation of the UUID should be based on
|
|
|
|
lower case characters.
|
2010-08-30 04:43:41 -05:00
|
|
|
.RE
|
2006-12-06 17:25:32 -06:00
|
|
|
|
2010-08-30 04:43:41 -05:00
|
|
|
.B The second field
|
|
|
|
.RI ( fs_file ).
|
|
|
|
.RS
|
2016-09-20 08:45:15 -05:00
|
|
|
This field describes the mount point (target) for the filesystem. For swap partitions, this
|
2006-12-06 17:25:39 -06:00
|
|
|
field should be specified as `none'. If the name of the mount point
|
2017-07-27 16:00:15 -05:00
|
|
|
contains spaces or tabs these can be escaped as `\\040' and '\\011'
|
|
|
|
respectively.
|
2010-08-30 04:43:41 -05:00
|
|
|
.RE
|
2006-12-06 17:25:32 -06:00
|
|
|
|
2010-08-30 04:43:41 -05:00
|
|
|
.B The third field
|
|
|
|
.RI ( fs_vfstype ).
|
|
|
|
.RS
|
2015-02-24 20:40:41 -06:00
|
|
|
This field describes the type of the filesystem. Linux supports many
|
|
|
|
filesystem types: ext4, xfs, btrfs, f2fs, vfat, ntfs, hfsplus,
|
|
|
|
tmpfs, sysfs, proc, iso9660, udf, squashfs, nfs, cifs, and many more.
|
|
|
|
For more details, see
|
2006-12-06 17:25:53 -06:00
|
|
|
.BR mount (8).
|
2010-08-30 04:43:41 -05:00
|
|
|
|
2006-12-06 17:25:53 -06:00
|
|
|
An entry
|
|
|
|
.I swap
|
|
|
|
denotes a file or partition to be used
|
|
|
|
for swapping, cf.\&
|
|
|
|
.BR swapon (8).
|
|
|
|
An entry
|
2007-10-04 08:07:30 -05:00
|
|
|
.I none
|
|
|
|
is useful for bind or move mounts.
|
2006-12-06 17:25:32 -06:00
|
|
|
|
2014-07-25 06:08:41 -05:00
|
|
|
More than one type may be specified in a comma-separated list.
|
|
|
|
|
2010-08-30 03:48:52 -05:00
|
|
|
.BR mount (8)
|
|
|
|
and
|
|
|
|
.BR umount (8)
|
2010-08-30 04:43:41 -05:00
|
|
|
support filesystem
|
|
|
|
.IR subtypes .
|
|
|
|
The subtype is defined by '.subtype' suffix. For
|
2010-08-30 03:48:52 -05:00
|
|
|
example 'fuse.sshfs'. It's recommended to use subtype notation rather than add
|
|
|
|
any prefix to the first fstab field (for example 'sshfs#example.com' is
|
2012-02-28 10:45:09 -06:00
|
|
|
deprecated).
|
2010-08-30 04:43:41 -05:00
|
|
|
.RE
|
2010-08-30 03:48:52 -05:00
|
|
|
|
2010-08-30 04:43:41 -05:00
|
|
|
.B The fourth field
|
|
|
|
.RI ( fs_mntops ).
|
|
|
|
.RS
|
|
|
|
This field describes the mount options associated with the filesystem.
|
2006-12-06 17:25:32 -06:00
|
|
|
|
2015-02-24 20:40:41 -06:00
|
|
|
It is formatted as a comma-separated list of options.
|
|
|
|
It contains at least the type of mount
|
|
|
|
.RB ( ro
|
|
|
|
or
|
|
|
|
.BR rw ),
|
|
|
|
plus any additional options appropriate to the filesystem
|
|
|
|
type (including performance-tuning options).
|
|
|
|
For details, see
|
|
|
|
.BR mount (8)
|
|
|
|
or
|
2010-11-10 04:48:30 -06:00
|
|
|
.BR swapon (8).
|
|
|
|
|
2015-02-24 20:40:41 -06:00
|
|
|
Basic filesystem-independent options are:
|
2010-08-30 04:43:41 -05:00
|
|
|
.TP
|
|
|
|
.B defaults
|
|
|
|
use default options: rw, suid, dev, exec, auto, nouser, and async.
|
|
|
|
.TP
|
|
|
|
.B noauto
|
|
|
|
do not mount when "mount -a" is given (e.g., at boot time)
|
|
|
|
.TP
|
|
|
|
.B user
|
|
|
|
allow a user to mount
|
|
|
|
.TP
|
|
|
|
.B owner
|
|
|
|
allow device owner to mount
|
|
|
|
.TP
|
|
|
|
.B comment
|
2012-06-19 05:04:03 -05:00
|
|
|
or
|
|
|
|
.B x-<name>
|
2010-08-30 04:43:41 -05:00
|
|
|
for use by fstab-maintaining programs
|
|
|
|
.TP
|
|
|
|
.B nofail
|
|
|
|
do not report errors for this device if it does not exist.
|
|
|
|
.RE
|
2006-12-06 17:25:32 -06:00
|
|
|
|
2010-08-30 04:43:41 -05:00
|
|
|
.B The fifth field
|
|
|
|
.RI ( fs_freq ).
|
|
|
|
.RS
|
2015-02-24 20:40:41 -06:00
|
|
|
This field is used by
|
2006-12-06 17:25:32 -06:00
|
|
|
.BR dump (8)
|
2015-02-24 20:40:41 -06:00
|
|
|
to determine which filesystems need to be dumped.
|
|
|
|
Defaults to zero (don't dump) if not present.
|
2010-08-30 04:43:41 -05:00
|
|
|
.RE
|
2006-12-06 17:25:32 -06:00
|
|
|
|
2010-08-30 04:43:41 -05:00
|
|
|
.B The sixth field
|
|
|
|
.RI ( fs_passno ).
|
|
|
|
.RS
|
2015-02-24 20:40:41 -06:00
|
|
|
This field is used by
|
2006-12-06 17:25:32 -06:00
|
|
|
.BR fsck (8)
|
2015-02-24 20:40:41 -06:00
|
|
|
to determine the order in which filesystem checks are done at
|
|
|
|
boot time. The root filesystem should be specified with a
|
2006-12-06 17:25:32 -06:00
|
|
|
.I fs_passno
|
2015-02-24 20:40:41 -06:00
|
|
|
of 1. Other filesystems should have a
|
2006-12-06 17:25:32 -06:00
|
|
|
.I fs_passno
|
|
|
|
of 2. Filesystems within a drive will be checked sequentially, but
|
|
|
|
filesystems on different drives will be checked at the same time to utilize
|
2015-02-24 20:40:41 -06:00
|
|
|
parallelism available in the hardware.
|
|
|
|
Defaults to zero (don't fsck) if not present.
|
2006-12-06 17:25:32 -06:00
|
|
|
|
2012-06-19 05:04:03 -05:00
|
|
|
.SH NOTES
|
2006-12-06 17:25:32 -06:00
|
|
|
The proper way to read records from
|
|
|
|
.B fstab
|
|
|
|
is to use the routines
|
2011-04-12 03:05:25 -05:00
|
|
|
.BR getmntent (3)
|
|
|
|
or
|
|
|
|
.BR libmount .
|
2012-06-19 05:04:03 -05:00
|
|
|
|
|
|
|
The keyword
|
|
|
|
.B ignore
|
2015-02-24 20:40:41 -06:00
|
|
|
as a filesystem type (3rd field) is no longer supported by the pure
|
2012-06-19 05:04:03 -05:00
|
|
|
libmount based mount utility (since util-linux v2.22).
|
|
|
|
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH FILES
|
2010-08-30 04:43:41 -05:00
|
|
|
.IR /etc/fstab ,
|
|
|
|
.I <fstab.h>
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH "SEE ALSO"
|
2016-11-10 04:59:27 -06:00
|
|
|
.BR getmntent (3),
|
|
|
|
.BR fs (5),
|
2012-06-19 05:04:03 -05:00
|
|
|
.BR findmnt (8),
|
2006-12-06 17:25:41 -06:00
|
|
|
.BR mount (8),
|
2016-11-10 04:59:27 -06:00
|
|
|
.BR swapon (8)
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH HISTORY
|
2006-12-06 17:25:53 -06:00
|
|
|
The ancestor of this
|
2006-12-06 17:25:32 -06:00
|
|
|
.B fstab
|
|
|
|
file format appeared in 4.0BSD.
|
2006-12-06 17:25:53 -06:00
|
|
|
.\" But without comment convention, and options and vfs_type.
|
|
|
|
.\" Instead there was a type rw/ro/rq/sw/xx, where xx is the present 'ignore'.
|
2007-07-02 18:17:04 -05:00
|
|
|
.SH AVAILABILITY
|
2010-11-30 04:41:59 -06:00
|
|
|
This man page is part of the util-linux package and is available from
|
2016-12-17 02:06:57 -06:00
|
|
|
https://www.kernel.org/pub/linux/utils/util-linux/.
|