Files
s390-tools/qethconf/qethconf.8
Michael Holzheu b627b8d8e1 Initial s390-tools-2.0.0 import
This commit is based on the s390-tools-1.39.0 version.

Changes on top of s390-tools-1.39.0:

 - Add MIT license to all source files
 - Add LICENSE file
 - Transform REAMDE to README.md (markdown)
 - Add AUTHORS.md file
 - Add CONTRIBUTING.md file
 - Move changelog from README to CHANGELOG.md file

Reviewed-by: Stefan Haberland <sth@linux.vnet.ibm.com>
Signed-off-by: Michael Holzheu <holzheu@linux.vnet.ibm.com>
2017-08-21 10:55:40 +02:00

92 lines
2.4 KiB
Groff

.\" Copyright 2017 IBM Corp.
.\" s390-tools is free software; you can redistribute it and/or modify
.\" it under the terms of the MIT license. See LICENSE for details.
.\"
.TH QETHCONF 8 "Apr 2006" "s390-tools"
.SH "NAME"
qethconf \- Configure QETH functions IPA, VIPA and Proxy ARP.
.SH "SYNOPSIS"
\fBqethconf\fR \fITYPE\fR \fICMD\fR [[\-x]\fIIPADDR\fR[/\fIMASKBITS\fR]] [\fIINTERFACE\fR]
.SH "DESCRIPTION"
\fBqethconf\fR simplifies usage of QETH IPA, VIPA and Proxy ARP functions for
OSA-Express cards in layer 3 mode.
.TP
\fITYPE\fR
<ipa/vipa/parp|rxip/list_all/list_msg>
.br
Choose one of these keywords for function:
.br
ipa \- IP address takeover (IPA)
.br
vipa \- Virtual IP address (VIPA)
.br
parp|rxip \- Proxy ARP
.br
list_all \- List all available IPA, VIPA and Proxy ARP entries
from the sysfs
.br
list_msg \- List messages and explanation of errors during
command execution
.TP
\fICMD\fR
<add/del/inv4/inv6/list>
.br
where
.br
add \- Add an IP address or address range.
.br
del \- Delete an IP address or address range.
.br
inv4 \- Invert the selection of address ranges for IPv4 (only IPA).
.br
inv6 \- Invert the selection of address ranges for IPv6 (only IPA).
.br
list \- List TYPE specific entries from the sysfs
.TP
\fIIPADDR\fR
Required for commands add and del.
.br
IP address in IPv4 or IPv6 format,
.br
e.g. 192.168.10.38 or FE80::1:800:23e7:f5db
.br
Use preceding option \-x for hexadecimal input format,
e.g. \-xc0a80a26
.TP
\fIMASKBITS\fR
Number of bits set in the network mask.
This allows to specify an address range, e.g. 192.168.10.0/24.
This subparameter is only valid for function IPA.
.TP
\fIINTERFACE\fR
Interface name to which the address or address range is
bound, e.g. eth0. This parameter is required for add,
del and the inv4 and inv6 command.
.SH "RESTRICTIONS"
.nf
Needs at least bash version 2.0.
.SH "EXAMPLES"
.nf
qethconf ipa add 192.168.10.0/24 eth0
qethconf ipa add \-xc0a80a00/24 eth1
qethconf ipa inv4 eth0
qethconf parp add 10.0.0.2 eth0 (or qethconf rxip add 10.0.0.2 eth0)
qethconf vipa del 192.168.10.2 tr0
qethconf vipa add FE80::1:800:23e7:f5db eth1
qethconf list_all
.SH "AUTHOR"
.nf
This man\-page was written by Thomas Weber.
.SH "SEE ALSO"
.PP
See the appropriate chapters for QETH IPA, VIPA and Proxy ARP in the
"Device Drivers, Features, and Commands" manual for Linux on System z.