man/networkd.conf.xml

   1 <?xml version='1.0'?> <!--*- Mode: nxml; nxml-child-indent: 2; indent-tabs-mode: nil -*-->
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   4
   5 <!--
   6   This file is part of systemd.
   7
   8   Copyright 2014 Tom Gundersen
   9
  10   systemd is free software; you can redistribute it and/or modify it
  11   under the terms of the GNU Lesser General Public License as published by
  12   the Free Software Foundation; either version 2.1 of the License, or
  13   (at your option) any later version.
  14
  15   systemd is distributed in the hope that it will be useful, but
  16   WITHOUT ANY WARRANTY; without even the implied warranty of
  17   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  18   Lesser General Public License for more details.
  19
  20   You should have received a copy of the GNU Lesser General Public License
  21   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  22 -->
  23
  24 <refentry id="networkd.conf" conditional='ENABLE_NETWORKD'
  25     xmlns:xi="http://www.w3.org/2001/XInclude">
  26   <refentryinfo>
  27     <title>networkd.conf</title>
  28     <productname>systemd</productname>
  29
  30     <authorgroup>
  31       <author>
  32         <contrib>Developer</contrib>
  33         <firstname>Vinay</firstname>
  34         <surname>Kulkarni</surname>
  35         <email>kulkarniv@vmware.com</email>
  36       </author>
  37     </authorgroup>
  38   </refentryinfo>
  39
  40   <refmeta>
  41     <refentrytitle>networkd.conf</refentrytitle>
  42     <manvolnum>5</manvolnum>
  43   </refmeta>
  44
  45   <refnamediv>
  46     <refname>networkd.conf</refname>
  47     <refname>networkd.conf.d</refname>
  48     <refpurpose>Global Network configuration files</refpurpose>
  49   </refnamediv>
  50
  51   <refsynopsisdiv>
  52     <para><filename>/etc/systemd/networkd.conf</filename></para>
  53     <para><filename>/etc/systemd/networkd.conf.d/*.conf</filename></para>
  54     <para><filename>/usr/lib/systemd/networkd.conf.d/*.conf</filename></para>
  55   </refsynopsisdiv>
  56
  57   <refsect1>
  58     <title>Description</title>
  59
  60     <para>These configuration files control global network parameters.
  61     For e.g. DHCP Unique Identifier (DUID).</para>
  62
  63   </refsect1>
  64
  65   <xi:include href="standard-conf.xml" xpointer="main-conf" />
  66
  67   <refsect1>
  68     <title>[DUID] Section Options</title>
  69
  70     <para>This section configures the DUID value used by the DHCP protocol. The DUID value
  71     specified here overrides the DUID that systemd-networkd generates using the machine-id
  72     from the <filename>/etc/machine-id</filename> file.</para>
  73
  74     <para>The configured DHCP DUID should conform to the specification in
  75     <ulink url="http://tools.ietf.org/html/rfc3315#section-9">RFC 3315</ulink>,
  76     <ulink url="http://tools.ietf.org/html/rfc6355">RFC 6355</ulink>. To configure IAID, see
  77     <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum>
  78     </citerefentry>.</para>
  79
  80     <para>The following options are available in <literal>[DUID]</literal> section:</para>
  81
  82     <variablelist class='network-directives'>
  83
  84       <varlistentry>
  85         <term><varname>Type=</varname></term>
  86         <listitem><para>The type of DUID specified in this section. The following values are
  87         supported:</para>
  88         <para>raw : If <literal>Type=raw</literal>, then <literal>RawData=</literal> specifies
  89         the entire DUID. For e.g: <literal>RawData=00:02:00:00:ab:11:f9:2a:c2:77:29:f9:5c:00</literal>
  90         specifies a 14 byte long DUID-EN ("00:02"), with enterprise number 43793 ("00:00:ab:11"),
  91         and identifier value "f9:2a:c2:77:29:f9:5c:00".</para></listitem>
  92       </varlistentry>
  93
  94       <varlistentry>
  95         <term><varname>RawData=</varname></term>
  96         <listitem><para>Specifies the DUID bytes as a single newline-terminated, hexadecimal
  97         string, with each byte separated by a ':'.</para></listitem>
  98       </varlistentry>
  99
 100     </variablelist>
 101   </refsect1>
 102
 103   <refsect1>
 104       <title>See Also</title>
 105       <para>
 106       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 107       <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
 108       <citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>1</manvolnum></citerefentry>
 109       </para>
 110   </refsect1>
 111
 112 </refentry>