]> git.ipfire.org Git - thirdparty/systemd.git/blobdiff - man/systemd.xml
man: add version info
[thirdparty/systemd.git] / man / systemd.xml
index 218ab7e6f3021d88fae6d4bf6a7c6d18c876ba8f..3bedfe417568f4a9a589e0a920769e5f296ba378 100644 (file)
         <listitem><para>Reboots userspace, starts the <filename>soft-reboot.target</filename> unit. This is
         mostly equivalent to <command>systemctl start soft-reboot.target
         --job-mode=replace-irreversibly</command>.</para>
+
+        <xi:include href="version-info.xml" xpointer="v254"/>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term><constant>SIGRTMIN+17</constant></term>
 
-        <listitem><para>Immediately reboots the userspace.</para></listitem>
+        <listitem><para>Immediately reboots the userspace.</para>
+
+        <xi:include href="version-info.xml" xpointer="v254"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <listitem><para>Restores the log level to its configured value. The configured value is derived from – in order
         of priority – the value specified with <varname>systemd.log-level=</varname> on the kernel command line, or the
         value specified with <option>LogLevel=</option> in the configuration file, or the built-in default of
-        <literal>info</literal>.</para></listitem>
+        <literal>info</literal>.</para>
+
+        <xi:include href="version-info.xml" xpointer="v239"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <term><constant>SIGRTMIN+24</constant></term>
 
         <listitem><para>Immediately exits the manager (only available
-        for --user instances).</para></listitem>
+        for --user instances).</para>
+
+        <xi:include href="version-info.xml" xpointer="v195"/></listitem>
       </varlistentry>
 
       <varlistentry>
         done asynchronously.</para>
 
         <para>The systemd system manager treats this signal the same way as
-        <constant>SIGTERM</constant>.</para></listitem>
+        <constant>SIGTERM</constant>.</para>
+
+        <xi:include href="version-info.xml" xpointer="v250"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <listitem><para>Restores the log target to its configured value. The configured value is derived from – in
         order of priority – the value specified with <varname>systemd.log-target=</varname> on the kernel command line,
         or the value specified with <option>LogTarget=</option> in the configuration file, or the built-in
-        default.</para></listitem>
+        default.</para>
+
+        <xi:include href="version-info.xml" xpointer="v239"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <term><varname>$SYSTEMD_LOG_TIME</varname></term>
         <listitem><xi:include href="common-variables.xml" xpointer="log-time-body" />
 
-        <para>This can be overridden with <option>--log-time=</option>.</para></listitem>
+        <para>This can be overridden with <option>--log-time=</option>.</para>
+
+        <xi:include href="version-info.xml" xpointer="v246"/></listitem>
       </varlistentry>
 
       <varlistentry>
 
       <varlistentry>
         <term><varname>$SYSTEMD_LOG_TID</varname></term>
-        <listitem><xi:include href="common-variables.xml" xpointer="log-tid-body" /></listitem>
+        <listitem><xi:include href="common-variables.xml" xpointer="log-tid-body" />
+
+        <xi:include href="version-info.xml" xpointer="v247"/></listitem>
       </varlistentry>
 
       <varlistentry>
 
       <varlistentry>
         <term><varname>$SYSTEMD_LOG_RATELIMIT_KMSG</varname></term>
-        <listitem><xi:include href="common-variables.xml" xpointer="log-ratelimit-kmsg-body" /></listitem>
+        <listitem><xi:include href="common-variables.xml" xpointer="log-ratelimit-kmsg-body" />
+
+        <xi:include href="version-info.xml" xpointer="v254"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <listitem><para>Takes a boolean argument or enables the option if specified
         without an argument. If enabled, the systemd manager (PID 1) dumps core when
         it crashes. Otherwise, no core dump is created. Defaults to enabled.</para>
+
+        <xi:include href="version-info.xml" xpointer="v233"/>
         </listitem>
       </varlistentry>
 
         argument, with the same effect as a positive boolean. If a positive integer (in the range 1–63) is
         specified, the system manager (PID 1) will activate the specified virtual terminal when it crashes.
         Defaults to disabled, meaning that no such switch is attempted. If set to enabled, the virtual
-        terminal the kernel messages are written to is used instead.</para></listitem>
+        terminal the kernel messages are written to is used instead.</para>
+
+        <xi:include href="version-info.xml" xpointer="v233"/></listitem>
       </varlistentry>
 
       <varlistentry>
         without an argument. If enabled, the system manager (PID 1) spawns a shell
         when it crashes, after a 10s delay. Otherwise, no shell is spawned. Defaults
         to disabled, for security reasons, as the shell is not protected by password
-        authentication.</para></listitem>
+        authentication.</para>
+
+        <xi:include href="version-info.xml" xpointer="v233"/></listitem>
       </varlistentry>
 
       <varlistentry>
         machine automatically when it crashes, after a 10s delay.  Otherwise, the
         system will hang indefinitely. Defaults to disabled, in order to avoid a
         reboot loop. If combined with <varname>systemd.crash_shell</varname>, the
-        system is rebooted after the shell exits.</para></listitem>
+        system is rebooted after the shell exits.</para>
+
+        <xi:include href="version-info.xml" xpointer="v233"/></listitem>
       </varlistentry>
 
       <varlistentry>
         using <option>/dev/console</option>. If a path or a console name (such as
         <literal>ttyS0</literal>) is provided, the virtual console pointed to by this
         path or described by the give name will be used instead. Defaults to disabled.
-        </para></listitem>
+        </para>
+
+        <xi:include href="version-info.xml" xpointer="v233"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
         Defaults to enabled, i.e. watchdogs and failure actions are processed
         normally. The hardware watchdog is not affected by this
