QETHARP(8)

NAME
qetarp - querying and purging address data in the OSA and HiperSockets hardware.

SYNOPSIS

qetharp
    [-hv]
    [-[n]q interface |-p interface]

DESCRIPTION
qetharp is a tool to get information like MAC and IP Addresses from OSA and HiperSockets. It also allows to flush the ARP table of the mentioned Hardware.

OPTIONS

-q or --query interface
    shows the ARP information found in the ARP table of OSA or HiperSockets, which depends on interface. If it is an OSA device, it shows the ARP entries stored in OSA's ARP table, otherwise the ones from HiperSockets' ARP table. If the IP address is IPv4, qetharp tries to determine the symbolic host name, if it fails the IP address will be shown. In case of IPv6 there is no attempt for determination of host names,so the IP address will be shown directly.

-n or --numeric
    shows numerical addresses instead of trying to determine symbolic host names. This option can only be used in conjunction with -q option.

-c or --compact
    shows only numerical addresses without any other information like interface name. Also omits the header.

-p or --purge interface
    flushes the ARP table of OSA. This option does only work with OSA Devices. qetharp returns immediately.

-a or --add interface
    adds a static ARP entry to the OSA card. This command needs an IP address and a MAC address (-i and -m switches).

-d or --delete interface
    deletes a static ARP entry from the OSA card. This command needs an IP address (-i switch).

-i or --ip IP address
    specifies an IP address to be added to or removed from the OSA ARP cache.

-m or --mac MAC address
    specifies a MAC address to be added to the OSA ARP cache.

-v or --verbose
    shows version information.

-h or --help
    shows usage information for qetharp.

EXAMPLE

qetharp -q eth0
    shows all ARP entries of OSA.

qetharp -nq eth0
    shows all ARP entries of OSA without resolving host names.

qetharp -p eth0
    flushes OSA's ARP table.

qetharp -a eth0 -i 1.2.3.4 -m aa:bb:cc:dd:ee:ff
    adds a static ARP entry for the IP address 1.2.3.4 to OSA's ARP cache, using a MAC address of aa:bb:cc:dd:ee:ff

qetharp -d eth0 -i 1.2.3.4
    deletes the static ARP entry for the IP address 1.2.3.4 from OSA's ARP cache.

BUGS
None so far ;-)

AUTHOR
This man-page was written by Frank Pavlic <pavlic@de.ibm.com>