d7162287c1
* Changes of existing tools:
dbginfo.sh: Add details on CPU-measurement
dbginfo.sh: Add new crypto command
dbginfo.sh: Add overview commands and crypto update
dbginfo.sh: Adding kdump info
dbginfo.sh: Removing outdated email references
dbginfo.sh: Rework network section
dbginfo.sh: Update copyright 2nd year
pvimg: Add '--(enable|disable)-image-encryption' flags to 'pvimg create'
pvimg: Add '--cck ' command line option and make '--comm-key' an alias
pvimg: Add '--hdr-key' command line option to 'pvimg create'
pvimg: Rename '--key' into '--hdr-key' and use '--key' as an alias (for 'pvimg info')
pvsecret: Add support for retrievable secrets
ziorep_config: Add PCHID field to adapter report
ziorep_traffic: Add DEVBUSID column to traffic report
ziorep_utilization: Add --fcp-device parameter to print virtual adapter report
ziorep_utilization: Add PCHID column to physical adapter report
ziorep_utilization: Now prints only physical adapter report by default
ziorep_utilization: Swap Bus-ID and CHPID columns in virtual adapter report
zipl/boot: Increase section size for eckd_mv dumper
zkey: Add support for listing and importing protected virtualization secrets
* Bug Fixes:
chpstat: Fix invalid utilization data on older kernels
opticsmon: Fix runaway loop in on_link_change()
zipl: Update inline assembly for GCC 15
zipl_helper.device-mapper: Add missed step in logical device resolution
- Revendored vendor.tar.gz
- Removed obsolete patches:
* s390-tools-01-zipl_helper.device-mapper-add-missed-step-in-logical.patch
* s390-tools-02-zipl-src-fix-imprecise-check-that-file-is-on-specifi.patch
* s390-tools-General-update-01.patch
* s390-tools-General-update-02.patch
* s390-tools-General-update-03.patch
* s390-tools-General-update-04.patch
* s390-tools-General-update-05.patch
* s390-tools-General-update-06.patch
* s390-tools-General-update-07.patch
* s390-tools-General-update-08.patch
* s390-tools-General-update-09.patch
* s390-tools-General-update-10.patch
* s390-tools-General-update-11.patch
* s390-tools-General-update-12.patch
* s390-tools-Additional-update-01.patch
* s390-tools-Additional-update-02.patch
* s390-tools-pvimg-info-command-01.patch
* s390-tools-pvimg-info-command-02.patch
* s390-tools-pvimg-info-command-03.patch
* s390-tools-Support-unencrypted-SE-images-01.patch
* s390-tools-pvimg-info-command-04.patch
* s390-tools-pvimg-additional-01.patch
* s390-tools-01-zkey-Add-support-for-retrieving-a-list-of-ultravisor-secrets.patch
* s390-tools-02-zkey-Add-the--pvsecrets-list-command.patch
* s390-tools-03-zkey-Add-PVSECRETS-AES-key-type.patch
* s390-tools-04-zkey-Add-the-pvsecrets-import-command.patch
* s390-tools-05-zkey-Reject-key-generation-and-APQN-association-for-PVSECRET-AES-keys.patch
* s390-tools-06-zkey-Reject-re-enciphering-of-PVSECRET-AES-keys.patch
* s390-tools-07-zkey-Support-validation-of-key-of-type-PVSECRET-AES.patch
* s390-tools-08-rust-pvimg-Fix-flag-parsing-for-allowing-dump.patch
* s390-tools-09-rust-pvimg-Document-the-change-from--comm-key-to--cck.patch
OBS-URL: https://build.opensuse.org/package/show/Base:System/s390-tools?expand=0&rev=249
156 lines
4.9 KiB
Groff
156 lines
4.9 KiB
Groff
.TH ctc_configure "8" "July 2013" "s390-tools"
|
|
.SH NAME
|
|
ctc_configure \- Configures or deconfigures a Channel-to-Channel adapter (CTC) or LAN Channel Station adapter (LCS)
|
|
.SH SYNOPSIS
|
|
.B ctc_configure read_channel write_channel online [protocol]
|
|
.SH DESCRIPTION
|
|
.B ctc_configure
|
|
is intended to make it easy to persistently add and remove IBM CTC and LCS adapters. 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.
|
|
.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
|
|
|
|
Keep in mind that for a CTC, the read channel needs to be coupled to the write channel of the peer, and vice versa. This does not apply to LCS adapters.
|
|
.RE
|
|
.RE
|
|
.IP online
|
|
Either a literal 1 to bring the adapter online or a literal 0 to take it offline
|
|
.IP protocol
|
|
.RS
|
|
0 Compatibility with peers other than OS/390®, or z/OS, for example, a z/VM TCP service machine. This is the default.
|
|
.RE
|
|
.RS
|
|
1 Enhanced package checking for Linux peers.
|
|
.RE
|
|
.RS
|
|
3 For compatibility with OS/390 or z/OS peers.
|
|
.RE
|
|
.RS
|
|
4 For MPC connections to VTAM on traditional mainframe operating systems.
|
|
.RE
|
|
.RS
|
|
|
|
Not needed for LCS adapters.
|
|
.SH FILES
|
|
.I /etc/udev/rules.d/51-ctcm-<ccwid>.rules
|
|
.RE
|
|
.I /etc/udev/rules.d/51-lcs-<ccwid>.rules
|
|
.RS
|
|
These files provide the udev rules necessary to activate a specific CTC or LCS.
|
|
.RE
|
|
.SH ENVIRONMENT
|
|
.IP DEBUG
|
|
If set to "yes" some minimal debugging information is output during execution.
|
|
.SH DIAGNOSTICS
|
|
The following messages may be issued on stdout:
|
|
.IP
|
|
.B /sysfs not present
|
|
.RS
|
|
The sysfs file system could not be found in /proc/mounts, so there's nothing the script can
|
|
do. Return code 1 is set.
|
|
.RE
|
|
.IP
|
|
.B Invalid device status ${ONLINE}
|
|
.RS
|
|
A value other than 0 or 1 was specified for the third parameter, online. Return code 2 is set.
|
|
.RE
|
|
.IP
|
|
.B Device ${CTC_READ_CHAN} does not exist
|
|
.RS
|
|
A non-existent <ccwid> was specified for the first parameter. Remember the x.y.ssss format is necessary. Return code 3 is set.
|
|
.RE
|
|
.IP
|
|
.B Device ${CTC_READ_CHAN} does not exist
|
|
.RS
|
|
A non-existent <ccwid> was specified for the second parameter. Remember the x.y.ssss format is necessary. Return code 4 is set.
|
|
.RE
|
|
.IP
|
|
.B Not a valid CTC device (cu ${_cutype}, dev ${_devtype})
|
|
.RS
|
|
The device number specified does not correspond to a valid CTC or LCS device type. Return code 5 is st.
|
|
.RE
|
|
.IP
|
|
.B CTC type mismatch (read: ${tmp_chan}, write: ${CCW_CHAN_GROUP})
|
|
.RS
|
|
The device number specified for the read channel has a different device type than the device number specified for the write channel. Return code 6 is set.
|
|
.RE
|
|
.IP
|
|
.B Could not load module ${CCW_CHAN_GROUP}
|
|
.RS
|
|
The kernel module for the device type failed to load. Try "dmesg" to see if there is any indication why. Return code 7 is set.
|
|
.RE
|
|
.IP
|
|
.B CCW devices grouped to different devices
|
|
.RS
|
|
The read and write channels are already grouped, but not within the same interface. Try again with different devices. Return code 8 is set.
|
|
.RE
|
|
.IP
|
|
.B Could not group ${CCW_CHAN_GROUP} devices ${CTC_READ_CHAN}/${CTC_WRITE_CHAN}
|
|
.RS
|
|
The attempt to group the read and write channels into an interface failed. Try "dmesg" to see if there is any indication why. Return code 9 is set.
|
|
.RE
|
|
.IP
|
|
.B Could not set device ${CCW_CHAN_ID} online
|
|
.RS
|
|
The attempt to bring the grouped devices online failed. Try "dmesg" to see if there is any indication why. Return code 10 is set.
|
|
.RE
|
|
.IP
|
|
.B Could not set device ${CCW_CHAN_ID} offline
|
|
.RS
|
|
The attempt to take the grouped devices offline failed. Try "dmesg" to see if there is any indication why. Return code 11 is set.
|
|
.RE
|
|
|
|
If environment variable DEBUG is set to "yes," the following messages may be issued on stdout:
|
|
.IP
|
|
.B
|
|
Configuring CTC/LCS device ${CTC_READ_CHAN}/${CTC_WRITE_CHAN}
|
|
.RS
|
|
Just a little bit of verbosity, since it just indicates that we got past certain error checks and will now try to do something useful.
|
|
.RE
|
|
.IP
|
|
.B Group is ${_ccw_groupdir}/drivers/${CCW_CHAN_GROUP}/group
|
|
.RS
|
|
Just a little bit of verbosity.
|
|
.RE
|
|
.IP
|
|
.B Setting device online
|
|
.RS
|
|
Just a little bit of verbosity.
|
|
.RE
|
|
.IP
|
|
.B Device ${CCW_CHAN_ID} is already online
|
|
.RS
|
|
An attempt was made to bring the adapter online when it was already online.
|
|
.RE
|
|
.IP
|
|
.B Setting device offline
|
|
.RS
|
|
Just a little bit of verbosity.
|
|
.RE
|
|
.IP
|
|
.B Device ${CCW_CHAN_ID} is already offline
|
|
.RS
|
|
An attempt was made to take the adapter offline when it was already offline.
|
|
.RE
|
|
.SH BUGS
|
|
Gotta be some, I'm sure. If you find one, please open a bug report.
|