forked from ungleich-public/cdist
Rewrite man page in rst
This commit is contained in:
Darko Poljak
parent
a30b4e3619
commit
7408ddc134
2 changed files with 198 additions and 167 deletions
198
cdist/conf/type/__network_interface/man.rst
Normal file
198
cdist/conf/type/__network_interface/man.rst
Normal file
|
|
@ -0,0 +1,198 @@
|
||||||
|
cdist-type__network_interface(7)
|
||||||
|
================================
|
||||||
|
|
||||||
|
NAME
|
||||||
|
----
|
||||||
|
cdist-type__network_interface - configure network interfaces
|
||||||
|
|
||||||
|
|
||||||
|
DESCRIPTION
|
||||||
|
-----------
|
||||||
|
Configures network interfaces on debian an redhat based systems.
|
||||||
|
Interface names containing a dot are assumed to be vlan tagged sub interfaces.
|
||||||
|
e.g. eth0.10 is vlan 10 on physical device eth0.
|
||||||
|
|
||||||
|
|
||||||
|
REQUIRED PARAMETERS
|
||||||
|
-------------------
|
||||||
|
None.
|
||||||
|
|
||||||
|
OPTIONAL PARAMETERS
|
||||||
|
-------------------
|
||||||
|
name
|
||||||
|
The name of the physical or logical network device.
|
||||||
|
Defaults to __object_id.
|
||||||
|
|
||||||
|
method
|
||||||
|
The method for determining an IP address for the interface.
|
||||||
|
'dhcp', 'static' or 'manual'.
|
||||||
|
Defaults to 'dhcp'.
|
||||||
|
|
||||||
|
address
|
||||||
|
The IP address of the network interface.
|
||||||
|
Only used if --method is not 'dhcp'.
|
||||||
|
|
||||||
|
broadcast
|
||||||
|
Only used if --method is not 'dhcp'.
|
||||||
|
|
||||||
|
comment
|
||||||
|
Comment.
|
||||||
|
|
||||||
|
extra-config
|
||||||
|
Additional config that is added to the generated interfaces file verbatim.
|
||||||
|
|
||||||
|
gateway
|
||||||
|
Default gateway (dotted quad).
|
||||||
|
Only used if --method is not 'dhcp'.
|
||||||
|
|
||||||
|
netmask
|
||||||
|
The subnet mask to apply to the interface.
|
||||||
|
Only used if --method is not 'dhcp'.
|
||||||
|
|
||||||
|
metric
|
||||||
|
Routing metric for the default gateway.
|
||||||
|
|
||||||
|
mtu
|
||||||
|
The Maximum Transmission Unit size to use for the interface.
|
||||||
|
|
||||||
|
state
|
||||||
|
'present' or 'absent', defaults to 'present'.
|
||||||
|
|
||||||
|
bond-arp-interval
|
||||||
|
Specifies (in milliseconds) how often ARP monitoring occurs.
|
||||||
|
|
||||||
|
bond-arp-ip-target
|
||||||
|
Specifies the target IP address of ARP requests when the arp_interval parameter is enabled.
|
||||||
|
Can be specified up to 16 times.
|
||||||
|
|
||||||
|
bond-master
|
||||||
|
The name of the master (bonding) interface to which this slave should be enslaved.
|
||||||
|
|
||||||
|
bond-miimon
|
||||||
|
Specifies (in milliseconds) how often MII link monitoring occurs.
|
||||||
|
|
||||||
|
bond-mode
|
||||||
|
Allows you to specify the bonding policy. The value can be one of:
|
||||||
|
|
||||||
|
- balance-rr (0)
|
||||||
|
- active-backup (1)
|
||||||
|
- balance-xor (2)
|
||||||
|
- broadcast (3)
|
||||||
|
- 802.3ad (4)
|
||||||
|
- balance-tlb (5)
|
||||||
|
- balance-alb (6)
|
||||||
|
|
||||||
|
bond-primary
|
||||||
|
Specifies the interface name, such as eth0, of the primary device.
|
||||||
|
|
||||||
|
bond-slaves
|
||||||
|
The slave interfaces that form this bonding.
|
||||||
|
|
||||||
|
linkdelay
|
||||||
|
Only useable on Redhat based systems.
|
||||||
|
Time in seconds that the system should pause after the specific interface
|
||||||
|
is enabled. This may be useful if one interface is connected to a
|
||||||
|
switch which has spanning tree enabled and must wait for STP to
|
||||||
|
converge before the interface should be considered usable.
|
||||||
|
|
||||||
|
BOOLEAN PARAMETERS
|
||||||
|
------------------
|
||||||
|
onboot
|
||||||
|
Whether to bring the interface up on boot.
|
||||||
|
|
||||||
|
hotplug
|
||||||
|
Allow/disallow hotplug support for this interface.
|
||||||
|
|
||||||
|
nodns
|
||||||
|
Do not configure nameservers in /etc/resolv.conf.
|
||||||
|
|
||||||
|
noroute
|
||||||
|
Do not set default route.
|
||||||
|
|
||||||
|
no-network-wait-online
|
||||||
|
Do not consider this network interface in the network-wait-online.service unit.
|
||||||
|
|
||||||
|
symmetric-routing
|
||||||
|
Manage routing tables and rules to ensure symmetric routing.
|
||||||
|
|
||||||
|
|
||||||
|
EXAMPLES
|
||||||
|
--------
|
||||||
|
|
||||||
|
.. code-block:: sh
|
||||||
|
|
||||||
|
__network_interface eth0 --onboot
|
||||||
|
|
||||||
|
# Same thing, but explicitly define method
|
||||||
|
__network_interface eth0 --method dhcp --onboot
|
||||||
|
|
||||||
|
__network_interface eth1 \
|
||||||
|
--method static \
|
||||||
|
--address 192.168.42.23 \
|
||||||
|
--netmask 255.255.255.0 \
|
||||||
|
--gateway 192.168.42.1 \
|
||||||
|
--onboot
|
||||||
|
|
||||||
|
__network_interface eth3 --method dhcp --hotplug
|
||||||
|
|
||||||
|
# Don't wait for Infiniband interface to be up before reaching systemd network-online.target
|
||||||
|
__network_interface ib0 --method dhcp --no-network-wait-online
|
||||||
|
|
||||||
|
# active-backup bonding with 2 slaves
|
||||||
|
__network_interface bond0 \
|
||||||
|
--onboot \
|
||||||
|
--method static \
|
||||||
|
--bond-mode active-backup \
|
||||||
|
--bond-miimon 500 \
|
||||||
|
--bond-primary eth5 \
|
||||||
|
--address 10.205.9.65 \
|
||||||
|
--netmask 255.255.224.0
|
||||||
|
|
||||||
|
__network_interface eth5 \
|
||||||
|
--onboot \
|
||||||
|
--method manual \
|
||||||
|
--bond-master bond0
|
||||||
|
|
||||||
|
__network_interface eth6 \
|
||||||
|
--onboot \
|
||||||
|
--method manual \
|
||||||
|
--bond-master bond0
|
||||||
|
|
||||||
|
# extra config
|
||||||
|
__network_interface eth0 \
|
||||||
|
--method dhcp \
|
||||||
|
--extra-config - << DONE
|
||||||
|
post-up ip route add 10.205.0.0/19 via 10.205.161.1
|
||||||
|
post-up ip route add 10.205.96.0/19 via 10.205.161.1
|
||||||
|
pre-down ip route del 10.205.0.0/19 via 10.205.161.1
|
||||||
|
pre-down ip route del 10.205.96.0/19 via 10.205.161.1
|
||||||
|
DONE
|
||||||
|
|
||||||
|
|
||||||
|
SEE ALSO
|
||||||
|
--------
|
||||||
|
Redhat bonding documentation:
|
||||||
|
|
||||||
|
* https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/sec-Using_Channel_Bonding.html
|
||||||
|
* https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Networking_Guide/sec-Using_Channel_Bonding.html
|
||||||
|
* https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/s2-networkscripts-interfaces-chan.html
|
||||||
|
|
||||||
|
Debian bonding documentation
|
||||||
|
|
||||||
|
* /usr/share/doc/ifenslave-2.6/README.Debian.gz
|
||||||
|
|
||||||
|
Symmetric routing
|
||||||
|
|
||||||
|
* http://www.microhowto.info/howto/ensure_symmetric_routing_on_a_server_with_multiple_default_gateways.html
|
||||||
|
|
||||||
|
|
||||||
|
AUTHORS
|
||||||
|
-------
|
||||||
|
Steven Armstrong <steven-cdist--@--armstrong.cc>
|
||||||
|
|
||||||
|
COPYING
|
||||||
|
-------
|
||||||
|
Copyright \(C) 2012-2016 Steven Armstrong. You can redistribute it
|
||||||
|
and/or modify it under the terms of the GNU General Public License as
|
||||||
|
published by the Free Software Foundation, either version 3 of the
|
||||||
|
License, or (at your option) any later version.
|
||||||
|
|
@ -1,167 +0,0 @@
|
||||||
cdist-type__network_interface(7)
|
|
||||||
================================
|
|
||||||
Steven Armstrong <steven-cdist--@--armstrong.cc>
|
|
||||||
|
|
||||||
|
|
||||||
NAME
|
|
||||||
----
|
|
||||||
cdist-type__network_interface - configure network interfaces
|
|
||||||
|
|
||||||
|
|
||||||
DESCRIPTION
|
|
||||||
-----------
|
|
||||||
Configures network interfaces on debian an redhat based systems.
|
|
||||||
Interface names containing a dot are assumed to be vlan tagged sub interfaces.
|
|
||||||
e.g. eth0.10 is vlan 10 on physical device eth0
|
|
||||||
|
|
||||||
|
|
||||||
REQUIRED PARAMETERS
|
|
||||||
-------------------
|
|
||||||
|
|
||||||
|
|
||||||
OPTIONAL PARAMETERS
|
|
||||||
-------------------
|
|
||||||
name::
|
|
||||||
The name of the physical or logical network device.
|
|
||||||
Defaults to __object_id.
|
|
||||||
method::
|
|
||||||
The method for determining an IP address for the interface.
|
|
||||||
'dhcp', 'static' or 'manual'.
|
|
||||||
Defaults to 'dhcp'.
|
|
||||||
address::
|
|
||||||
The IP address of the network interface.
|
|
||||||
Only used if --method is not 'dhcp'
|
|
||||||
broadcast::
|
|
||||||
Only used if --method is not 'dhcp'
|
|
||||||
comment::
|
|
||||||
extra-config::
|
|
||||||
additional config that is added to the generated interfaces file verbatim
|
|
||||||
gateway::
|
|
||||||
Default gateway (dotted quad)
|
|
||||||
Only used if --method is not 'dhcp'
|
|
||||||
netmask::
|
|
||||||
The subnet mask to apply to the interface
|
|
||||||
Only used if --method is not 'dhcp'
|
|
||||||
metric::
|
|
||||||
Routing metric for the default gateway
|
|
||||||
mtu::
|
|
||||||
The Maximum Transmission Unit size to use for the interface
|
|
||||||
state::
|
|
||||||
'present' or 'absent', defaults to 'present'
|
|
||||||
bond-arp-interval::
|
|
||||||
Specifies (in milliseconds) how often ARP monitoring occurs.
|
|
||||||
bond-arp-ip-target::
|
|
||||||
Specifies the target IP address of ARP requests when the arp_interval parameter is enabled.
|
|
||||||
Can be specified up to 16 times.
|
|
||||||
bond-master::
|
|
||||||
The name of the master (bonding) interface to which this slave should be enslaved.
|
|
||||||
bond-miimon::
|
|
||||||
Specifies (in milliseconds) how often MII link monitoring occurs.
|
|
||||||
bond-mode::
|
|
||||||
Allows you to specify the bonding policy. The value can be one of:
|
|
||||||
balance-rr (0)
|
|
||||||
active-backup (1)
|
|
||||||
balance-xor (2)
|
|
||||||
broadcast (3)
|
|
||||||
802.3ad (4)
|
|
||||||
balance-tlb (5)
|
|
||||||
balance-alb (6)
|
|
||||||
bond-primary::
|
|
||||||
Specifies the interface name, such as eth0, of the primary device.
|
|
||||||
bond-slaves::
|
|
||||||
The slave interfaces that form this bonding.
|
|
||||||
linkdelay::
|
|
||||||
Only useable on Redhat based systems.
|
|
||||||
Time in seconds that the system should pause after the specific interface
|
|
||||||
is enabled. This may be useful if one interface is connected to a
|
|
||||||
switch which has spanning tree enabled and must wait for STP to
|
|
||||||
converge before the interface should be considered usable.
|
|
||||||
|
|
||||||
|
|
||||||
BOOLEAN PARAMETERS
|
|
||||||
------------------
|
|
||||||
onboot:
|
|
||||||
Whether to bring the interface up on boot
|
|
||||||
hotplug::
|
|
||||||
Allow/disallow hotplug support for this interface
|
|
||||||
nodns::
|
|
||||||
Do not configure nameservers in /etc/resolv.conf.
|
|
||||||
noroute::
|
|
||||||
Do not set default route.
|
|
||||||
no-network-wait-online::
|
|
||||||
Do not consider this network interface in the network-wait-online.service unit.
|
|
||||||
symmetric-routing::
|
|
||||||
Manage routing tables and rules to ensure symmetric routing.
|
|
||||||
|
|
||||||
|
|
||||||
EXAMPLES
|
|
||||||
--------
|
|
||||||
|
|
||||||
--------------------------------------------------------------------------------
|
|
||||||
__network_interface eth0 --onboot
|
|
||||||
# Same thing, but explicitly define method
|
|
||||||
__network_interface eth0 --method dhcp --onboot
|
|
||||||
|
|
||||||
__network_interface eth1 \
|
|
||||||
--method static \
|
|
||||||
--address 192.168.42.23 \
|
|
||||||
--netmask 255.255.255.0 \
|
|
||||||
--gateway 192.168.42.1 \
|
|
||||||
--onboot
|
|
||||||
|
|
||||||
__network_interface eth3 --method dhcp --hotplug
|
|
||||||
|
|
||||||
|
|
||||||
# Don't wait for Infiniband interface to be up before reaching systemd network-online.target
|
|
||||||
__network_interface ib0 --method dhcp --no-network-wait-online
|
|
||||||
|
|
||||||
# active-backup bonding with 2 slaves
|
|
||||||
__network_interface bond0 \
|
|
||||||
--onboot \
|
|
||||||
--method static \
|
|
||||||
--bond-mode active-backup \
|
|
||||||
--bond-miimon 500 \
|
|
||||||
--bond-primary eth5 \
|
|
||||||
--address 10.205.9.65 \
|
|
||||||
--netmask 255.255.224.0
|
|
||||||
|
|
||||||
__network_interface eth5 \
|
|
||||||
--onboot \
|
|
||||||
--method manual \
|
|
||||||
--bond-master bond0
|
|
||||||
|
|
||||||
__network_interface eth6 \
|
|
||||||
--onboot \
|
|
||||||
--method manual \
|
|
||||||
--bond-master bond0
|
|
||||||
|
|
||||||
|
|
||||||
# extra config
|
|
||||||
__network_interface eth0 \
|
|
||||||
--method dhcp \
|
|
||||||
--extra-config - << DONE
|
|
||||||
post-up ip route add 10.205.0.0/19 via 10.205.161.1
|
|
||||||
post-up ip route add 10.205.96.0/19 via 10.205.161.1
|
|
||||||
pre-down ip route del 10.205.0.0/19 via 10.205.161.1
|
|
||||||
pre-down ip route del 10.205.96.0/19 via 10.205.161.1
|
|
||||||
DONE
|
|
||||||
--------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
|
|
||||||
SEE ALSO
|
|
||||||
--------
|
|
||||||
- cdist-type(7)
|
|
||||||
- Redhat bonding documentation
|
|
||||||
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/sec-Using_Channel_Bonding.html
|
|
||||||
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Networking_Guide/sec-Using_Channel_Bonding.html
|
|
||||||
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/s2-networkscripts-interfaces-chan.html
|
|
||||||
- Debian bonding documentation
|
|
||||||
/usr/share/doc/ifenslave-2.6/README.Debian.gz
|
|
||||||
- Symmetric routing
|
|
||||||
http://www.microhowto.info/howto/ensure_symmetric_routing_on_a_server_with_multiple_default_gateways.html
|
|
||||||
|
|
||||||
|
|
||||||
COPYING
|
|
||||||
-------
|
|
||||||
Copyright \(C) 2012-2016 Steven Armstrong. Free use of this software is
|
|
||||||
granted under the terms of the GNU General Public License version 3 (GPLv3).
|
|
||||||
Loading…
Reference in a new issue