diff options
author | Chris Down <chris@chrisdown.name> | 2020-06-09 14:43:05 +0100 |
---|---|---|
committer | Lennart Poettering <lennart@poettering.net> | 2020-06-09 17:13:59 +0200 |
commit | 69876f94abc3f5861e87ad287b8d1f6770c6fdce (patch) | |
tree | b17337ee0b927a7fc304d81b0f3ea2276255119f /man/systemd.automount.xml | |
parent | fa0e23c900303bd896f86303b711896778c14633 (diff) | |
download | systemd-69876f94abc3f5861e87ad287b8d1f6770c6fdce.tar.gz |
doc: Try to clarify automount dependency confusion
Arch recently upgraded systemd to 245.6. Shortly afterwards, users began
reporting[0] that systemd detected an ordering cycle, and they were
unable to log in. The reason they were unable to log in was because of
ordering cycle resolution:
[...]
systemd[1]: sysinit.target: Job systemd-tmpfiles-setup.service/start deleted to break ordering cycle starting with sysinit.target/start
systemd[1]: sysinit.target: Job systemd-update-done.service/start deleted to break ordering cycle starting with sysinit.target/start
systemd[1]: sysinit.target: Job systemd-journal-catalog-update.service/start deleted to break ordering cycle starting with sysinit.target/start
systemd[1]: sysinit.target: Job local-fs.target/start deleted to break ordering cycle starting with sysinit.target/start
systemd[1]: sysinit.target: Job systemd-tmpfiles-setup.service/start deleted to break ordering cycle starting with sysinit.target/start
[...]
Whether the resolution did the right thing here or not is a longer-term
discussion, but in the interim we should at least make this distinction
between automount dependencies and mount dependencies clearer in the
documentation, so that users and distribution maintainers know what's
acceptable. In this case Arch actually backed out b3d7aef5 entirely and
released a new version due to the confusion.
Also see https://github.com/systemd/systemd-stable/issues/69.
0: https://bugs.archlinux.org/task/66908
Diffstat (limited to 'man/systemd.automount.xml')
-rw-r--r-- | man/systemd.automount.xml | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/man/systemd.automount.xml b/man/systemd.automount.xml index 35690fd22a..fd65f5da79 100644 --- a/man/systemd.automount.xml +++ b/man/systemd.automount.xml @@ -57,6 +57,12 @@ <para>Automount units may be used to implement on-demand mounting as well as parallelized mounting of file systems.</para> + + <para>Note that automount units are separate from the mount itself, so you + should not set <varname>After=</varname> or <varname>Requires=</varname> + for mount dependencies here. For example, you should not set + <varname>After=network-online.target</varname> or similar on network + filesystems. Doing so may result in an ordering cycle.</para> </refsect1> <refsect1> |