mirror of
https://github.com/ibm-s390-linux/s390-tools.git
synced 2026-08-05 02:14:52 +00:00
Steffen Maier
a20cabccc4
Show if command line option for more attribute details specified twice
and depending on existence in sysfs (i.e. not for non-disk such as tape).
Abbreviated examples:
$ lszfcp -DVeamm
/sys/devices/css0/0.0.0019/0.0.1880/0x50050763031bd327/0x4045400300000000
/sys/bus/ccw/drivers/zfcp/0.0.1880/host2/rport-2:0-0/target2:0:0/2:0:0:1073954885
/sys/block/sdd /sys/class/scsi_generic/sg3
Class = "zfcp_unit"
access_denied = "0"
access_readonly = "0"
access_shared = "0"
failed = "0"
in_recovery = "0"
status = "0x54000000"
Class = "scsi_device"
...
modalias = "scsi:t-0x00"
model = "2107900"
scsi_level = "6"
state = "running"
type = "0"
...
zfcp_access_denied = "0"
zfcp_failed = "0"
zfcp_in_recovery = "0"
zfcp_status = "0x54000000"
Class = "scsi_disk"
allow_restart = "0"
app_tag_own = "1"
cache_type = "write back"
FUA = "0"
manage_start_stop = "0"
max_medium_access_timeouts = "2"
max_write_same_blocks = "65535"
protection_mode = "dix1"
protection_type = "1"
provisioning_mode = "unmap"
thin_provisioning = "1"
zeroing_mode = "writesame"
Class = "block"
alignment_offset = "0"
capability = "50"
dev = "8:48"
discard_alignment = "0"
size = "2097152"
...
uevent = "MAJOR=8"
Class = "block_integrity"
device_is_integrity_capable = "1"
format = "T10-DIF-TYPE1-IP"
protection_interval_bytes = "512"
read_verify = "1"
tag_size = "2"
write_generate = "1"
Class = "block_queue"
add_random = "1"
chunk_sectors = "0"
dax = "0"
discard_granularity = "1073741824"
discard_max_bytes = "4294966784"
discard_max_hw_bytes = "4294966784"
discard_zeroes_data = "0"
hw_sector_size = "512"
io_poll = "0"
io_poll_delay = "0"
iostats = "1"
logical_block_size = "512"
max_discard_segments = "1"
max_hw_sectors_kb = "1076"
max_integrity_segments = "269"
max_sectors_kb = "1076"
max_segments = "269"
max_segment_size = "4096"
minimum_io_size = "512"
nomerges = "0"
nr_requests = "128"
optimal_io_size = "0"
physical_block_size = "512"
read_ahead_kb = "512"
rotational = "1"
rq_affinity = "1"
scheduler = "noop [deadline] cfq"
write_cache = "write back"
write_same_max_bytes = "33553920"
write_zeroes_max_bytes = "33553920"
zoned = "none"
Class = "block_queue_iosched"
fifo_batch = "16"
front_merges = "1"
read_expire = "500"
write_expire = "5000"
writes_starved = "2"
/sys/devices/css0/0.0.0222/0.0.3c80/0x2002000e1115c62f/0x0000000000000000
/sys/bus/ccw/drivers/zfcp/0.0.3c80/host4/rport-4:0-2/target4:0:2/4:0:2:0
Class = "zfcp_unit"
access_denied = "0"
access_readonly = "0"
access_shared = "0"
failed = "0"
in_recovery = "0"
status = "0x54000000"
Class = "scsi_device"
...
modalias = "scsi:t-0x01"
model = "ULT3580-TD6"
scsi_level = "7"
state = "running"
type = "1"
...
zfcp_access_denied = "0"
zfcp_failed = "0"
zfcp_in_recovery = "0"
zfcp_status = "0x54000000"
/sys/devices/css0/0.0.0222/0.0.3c80/0x2002000e1115c62f/0x0001000000000000
/sys/bus/ccw/drivers/zfcp/0.0.3c80/host4/rport-4:0-2/target4:0:2/4:0:2:1
Class = "zfcp_unit"
access_denied = "0"
access_readonly = "0"
access_shared = "0"
failed = "0"
in_recovery = "0"
status = "0x54000000"
Class = "scsi_device"
...
modalias = "scsi:t-0x08"
model = "3573-TL"
scsi_level = "6"
state = "running"
type = "8"
...
zfcp_access_denied = "0"
zfcp_failed = "0"
zfcp_in_recovery = "0"
zfcp_status = "0x54000000"
/sys/devices/css0/0.0.0222/0.0.3c80/0x500507630313d327/0xffffffffffffffff failed
-
Class = "zfcp_unit"
access_denied = "0"
access_readonly = "0"
access_shared = "0"
failed = "1"
in_recovery = "0"
status = "0x00000000"
Signed-off-by: Steffen Maier <maier@linux.ibm.com>
Reviewed-by: Jens Remus <jremus@linux.ibm.com>
Signed-off-by: Jan Höppner <hoeppner@linux.ibm.com>
148 lines
5.0 KiB
Plaintext
148 lines
5.0 KiB
Plaintext
.\" Copyright IBM Corp. 2006, 2019
|
|
.\" 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 LSZFCP 8 "Feb 2019" "s390-tools"
|
|
.SH NAME
|
|
lszfcp \- list information about zfcp adapters, ports, and units
|
|
|
|
.SH SYNOPSIS
|
|
.B lszfcp
|
|
.RB [ \-hvVaHDPem ]
|
|
.RB [ \-b
|
|
.IR busid ]
|
|
.RB [ \-l
|
|
.IR lun ]
|
|
.RB [ \-p
|
|
.IR wwpn ]
|
|
.RB [ \-s
|
|
.IR /path/to/sys ]
|
|
|
|
.SH DESCRIPTION
|
|
.PP
|
|
.B lszfcp
|
|
provides information contained in sysfs about zfcp adapters, ports and
|
|
units and its associated scsi_hosts, fc_hosts, fc_remote_ports and
|
|
scsi_devices.
|
|
|
|
The default is to list busids of all zfcp adapters and their corresponding
|
|
SCSI host names.
|
|
|
|
There are three output variants. Default (without options "-a" or
|
|
"-V") is one line for each object. For adapters the busid and their
|
|
corresponding SCSI host names are listed. For ports the pair
|
|
"busid"/"wwpn" and their corresponding FC-remote-port names are listed.
|
|
For units the triple "busid"/"wwpn"/"lun" and their corresponding SCSI
|
|
device names are listed.
|
|
|
|
Option "-V" additionally shows the sysfs paths of interest for the
|
|
listed object.
|
|
If a SCSI device has an associated block device (disk)
|
|
and SCSI generic (sg) device, show their sysfs paths in a 3rd line.
|
|
|
|
Option "-a" additionally shows attributes of interest found in
|
|
sysfs for the listed object.
|
|
|
|
Option "-m" together with option "-a" shows sysfs attributes if available for:
|
|
host: css (subchannel); port: zfcp_port; lun: zfcp_unit.
|
|
Specifying option "-m" twice together with option "-a"
|
|
additionally shows SCSI device sysfs attributes
|
|
if available for:
|
|
scsi_disk, block, block_integrity, block_queue, block_queue_iosched.
|
|
|
|
Option "-e" enables an extended output format.
|
|
It enumerates all hosts/ports/luns independent of their state.
|
|
It also produces some improved error messages.
|
|
The extended output format can help determining problems.
|
|
Since a long time, without option "-e", lszfcp has
|
|
.I
|
|
not
|
|
enumerated:
|
|
hosts that have never been online (since last bind to zfcp device driver),
|
|
hosts that are defunct (CHPID configured off, or z/VM detach),
|
|
ports with fc_rport port_state unequal to "Online" (such as fibres pulled),
|
|
zfcp units without associated SCSI device (unit_add of non-existent LUN).
|
|
|
|
.SH OPTIONS
|
|
.TP
|
|
.B -a, --attributes
|
|
Show the most interesting attributes of the specified objects.
|
|
.TP
|
|
.B -m, --moreattrs
|
|
Show more attributes of the specified objects.
|
|
Host: css (subchannel). Port: zfcp_port. Lun: zfcp_unit.
|
|
If specified twice,
|
|
show additional attributes of the specified SCSI device objects:
|
|
scsi_disk, block, block_integrity, block_queue, block_queue_iosched.
|
|
.TP
|
|
.B -D, --devices
|
|
List zfcp units and SCSI devices.
|
|
.TP
|
|
.B -H, --hosts
|
|
List zfcp adapters, fc-hosts, and scsi-hosts (default).
|
|
Without option "-e", information is given only
|
|
for adapters that are online (registered at the SCSI stack).
|
|
.TP
|
|
.B -P, --ports
|
|
List zfcp ports and FC remote ports.
|
|
.TP
|
|
.B -b busid, --busid busid
|
|
Show zfcp adapter, fc-host selected by busid.
|
|
.TP
|
|
.B -l lun, --lun lun
|
|
List zfcp unit(s) and SCSI device(s) selected by lun. (Information for
|
|
several units might be shown if devices with equivalent LUNs are
|
|
configured for different adapters or ports.)
|
|
.TP
|
|
.B -p wwpn, --wwpn wwpn
|
|
List zfcp port(s) and FC remote port(s) selected by wwpn. (Information
|
|
for several ports might be shown if a remote port is configured for
|
|
different adapters.)
|
|
.TP
|
|
.B -e, --extended
|
|
Generate extended output.
|
|
.TP
|
|
.B -V, --verbose
|
|
Generate verbose output. Display sysfs path names of class and bus
|
|
devices that are of interest for this object.
|
|
If a SCSI device has an associated block device (disk)
|
|
and SCSI generic (sg) device, show their sysfs paths in a 3rd line.
|
|
.TP
|
|
.B -s, --sysfs /path/to/sys
|
|
Use path as sysfs (for dbginfo archives).
|
|
.TP
|
|
.B -h, --help
|
|
Print help message and exit.
|
|
.TP
|
|
.B -v, --version
|
|
Display version info and exit.
|
|
|
|
.SH NOTE
|
|
.PP
|
|
Options "-b", "-p" or "-l" are of restricting nature. They limit the output
|
|
to those adapters, ports or units that match the specified busid, wwpn and lun.
|
|
If none of the options "-H", "-P" and "-D" are specified, "-b" implies "-H",
|
|
"-p" implies "-P" and "-l" implies "-D".
|
|
|
|
.SH EXAMPLES
|
|
.PP
|
|
.IP "lszfcp -P -H -D -V"
|
|
Show all device paths of all zfcp adapters, ports, units and its
|
|
associated SCSI devices, SCSI hosts, FC hosts and FC remote ports
|
|
.PP
|
|
.IP "lszfcp -b 0.0.0815 -a"
|
|
Show all attributes of ccw_device, scsi_host and fc_host which belong
|
|
to the adapter with busid "0.0.0815".
|
|
.IP "lszfcp -D -b 0.0.0815 -p 0x5005123456789000 -l 0x0000000000000000"
|
|
Show the device which matches the given busid, wwpn and lun.
|
|
.IP "lszfcp -b 0.0.0815 -p 0x5005123456789000 -l 0x0000000000000000"
|
|
Show all adapters that match the given busid, all ports that match the given
|
|
busid and wwpnn and show all units that match the given busid, wwpn and lun.
|
|
.IP "lszfcp -b 0.0.0815 -p 0x5005123456789000 -l 0x0000000000000000 -H -P -D"
|
|
Generates same output as previous example.
|
|
.IP "lszfcp -HPDVeamm"
|
|
Generates the fullest output in the extended format.
|
|
.SH "SEE ALSO"
|
|
.BR lscss (8)
|
|
|