forked from pool/s390-tools
6a6c0cb679
*** v2.34.0
* Changes of existing tools:
- ap_tools/ap-check: Add support for vfio-ap dynamic configuration
- dbginfo.sh: Update/Add additional DASD data collection
- dumpconf: Add new parameter 'SCP_DATA' for SCSI/NVMe/ECKD dump devices
- libutil: Make formatted meta-data configurable
- s390-tools: Replace 'which' with built-in 'command -v'
- zdump/dfi_elf: Support core dumps of vr-kernels
* Bug Fixes:
- chzdev: Fix warning about failed ATTR writes by udev
- rust/pv: Try again if first CRL-URI is invalid
- rust/pvattest: Add short option for --arpk
- zdump: Fix 'zgetdump -i' ioctl error on s390 formatted dump file
*** v2.33.1
* Bug Fixes:
- s390-tools: Fix formatting and typos in README.md
- s390-tools: Fix release string
*** v2.33.0
* Add new tools / libraries:
- chpstat: New tool for displaying channel path statistics
- libutil: Add output format helpers(util_fmt: JSON, JSON-SEQ, CSV, text pairs)
* Changes of existing tools / libraries:
- chzdev: Add --is-owner to identify files created by zdev
- dasdfmt: Change default mode to always use full-format (Note: affects ESE DASD)
- libap: Significantly reduce delay time between file lock retries
- pvattest: Rewrite from C to Rust
- pvattest: Support additional data & user-data
- rust/pv: Support for Attestation
* Bug Fixes:
- chreipl: Improve disk type detection when running under QEMU
- dbginfo.sh: Use POSIX option with uname
- s390-tools: Fix missing hyphen escapes in the man page for many tools
- zipl/src: Fix bugs in disk_get_info() reproducible in corner cases
*** v2.32.0
* Changes of existing tools:
- cpumf/lscpumf: add support for machine type 3932
- genprotimg, pvattest, and pvsecret accept IBM signing key with Armonk as
subject locality
- zdump/zipl: Support for List-Directed dump from ECKD DASD
- zkey: Detect FIPS mode and generate PBKDF for luksFormat according to it
* Bug Fixes:
- dbginfo.sh: dash compatible copy sequence
- rust/pv_core: Fix UvDeviceInfo::get() method
- zipl/src: Fix leak of files if run with a broken configuration
- zkey: Fix convert command to accept only keys of type CCA-AESDATA
* Revendored vendor.tar.gz
* Removed obsolete patches
- s390-tools-sles15sp5-01-rust-pv-support-Armonk-in-IBM-signing-key-subject.patch
- s390-tools-sles15sp6-02-genprotimg-support-Armonk-in-IBM-signing-key-subject.patch
- s390-tools-sles15sp6-03-libpv-support-Armonk-in-IBM-signing-key-subject.patch
- s390-tools-sles15sp6-04-pvattest-Fix-root-ca-parsing.patch
- s390-tools-sles15sp6-genprotimg-makefile.patch
OBS-URL: https://build.opensuse.org/package/show/Base:System/s390-tools?expand=0&rev=219
65 lines
2.1 KiB
Groff
65 lines
2.1 KiB
Groff
.TH iucv_configure "8" "July 2013" "s390-tools"
|
|
.SH NAME
|
|
iucv_configure \- Configures or deconfigures a z/VM Inter-User Communications Vehicle (IUCV) network adapter
|
|
.SH SYNOPSIS
|
|
.B iucv_configure peer_userid online
|
|
.SH DESCRIPTION
|
|
.B iucv_configure
|
|
is intended to make it easy to persistently add and remove z/VM point-to-point IUCV network 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 peer_userid
|
|
The z/VM userid of the virtual machine on the other end of the point-to-point connection.
|
|
.IP online
|
|
Either a literal 1 to bring the adapter online or a literal 0 to take it offline
|
|
.SH FILES
|
|
.I /etc/udev/rules.d/51-iucv-<peer_userid>.rules
|
|
.RS
|
|
This file provide the udev rules necessary to activate a specific IUCV adapter.
|
|
.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 No IUCV user name given
|
|
.RS
|
|
You didn't specify the z/VM userid of the virtual machine to which you want to connect. Return code 2 is set.
|
|
.RE
|
|
.IP
|
|
.B Unable to connect to $PEER_USERID
|
|
.RS
|
|
The attempt to connect to the IUCV peer failed. Try "dmesg" to see if there is any indication why. Return code 3 is set.
|
|
.RE
|
|
.IP
|
|
.B Unable to remove device $netdev
|
|
.RS
|
|
The attempt to remove the IUCV adapter failed. Try "dmesg" to see if there is any indication why. Return code 4 is set.
|
|
.RE
|
|
|
|
If environment variable DEBUG is set to "yes," the following messages may be issued on stdout:
|
|
.IP
|
|
.B
|
|
Configuring IUCV device ${PEER_USERID}
|
|
.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 Configured device $iucvdev
|
|
.RS
|
|
The attempt to create the IUCV adapter was successful.
|
|
.RE
|
|
.IP
|
|
.B Removed device $iucvdev
|
|
.RS
|
|
The attempt to remove the IUCV adapter was successful.
|
|
.RE
|
|
.SH BUGS
|
|
Gotta be some, I'm sure. If you find one, please open a bug report.
|