chiark / gitweb /
man: document variable substitution
authorLennart Poettering <lennart@poettering.net>
Thu, 8 Jul 2010 02:19:54 +0000 (04:19 +0200)
committerLennart Poettering <lennart@poettering.net>
Thu, 8 Jul 2010 02:19:54 +0000 (04:19 +0200)
man/systemd.service.xml
src/test-loopback.c

index 7eaf9cb..709a448 100644 (file)
                                 <literal>argv[0]</literal> to the
                                 executed process, followed by the
                                 further arguments specified. Unless
-                                <varname>Type=forking</varname> is set,
-                                the process started via this command
-                                line will be considered the main
-                                process of the
-                                daemon.</para></listitem>
+                                <varname>Type=forking</varname> is
+                                set, the process started via this
+                                command line will be considered the
+                                main process of the daemon. The
+                                command line accepts % specifiers as
+                                described in
+                                <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>. On
+                                top of that basic environment variable
+                                substitution is supported, where
+                                <literal>$(FOO)</literal> is replaced
+                                by the value of the environment
+                                variable of the same
+                                name.</para></listitem>
                         </varlistentry>
 
                         <varlistentry>
                                 suitable for XDG
                                 <filename>.desktop</filename> files.
                                 Use of these settings is
-                                optional.</para></listitem>
+                                optional. Specifier and environment
+                                variable substitution is
+                                supported.</para></listitem>
                         </varlistentry>
 
                         <varlistentry>
                                 scheme as pointed out for
                                 <varname>ExecStartPre=</varname>
                                 above. Use of this setting is
-                                optional.  </para></listitem>
+                                optional. Specifier and environment
+                                variable substitution is supported
+                                here following the same scheme as for
+                                <varname>ExecStart=</varname>. One
+                                special environment variable is set:
+                                if known <literal>$MAINPID</literal> is
+                                set to the main process of the
+                                daemon, and may be used for command
+                                lines like the following:
+                                <command>/bin/kill -HUP
+                                $(MAINPID)</command>.</para></listitem>
                         </varlistentry>
 
                         <varlistentry>
                                 (see below). If this option is not
                                 specified the process is terminated
                                 right-away when service stop is
-                                requested.</para></listitem>
+                                requested. Specifier and environment
+                                variable substitution is supported
+                                (including
+                                <literal>$(MAINPID)</literal>, see
+                                above).</para></listitem>
                         </varlistentry>
 
                         <varlistentry>
                                 out for
                                 <varname>ExecStartPre</varname>. Use
                                 of these settings is
-                                optional.</para></listitem>
+                                optional. Specifier and environment
+                                variable substitution is
+                                supported.</para></listitem>
                         </varlistentry>
 
                         <varlistentry>
index 5cd7b41..478f2f6 100644 (file)
@@ -24,6 +24,7 @@
 #include <stdio.h>
 
 #include "loopback-setup.h"
+#include "util.h"
 
 int main(int argc, char* argv[]) {
         int r;