From: Lennart Poettering <lennart@poettering.net>
Date: Thu, 16 Jan 2020 15:41:29 +0000 (+0100)
Subject: man: mention that Before= doesn't work for device units
X-Git-Tag: v245-rc1~109^2~8
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=eec68a1a08078fbf136d25028438ae3c214aa1ad;p=thirdparty%2Fsystemd.git

man: mention that Before= doesn't work for device units

Fixes: #13362
---

diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index debb0c0d6c1..64830ae7237 100644
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -756,7 +756,11 @@
         configured by <varname>Requires=</varname>, <varname>Wants=</varname>, <varname>Requisite=</varname>,
         or <varname>BindsTo=</varname>. It is a common pattern to include a unit name in both the
         <varname>After=</varname> and <varname>Wants=</varname> options, in which case the unit listed will
-        be started before the unit that is configured with these options.</para></listitem>
+        be started before the unit that is configured with these options.</para>
+
+        <para>Note that <varname>Before=</varname> dependencies on device units have no effect and are not
+        supported.  Devices generally become available as a result of an external hotplug event, and systemd
+        creates the corresponding device unit without delay.</para></listitem>
       </varlistentry>
 
       <varlistentry>