systemd.automount
systemd
Developer
Lennart
Poettering
lennart@poettering.net
systemd.automount
5
systemd.automount
Automount unit configuration
automount.automount
Description
A unit configuration file whose name ends in
.automount encodes information
about a file system automount point controlled and
supervised by systemd.
This man page lists the configuration options
specific to this unit type. See
systemd.unit5
for the common options of all unit configuration
files. The common configuration items are configured
in the generic [Unit] and [Install] sections. The
automount specific configuration options are configured
in the [Automount] section.
Automount units must be named after the
automount directories they control. Example: the
automount point /home/lennart
must be configured in a unit file
home-lennart.automount. For
details about the escaping logic used to convert a
file system path to a unit name see
systemd.unit5.
For each automount unit file a matching mount
unit file (see
systemd.mount5
for details) must exist which is activated when the
automount path is accessed. Example: if an automount
unit home-lennart.automount is
active and the user accesses
/home/lennart the mount unit
home-lennart.mount will be
activated.
Automount units may be used to implement
on-demand mounting as well as parallelized mounting of
file systems.
If an automount point is beneath another mount
point in the file system hierarchy, a dependency
between both units is created automatically.
fstab
Automount units may either be configured via unit
files, or via /etc/fstab (see
fstab5
for details).
For details how systemd parses
/etc/fstab see
systemd.mount5.
If an automount point is configured in both
/etc/fstab and a unit file, the
configuration in the latter takes precedence.
Options
Automount files must include an [Automount]
section, which carries information about the file
system automount points it supervises. The options
specific to the [Automount] section of automount units
are the following:
Where=
Takes an absolute path
of a directory of the automount
point. If the automount point does not
exist at time that the automount
point is installed, it is created. This
string must be reflected in the unit
filename. (See above.) This option is
mandatory.
DirectoryMode=
Directories of
automount points (and any parent
directories) are automatically created
if needed. This option specifies the
file system access mode used when
creating these directories. Takes an
access mode in octal
notation. Defaults to
0755.
See Also
systemd1,
systemctl1,
systemd.unit5,
systemd.mount5,
mount8,
automount8,
systemd.directives7