1 .\" Copyright (c) 1980, 1989, 1991 The Regents of the University of California.
2 .\" All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
12 .\" 3. All advertising materials mentioning features or use of this software
13 .\" must display the following acknowledgement:
14 .\" This product includes software developed by the University of
15 .\" California, Berkeley and its contributors.
16 .\" 4. Neither the name of the University nor the names of its contributors
17 .\" may be used to endorse or promote products derived from this software
18 .\" without specific prior written permission.
20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 .\" @(#)fstab.5 6.5 (Berkeley) 5/10/91
34 .\" Modified Sat Mar 6 20:45:03 1993, faith@cs.unc.edu, for Linux
35 .\" Sat Oct 9 10:07:10 1993: converted to man format by faith@cs.unc.edu
36 .\" Sat Nov 20 20:47:38 1993: hpfs documentation added
37 .\" Sat Nov 27 20:23:32 1993: Updated authorship information
38 .\" Wed Jul 26 00:00:00 1995: Updated some nfs stuff, joey@infodrom.north.de
39 .\" Tue Apr 2 00:38:28 1996: added info about "noauto", "user", etc.
40 .\" Tue Jun 15 20:02:18 1999: added LABEL and UUID
41 .\" Sat Jul 14 2001: Michael K. Johnson <johnsonm@redhat.com> added -O
43 .TH FSTAB 5 "August 2010" "util-linux" "File Formats"
45 fstab \- static information about the filesystems
51 contains descriptive information about the various file systems.
53 is only read by programs, and not written; it is the duty of the system
54 administrator to properly create and maintain this file. Each filesystem
55 is described on a separate line; fields on each line are separated by tabs or
56 spaces. Lines starting with '#' are comments, blank lines are ignored. The
64 sequentially iterate through
71 This field describes the block special device or
72 remote filesystem to be mounted.
74 For ordinary mounts it will hold (a link to) a block special
75 device node (as created by
77 for the device to be mounted, like `/dev/cdrom' or `/dev/sdb7'.
78 For NFS mounts one will have <host>:<dir>, e.g., `knuth.aeb.nl:/'.
79 For procfs, use `proc'.
81 Instead of giving the device explicitly, one may indicate
82 the filesystem that is to be mounted by its UUID or
87 writing LABEL=<label> or UUID=<uuid>,
88 e.g., `LABEL=Boot' or `UUID=3e6be9de\%-8139\%-11d1\%-9106\%-a43f08d823a6'.
90 It's also possible to use PARTUUID= and PARTLABEL=. These partitions identifiers
91 are supported for GUID Partition Table (GPT) and MAC partition table only.
97 for more details about devices identifiers.
102 uses UUIDs as strings. The string representation of the UUID should be based on
103 lower case characters.
109 This field describes the mount point for the filesystem. For swap partitions, this
110 field should be specified as `none'. If the name of the mount point
111 contains spaces these can be escaped as `\\040'.
117 This field describes the type of the filesystem. Linux supports lots
118 of filesystem types, such as
151 and possibly others. For more details, see
154 For the filesystems currently supported by the running kernel, see
155 .IR /proc/filesystems .
159 denotes a file or partition to be used
164 causes the line to be ignored. This is useful
165 to show disk partitions which are currently unused.
168 is useful for bind or move mounts.
175 The subtype is defined by '.subtype' suffix. For
176 example 'fuse.sshfs'. It's recommended to use subtype notation rather than add
177 any prefix to the first fstab field (for example 'sshfs#example.com' is
184 This field describes the mount options associated with the filesystem.
186 It is formatted as a comma separated list of options. It contains at least
187 the type of mount plus any additional options appropriate to the filesystem
188 type. For documentation on the available mount options, see
190 For documentation on the available swap options, see
193 Basic file system independent options are:
196 use default options: rw, suid, dev, exec, auto, nouser, and async.
199 do not mount when "mount -a" is given (e.g., at boot time)
202 allow a user to mount
205 allow device owner to mount
208 for use by fstab-maintaining programs
211 do not report errors for this device if it does not exist.
217 This field is used for these filesystems by the
219 command to determine which filesystems need to be dumped. If the fifth
220 field is not present, a value of zero is returned and
222 will assume that the filesystem does not need to be dumped.
228 This field is used by the
230 program to determine the order in which filesystem checks are done at
231 reboot time. The root filesystem should be specified with a
233 of 1, and other filesystems should have a
235 of 2. Filesystems within a drive will be checked sequentially, but
236 filesystems on different drives will be checked at the same time to utilize
237 parallelism available in the hardware. If the sixth field is not present
238 or zero, a value of zero is returned and
240 will assume that the filesystem does not need to be checked.
243 The proper way to read records from
245 is to use the routines
263 file format appeared in 4.0BSD.
264 .\" But without comment convention, and options and vfs_type.
265 .\" Instead there was a type rw/ro/rq/sw/xx, where xx is the present 'ignore'.
267 This man page is part of the util-linux package and is available from
268 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.