qethconf - Configure qeth devices

Use the qethconf command to configure IP address takeover, virtual IP address (VIPA), and proxy ARP for layer3 qeth devices.

You cannot use this command with the layer2 option.

From the arguments that are specified, qethconf assembles the function command and redirects it to the corresponding sysfs attributes. You can also use qethconf to list the already defined entries.

qethconf syntax


1  qethconf
2.1   ipa
2.2.1 
2.2.2.1 
2.2.2.2.1  add
2.2.2.2.1  del
2.2.2.1  <ip_addr>/<mask_bits>
2.2.2.1 
2.2.2.2.1  inv4
2.2.2.2.1  inv6
2.2.1  <interface>
2.2.1  list
2.1 
2.2.1  vipa
2.2.1  parp
2.2.1 
2.2.2.1  add
2.2.2.1  del
2.2.1  <ip_addr>
2.2.1  <interface>
2.2.1   list
2.1  list_all
2.1  list_msg
The qethconf command has these function keywords:
ipa
configures qeth for IP address takeover (IPA).
vipa
configures qeth for virtual IP address (VIPA).
parp or rxip
configures qeth for proxy ARP.
The qethconf command has these action keywords:
add
adds an IP address or address range.
del
deletes an IP address or address range.
inv4
inverts the selection of address ranges for IPv4 address takeover. This inversion makes the list of IP addresses that was specified with qethconf add and qethconf del an exclusion list.
inv6
inverts the selection of address ranges for IPv6 address takeover. This inversion makes the list of IP addresses that was specified with qethconf add and qethconf del an exclusion list.
list
lists existing definitions for specified qeth function.
list_all
lists existing definitions for IPA, VIPA, and proxy ARP.
<ip_addr>
IP address. Can be specified in one of these formats:
  • IP version 4 format, for example, 192.168.10.38
  • IP version 6 format, for example, FE80::1:800:23e7:f5db
  • 8- or 32-character hexadecimals prefixed with -x, for example, -xc0a80a26
<mask_bits>
specifies the number of bits that are set in the network mask. Enables you to specify an address range.
Example: A <mask_bits> of 24 corresponds to a network mask of 255.255.255.0.
<interface>
specifies the name of the interface that is associated with the specified address or address range.
list_msg
lists qethconf messages and explanations.
-v or --version
displays version information.
-h or --help
displays a short help text, then exits. To view the man page, enter man qethconf.

Examples

  • List existing proxy ARP definitions: 
    # qethconf parp list
parp add 1.2.3.4 eth0
  • Assume responsibility for packages that are destined for 1.2.3.5: 
    # qethconf parp add 1.2.3.5 eth0
qethconf: Added 1.2.3.5 to /sys/class/net/eth0/device/rxip/add4.
qethconf: Use "qethconf parp list" to check for the result
    Confirm the new proxy ARP definitions: 
    # qethconf parp list
parp add 1.2.3.4 eth0
parp add 1.2.3.5 eth0
  • Configure eth0 for IP address takeover for all addresses that start with 192.168.10: 
    # qethconf ipa add 192.168.10.0/24 eth0
qethconf: Added 192.168.10.0/24 to /sys/class/net/eth0/device/ipa_takeover/add4.
qethconf: Use "qethconf ipa list" to check for the result
    Display the new IP address takeover definitions: 
    # qethconf ipa list
ipa add 192.168.10.0/24 eth0
  • Configure VIPA for eth1: 
    # qethconf vipa add 10.99.3.3 eth1
qethconf: Added 10.99.3.3 to /sys/class/net/eth1/device/vipa/add4.
qethconf: Use "qethconf vipa list" to check for the result
    Display the new VIPA definitions: 
    # qethconf vipa list
vipa add 10.99.3.3 eth1
  • List all existing IPA, VIPA, and proxy ARP definitions. 
    # qethconf list_all
parp add 1.2.3.4 eth0
parp add 1.2.3.5 eth0
ipa add 192.168.10.0/24 eth0
vipa add 10.99.3.3 eth1