nmstate-autoconf(8)

1nmstate-autoconf(8)        nmstate-autoconf man page       nmstate-autoconf(8)
2
3
4

NAME

6       nmstate-autoconf - A nmstate command line tool to automatically config‐
7       ure the network state using LLDP information
8

SYNOPSIS

10       nmstate-autoconf [INTERFACE_NAME] [--dry-run]
11

DESCRIPTION

13       nmstate-autoconf is a command line tool that uses libnmstate  in  order
14       to  confgure  the  network  state automatically using LLDP information.
15       This tool is experimental only.
16
17       nmstate-autoconf will identify the interfaces connected to a  VLAN  and
18       unify  them in a bond interface.  In addition, a vlan interface will be
19       created in top of the bond.
20
21       The bond state will be the following one:
22
23       - name: bond50
24         type: bond
25         state: up
26         link-aggregation:
27           mode: balance-rr
28           port:
29           - enp4s0
30           - enp4s0d1
31
32       The host VLAN state will be the following one:
33
34       - name: prod-net
35         type: vlan
36         state: up
37         vlan:
38           base-iface: bond50
39           id: 50
40
41
42       For multiple interface names, use comma to separate them. You can  also
43       use patterns for interface names:
44              * matches everything
45              ? matches any single character
46              [seq] matches any character in seq
47              [!seq] matches any character not in seq
48
49       For example, to enable LLDP auto configuration on all interfaces starts
50       with eth:
51              nmstate-autoconf eth\*
52              # The backslash is required to stop shell expanding '*' to  file
53              names.
54

OPTIONS

56       --dry-run, -d
57              Generate the network state that is going to be applied and print
58              it out. It won't apply any changes in the host.
59

LIMITATIONS

61       * This tool is experimental only.  * It is not  possible  to  configure
62       automatically bond or vlan options.
63

BUG REPORTS

65       Report  bugs  on  nmstate GitHub issues <https://github.com/nmstate/nm‐
66       state>.
67

COPYRIGHT

69       License  LGPL-2.1  or  any   later   version   <https://www.gnu.org/li‐
70       censes/old-licenses/lgpl-2.1.txt>.
71