units: introduce new Documentation= field and make use of it everywhere

This should help making the boot process a bit easier to explore and
understand for the administrator. The simple idea is that "systemctl
status" now shows a link to documentation alongside the other status and
decriptionary information of a service.

This patch adds the necessary fields to all our shipped units if we have
proper documentation for them.

diff --git a/man/systemd.special.xml b/man/systemd.special.xml
index 984e998abab7e48ec018c42448cae3a5c9bd6d3e..96befd5f5d2b172d98d3186c8e6835794aeee5bf 100644 (file)
--- a/man/systemd.special.xml
+++ b/man/systemd.special.xml
@@ -49,7 +49,9 @@
 
         <refsynopsisdiv>
                 <para><filename>basic.target</filename>,
+                <filename>bluetooth.target</filename>,
                 <filename>ctrl-alt-del.target</filename>,
+                <filename>cryptsetup.target</filename>,
                 <filename>dbus.service</filename>,
                 <filename>dbus.socket</filename>,
                 <filename>default.target</filename>,
@@ -57,6 +59,7 @@
                 <filename>emergency.target</filename>,
                 <filename>exit.service</filename>,
                 <filename>final.service</filename>,
+                <filename>getty.target</filename>,
                 <filename>graphical.target</filename>,
                 <filename>hibernate.target</filename>,
                 <filename>http-daemon.target</filename>,
@@ -69,7 +72,9 @@
                 <filename>multi-user.target</filename>,
                 <filename>network.target</filename>,
                 <filename>nss-lookup.target</filename>,
+                <filename>nss-user-lookup.target</filename>,
                 <filename>poweroff.target</filename>,
+                <filename>printer.target</filename>,
                 <filename>reboot.target</filename>,
                 <filename>remote-fs.target</filename>,
                 <filename>remote-fs-pre.target</filename>,
@@ -82,7 +87,9 @@
                 <filename>shutdown.target</filename>,
                 <filename>sigpwr.target</filename>,
                 <filename>sleep.target</filename>,
+                <filename>smartcard.target</filename>,
                 <filename>sockets.target</filename>,
+                <filename>sound.target</filename>,
                 <filename>suspend.target</filename>,
                 <filename>swap.target</filename>,
                 <filename>sysinit.target</filename>,
@@ -127,6 +134,16 @@
                                         this unit.</para>
                                 </listitem>
                         </varlistentry>
+                        <varlistentry>
+                                <term><filename>bluetooth.target</filename></term>
+                                <listitem>
+                                        <para>This target is started
+                                        automatically as soon as a
+                                        bluetooth controller is
+                                        plugged in or becomes
+                                        available at boot.</para>
+                                </listitem>
+                        </varlistentry>
                         <varlistentry>
                                 <term><filename>ctrl-alt-del.target</filename></term>
                                 <listitem>
@@ -139,6 +156,15 @@
                                         <filename>reboot.target</filename>.</para>
                                 </listitem>
                         </varlistentry>
+                        <varlistentry>
+                                <term><filename>cryptsetup.target</filename></term>
+                                <listitem>
+                                        <para>A target that pulls in
+                                        setup services for all
+                                        encrypted block
+                                        devices.</para>
+                                </listitem>
+                        </varlistentry>
                         <varlistentry>
                                 <term><filename>dbus.service</filename></term>
                                 <listitem>
@@ -226,6 +252,15 @@
                                         </para>
                                 </listitem>
                         </varlistentry>
+                        <varlistentry>
+                                <term><filename>getty.target</filename></term>
+                                <listitem>
+                                        <para>A special target unit
+                                        that pulls in all local TTY
+                                        <filename>getty</filename> instances.
+                                        </para>
+                                </listitem>
+                        </varlistentry>
                         <varlistentry>
                                 <term><filename>graphical.target</filename></term>
                                 <listitem>
@@ -442,6 +477,16 @@
                                         unit, for compatibility with SysV.</para>
                                 </listitem>
                         </varlistentry>
+                        <varlistentry>
+                                <term><filename>printer.target</filename></term>
+                                <listitem>
+                                        <para>This target is started
+                                        automatically as soon as a
+                                        printer is plugged in or
+                                        becomes available at
+                                        boot.</para>
+                                </listitem>
+                        </varlistentry>
                         <varlistentry>
                                 <term><filename>reboot.target</filename></term>
                                 <listitem>
@@ -615,6 +660,16 @@
                                         logic.</para>
                                 </listitem>
                         </varlistentry>
+                        <varlistentry>
+                                <term><filename>smartcard.target</filename></term>
+                                <listitem>
+                                        <para>This target is started
+                                        automatically as soon as a
+                                        smartcard controller is
+                                        plugged in or becomes
+                                        available at boot.</para>
+                                </listitem>
+                        </varlistentry>
                         <varlistentry>
                                 <term><filename>sockets.target</filename></term>
                                 <listitem>
@@ -629,6 +684,16 @@
                                         during installation.</para>
                                 </listitem>
                         </varlistentry>
+                        <varlistentry>
+                                <term><filename>sound.target</filename></term>
+                                <listitem>
+                                        <para>This target is started
+                                        automatically as soon as a
+                                        sound card is plugged in or
+                                        becomes available at
+                                        boot.</para>
+                                </listitem>
+                        </varlistentry>
                         <varlistentry>
                                 <term><filename>suspend.target</filename></term>
                                 <listitem>

diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index c81c7a30b04fb77c766e11cd7bf151f4dcf88104..dbc5fedea9a30fb514b94a269cffe86bd67f1bd9 100644 (file)
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -294,6 +294,23 @@
                                 name.</para></listitem>
                         </varlistentry>
 
+                        <varlistentry>
+                                <term><varname>Documentation=</varname></term>
+                                <listitem><para>A space separated list
+                                of URIs referencing documentation for
+                                this unit or its
+                                configuration. Accepted are only URIs
+                                of the types
+                                <literal>http://</literal>,
+                                <literal>https://</literal>,
+                                <literal>file:</literal>,
+                                <literal>info:</literal>,
+                                <literal>man:</literal>. For more
+                                information about the syntax of these
+                                URIs see
+                                <citerefentry><refentrytitle>uri</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para></listitem>
+                        </varlistentry>
+
                         <varlistentry>
                                 <term><varname>Requires=</varname></term>
 

