diff options
author | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2020-03-05 08:05:24 +0100 |
---|---|---|
committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2020-03-05 08:20:06 +0100 |
commit | 4a29c185b7fefe5b931c037399ccb259867197fa (patch) | |
tree | 91a0899dcb2a11e0463ce4854427d67b2a691198 | |
parent | dd0395b5654c52e982adf6d354db9c7fdcf4b6c7 (diff) | |
download | systemd-4a29c185b7fefe5b931c037399ccb259867197fa.tar.gz |
man: add systemd-network-generator.service(8)
It's a bit bare-bones, but it should be enough to point the reader in the right
direction.
-rw-r--r-- | man/rules/meson.build | 4 | ||||
-rw-r--r-- | man/systemd-network-generator.service.xml | 103 | ||||
-rw-r--r-- | man/systemd-networkd.service.xml | 3 | ||||
-rw-r--r-- | units/systemd-network-generator.service.in | 1 |
4 files changed, 110 insertions, 1 deletions
diff --git a/man/rules/meson.build b/man/rules/meson.build index 6b08add2bb..296dd7da3a 100644 --- a/man/rules/meson.build +++ b/man/rules/meson.build @@ -763,6 +763,10 @@ manpages = [ ''], ['systemd-modules-load.service', '8', ['systemd-modules-load'], 'HAVE_KMOD'], ['systemd-mount', '1', ['systemd-umount'], ''], + ['systemd-network-generator.service', + '8', + ['systemd-network-generator'], + 'ENABLE_NETWORKD'], ['systemd-networkd-wait-online.service', '8', ['systemd-networkd-wait-online'], diff --git a/man/systemd-network-generator.service.xml b/man/systemd-network-generator.service.xml new file mode 100644 index 0000000000..fcb3c69ffb --- /dev/null +++ b/man/systemd-network-generator.service.xml @@ -0,0 +1,103 @@ +<?xml version='1.0'?> <!--*-nxml-*--> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> +<!-- SPDX-License-Identifier: LGPL-2.1+ --> + +<refentry id="systemd-network-generator.service" conditional='ENABLE_NETWORKD'> + + <refentryinfo> + <title>systemd-network-generator.service</title> + <productname>systemd</productname> + </refentryinfo> + + <refmeta> + <refentrytitle>systemd-network-generator.service</refentrytitle> + <manvolnum>8</manvolnum> + </refmeta> + + <refnamediv> + <refname>systemd-network-generator.service</refname> + <refname>systemd-network-generator</refname> + <refpurpose>Generate network configuration from the kernel command line</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <para><filename>systemd-network-generator.service</filename></para> + <para><filename>/usr/lib/systemd/systemd-network-generator</filename></para> + </refsynopsisdiv> + + <refsect1> + <title>Description</title> + + <para><filename>systemd-network-generator.service</filename> is a system service that translates + <varname>ip=</varname> and the related settings on the kernel command line (see below) into + <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>, + <citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>, and + <citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry> + configuration files understood by + <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry> + and + <citerefentry><refentrytitle>systemd-udevd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>. + </para> + + <para>Files are generated in <filename>/run/systemd/network/</filename>.</para> + </refsect1> + + <refsect1><title>Kernel command line options</title> + <para>This tool understands the following options:</para> + + <variablelist class='kernel-commandline-options'> + <varlistentry> + <term><varname>ip=</varname></term> + <term><varname>rd.route=</varname></term> + <term><varname>rd.peerdns=</varname></term> + <listitem> + <para>— translated into + <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry> files.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><varname>ifname=</varname></term> + <listitem> + <para>— translated into + <citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry> files.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><varname>vlan=</varname></term> + <term><varname>bond=</varname></term> + <term><varname>bridge=</varname></term> + <term><varname>bootdev=</varname></term> + <listitem> + <para>— translated into + <citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry> files.</para> + </listitem> + </varlistentry> + + <!-- unsupported: + team=<teammaster>:<teamslaves> + bootdev= + BOOTIF= + bootdev= + bootdev= + bootdev= + --> + </variablelist> + + <para>See + <citerefentry project='man-pages'><refentrytitle>dracut.kernel</refentrytitle><manvolnum>7</manvolnum></citerefentry> + for option syntax and details.</para> + </refsect1> + + <refsect1> + <title>See Also</title> + <para> + <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>, + <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>, + <citerefentry><refentrytitle>dracut</refentrytitle><manvolnum>8</manvolnum></citerefentry> + </para> + </refsect1> + +</refentry> diff --git a/man/systemd-networkd.service.xml b/man/systemd-networkd.service.xml index b3ba621ae6..66043f4b95 100644 --- a/man/systemd-networkd.service.xml +++ b/man/systemd-networkd.service.xml @@ -86,7 +86,8 @@ <citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>, - <citerefentry><refentrytitle>systemd-networkd-wait-online.service</refentrytitle><manvolnum>8</manvolnum></citerefentry> + <citerefentry><refentrytitle>systemd-networkd-wait-online.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>, + <citerefentry><refentrytitle>systemd-networkd-generator.service</refentrytitle><manvolnum>8</manvolnum></citerefentry> </para> </refsect1> diff --git a/units/systemd-network-generator.service.in b/units/systemd-network-generator.service.in index e314aded9b..1a70ad70e9 100644 --- a/units/systemd-network-generator.service.in +++ b/units/systemd-network-generator.service.in @@ -9,6 +9,7 @@ [Unit] Description=Generate network units from Kernel command line +Documentation=man:systemd-network-generator.service(8) DefaultDependencies=no Before=network-pre.target |