forked from pool/s390-tools
37e471ec3d
* s390-tools: Define Rust MSRV as 1.75.0
* Add new tools / libraries:
- cpacfinfo: Tool to provide CPACF information
- opticsmon: Tools to monitor optical modules for directly attached PCI based NICs
- pvimg: Rust rewrite of genprotimg
* Changes of existing tools:
- chpstat: Add data bandwidth utilization column
- chpstat: Add support for full CMCB
- chpstat: Add support for new CMG types
- dbginfo.sh: add overview commands and crypto update
- hyptop: Support for structured output (json, json-seq, csv)
- lszfcp: Add missing fallback marker for non-good fc_host port_state
- lszfcp: Improve speed with many SCSI devices
- pvattest: Add attestation policy check command
- zipl: Add support of partitions of mirror md-devices
* Bug Fixes:
- lszcrypt: Fix wrong state showing up for removed AP queue within SE guest
- lszfcp: Show device names line for zfcp_units without SCSI device
- Revendored vendor.tar.gz
OBS-URL: https://build.opensuse.org/package/show/Base:System/s390-tools?expand=0&rev=232
67 lines
2.3 KiB
Groff
67 lines
2.3 KiB
Groff
.TH qeth_configure "8" "July 2013" "s390-tools"
|
|
.SH NAME
|
|
qeth_configure \- Configures or deconfigures a HiperSocket adapter or an IBM Open Systems Adapter (OSA) in QDIO mode
|
|
.SH SYNOPSIS
|
|
.B qeth_configure [options] read_channel write_channel data_channel online
|
|
.SH DESCRIPTION
|
|
.B qeth_configure
|
|
is intended to make it easy to persistently add and remove HiperSocket Adapters and Open System Adapters (OSAs) that are in QDIO mode. In addition to bringing the adapter online or offline, it will also create or delete the necessary udev rules for the adapter.
|
|
.SH PARAMETERS
|
|
.IP read_channel
|
|
The device number of the read channel of the adapter. Takes the form x.y.ssss.
|
|
.IP write_channel
|
|
The device number of the write channel of the adapter.Takes the form x.y.ssss.
|
|
.IP data_channel
|
|
The device number of the data channel of the adapter.Takes the form x.y.ssss.
|
|
.RS
|
|
|
|
where
|
|
.RS
|
|
.B x
|
|
is always 0 until IBM creates something that uses that number.
|
|
.RE
|
|
.RS
|
|
.B y
|
|
is the logical channel subsystem (lcss) number. Most often this is 0, but it could be non-zero.
|
|
.RE
|
|
.RS
|
|
.B ssss
|
|
is the four digit subchannel address of the device, in hexidecimal, with leading zeros. If entered in upper/mixed case, this is automatically converted to lower case.
|
|
.RE
|
|
.RE
|
|
.RS
|
|
.RE
|
|
.RE
|
|
.IP online
|
|
Either a literal 1 to bring the adapter online or a literal 0 to take it offline
|
|
.SH OPTIONAL PARAMETERS
|
|
.IP -i
|
|
Configure IP takeover
|
|
.IP -l
|
|
Configure Layer 2 support
|
|
.IP -f
|
|
Force creation of udev rules, do not check values in /sys. Requires -t to be specfied.
|
|
.IP "-t CARDTYPE"
|
|
The type of card being configured. Valid values are: qeth, hsi, or osn.
|
|
.IP "-o ""Values"""
|
|
General/arbitrary QETH options, separated by spaces
|
|
.IP "-n portnumber"
|
|
QETH port number to use, 0 or 1. Only needed for real, not virtual devices.
|
|
.IP "-p portname"
|
|
QETH Portname to use. Only needed if sharing a real OSA with z/OS.
|
|
.SH FILES
|
|
Please see the documentation of
|
|
.B chzdev.
|
|
.SH ENVIRONMENT
|
|
.IP DEBUG
|
|
If set to "yes" some minimal debugging information is output during execution.
|
|
.SH DIAGNOSTICS
|
|
Messages and return codes are determined by the
|
|
.B chzdev
|
|
command.
|
|
If environment variable DEBUG is set to "yes," it shows the command line of the invoked
|
|
.B chzdev,
|
|
and a message for each command line option is issued on stdout.
|
|
.SH BUGS
|
|
Gotta be some, I'm sure. If you find one, please open a bug report.
|