diff --git a/src/core/dbus-unit.c b/src/core/dbus-unit.c
index 834fbd7693d74ebe3c845e8864b940ae2ce7544b..812f1b9f1600c750efb71e25bd8b3ab86d3609f6 100644 (file)
--- a/src/core/dbus-unit.c
+++ b/src/core/dbus-unit.c
@@ -808,6 +808,7 @@ const BusProperty bus_unit_properties[] = {
         { "PropagateReloadTo",    bus_unit_append_dependencies,      "as", offsetof(Unit, dependencies[UNIT_PROPAGATE_RELOAD_TO]),     true },
         { "PropagateReloadFrom",  bus_unit_append_dependencies,      "as", offsetof(Unit, dependencies[UNIT_PROPAGATE_RELOAD_FROM]),   true },
         { "RequiresMountsFor",    bus_property_append_strv,          "as", offsetof(Unit, requires_mounts_for),                        true },
+        { "Documentation",        bus_property_append_strv,          "as", offsetof(Unit, documentation),                              true },
         { "Description",          bus_unit_append_description,        "s", 0 },
         { "LoadState",            bus_unit_append_load_state,         "s", offsetof(Unit, load_state)                         },
         { "ActiveState",          bus_unit_append_active_state,       "s", 0 },

diff --git a/src/core/dbus-unit.h b/src/core/dbus-unit.h
index d22802d27440d71616ccc76456b980ff75decf1f..9680b56f062fec66c83f16657de6a135df13b494 100644 (file)
--- a/src/core/dbus-unit.h
+++ b/src/core/dbus-unit.h
@@ -87,6 +87,7 @@
         "  <property name=\"PropagateReloadFrom\" type=\"as\" access=\"read\"/>\n" \
         "  <property name=\"RequiresMountsFor\" type=\"as\" access=\"read\"/>\n" \
         "  <property name=\"Description\" type=\"s\" access=\"read\"/>\n" \
+        "  <property name=\"Documentation\" type=\"as\" access=\"read\"/>\n" \
         "  <property name=\"LoadState\" type=\"s\" access=\"read\"/>\n" \
         "  <property name=\"ActiveState\" type=\"s\" access=\"read\"/>\n" \
         "  <property name=\"SubState\" type=\"s\" access=\"read\"/>\n"  \

diff --git a/src/core/load-fragment-gperf.gperf.m4 b/src/core/load-fragment-gperf.gperf.m4
index d9292738773443191f8403d53ad43e9b8c570d16..f0e25c0c5dac9370d0bbfdec6a8f3a3f980d13e1 100644 (file)
--- a/src/core/load-fragment-gperf.gperf.m4
+++ b/src/core/load-fragment-gperf.gperf.m4
@@ -92,6 +92,7 @@ $1.ControlGroupPersistent,       config_parse_tristate,              0,
 )m4_dnl
 Unit.Names,                      config_parse_unit_names,            0,                             0
 Unit.Description,                config_parse_unit_string_printf,    0,                             offsetof(Unit, description)
+Unit.Documentation,              config_parse_documentation,         0,                             offsetof(Unit, documentation)
 Unit.Requires,                   config_parse_unit_deps,             UNIT_REQUIRES,                 0
 Unit.RequiresOverridable,        config_parse_unit_deps,             UNIT_REQUIRES_OVERRIDABLE,     0
 Unit.Requisite,                  config_parse_unit_deps,             UNIT_REQUISITE,                0

diff --git a/src/core/load-fragment.c b/src/core/load-fragment.c
index c2efec6657fa23fb33a708c8349a1e280c47a65d..3bc053341c5a8bdac65e4e4bc00590b51f7e401d 100644 (file)
--- a/src/core/load-fragment.c
+++ b/src/core/load-fragment.c
@@ -2063,6 +2063,43 @@ int config_parse_unit_requires_mounts_for(
         return r;
 }
 
