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