man/systemd-fstab-generator.8

   1 '\" t
   2 .TH "SYSTEMD\-FSTAB\-GENERATOR" "8" "" "systemd 221" "systemd-fstab-generator"
   3 .\" -----------------------------------------------------------------
   4 .\" * Define some portability stuff
   5 .\" -----------------------------------------------------------------
   6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   7 .\" http://bugs.debian.org/507673
   8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
   9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  10 .ie \n(.g .ds Aq \(aq
  11 .el       .ds Aq '
  12 .\" -----------------------------------------------------------------
  13 .\" * set default formatting
  14 .\" -----------------------------------------------------------------
  15 .\" disable hyphenation
  16 .nh
  17 .\" disable justification (adjust text to left margin only)
  18 .ad l
  19 .\" -----------------------------------------------------------------
  20 .\" * MAIN CONTENT STARTS HERE *
  21 .\" -----------------------------------------------------------------
  22 .SH "NAME"
  23 systemd-fstab-generator \- Unit generator for /etc/fstab
  24 .SH "SYNOPSIS"
  25 .PP
  26 /usr/lib/systemd/system\-generators/systemd\-fstab\-generator
  27 .SH "DESCRIPTION"
  28 .PP
  29 systemd\-fstab\-generator
  30 is a generator that translates
  31 /etc/fstab
  32 (see
  33 \fBfstab\fR(5)
  34 for details) into native systemd units early at boot and when configuration of the system manager is reloaded\&. This will instantiate mount and swap units as necessary\&.
  35 .PP
  36 The
  37 \fIpassno\fR
  38 field is treated like a simple boolean, and the ordering information is discarded\&. However, if the root file system is checked, it is checked before all the other file systems\&.
  39 .PP
  40 See
  41 \fBsystemd.mount\fR(5)
  42 and
  43 \fBsystemd.swap\fR(5)
  44 for more information about special
  45 /etc/fstab
  46 mount options this generator understands\&.
  47 .PP
  48 systemd\-fstab\-generator
  49 implements
  50 \fBsystemd.generator\fR(7)\&.
  51 .SH "KERNEL COMMAND LINE"
  52 .PP
  53 systemd\-fstab\-generator
  54 understands the following kernel command line parameters:
  55 .PP
  56 \fIfstab=\fR, \fIrd\&.fstab=\fR
  57 .RS 4
  58 Takes a boolean argument\&. Defaults to
  59 "yes"\&. If
  60 "no", causes the generator to ignore any mounts or swaps configured in
  61 /etc/fstab\&.
  62 \fIrd\&.fstab=\fR
  63 is honored only by initial RAM disk (initrd) while
  64 \fIfstab=\fR
  65 is honored by both the main system and the initrd\&.
  66 .RE
  67 .PP
  68 \fIroot=\fR
  69 .RS 4
  70 Takes the root filesystem to mount in the initrd\&.
  71 \fIroot=\fR
  72 is honored by the initrd\&.
  73 .RE
  74 .PP
  75 \fIrootfstype=\fR
  76 .RS 4
  77 Takes the root filesystem type that will be passed to the mount command\&.
  78 \fIrootfstype=\fR
  79 is honored by the initrd\&.
  80 .RE
  81 .PP
  82 \fIrootflags=\fR
  83 .RS 4
  84 Takes the root filesystem mount options to use\&.
  85 \fIrootflags=\fR
  86 is honored by the initrd\&.
  87 .RE
  88 .PP
  89 \fImount\&.usr=\fR
  90 .RS 4
  91 Takes the
  92 /usr
  93 filesystem to be mounted by the initrd\&. If
  94 \fImount\&.usrfstype=\fR
  95 or
  96 \fImount\&.usrflags=\fR
  97 is set, then
  98 \fImount\&.usr=\fR
  99 will default to the value set in
 100 \fIroot=\fR\&.
 101 .sp
 102 Otherwise this parameter defaults to the
 103 /usr
 104 entry found in
 105 /etc/fstab
 106 on the root filesystem\&.
 107 .sp
 108 \fImount\&.usr=\fR
 109 is honored by the initrd\&.
 110 .RE
 111 .PP
 112 \fImount\&.usrfstype=\fR
 113 .RS 4
 114 Takes the
 115 /usr
 116 filesystem type that will be passed to the mount command\&. If
 117 \fImount\&.usr=\fR
 118 or
 119 \fImount\&.usrflags=\fR
 120 is set, then
 121 \fImount\&.usrfstype=\fR
 122 will default to the value set in
 123 \fIrootfstype=\fR\&.
 124 .sp
 125 Otherwise this value will be read from the
 126 /usr
 127 entry in
 128 /etc/fstab
 129 on the root filesystem\&.
 130 .sp
 131 \fImount\&.usrfstype=\fR
 132 is honored by the initrd\&.
 133 .RE
 134 .PP
 135 \fImount\&.usrflags=\fR
 136 .RS 4
 137 Takes the
 138 /usr
 139 filesystem mount options to use\&. If
 140 \fImount\&.usr=\fR
 141 or
 142 \fImount\&.usrfstype=\fR
 143 is set, then
 144 \fImount\&.usrflags=\fR
 145 will default to the value set in
 146 \fIrootflags=\fR\&.
 147 .sp
 148 Otherwise this value will be read from the
 149 /usr
 150 entry in
 151 /etc/fstab
 152 on the root filesystem\&.
 153 .sp
 154 \fImount\&.usrflags=\fR
 155 is honored by the initrd\&.
 156 .RE
 157 .SH "SEE ALSO"
 158 .PP
 159 \fBsystemd\fR(1),
 160 \fBfstab\fR(5),
 161 \fBsystemd.mount\fR(5),
 162 \fBsystemd.swap\fR(5),
 163 \fBsystemd-cryptsetup-generator\fR(8)