summaryrefslogtreecommitdiff
path: root/docs/_include/interface-address-with-dhcp.txt
blob: d454d051096e3f900a24a1f581011088dbeebf85 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
.. cfgcmd:: set interfaces {{ var0 }} <interface> {{ var2 }} {{ var3 }}
  {{ var5 }} {{ var6 }} address <address | dhcp |
   dhcpv6>

  Configure interface `<interface>` with one or more interface addresses.

  * **address** can be specified multiple times as IPv4 and/or IPv6
    address, e.g. 192.0.2.1/24 and/or 2001:db8::1/64
  * **dhcp** interface address is received by DHCP from a DHCP server
    on this segment.
  * **dhcpv6** interface address is received by DHCPv6 from a DHCPv6
    server on this segment.

  .. note:: When using DHCP to retrieve IPv4 address and if local
     customizations are needed, they should be possible using the enter and
     exit hooks provided. The hook dirs are:

     * ``/config/scripts/dhcp-client/pre-hooks.d/``
     * ``/config/scripts/dhcp-client/post-hooks.d/``


  Example:

  .. code-block:: none

    set interfaces {{ var0 }} {{ var1 }} {{ var2 }} {{ var4 }} {{ var5 }} {{ var7 }} address 192.0.2.1/24
    set interfaces {{ var0 }} {{ var1 }} {{ var2 }} {{ var4 }} {{ var5 }} {{ var7 }} address 2001:db8::1/64
    set interfaces {{ var0 }} {{ var1 }} {{ var2 }} {{ var4 }} {{ var5 }} {{ var7 }} address dhcp
    set interfaces {{ var0 }} {{ var1 }} {{ var2 }} {{ var4 }} {{ var5 }} {{ var7 }} address dhcpv6