+int config_parse_documentation(
+                const char *filename,
+                unsigned line,
+                const char *section,
+                const char *lvalue,
+                int ltype,
+                const char *rvalue,
+                void *data,
+                void *userdata) {
+
+        Unit *u = userdata;
+        int r;
+        char **a, **b;
+
+        assert(filename);
+        assert(lvalue);
+        assert(rvalue);
+        assert(u);
+
+        r = config_parse_unit_strv_printf(filename, line, section, lvalue, ltype, rvalue, data, userdata);
+        if (r < 0)
+                return r;
+
+        for (a = b = u->documentation; a && *a; a++) {
+
+                if (is_valid_documentation_url(*a))
+                        *(b++) = *a;
+                else {
+                        log_error("[%s:%u] Invalid URL, ignoring: %s", filename, line, *a);
+                        free(*a);
+                }
+        }
+        *b = NULL;
+
+        return r;
+}
+
 #define FOLLOW_MAX 8
 
 static int open_follow(char **filename, FILE **_f, Set *names, char **_final) {

diff --git a/src/core/load-fragment.h b/src/core/load-fragment.h
index ccc436420e8d26a7ed4349636bda782d95806265..3b2ed096b50c373f00e39dc8360e533e4e5000f9 100644 (file)
--- a/src/core/load-fragment.h
+++ b/src/core/load-fragment.h
@@ -36,6 +36,7 @@ int config_parse_unit_names(const char *filename, unsigned line, const char *sec
 int config_parse_unit_string_printf(const char *filename, unsigned line, const char *section, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 int config_parse_unit_strv_printf(const char *filename, unsigned line, const char *section, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 int config_parse_unit_path_printf(const char *filename, unsigned line, const char *section, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
+int config_parse_documentation(const char *filename, unsigned line, const char *section, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 int config_parse_socket_listen(const char *filename, unsigned line, const char *section, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 int config_parse_socket_bind(const char *filename, unsigned line, const char *section, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);
 int config_parse_exec_nice(const char *filename, unsigned line, const char *section, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);

diff --git a/src/core/unit.c b/src/core/unit.c
index 200d1968786502753f9efb90b23337223d99414d..1f1a5314f7e4e5820ae5a3517d687b7fc5a85a9d 100644 (file)
--- a/src/core/unit.c
+++ b/src/core/unit.c
@@ -397,6 +397,7 @@ void unit_free(Unit *u) {
         cgroup_attribute_free_list(u->cgroup_attributes);
 
         free(u->description);
+        strv_free(u->documentation);
         free(u->fragment_path);
         free(u->instance);
 
@@ -624,7 +625,7 @@ const char *unit_description(Unit *u) {
 }
 
 void unit_dump(Unit *u, FILE *f, const char *prefix) {
-        char *t;
+        char *t, **j;
         UnitDependency d;
         Iterator i;
         char *p2;
@@ -672,6 +673,9 @@ void unit_dump(Unit *u, FILE *f, const char *prefix) {
         SET_FOREACH(t, u->names, i)
                 fprintf(f, "%s\tName: %s\n", prefix, t);
 
+        STRV_FOREACH(j, u->documentation)
+                fprintf(f, "%s\tDocumentation: %s\n", prefix, *j);
+
         if ((following = unit_following(u)))
                 fprintf(f, "%s\tFollowing: %s\n", prefix, following->id);
 
@@ -698,8 +702,6 @@ void unit_dump(Unit *u, FILE *f, const char *prefix) {
         }
 
         if (!strv_isempty(u->requires_mounts_for)) {
-                char **j;
-
                 fprintf(f,
                         "%s\tRequiresMountsFor:", prefix);
 

diff --git a/src/core/unit.h b/src/core/unit.h
index e8e6b09866b64396c4665025689a51ed1ebc0d05..87dc88c96171bb555a3780ce710fc24f363dbd30 100644 (file)
--- a/src/core/unit.h
+++ b/src/core/unit.h
@@ -157,6 +157,7 @@ struct Unit {
         char **requires_mounts_for;
 
         char *description;
+        char **documentation;
 
         char *fragment_path; /* if loaded from a config file this is the primary path to it */
         usec_t fragment_mtime;

diff --git a/src/shared/util.c b/src/shared/util.c
index 0b81e1c4f985ea08dfc657682576d467e060bae1..ae0ce320ad40b5bb0ac4cab909096a27bc7d315f 100644 (file)
--- a/src/shared/util.c
+++ b/src/shared/util.c
@@ -5610,3 +5610,24 @@ int can_sleep(const char *type) {
         free(p);
         return found;
 }
+
+bool is_valid_documentation_url(const char *url) {
+        assert(url);
+
+        if (startswith(url, "http://") && url[7])
+                return true;
+
+        if (startswith(url, "https://") && url[8])
+                return true;
+
+        if (startswith(url, "file:") && url[5])
+                return true;
+
+        if (startswith(url, "info:") && url[5])
+                return true;
+
+        if (startswith(url, "man:") && url[4])
+                return true;
+
+        return false;
+}

diff --git a/src/shared/util.h b/src/shared/util.h
index f1bcb8a1017a596de38c620f8dc305a462e5d11d..3dce047b40f6a899e72eb6f6096952fbd6994a28 100644 (file)
--- a/src/shared/util.h
+++ b/src/shared/util.h
@@ -508,4 +508,6 @@ int getenv_for_pid(pid_t pid, const char *field, char **_value);
 
 int can_sleep(const char *type);
 
+bool is_valid_documentation_url(const char *url);
+
 #endif

diff --git a/src/systemctl/systemctl.c b/src/systemctl/systemctl.c
index 92c79d038f5b94d3ceb7442315b27783800b870e..0d2044f8744525ccc6528a2de9c3eb45002451ee 100644 (file)
--- a/src/systemctl/systemctl.c
+++ b/src/systemctl/systemctl.c
@@ -2158,6 +2158,8 @@ typedef struct UnitStatusInfo {
         const char *description;
         const char *following;
 
+        char **documentation;
+
         const char *path;
         const char *default_control_group;
 
@@ -2303,6 +2305,19 @@ static void print_status_info(UnitStatusInfo *i) {
         if (i->what)
                 printf("\t    What: %s\n", i->what);
 
+        if (!strv_isempty(i->documentation)) {
+                char **t;
+                bool first = true;
+
+                STRV_FOREACH(t, i->documentation) {
+                        if (first) {
+                                printf("\t    Docs: %s\n", *t);
+                                first = false;
+                        } else
+                                printf("\t          %s\n", *t);
+                }
+        }
+
         if (i->accept)
                 printf("\tAccepted: %u; Connected: %u\n", i->n_accepted, i->n_connections);
 
@@ -2607,6 +2622,27 @@ static int status_property(const char *name, DBusMessageIter *iter, UnitStatusIn
 
                                 LIST_PREPEND(ExecStatusInfo, exec, i->exec, info);
 
+                                dbus_message_iter_next(&sub);
+                        }
+                } else if (dbus_message_iter_get_element_type(iter) == DBUS_TYPE_STRING &&
+                           streq(name, "Documentation")) {
+
+                        DBusMessageIter sub;
+
+                        dbus_message_iter_recurse(iter, &sub);
+                        while (dbus_message_iter_get_arg_type(&sub) == DBUS_TYPE_STRING) {
+                                const char *s;
+                                char **l;
+
+                                dbus_message_iter_get_basic(&sub, &s);
+
+                                l = strv_append(i->documentation, s);
+                                if (!l)
+                                        return -ENOMEM;
+
+                                strv_free(i->documentation);
+                                i->documentation = l;
+
                                 dbus_message_iter_next(&sub);
                         }
                 }
@@ -2932,6 +2968,8 @@ static int show_one(const char *verb, DBusConnection *bus, const char *path, boo
         if (!show_properties)
                 print_status_info(&info);
 
+        strv_free(info.documentation);
+
         if (!streq_ptr(info.active_state, "active") &&
             !streq_ptr(info.active_state, "reloading") &&
             streq(verb, "status"))

diff --git a/units/basic.target b/units/basic.target
index c3c7ced7c617aeeaad3ff070aff7e7ceb2d49007..f9d03fa16f8a2f33a713431377a8743ce5fd2703 100644 (file)
--- a/units/basic.target
+++ b/units/basic.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Basic System
+Documentation=man:systemd.special(7)
 Requires=sysinit.target sockets.target
 After=sysinit.target sockets.target
 RefuseManualStart=yes

diff --git a/units/bluetooth.target b/units/bluetooth.target
index 6b9b5b5442de8062d7c4a13d08ca31a2d4aa5f33..dd4ae14cfb61c0ea6844868b3bad454b1dd31b3a 100644 (file)
--- a/units/bluetooth.target
+++ b/units/bluetooth.target
@@ -5,8 +5,7 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Bluetooth
+Documentation=man:systemd.special(7)
 StopWhenUnneeded=yes

diff --git a/units/cryptsetup.target b/units/cryptsetup.target
index af38e5d673a015df6ae9f2da53ea5fc7101175ed..25d3e33f6a5b5374a546fa68e791fc55389d88d0 100644 (file)
--- a/units/cryptsetup.target
+++ b/units/cryptsetup.target
@@ -5,7 +5,6 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Encrypted Volumes
+Documentation=man:systemd.special(7)

diff --git a/units/dev-hugepages.mount b/units/dev-hugepages.mount
index fcc50736e0d767e621c8cd39fe714ee95a8d40cc..9381167c8392636ef5e3144036c9a9a32897d7fa 100644 (file)
--- a/units/dev-hugepages.mount
+++ b/units/dev-hugepages.mount
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Huge Pages File System
+Documentation=https://www.kernel.org/doc/Documentation/vm/hugetlbpage.txt
 DefaultDependencies=no
 Before=sysinit.target
 ConditionPathExists=/sys/kernel/mm/hugepages

diff --git a/units/dev-mqueue.mount b/units/dev-mqueue.mount
index a55ac935c4ca86841cb85ecb4fc9d3e6b211c91f..5786bb1519bdc34b596a56d0b8973b1287abe017 100644 (file)
--- a/units/dev-mqueue.mount
+++ b/units/dev-mqueue.mount
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=POSIX Message Queue File System
+Documentation=man:mq_overview(7)
 DefaultDependencies=no
 Before=sysinit.target
 ConditionPathExists=/proc/sys/fs/mqueue

diff --git a/units/emergency.service.in b/units/emergency.service.in
index 75007563d736cdc67d09629d182d636c9b4e2ddc..87864f1c53f348aba879792c43d4d2b0a1312da0 100644 (file)
--- a/units/emergency.service.in
+++ b/units/emergency.service.in
@@ -5,8 +5,6 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Emergency Shell
 DefaultDependencies=no

diff --git a/units/emergency.target b/units/emergency.target
index 791dbe595c58755b7b10efe8f551b0cf9fef6236..0760d66f9592bd44e4b7c6123b400791c0042dbe 100644 (file)
--- a/units/emergency.target
+++ b/units/emergency.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Emergency Mode
+Documentation=man:systemd.special(7)
 Requires=emergency.service
 After=emergency.service
 AllowIsolate=yes

diff --git a/units/final.target b/units/final.target
index d516f38e9e38d65a08710eeb84cce6acf04d1d82..42819105c8f47a037e398fcc7e86f7f88e9f304b 100644 (file)
--- a/units/final.target
+++ b/units/final.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Final Step
+Documentation=man:systemd.special(7)
 DefaultDependencies=no
 RefuseManualStart=yes
 After=shutdown.target umount.target

diff --git a/units/getty.target b/units/getty.target
index f1c926c72d7a70bc0e4013dc8000151880a59e0d..d53da35f9cc1d020b4c521a489041283919d71f1 100644 (file)
--- a/units/getty.target
+++ b/units/getty.target
@@ -7,3 +7,4 @@
 
 [Unit]
 Description=Login Prompts
+Documentation=man:systemd.special(7)

diff --git a/units/getty@.service.m4 b/units/getty@.service.m4
index 431a3dd722c6def4834d44e99f71065cfc1b683b..6d458360a4e67d2a65e82b800d2f5eb55ee0b009 100644 (file)
--- a/units/getty@.service.m4
+++ b/units/getty@.service.m4
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Getty on %I
+Documentation=man:agetty(8)
 After=systemd-user-sessions.service plymouth-quit-wait.service
 m4_ifdef(`TARGET_FEDORA',
 After=rc-local.service

diff --git a/units/graphical.target b/units/graphical.target
index 2e82d6f89854a6362a9b675804253066ee7d36b6..7c6ebd47897501bbd2f5ebb18994cb364325e9a3 100644 (file)
--- a/units/graphical.target
+++ b/units/graphical.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Graphical Interface
+Documentation=man:systemd.special(7)
 Requires=multi-user.target
 After=multi-user.target
 Conflicts=rescue.target

diff --git a/units/halt.target b/units/halt.target
index dc908805db5ed89888cdae18d89869a2f315dbcd..41266b96f0c763fd84aa198fe2f594d87a44ae30 100644 (file)
--- a/units/halt.target
+++ b/units/halt.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Halt
+Documentation=man:systemd.special(7)
 DefaultDependencies=no
 Requires=halt.service
 After=halt.service

diff --git a/units/hibernate.target b/units/hibernate.target
index 05238a7cbf4f5b054fe8bf3135dc7b138c06a56c..23a9f99984c17981a853f567195f6278984c8297 100644 (file)
--- a/units/hibernate.target
+++ b/units/hibernate.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Hibernate
+Documentation=man:systemd.special(7)
 DefaultDependencies=no
 BindTo=hibernate.service
 After=hibernate.service

diff --git a/units/http-daemon.target b/units/http-daemon.target
index 1de1ec40188a0126a3bf679ebe56811a7971f14a..21ce997c1aed77ce585191d412fa4ad74da91f83 100644 (file)
--- a/units/http-daemon.target
+++ b/units/http-daemon.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 # This exists mostly for compatibility with SysV/LSB units, and
 # implementations lacking socket/bus activation.
 
 [Unit]
 Description=Web Server
+Documentation=man:systemd.special(7)

diff --git a/units/kexec.target b/units/kexec.target
index 4941f51c91e19294eb76777a81b31bf7c815b290..be8eafcf1f713521d526b0fbb96a59af4059afc8 100644 (file)
--- a/units/kexec.target
+++ b/units/kexec.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Reboot via kexec
+Documentation=man:systemd.special(7)
 DefaultDependencies=no
 Requires=kexec.service
 After=kexec.service

diff --git a/units/local-fs-pre.target b/units/local-fs-pre.target
index a928c1d79eb1b56dbe28638e9b57cba4cab56ee1..f8760ec9dfca909576f7b1dfef3d608306d732f4 100644 (file)
--- a/units/local-fs-pre.target
+++ b/units/local-fs-pre.target
@@ -5,7 +5,6 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Local File Systems (Pre)
+Documentation=man:systemd.special(7)

diff --git a/units/local-fs.target b/units/local-fs.target
index 2aa51fca8c1ad3c8d5eab792e7760e815c190028..dd92b17b6abcd13c5f13aa4b08fecc8ea6dea41c 100644 (file)
--- a/units/local-fs.target
+++ b/units/local-fs.target
@@ -5,9 +5,8 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Local File Systems
+Documentation=man:systemd.special(7)
 OnFailure=emergency.target
 OnFailureIsolate=yes

diff --git a/units/mail-transfer-agent.target b/units/mail-transfer-agent.target
index 94d134e3458a74f7a50f2c7ebd6e90619323ebf3..d2f24d15b90bb574935894ee85ca9fa25f2029fa 100644 (file)
--- a/units/mail-transfer-agent.target
+++ b/units/mail-transfer-agent.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 # This exists mostly for compatibility with SysV/LSB units, and
 # implementations lacking socket/bus activation.
 
 [Unit]
 Description=Mail Transfer Agent
+Documentation=man:systemd.special(7)

diff --git a/units/multi-user.target b/units/multi-user.target
index fe19cbcd0bd03b3c1eaa84c327ba12c28b8c9ce6..6e3f0b4f7ac4083a0b2ad1bb314c6497ebdcee61 100644 (file)
--- a/units/multi-user.target
+++ b/units/multi-user.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Multi-User
+Documentation=man:systemd.special(7)
 Requires=basic.target
 Conflicts=rescue.service rescue.target
 After=basic.target rescue.service rescue.target

diff --git a/units/network.target b/units/network.target
index da800da5b033210d4048987f4410e3a213f403d3..5406f4e5d96ddfaafb8a1a1234f7b6ae14fc26cc 100644 (file)
--- a/units/network.target
+++ b/units/network.target
@@ -5,7 +5,6 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Network
+Documentation=man:systemd.special(7)

diff --git a/units/nss-lookup.target b/units/nss-lookup.target
index c2d605c8a16ea570f3fee739d446855f4d7e63cd..eea905a715b48ded772ff70b3e2191b83894c1c3 100644 (file)
--- a/units/nss-lookup.target
+++ b/units/nss-lookup.target
@@ -5,11 +5,10 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 # This exists mostly for compatibility with SysV/LSB units, and
 # implementations lacking socket/bus activation.
 
 [Unit]
 Description=Host and Network Name Lookups
+Documentation=man:systemd.special(7)
 After=network.target

diff --git a/units/nss-user-lookup.target b/units/nss-user-lookup.target
index 0053f0608cafe886291bc300ff132016fa687d14..3e0fced10162503702388cdb4644602f86bcb9df 100644 (file)
--- a/units/nss-user-lookup.target
+++ b/units/nss-user-lookup.target
@@ -5,11 +5,10 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 # This exists mostly for implementations lacking socket/bus
 # activation.
 
 [Unit]
 Description=User and Group Name Lookups
+Documentation=man:systemd.special(7)
 After=network.target

diff --git a/units/poweroff.target b/units/poweroff.target
index b81d6ee0d44318905651877ac83f61c528b48001..bb60c33dd9dac8fa1ec71160b186fcce1624a0e7 100644 (file)
--- a/units/poweroff.target
+++ b/units/poweroff.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Power-Off
+Documentation=man:systemd.special(7)
 DefaultDependencies=no
 Requires=poweroff.service
 After=poweroff.service

diff --git a/units/printer.target b/units/printer.target
index b8582da7ad8490fdc6bc2a7c4e84e47e20580144..a6b86caa8db422de8e81988a867ef4aa43c802f6 100644 (file)
--- a/units/printer.target
+++ b/units/printer.target
@@ -5,8 +5,7 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Printer
+Documentation=man:systemd.special(7)
 StopWhenUnneeded=yes

diff --git a/units/proc-sys-fs-binfmt_misc.mount b/units/proc-sys-fs-binfmt_misc.mount
index ff958ca01bac538a472b5b694b9bdc4de932d02f..c64c84951e4933f3989923cb21978229dc02d1ce 100644 (file)
--- a/units/proc-sys-fs-binfmt_misc.mount
+++ b/units/proc-sys-fs-binfmt_misc.mount
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Arbitrary Executable File Formats File System
+Documentation=https://www.kernel.org/doc/Documentation/binfmt_misc.txt
 DefaultDependencies=no
 
 [Mount]

diff --git a/units/reboot.target b/units/reboot.target
index 6d02417eb5537bc6d75055ca421464e81523f6f4..9faeb1800f57a2d5b1a0a3561dcd361c06656ea5 100644 (file)
--- a/units/reboot.target
+++ b/units/reboot.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Reboot
+Documentation=man:systemd.special(7)
 DefaultDependencies=no
 Requires=reboot.service
 After=reboot.service

diff --git a/units/remote-fs-pre.target b/units/remote-fs-pre.target
index 8f688ad7af228988ea1005db606fb353204c6c32..2169533bd312bdbefd471f85a8e56e31d28de0a3 100644 (file)
--- a/units/remote-fs-pre.target
+++ b/units/remote-fs-pre.target
@@ -5,8 +5,7 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Remote File Systems (Pre)
+Documentation=man:systemd.special(7)
 After=network.target nss-lookup.target

diff --git a/units/remote-fs.target b/units/remote-fs.target
index 87455a4a993719afa21f3d2c6e4877c4b697464b..9e68878ad8d2c1a949acf8b8a4b214da8bc57877 100644 (file)
--- a/units/remote-fs.target
+++ b/units/remote-fs.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Remote File Systems
+Documentation=man:systemd.special(7)
 
 [Install]
 WantedBy=multi-user.target

diff --git a/units/rescue.service.m4.in b/units/rescue.service.m4.in
index 3adfcf45bd5c71f2a7aadaee78139a9a7ac9f13d..75b9fde278a4e9dfdc063ca7546c15b88c13ade7 100644 (file)
--- a/units/rescue.service.m4.in
+++ b/units/rescue.service.m4.in
@@ -5,8 +5,6 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Rescue Shell
 DefaultDependencies=no

diff --git a/units/rescue.target b/units/rescue.target
index 85099a1ee014e9133953716d385a5297d8aaf3cc..c17a4e12d0ca03fc9b1b99a91dddbf6b8ce72c2a 100644 (file)
--- a/units/rescue.target
+++ b/units/rescue.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Rescue Mode
+Documentation=man:systemd.special(7)
 Requires=basic.target rescue.service
 After=basic.target rescue.service
 AllowIsolate=yes

diff --git a/units/rpcbind.target b/units/rpcbind.target
index 5a286ebe6a2759594b3764a5f776065dd44de40d..eb06a6db269d1e7056f2b1215137ed8412a7b7da 100644 (file)
--- a/units/rpcbind.target
+++ b/units/rpcbind.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 # This exists mostly for compatibility with SysV/LSB units, and
 # implementations lacking socket/bus activation.
 
 [Unit]
 Description=RPC Port Mapper
+Documentation=man:systemd.special(7)

diff --git a/units/serial-getty@.service.m4 b/units/serial-getty@.service.m4
index 366b2d0710d05256f8db01630d8b62d67c16f570..d61f93cec3934bcae7038b44042b861b262efb0d 100644 (file)
--- a/units/serial-getty@.service.m4
+++ b/units/serial-getty@.service.m4
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Serial Getty on %I
+Documentation=man:agetty(8)
 BindTo=dev-%i.device
 After=dev-%i.device systemd-user-sessions.service plymouth-quit-wait.service
 m4_ifdef(`TARGET_FEDORA',

diff --git a/units/shutdown.target b/units/shutdown.target
index 1bbef682801e7cf358433046c1ed0bc217baf916..73e302b8b2141c2ab883600137865af5be709218 100644 (file)
--- a/units/shutdown.target
+++ b/units/shutdown.target
@@ -5,9 +5,8 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Shutdown
+Documentation=man:systemd.special(7)
 DefaultDependencies=no
 RefuseManualStart=yes

diff --git a/units/sigpwr.target b/units/sigpwr.target
index 18a9683fb85961729c9cad384f75a4dd0c6bfc97..a52e7cffc9609ca6573cc73327a1f70f9bb8a9bd 100644 (file)
--- a/units/sigpwr.target
+++ b/units/sigpwr.target
@@ -5,7 +5,6 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Power Failure
+Documentation=man:systemd.special(7)

diff --git a/units/sleep.target b/units/sleep.target
index 9f4b247eb5b99e4c9e08752a6aaa4e1ec0d654f1..d7ebd289c8d516cd497b0255b15592975d4679f1 100644 (file)
--- a/units/sleep.target
+++ b/units/sleep.target
@@ -5,9 +5,8 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Sleep
+Documentation=man:systemd.special(7)
 DefaultDependencies=no
 RefuseManualStart=yes

diff --git a/units/smartcard.target b/units/smartcard.target
index 3e554a0303e93356b66b62c0cd9761277021d40f..5fefe84703194a21763d701a28217e9c5172f0bb 100644 (file)
--- a/units/smartcard.target
+++ b/units/smartcard.target
@@ -5,8 +5,7 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Smart Card
+Documentation=man:systemd.special(7)
 StopWhenUnneeded=yes

diff --git a/units/sockets.target b/units/sockets.target
index ab1b786870625126a878f024cb3c3ce1c0c902f6..26ab065d0288a78cc67f7e1f1f0ed3fddf85cb72 100644 (file)
--- a/units/sockets.target
+++ b/units/sockets.target
@@ -5,7 +5,6 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Sockets
+Documentation=man:systemd.special(7)

diff --git a/units/sound.target b/units/sound.target
index 6a17360c102ce63ff18d0226ba503ac2c6c4d668..6699adecebc205dbc78245a59e9461719c256fe2 100644 (file)
--- a/units/sound.target
+++ b/units/sound.target
@@ -5,8 +5,7 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Sound Card
+Documentation=man:systemd.special(7)
 StopWhenUnneeded=yes

diff --git a/units/suspend.target b/units/suspend.target
index 3ddb44975df9d5d8b5cfb34d8ddecd140537e125..eaf79bed11a6960e5a938e0e22cf1dbd16a79a3a 100644 (file)
--- a/units/suspend.target
+++ b/units/suspend.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Suspend
+Documentation=man:systemd.special(7)
 DefaultDependencies=no
 BindTo=suspend.service
 After=suspend.service

diff --git a/units/swap.target b/units/swap.target
index 4e165424b2b9a2f3b088c8079555480a050824bd..23a7d0dc9cf11bfe516a59fc152006c53fadcda4 100644 (file)
--- a/units/swap.target
+++ b/units/swap.target
@@ -5,7 +5,6 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Swap
+Documentation=man:systemd.special(7)

diff --git a/units/sysinit.target b/units/sysinit.target
index 5bc568ff224455e5496ef77c2e84ab9e54c59ee2..8f4fb8f5c12f26cd3e2ea2ee47ce8ad65bc92957 100644 (file)
--- a/units/sysinit.target
+++ b/units/sysinit.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=System Initialization
+Documentation=man:systemd.special(7)
 Conflicts=emergency.service emergency.target
 Wants=local-fs.target swap.target
 After=local-fs.target swap.target emergency.service emergency.target

diff --git a/units/syslog.socket b/units/syslog.socket
index f644f6e38b74e02ea77c37eb1b3278b76e620282..a228e5b09d0bbc9f228610e31bad5e73171cd728 100644 (file)
--- a/units/syslog.socket
+++ b/units/syslog.socket
@@ -5,10 +5,10 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Syslog Socket
+Documentation=man:systemd.special(7)
+Documentation=http://www.freedesktop.org/wiki/Software/systemd/syslog
 DefaultDependencies=no
 Before=sockets.target syslog.target
 Conflicts=shutdown.target

diff --git a/units/syslog.target b/units/syslog.target
index 92d2576e953efc316b6f9d4499c099a2ec184613..87ac886df396bb3f578c39b03df67bcc44fdf17e 100644 (file)
--- a/units/syslog.target
+++ b/units/syslog.target
@@ -5,13 +5,13 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 # This exists mostly for compatibility with SysV/LSB units, and
 # implementations lacking socket/bus activation.
 
 [Unit]
 Description=Syslog
+Documentation=man:systemd.special(7)
+Documentation=http://www.freedesktop.org/wiki/Software/systemd/syslog
 
 # Avoid that we conflict with shutdown.target, so that we can stay
 # until the very end and do not cancel shutdown.target if we should

diff --git a/units/systemd-ask-password-console.path b/units/systemd-ask-password-console.path
index dc8ab32bcb7b31eb0dd4ed9067e5cd0054e48e31..a0a3631b2f5a7d5cc6666e6705d6e1f56f511072 100644 (file)
--- a/units/systemd-ask-password-console.path
+++ b/units/systemd-ask-password-console.path
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Dispatch Password Requests to Console Directory Watch
+Documentation=http://www.freedesktop.org/wiki/Software/systemd/PasswordAgents
 DefaultDependencies=no
 Conflicts=shutdown.target
 After=plymouth-start.service

diff --git a/units/systemd-ask-password-console.service.in b/units/systemd-ask-password-console.service.in
index 55e3d8648e0865fac5f10c07bc2d970a65a4c511..85e739fd800bb9be61d8816dd71af30a1a00758d 100644 (file)
--- a/units/systemd-ask-password-console.service.in
+++ b/units/systemd-ask-password-console.service.in
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Dispatch Password Requests to Console
+Documentation=http://www.freedesktop.org/wiki/Software/systemd/PasswordAgents
 DefaultDependencies=no
 Conflicts=shutdown.target
 After=plymouth-start.service

diff --git a/units/systemd-ask-password-plymouth.path b/units/systemd-ask-password-plymouth.path
index b938ae57cfbea86b034851caaacd21ae24bc27df..9320b4a4df327c036b6f471fe90fb2d392c26603 100644 (file)
--- a/units/systemd-ask-password-plymouth.path
+++ b/units/systemd-ask-password-plymouth.path
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Forward Password Requests to Plymouth Directory Watch
+Documentation=http://www.freedesktop.org/wiki/Software/systemd/PasswordAgents
 DefaultDependencies=no
 Conflicts=shutdown.target
 After=plymouth-start.service

diff --git a/units/systemd-ask-password-plymouth.service.in b/units/systemd-ask-password-plymouth.service.in
index fcc28536422320de29b693b2ad1e5b4916b0f388..ea80bbd931676583411adc673c3a99286fa295db 100644 (file)
--- a/units/systemd-ask-password-plymouth.service.in
+++ b/units/systemd-ask-password-plymouth.service.in
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Forward Password Requests to Plymouth
+Documentation=http://www.freedesktop.org/wiki/Software/systemd/PasswordAgents
 DefaultDependencies=no
 Conflicts=shutdown.target
 After=plymouth-start.service

diff --git a/units/systemd-ask-password-wall.path b/units/systemd-ask-password-wall.path
index 73e13616b6c8acc89fb31697e2521ec5437d0a0a..3890a7412dfb2ef83ae44110d2f6d21a85581b83 100644 (file)
--- a/units/systemd-ask-password-wall.path
+++ b/units/systemd-ask-password-wall.path
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Forward Password Requests to Wall Directory Watch
+Documentation=http://www.freedesktop.org/wiki/Software/systemd/PasswordAgents
 DefaultDependencies=no
 Conflicts=shutdown.target
 Before=basic.target shutdown.target

diff --git a/units/systemd-ask-password-wall.service.in b/units/systemd-ask-password-wall.service.in
index 1db408e55bd65ff037b4ddf154943635f55ef9b0..9305fca6f7dd697545e616418e118c8d2f8cb1b5 100644 (file)
--- a/units/systemd-ask-password-wall.service.in
+++ b/units/systemd-ask-password-wall.service.in
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Forward Password Requests to Wall
+Documentation=http://www.freedesktop.org/wiki/Software/systemd/PasswordAgents
 After=systemd-user-sessions.service
 
 [Service]

diff --git a/units/systemd-binfmt.service.in b/units/systemd-binfmt.service.in
index 8d288066dccbd028a0b2e3a21e1d677b3fd0517c..a7cda979d4b943f28ad65c9151e21278afbcff91 100644 (file)
--- a/units/systemd-binfmt.service.in
+++ b/units/systemd-binfmt.service.in
@@ -7,6 +7,8 @@
 
 [Unit]
 Description=Set Up Additional Binary Formats
+Documentation=man:binfmt.d(5)
+Documentation=https://www.kernel.org/doc/Documentation/binfmt_misc.txt
 DefaultDependencies=no
 Conflicts=shutdown.target
 After=systemd-readahead-collect.service systemd-readahead-replay.service proc-sys-fs-binfmt_misc.automount

diff --git a/units/systemd-hostnamed.service.in b/units/systemd-hostnamed.service.in
index a9a99136c01acfbabcbf1c4a0deae829a854bacb..d7fd1940f31bf7d996d732a489f7f6d87a56b615 100644 (file)
--- a/units/systemd-hostnamed.service.in
+++ b/units/systemd-hostnamed.service.in
@@ -5,10 +5,11 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Hostname Service
+Documentation=man:hostname(5)
+Documentation=man:machine-info(5)
+Documentation=http://www.freedesktop.org/wiki/Software/systemd/hostnamed
 
 [Service]
 ExecStart=@rootlibexecdir@/systemd-hostnamed

diff --git a/units/systemd-initctl.service.in b/units/systemd-initctl.service.in
index bcadcc8d1a1b722a5a126cd747fba99bb2ac8568..11e22860352897291e9d38be665a8e3368822788 100644 (file)
--- a/units/systemd-initctl.service.in
+++ b/units/systemd-initctl.service.in
@@ -5,8 +5,6 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=/dev/initctl Compatibility Daemon
 DefaultDependencies=no

diff --git a/units/systemd-initctl.socket b/units/systemd-initctl.socket
index 66597ee10746af422b12255dde138de82641f8fb..abafc525d7603adbedfb7c99df2a86a4b67b5a62 100644 (file)
--- a/units/systemd-initctl.socket
+++ b/units/systemd-initctl.socket
@@ -5,8 +5,6 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=/dev/initctl Compatibility Named Pipe
 DefaultDependencies=no

diff --git a/units/systemd-journald.service.in b/units/systemd-journald.service.in
index a3c22c8ffa030ec496427f16b43a0c6c889a9706..da07cb9ce6c54db1caa4c2a71263f563a96b0127 100644 (file)
--- a/units/systemd-journald.service.in
+++ b/units/systemd-journald.service.in
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Journal Service
+Documentation=man:journald.conf(5)
 DefaultDependencies=no
 Requires=systemd-journald.socket
 After=systemd-journald.socket

diff --git a/units/systemd-journald.socket b/units/systemd-journald.socket
index d613e2288f3d74c91803532234031e1d43ce071b..0454e3e3403d24b4226d87bfdd8e0ea0cf09c5f5 100644 (file)
--- a/units/systemd-journald.socket
+++ b/units/systemd-journald.socket
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Journal Socket
+Documentation=man:journald.conf(5)
 DefaultDependencies=no
 Before=sockets.target syslog.target
 

diff --git a/units/systemd-localed.service.in b/units/systemd-localed.service.in
index 763d2900fcf473e6860242d961a81158044fc2a2..f973fa4585eae050378e7480306dc8e7e3ff9755 100644 (file)
--- a/units/systemd-localed.service.in
+++ b/units/systemd-localed.service.in
@@ -5,10 +5,11 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Locale Service
+Documentation=http://www.freedesktop.org/wiki/Software/systemd/localed
+Documentation=man:locale.conf(5)
+Documentation=man:vconsole.conf(5)
 
 [Service]
 ExecStart=@rootlibexecdir@/systemd-localed

diff --git a/units/systemd-logind.service.in b/units/systemd-logind.service.in
index f244761606699193b20f60eee4ed9ac11b4fe195..d890713fddb4c23938119185aa9ea99e166a3526 100644 (file)
--- a/units/systemd-logind.service.in
+++ b/units/systemd-logind.service.in
@@ -5,10 +5,10 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Login Service
+Documentation=http://www.freedesktop.org/wiki/Software/systemd/multiseat
+Documentation=man:logind.conf(5)
 After=nss-user-lookup.target
 
 [Service]

diff --git a/units/systemd-modules-load.service.in b/units/systemd-modules-load.service.in
index 243afadc83ec2461d49360b597c69eb825032c1d..8f25091986222cd8c6b576231f37b69b9f278670 100644 (file)
--- a/units/systemd-modules-load.service.in
+++ b/units/systemd-modules-load.service.in
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Load Kernel Modules
+Documentation=man:modules-load.d(5)
 DefaultDependencies=no
 Conflicts=shutdown.target
 After=systemd-readahead-collect.service systemd-readahead-replay.service

diff --git a/units/systemd-shutdownd.service.in b/units/systemd-shutdownd.service.in
index ec88b23fde0db00474406decde8be35f57288bad..b9e271f0f61f9c97c9e872691fc6d7a396989638 100644 (file)
--- a/units/systemd-shutdownd.service.in
+++ b/units/systemd-shutdownd.service.in
@@ -5,8 +5,6 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Delayed Shutdown Service
 DefaultDependencies=no

diff --git a/units/systemd-shutdownd.socket b/units/systemd-shutdownd.socket
index c97e01a3374e398e58a8037368a0800e3e83da6c..ed6225a09838843e6d18e2152036e26781e46f46 100644 (file)
--- a/units/systemd-shutdownd.socket
+++ b/units/systemd-shutdownd.socket
@@ -5,8 +5,6 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Delayed Shutdown Socket
 DefaultDependencies=no

diff --git a/units/systemd-sysctl.service.in b/units/systemd-sysctl.service.in
index d38f026142c373475b96c3b63ef16f761e2fa68e..d8849e79298f4f5bf7d1f4df96e7911097228163 100644 (file)
--- a/units/systemd-sysctl.service.in
+++ b/units/systemd-sysctl.service.in
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Apply Kernel Variables
+Documentation=man:sysctl.d(5)
 DefaultDependencies=no
 Conflicts=shutdown.target
 After=systemd-readahead-collect.service systemd-readahead-replay.service

diff --git a/units/systemd-timedated-ntp.target b/units/systemd-timedated-ntp.target
index 128424857d4f4b66839eb9bddbdc16df0743bd8b..083700412865b91f36ca73821925b1fe9d89ee4e 100644 (file)
--- a/units/systemd-timedated-ntp.target
+++ b/units/systemd-timedated-ntp.target
@@ -12,6 +12,7 @@
 
 [Unit]
 Description=Network Time Protocol
+Documentation=http://www.freedesktop.org/wiki/Software/systemd/timedated
 
 [Install]
 WantedBy=multi-user.target

diff --git a/units/systemd-timedated.service.in b/units/systemd-timedated.service.in
index 01222833d12b74bc3eade026eb21856d631f0648..fbdf9e1746373c92f8674f79dd58bee34cbf7f13 100644 (file)
--- a/units/systemd-timedated.service.in
+++ b/units/systemd-timedated.service.in
@@ -5,10 +5,10 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Time & Date Service
+Documentation=http://www.freedesktop.org/wiki/Software/systemd/timedated
+Documentation=man:timezone(5)
 
 [Service]
 ExecStart=@rootlibexecdir@/systemd-timedated

diff --git a/units/systemd-tmpfiles-clean.service.in b/units/systemd-tmpfiles-clean.service.in
index 0a8707e138d061b05fe2d52b8c6baf1f51bf590e..a288232e12f0d58b96b2ee6cb651f2f722005a7f 100644 (file)
--- a/units/systemd-tmpfiles-clean.service.in
+++ b/units/systemd-tmpfiles-clean.service.in
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Cleanup of Temporary Directories
+Documentation=man:tmpfiles.d(5)
 DefaultDependencies=no
 Wants=local-fs.target
 After=systemd-readahead-collect.service systemd-readahead-replay.service local-fs.target

diff --git a/units/systemd-tmpfiles-clean.timer b/units/systemd-tmpfiles-clean.timer
index c9f89e803da9df301238cf8f355fd4e7413d71e3..fac4ee3da8cd2851613f61d6df0861532d5cee44 100644 (file)
--- a/units/systemd-tmpfiles-clean.timer
+++ b/units/systemd-tmpfiles-clean.timer
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Daily Cleanup of Temporary Directories
+Documentation=man:tmpfiles.d(5)
 
 [Timer]
 OnBootSec=15min

diff --git a/units/systemd-tmpfiles-setup.service.in b/units/systemd-tmpfiles-setup.service.in
index 58c3415b1e01d5a0e24ca1b7530a228e560905d6..dbd6bfb6d5dde780f2360158d5f51b3aa98b05ab 100644 (file)
--- a/units/systemd-tmpfiles-setup.service.in
+++ b/units/systemd-tmpfiles-setup.service.in
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Recreate Volatile Files and Directories
+Documentation=man:tmpfiles.d(5)
 DefaultDependencies=no
 Wants=local-fs.target
 After=systemd-readahead-collect.service systemd-readahead-replay.service local-fs.target

diff --git a/units/systemd-udev-control.socket b/units/systemd-udev-control.socket
index 1cf06839118c6b5ab6de8e33e551837eef01848d..dc5e1da1747ade3cb3c9f055b2436e8ab7798f31 100644 (file)
--- a/units/systemd-udev-control.socket
+++ b/units/systemd-udev-control.socket
@@ -1,5 +1,14 @@
+#  This file is part of systemd.
+#
+#  systemd is free software; you can redistribute it and/or modify it
+#  under the terms of the GNU Lesser General Public License as published by
+#  the Free Software Foundation; either version 2.1 of the License, or
+#  (at your option) any later version.
+
 [Unit]
 Description=udev Control Socket
+Documentation=man:udev(7)
+Documentation=man:udevd(8)
 DefaultDependencies=no
 ConditionCapability=CAP_MKNOD
 

diff --git a/units/systemd-udev-kernel.socket b/units/systemd-udev-kernel.socket
index 8f2690f3fe6b27a42536e0e39772777748fea23b..3270fe8ced19a024a1ce6f8a7b8ff4f4f6fb04e2 100644 (file)
--- a/units/systemd-udev-kernel.socket
+++ b/units/systemd-udev-kernel.socket
@@ -1,5 +1,14 @@
+#  This file is part of systemd.
+#
+#  systemd is free software; you can redistribute it and/or modify it
+#  under the terms of the GNU Lesser General Public License as published by
+#  the Free Software Foundation; either version 2.1 of the License, or
+#  (at your option) any later version.
+
 [Unit]
 Description=udev Kernel Socket
+Documentation=man:udev(7)
+Documentation=man:udevd(8)
 DefaultDependencies=no
 ConditionCapability=CAP_MKNOD
 

diff --git a/units/systemd-udev-settle.service.in b/units/systemd-udev-settle.service.in
index e8c92231622dfe077774016542b8dd3f50a5fb57..b782d73ad0df26d371e77500010b411873adcae5 100644 (file)
--- a/units/systemd-udev-settle.service.in
+++ b/units/systemd-udev-settle.service.in
@@ -1,3 +1,10 @@
+#  This file is part of systemd.
+#
+#  systemd is free software; you can redistribute it and/or modify it
+#  under the terms of the GNU Lesser General Public License as published by
+#  the Free Software Foundation; either version 2.1 of the License, or
+#  (at your option) any later version.
+
 # This service is usually not enabled by default. If enabled, it
 # acts as a barrier for basic.target -- so all later services will
 # wait for udev completely finishing its coldplug run.
@@ -10,6 +17,8 @@
 
 [Unit]
 Description=udev Wait for Complete Device Initialization
+Documentation=man:udev(7)
+Documentation=man:udevd(8)
 DefaultDependencies=no
 Wants=systemd-udev.service
 After=udev-trigger.service

diff --git a/units/systemd-udev-trigger.service.in b/units/systemd-udev-trigger.service.in
index 523dd47abc1e2d34f98d784856fe0f0310ae77d3..61d188e489dc8114207ce2fe46cf73ea1b94266d 100644 (file)
--- a/units/systemd-udev-trigger.service.in
+++ b/units/systemd-udev-trigger.service.in
@@ -1,5 +1,14 @@
+#  This file is part of systemd.
+#
+#  systemd is free software; you can redistribute it and/or modify it
+#  under the terms of the GNU Lesser General Public License as published by
+#  the Free Software Foundation; either version 2.1 of the License, or
+#  (at your option) any later version.
+
 [Unit]
 Description=udev Coldplug all Devices
+Documentation=man:udev(7)
+Documentation=man:udevd(8)
 Wants=systemd-udev.service
 After=systemd-udev-kernel.socket systemd-udev-control.socket
 DefaultDependencies=no

diff --git a/units/systemd-udev.service.in b/units/systemd-udev.service.in
index 8a1793339b765f856a127edf71064c7277e9f288..7bd8e3c2101e333a7ef4e808b43ee48b274c7d2f 100644 (file)
--- a/units/systemd-udev.service.in
+++ b/units/systemd-udev.service.in
@@ -1,5 +1,14 @@
+#  This file is part of systemd.
+#
+#  systemd is free software; you can redistribute it and/or modify it
+#  under the terms of the GNU Lesser General Public License as published by
+#  the Free Software Foundation; either version 2.1 of the License, or
+#  (at your option) any later version.
+
 [Unit]
 Description=udev Kernel Device Manager
+Documentation=man:udev(7)
+Documentation=man:udevd(8)
 Wants=systemd-udev-control.socket systemd-udev-kernel.socket
 After=systemd-udev-control.socket systemd-udev-kernel.socket
 Before=basic.target

diff --git a/units/systemd-update-utmp-runlevel.service.in b/units/systemd-update-utmp-runlevel.service.in
index 2a0751e89670ace636f745a751a3f12fe48903c1..6666dbd7902f0afc27b7140b7ee60572e8407c3c 100644 (file)
--- a/units/systemd-update-utmp-runlevel.service.in
+++ b/units/systemd-update-utmp-runlevel.service.in
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Update UTMP about System Runlevel Changes
+Documentation=man:utmp(5)
 DefaultDependencies=no
 After=local-fs.target sysinit.target auditd.service runlevel1.target runlevel2.target runlevel3.target runlevel4.target runlevel5.target systemd-tmpfiles-setup.service
 Before=poweroff.service reboot.service halt.service

diff --git a/units/systemd-update-utmp-shutdown.service.in b/units/systemd-update-utmp-shutdown.service.in
index e86c7705486ef9d3dd43789b50d92ba9e5767a33..5b726c3688ef96aa4c07cacff0225588a1c47991 100644 (file)
--- a/units/systemd-update-utmp-shutdown.service.in
+++ b/units/systemd-update-utmp-shutdown.service.in
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Update UTMP about System Shutdown
+Documentation=man:utmp(5)
 DefaultDependencies=no
 After=local-fs.target sysinit.target auditd.service systemd-update-utmp-runlevel.service
 Before=poweroff.service reboot.service halt.service

diff --git a/units/systemd-vconsole-setup.service.in b/units/systemd-vconsole-setup.service.in
index 1420ce8f62753d1ce7d68bfb2b93312cd33ef026..51fc0b5124cc7b7001bb3bdc5c5b0cade7ad1c4c 100644 (file)
--- a/units/systemd-vconsole-setup.service.in
+++ b/units/systemd-vconsole-setup.service.in
@@ -7,6 +7,7 @@
 
 [Unit]
 Description=Setup Virtual Console
+Documentation=man:vconsole.conf(5)
 DefaultDependencies=no
 Conflicts=shutdown.target
 After=systemd-readahead-collect.service systemd-readahead-replay.service

diff --git a/units/time-sync.target b/units/time-sync.target
index 36b9e7aeeab0a5a4d8f4943ffb4d08c41e2f8d9f..ec00ecbbf491b59c8d1286c3b2c9bdd4046b5ff6 100644 (file)
--- a/units/time-sync.target
+++ b/units/time-sync.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 # This exists mostly for compatibility with SysV/LSB units, and
 # implementations lacking socket/bus activation.
 
 [Unit]
 Description=System Time Synchronized
+Documentation=man:systemd.special(7)

diff --git a/units/umount.target b/units/umount.target
index c583062911b35703cf00cb45966e59e680fef6be..39668d85d2d5cefef9bf0ac33162e43691bba228 100644 (file)
--- a/units/umount.target
+++ b/units/umount.target
@@ -5,9 +5,8 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Unmount All Filesystems
+Documentation=man:systemd.special(7)
 DefaultDependencies=no
 RefuseManualStart=yes

diff --git a/units/user/default.target b/units/user/default.target
index 4f9379ea5ef38d4eff680de3d5498ee2b92a5660..56cf4dcb9c789cadf4791d9d4129d8f393122caf 100644 (file)
--- a/units/user/default.target
+++ b/units/user/default.target
@@ -5,7 +5,6 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Default
+Documentation=man:systemd.special(7)

diff --git a/units/user/exit.service.in b/units/user/exit.service.in
index c785fbd64ad0d29d5aae6ddb1c87e438dfb4f5c2..a114f6c1bee2a942aa48639b7e04222df3fbe550 100644 (file)
--- a/units/user/exit.service.in
+++ b/units/user/exit.service.in
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Exit the Session
+Documentation=man:systemd.special(7)
 DefaultDependencies=no
 Requires=shutdown.target
 After=shutdown.target

diff --git a/units/user/exit.target b/units/user/exit.target
index ffc8fad0198a0238afea4291d516c0ac372486ef..539e03a9aa9923f2f31e51ec3b1106e57739c62b 100644 (file)
--- a/units/user/exit.target
+++ b/units/user/exit.target
@@ -5,10 +5,9 @@
 #  the Free Software Foundation; either version 2.1 of the License, or
 #  (at your option) any later version.
 
-# See systemd.special(7) for details
-
 [Unit]
 Description=Exit the Session
+Documentation=man:systemd.special(7)
 DefaultDependencies=no
 Requires=exit.service
 After=exit.service