-        option.</para></listitem>
+        option.</para>
+
+        <xi:include href="version-info.xml" xpointer="v237"/></listitem>
       </varlistentry>
 
       <varlistentry>
         command line option, in which case it defaults to <constant>error</constant>. If specified overrides
         the system manager configuration file option <option>ShowStatus=</option>, see
         <citerefentry><refentrytitle>systemd-system.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
-        </para></listitem>
+        </para>
+
+        <xi:include href="version-info.xml" xpointer="v233"/></listitem>
       </varlistentry>
 
       <varlistentry>
         description in status messages. When specified, overrides the system manager configuration file
         option <option>StatusUnitFormat=</option>, see
         <citerefentry><refentrytitle>systemd-system.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
-        </para></listitem>
+        </para>
+
+        <xi:include href="version-info.xml" xpointer="v243"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <listitem><para>Takes a 32 character hex value to be
         used for setting the machine-id. Intended mostly for
         network booting where the same machine-id is desired
-        for every boot.</para></listitem>
+        for every boot.</para>
+
+        <xi:include href="version-info.xml" xpointer="v229"/></listitem>
       </varlistentry>
 
       <varlistentry>
 
         <listitem><para>Takes a boolean argument. If false disables importing credentials from the kernel
         command line, the DMI/SMBIOS OEM string table, the qemu_fw_cfg subsystem or the EFI kernel
-        stub.</para></listitem>
+        stub.</para>
+
+        <xi:include href="version-info.xml" xpointer="v251"/></listitem>
       </varlistentry>
 
       <varlistentry>
         this option is also read by the kernel itself and disables
         kernel log output. Passing this option hence turns off the
         usual output from both the system manager and the kernel.
-        </para></listitem>
+        </para>
+
+        <xi:include href="version-info.xml" xpointer="v186"/></listitem>
       </varlistentry>
 
       <varlistentry>
         option is also read by the kernel itself and enables kernel
         debug output. Passing this option hence turns on the debug
         output from both the system manager and the
-        kernel.</para></listitem>
+        kernel.</para>
+
+        <xi:include href="version-info.xml" xpointer="v205"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <varname>systemd.unit=runlevel4.target</varname>, and
         <varname>systemd.unit=runlevel5.target</varname>,
         respectively, and provided for compatibility reasons and to be
-        easier to type.</para></listitem>
+        easier to type.</para>
+
+        <xi:include href="version-info.xml" xpointer="v186"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <citerefentry project='man-pages'><refentrytitle>locale.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
         and
         <citerefentry project='man-pages'><refentrytitle>locale</refentrytitle><manvolnum>7</manvolnum></citerefentry>.
-        </para></listitem>
+        </para>
+
+        <xi:include href="version-info.xml" xpointer="v186"/></listitem>
       </varlistentry>
     </variablelist>
 
 
           <para>This feature is useful for hypervisors/VMMs or other processes on the host to receive a
           notification via VSOCK when a virtual machine has finished booting.</para>
+
+          <xi:include href="version-info.xml" xpointer="v254"/>
         </listitem>
       </varlistentry>
 
           file is not set up yet. See
           <citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry> for
           details.</para>
+
+        <xi:include href="version-info.xml" xpointer="v254"/>
         </listitem>
       </varlistentry>
     </variablelist>
           <term><option>--show-status</option></term>
 
           <listitem><para>Show terse unit status information on the console during boot-up and shutdown. See
-          <varname>systemd.show_status</varname> above.</para></listitem>
+          <varname>systemd.show_status</varname> above.</para>
+
+          <xi:include href="version-info.xml" xpointer="v244"/></listitem>
         </varlistentry>
 
         <varlistentry>
           <term><option>--log-color</option></term>
 
           <listitem><para>Highlight important log messages. See <varname>systemd.log_color</varname> above.
-          </para></listitem>
+          </para>
+
+          <xi:include href="version-info.xml" xpointer="v244"/></listitem>
         </varlistentry>
 
         <varlistentry>
           <term><option>--log-location</option></term>
 
           <listitem><para>Include code location in log messages. See <varname>systemd.log_location</varname>
-          above.</para></listitem>
+          above.</para>
+
+          <xi:include href="version-info.xml" xpointer="v244"/></listitem>
         </varlistentry>
 
         <varlistentry>
           <term><option>--log-time=</option></term>
 
           <listitem><para>Prefix console messages with timestamp. See <varname>systemd.log_time</varname> above.
-          </para></listitem>
+          </para>
+
+          <xi:include href="version-info.xml" xpointer="v246"/></listitem>
         </varlistentry>
 
         <varlistentry>
           <term><option>--service-watchdogs</option></term>
 
           <listitem><para>Globally enable/disable all service watchdog timeouts and emergency actions. See
-          <varname>systemd.service_watchdogs</varname> above.</para></listitem>
+          <varname>systemd.service_watchdogs</varname> above.</para>
+
+          <xi:include href="version-info.xml" xpointer="v244"/></listitem>
         </varlistentry>
 
         <varlistentry>
           <term>systemd 252</term>
           <listitem><para>Kernel command-line arguments <varname>systemd.unified_cgroup_hierarchy</varname>
           and <varname>systemd.legacy_systemd_cgroup_controller</varname> were deprecated. Please switch to
-          the unified cgroup hierarchy.</para></listitem>
+          the unified cgroup hierarchy.</para>
+
+          <xi:include href="version-info.xml" xpointer="v252"/></listitem>
         </varlistentry>
       </variablelist>
   </refsect1>