svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
fcinfo(8)
fcinfo(8) System Administration Commands fcinfo(8)
NAME
fcinfo, fcadm - Fibre Channel HBA Port Command Line Interface
SYNOPSIS
fcinfo hba-port [-Tvlite] [-o output_fields | -O output_fields] [HBA_port_WWN]...
fcadm hba-port [-Tvlite] [HBA_port_WWN]...
fcinfo remote-port [-ls] [-p HBA_port_WWN]
[Remote_port_WWN]...
fcadm remote-port [-ls] [-p HBA_port_WWN]
[Remote_port_WWN]...
fcinfo logical-unit | lu [-v] [-P Remote_port_WWN]
[-N Remote_node_WWN] [OS device_path]
fcadm logical-unit | lu [-v] [-P REMOTE_port_WWN]
[-N Remote_node_WWN] [OS device_path]
fcadm create-npiv-port -p Virtual_Port_WWN [-n Virtual_Node_WWN]
PhysicalPort_port_WWN
fcadm delete-npiv-port -p Virtual_Port_WWN [-n Virtual_Node_WWN]
PhysicalPort_port_WWN
fcadm create-fcoe-port [-tf] -p Port_WWN [-n Node_WWN]
MAC_Interface
fcadm delete-fcoe-port MAC_Interface
fcadm list-fcoe-ports [-itv][Link[,...]]
fcadm force-lip Port_WWN
fcinfo [-V]
fcadm [-V]
fcinfo [-?]
fcadm [-?]
DESCRIPTION
fcinfo and fcadm are command line interfaces that collect administra‐
tive information on Fibre Channel host bus adapter (HBA) ports on a
host. They also collect data on any Fibre Channel targets that might be
connected to those ports in a Storage Area Network (SAN).
A port can be either in initiator mode or target mode. The same FC at‐
tribute information and remote port information are applied to both the
initiator and the target modes port except that SCSI-related operations
described below do not apply for the target mode port.
SUBCOMMANDS
The following subcommands are supported by both fcinfo and fcadm:
hba-port Lists information for the HBA port referenced by
the specified HBA_port_WWN. If -i and -t options
are not specified, both initiator and target mode
Fibre Channel HBA ports on the host will be
listed.
If -T option is used then the most common fields
are displayed in a tabular format. User can over‐
ride the default fields with either -o option for
human readable output or with -O option for
parsable output.
remote-port Lists the remote-port information for those remote
ports that are specified. If no Remote_port_WWN
is specified, all remote ports that are visible
through HBA_port_WWN are listed. If -p option is
not specified, all remote ports of each initiator
port on the host will be listed.
logical-unit | lu Lists the logical unit referenced by the specified
device_path. If device_path is not specified, all
Fibre Channel logical units will be listed. This
subcommand applies only to the initiator mode.
The following subcommands, which administer N_Port ID Virtualization
(NPIV) HBA ports, are supported only by fcadm:
create-npiv-port
Create an NPIV virtual port on the specified adapter.
delete-npiv-port
Delete an NPIV virtual port. This deletes only ports created by
fcadm.
The following subcommands, which administer Fibre Channel over Ethernet
(FCoE) ports, are supported only by fcadm:
create-fcoe-port
Creates a FCoE port associated with the given MAC interface and the
given Port_WWN/Node_WWN. If -p or -n is not specified, the Port WWN
or Node WWN will be generated automatically. If the specified MAC
interface does not support multiple unicast address, no FCoE port
will be created and you receive a message indicating that you can
add an -f option to force enabling promiscuous mode on the speci‐
fied MAC interface to enable FCoE.
delete-fcoe-port
Deletes the FCoE port associated with the specified MAC interface.
list-fcoe-ports
List information of FCoE ports.
force-lip
Force the link to reinitialize. When issuing this subcommand on the
target port side, causes a reset of the target port. When issuing
it from the host port side, resets the host port. When an FC switch
is connected, other FC ports in the SAN will get a RSCN (Remote
State Change Notification). Furthermore, other initiators will al‐
ways rediscover the port after this, and the FC login session will
be established or reused. Also, I/Os will be continued. This com‐
mand is disruptive to I/Os, but it is not destructive, as it does
not cause any data loss.
OPTIONS
The following options are supported:
-e, --fcoe
Lists the information for all FCoE ports.
-f, --fcoe-promiscuous
Used with create-fcoe-port to create an FCoE port on a MAC inter‐
face associated with a NIC that does not support multiple unicast
address. Promiscuous mode will be enabled for the specified MAC in‐
terface.
-i, --initiator
Lists the information for initiator mode ports only.
-l, --linkstat
Lists the link error statistics information for the port referenced
by the specified HBA_port_WWN or Remote_port_WWN.
-N Remote_node_WWN, --remote-node Remote_node_WWN
Retrieves information of all logical units on the remote port spec‐
ified by Remote_node_WWN. This option applies only to the subcom‐
mand logical-unit | lu.
-n HBA_node_WWN, --node HBA_node_WWN
When used with NPIV options, specify a virtual node WWN. If used
with create-npiv-port, it can be omitted, and a random based WWN
will be used.
When used with create-fcoe-port subcommand, specify the node WWN
for the FCoE port. It can be omitted, in which case a WWN will be
generated based on the MAC address of the specified MAC interface.
-O output_fields, --parsable output_fields
Displays HBA Port information in parsable format. Columns are not
indented, instead values are separated by ':'
To find which NPIV ports correspond to a particular physical port,
user should use the contents of the field PARENT_WWN, which con‐
tains the port WWN of the parent physical port.
-o output_fields, --tabular output_fields
Enables the user to choose HBA Port output fields to be displayed
in a tabular format. Field names must be one of the fields listed
below:
o crc_count
o ctrl
o driver_name
o driver_version
o drv_inst
o fcode_bios_version
o firmware_version
o link_failure_count
o loss_signal_count
o loss_sync_count
o manufacturer
o mode
o model
o node_wwn
o parent_wwn
o protocol_error_count
o phys_path
o port_id
o port_type
o port_wwn
o serial_number
o slot
o speed
o state
o supported_speeds
o tx_word_count
-P Remote_port_WWN, --remote-port Remote_node_WWN
Retrieves information of all logical units on the remote port spec‐
ified by Remote_node_WWN. This option applies only to the subcom‐
mand logical-unit | lu.
-p HBA_port_WWN, --port HBA_port_WWN
Retrieve remote port information from the HBA_port_WWN of the local
HBA port on the host. When used with the remote-port subcommand,
the -p option is mandatory.
When used with NPIV options, specify a virtual port WWN. If used
with create-npiv-port, it can be omitted, and a random based WWN
will be used. It is mandatory for delete-npiv-port.
When used with create-fcoe-port subcommand, specify the port WWN
for the FCoE port. It can be omitted, in which case a WWN will be
generated based on the MAC address of the specified MAC interface.
-s, --scsi-target
Lists the SCSI target information for all remote ports the user has
asked for. The -p, --port option must always be specified and must
be a valid HBA port on the host. This HBA port will be used as the
initiator for which to retrieve the SCSI level target information.
Note that this will only function on remote port Fibre Channel
World-Wide Names that support an FC4 type of SCSI. This option ap‐
plies only to an initiator mode port.
-T, --tabular-default
Displays default HBA Port information in a tabular format. Default
output fields are PORT_WWN, PARENT_WWN, MODE, CTRL, STATE and SPEED
In tabular format, NPIV ports are listed alongside physical ports.
NPIV ports belonging to a physical port are listed just below it.
For an NPIV port, the field PARENT_WWN contains port WWN of the
corresponding physical port. For a physical port, the field PAR‐
ENT_WWN contains 'NA'
-t, --target
Lists the information for target mode ports only.
When used with create-fcoe-port, creates a FCoE target mode port.
-V, --version
Displays the version information.
-v, --verbose
When used with hba-port subcommand, -v will additionally display
driver instance and slot information. When combined with -T, it
will add node wwn, driver name, driver instance and slot informa‐
tion to the default tabular output. When used with the logical-unit
subcommand, the -v displays additional information for the logical
unit, including SCSI vendor and product information and device type
as well as the FC World-Wide names for the local and remote Fibre
Channel ports to which this device is attached.
-?, --help
Displays the usage information.
EXAMPLES
Example 1 Listing Initiator Mode HBA Ports
The following command lists all initiator mode Fibre Channel HBA ports
on the host:
# fcinfo hba-port -i
HBA Port WWN: 10000090fab9070e
Port Mode: Initiator
Port ID: 10701
OS Device Name: /dev/cfg/c18
Manufacturer: Emulex
Model: 7101684
Firmware Version: 7101684 1.1.43.8
FCode/BIOS Version: Boot:1.1.43.8 Fcode:4.03a1
Serial Number: 4925382+154400006N
Driver Name: emlxs
Driver Version: 3.3.2.3 (2021.04.27.12.00)
Type: N-port
State: online
Supported Speeds: 4Gb 8Gb 16Gb
Current Speed: 8Gb
Node WWN: 20000090fab9070e
Max NPIV Ports: 127
NPIV port list:
HBA Port WWN: 2100000e1ee564d1
Port Mode: Initiator
Port ID: 10800
OS Device Name: /dev/cfg/c14
Manufacturer: Marvell Technology, Inc
Model: 7023303
Firmware Version: 8.08.04
FCode/BIOS Version: BIOS: 3.40; fcode: 4.10; EFI: 6.19;
Serial Number: 463916R+1713328298
Driver Name: qlc
Driver Version: 220520-5.11
Type: N-port
State: online
Supported Speeds: 4Gb 8Gb 16Gb
Current Speed: 8Gb
Node WWN: 2000000e1ee564d1
Max NPIV Ports: 7
NPIV port list:
Example 2 Listing Target Mode HBA Ports
The following command lists all target mode Fibre Channel HBA ports on
the host:
# fcinfo hba-port -t
HBA Port WWN: 2100000e1e263e30
Port Mode: Target
Port ID: ef
OS Device Name: Not Applicable
Manufacturer: QLogic Corp.
Model: QLE8362
Firmware Version: 8.8.4
FCode/BIOS Version: BIOS: 3.19; FCode: 4.02; EFI: 5.36;
Serial Number: 463916T+1507232753
Driver Name: COMSTAR QLT
Driver Version: 20200211-3.03
Type: L-port
State: online
Supported Speeds: 4Gb 8Gb 16Gb
Current Speed: 8Gb
Node WWN: 2000000e1e263e30
HBA Port WWN: 2100000e1e263e31
Port Mode: Target
Port ID: ef
OS Device Name: Not Applicable
Manufacturer: QLogic Corp.
Model: QLE8362
Firmware Version: 8.8.4
FCode/BIOS Version: BIOS: 3.19; FCode: 4.02; EFI: 5.36;
Serial Number: 463916T+1507232753
Driver Name: COMSTAR QLT
Driver Version: 20200211-3.03
Type: L-port
State: online
Supported Speeds: 4Gb 8Gb 16Gb
Current Speed: 8Gb
Node WWN: 2000000e1e263e31
Example 3 Listing HBA Ports and Link Statistics
The following command lists information for the HBA ports and the link
statistics for those ports:
# fcinfo hba-port -l
HBA Port WWN: 10000090fab9070e
Port Mode: Initiator
Port ID: 10701
OS Device Name: /dev/cfg/c18
Manufacturer: Emulex
Model: 7101684
Firmware Version: 7101684 1.1.43.8
FCode/BIOS Version: Boot:1.1.43.8 Fcode:4.03a1
Serial Number: 4925382+154400006N
Driver Name: emlxs
Driver Version: 3.3.2.3 (2021.04.27.12.00)
Type: N-port
State: online
Supported Speeds: 4Gb 8Gb 16Gb
Current Speed: 8Gb
Node WWN: 20000090fab9070e
Link Error Statistics:
Link Failure Count: 3
Loss of Sync Count: 8
Loss of Signal Count: 1
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 514
Invalid CRC Count: 0
Max NPIV Ports: 127
NPIV port list:
HBA Port WWN: 10000090fab017e5
Port Mode: Initiator
Port ID: 0
OS Device Name: /dev/cfg/c11
Manufacturer: Emulex
Model: LPe12002-S
Firmware Version: LPe12002-S 2.01a12
FCode/BIOS Version: Boot:5.03a0
Serial Number: 4925384+152300015A
Driver Name: emlxs
Driver Version: 3.3.2.3 (2021.04.27.12.00)
Type: unknown
State: offline
Supported Speeds: 2Gb 4Gb 8Gb
Current Speed: not established
Node WWN: 20000090fab017e5
Link Error Statistics:
Link Failure Count: 1
Loss of Sync Count: 0
Loss of Signal Count: 2
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
Max NPIV Ports: 255
NPIV port list:
Example 4 Listing HBA Ports with verbose information
The following command lists information for the HBA ports along with
driver instance and slot details
# fcinfo hba-port -v
HBA Port WWN: 10000090fab9070e
Port Mode: Initiator
Port ID: 10701
OS Device Name: /dev/cfg/c18
Manufacturer: Emulex
Model: 7101684
Firmware Version: 7101684 1.1.43.8
FCode/BIOS Version: Boot:1.1.43.8 Fcode:4.03a1
Serial Number: 4925382+154400006N
Driver Name: emlxs
Driver Version: 3.3.2.3 (2021.04.27.12.00)
Type: N-port
State: online
Supported Speeds: 4Gb 8Gb 16Gb
Current Speed: 8Gb
Node WWN: 20000090fab9070e
Driver Instance: 7
Slot: /SYS/MB/PCIE3/hba1
Max NPIV Ports: 127
NPIV port list:
HBA Port WWN: 2100000e1ee564d1
Port Mode: Initiator
Port ID: 10800
OS Device Name: /dev/cfg/c14
Manufacturer: Marvell Technology, Inc
Model: 7023303
Firmware Version: 8.08.04
FCode/BIOS Version: BIOS: 3.40; fcode: 4.10; EFI: 6.19;
Serial Number: 463916R+1713328298
Driver Name: qlc
Driver Version: 220520-5.11
Type: N-port
State: online
Supported Speeds: 4Gb 8Gb 16Gb
Current Speed: 8Gb
Node WWN: 2000000e1ee564d1
Driver Instance: 1
Slot: /SYS/MB/PCIE4/hba1
Max NPIV Ports: 7
NPIV port list:
Example 5 Display HBA Port information in a tabular format
The following command will display HBA Port information in tabular for‐
mat
# fcinfo hba-port -T
PORT_WWN PARENT_WWN MODE CTRL STATE SPEED
10000090fab9070e NA Initiator c18 online 8Gb
10000090fab9070d NA Initiator c17 offline not established
2100000e1ee564d0 NA Initiator c13 online 16Gb
2100000e1ee564d1 NA Initiator c14 online 8Gb
2100000e1e263e30 NA Target unknown online 8Gb
2100000e1e263e31 NA Target unknown online 8Gb
Example 6 Display HBA Port information in a tabular format with verbose
details
The following command will display HBA Port information along with ver‐
bose in tabular format
# fcinfo hba-port -Tv
PORT_WWN PARENT_WWN MODE CTRL STATE SPEED NODE_WWN DRIVER_NAME DRV_INST SLOT
10000090fab9070e NA Initiator c18 online 8Gb 20000090fab9070e emlxs 7 /SYS/MB/PCIE3/hba1
10000090fab9070d NA Initiator c17 offline not established 20000090fab9070d emlxs 6 /SYS/MB/PCIE3/hba0
2100000e1ee564d0 NA Initiator c13 online 16Gb 2000000e1ee564d0 qlc 0 /SYS/MB/PCIE4/hba0
2100000e1ee564d1 NA Initiator c14 online 8Gb 2000000e1ee564d1 qlc 1 /SYS/MB/PCIE4/hba1
2100000e1e263e30 NA Target unknown online 8Gb 2000000e1e263e30 COMSTAR QLT unknown unknown
2100000e1e263e31 NA Target unknown online 8Gb 2000000e1e263e31 COMSTAR QLT unknown unknown
Example 7 Display only specific fields from HBA Port information
The following command will display HBA port information specific to
fields mentioned by the user in a Tabular format
# fcinfo hba-port -o "port_wwn,firmware_version,port_id,fcode_bios_version,model,phys_path"
PORT_WWN FIRMWARE_VERSION PORT_ID FCODE_BIOS_VERSION MODEL PHYS_PATH
10000090fab017e4 LPe12002-S 2.01a12 11000 Boot:5.03a0 LPe12002-S /pci@7a,0/pci8086,2f06@2,2/pci10df,fc42@0/fp@0,0:fc
10000090fab017e5 LPe12002-S 2.01a12 0 Boot:5.03a0 LPe12002-S /pci@7a,0/pci8086,2f06@2,2/pci10df,fc42@0,1/fp@0,0:fc
c0007ddf0cb5ff66 7101684 10.6.230.0 0 Boot:10.6.230.0 7101684 /pci@7a,0/pci8086,2f04@2/pci10df,e20e@0,1/fp@0,1:fc
c0007dc54976f22f 7101684 10.6.230.0 0 Boot:10.6.230.0 7101684 /pci@7a,0/pci8086,2f04@2/pci10df,e20e@0,1/fp@0,2:fc
2100000e1e263e30 8.8.4 ef BIOS: 3.19; FCode: 4.02; EFI: 5.36; QLE8362 unknown
2100000e1e263e31 8.8.4 ef BIOS: 3.19; FCode: 4.02; EFI: 5.36; QLE8362 unknown
Example 8 Display specific output fields of HBA Port information in
a parsable format
The following command will display only specific output fields of HBA
Port information in a parsable format
# fcinfo hba-port -O "port_wwn,firmware_version,port_id,fcode_bios_version,model,phys_path"
10000090fab017e4:LPe12002-S 2.01a12:11000:Boot5.03a0:LPe12002-S:/pci@7a,0/pci8086,2f06@2,2/pci10df,fc42@0/fp@0,0fc
c0007d48a022a000:LPe12002-S 2.01a12:11001:Boot5.03a0:LPe12002-S:/pci@7a,0/pci8086,2f06@2,2/pci10df,fc42@0/fp@0,1fc
10000090fab017e5:LPe12002-S 2.01a12:0:Boot5.03a0:LPe12002-S:/pci@7a,0/pci8086,2f06@2,2/pci10df,fc42@0,1/fp@0,0fc
10000090fad935c8:7101684 10.6.230.0:0:Boot10.6.230.0:7101684:/pci@7a,0/pci8086,2f04@2/pci10df,e20e@0/fp@0,0fc
c0007d9456deda2b:7101684 10.6.230.0:0:Boot10.6.230.0:7101684:/pci@7a,0/pci8086,2f04@2/pci10df,e20e@0/fp@0,2fc
2100000e1e263e30:8.8.4:ef: BIOS 3.19; FCode 4.02; EFI 5.36;:QLE8362 :unknown
2100000e1e263e31:8.8.4:ef: BIOS 3.19; FCode 4.02; EFI 5.36;:QLE8362 :unknown
Example 9 Display HBA Port information in a tabular format with Link
Error Statistics
The following command will display HBA Port information along with Link
Error Statistic in tabular format
# fcinfo hba-port -Tl
PORT_WWN PARENT_WWN MODE CTRL STATE SPEED LINK_FAILURE_COUNT LOSS_SYNC_COUNT LOSS_SIGNAL_COUNT PROTOCOL_ERROR_COUNT TX_WORD_COUNT CRC_COUNT
10000090fab9070e NA Initiator c18 online 8Gb 3 8 1 0 514 0
10000090fab9070d NA Initiator c17 offline not established 0 0 0 0 4 0
2100000e1ee564d0 NA Initiator c13 online 16Gb 0 0 0 0 0 0
2100000e1ee564d1 NA Initiator c14 online 8Gb 0 0 0 0 0 0
2100000e1e263e30 NA Target unknown online 8Gb 0 0 0 0 0 0
2100000e1e263e31 NA Target unknown online 8Gb 0 0 0 0 0
Example 10 Listing All Remote Ports
The following command lists all remote ports that are visible through
each HBA port on the host:
# fcinfo remote-port
HBA Port WWN: 10000000c957ebdc
Count of Remote Port(s): 3
Remote Port WWN: 10000000c983b45e
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 70800
Port Symbolic Name: Emulex PPN-10:00:00:00:c9:83:b4:5e
Node WWN: 20000000c983b45e
Remote Port WWN: 2100001b3286bc63
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 70a00
Port Symbolic Name: qlt0,0
Node WWN: 2000001b3286bc63
Remote Port WWN: 2101001b32a6bc63
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 70b00
Port Symbolic Name: qlt1,0
Node WWN: 2001001b32a6bc63
HBA Port WWN: 10000000c957ebdd
Count of Remote Port(s): 0
HBA Port WWN: 10000000c983b45e
Count of Remote Port(s): 4
Remote Port WWN: 2100001b3286bc63
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 70a00
Port Symbolic Name: qlt0,0
Node WWN: 2000001b3286bc63
Remote Port WWN: 2101001b32a6bc63
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 70b00
Port Symbolic Name: qlt1,0
Node WWN: 2001001b32a6bc63
Remote Port WWN: 201600a0b82a3846
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 70e00
Port Symbolic Name:
Node WWN: 200600a0b82a3846
Remote Port WWN: 10000000c957ebdc
Active FC4 Types:
SCSI Target: no
Port ID: 70900
Port Symbolic Name:
Node WWN: 20000000c957ebdc
HBA Port WWN: 10000000c983b45f
Count of Remote Port(s): 0
Example 11 Listing All Remote Ports of the Given HBA
The following command lists all remote ports that are visible through
the given HBA:
# fcinfo remote-port -p 10000000c957ebdc
HBA Port WWN: 10000000c957ebdc
Count of Remote Port(s): 3
Remote Port WWN: 10000000c983b45e
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 70800
Port Symbolic Name: Emulex PPN-10:00:00:00:c9:83:b4:5e
Node WWN: 20000000c983b45e
Remote Port WWN: 2100001b3286bc63
Port ID: 70a00
Port Symbolic Name: qlt0,0
Node WWN: 2000001b3286bc63
Remote Port WWN: 2101001b32a6bc63
Port ID: 70b00
Port Symbolic Name: qlt1,0
Node WWN: 2001001b32a6bc63
Example 12 Listing Remote Ports and Link Statistics of the Given HBA
The following command lists information for the remote ports and the
link statistics for those ports on the given HBA port:
# fcinfo remote-port -l -p 210100e08b272ab5
HBA Port WWN: 210100e08b272ab5
Count of Remote Port(s): 7
Remote Port WWN: 210100e08b296a60
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 10d00
Port Symbolic Name: unknown
Node WWN: 200100e08b296a60
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
Remote Port WWN: 20030003ba27d56d
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 10800
Port Symbolic Name: unknown
Node WWN: 10000003ba27d56d
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 4765165
Loss of Signal Count: 4765165
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
Remote Port WWN: 210100e08b27f7a6
Active FC4 Types: SCSI
SCSI Target: no
Port ID: 10e00
Port Symbolic Name: unknown
Node WWN: 200100e08b27f7a6
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
Remote Port WWN: 50020f230000b897
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 10200
Port Symbolic Name: unknown
Node WWN: 50020f200000b897
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 7
Loss of Signal Count: 7
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
Remote Port WWN: 210100e08b27daa6
Active FC4 Types: SCSI
SCSI Target: no
Port ID: 10100
Port Symbolic Name: unknown
Node WWN: 200100e08b27daa6
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
Remote Port WWN: 210000e08b074cb5
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 10700
Port Symbolic Name: unknown
Node WWN: 200000e08b074cb5
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
Remote Port WWN: 210100e08b296060
Active FC4 Types: SCSI
SCSI Target: no
Port ID: 10600
Port Symbolic Name: unknown
Node WWN: 200100e08b296060
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
Example 13 Listing All SCSI Targets and Link Statistics on the Given
HBA
The following command lists all remote ports as well as the link sta‐
tistics and scsi-target information on the given HBA port:
# fcinfo remote-port -sl -p 210100e08b272ab5
HBA Port WWN: 210100e08b272ab5
Count of Remote Port(s): 7
Remote Port WWN: 210100e08b296a60
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 10d00
Port Symbolic Name: unknown
Node WWN: 200100e08b296a60
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
Remote Port WWN: 20030003ba27d56d
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 10800
Port Symbolic Name: unknown
Node WWN: 10000003ba27d56d
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 4765165
Loss of Signal Count: 4765165
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
LUN: 0
Vendor: SUN
Product: T4
OS Device Name: /dev/rdsk/c4t20030003BA27D56Dd0s2
LUN: 1
Vendor: SUN
Product: T4
OS Device Name: /dev/rdsk/c4t20030003BA27D56Dd1s2
Remote Port WWN: 210100e08b27f7a6
Active FC4 Types: SCSI
SCSI Target: no
Port ID: 10e00
Port Symbolic Name: unknown
Node WWN: 200100e08b27f7a6
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
Remote Port WWN: 50020f230000b897
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 10200
Port Symbolic Name: unknown
Node WWN: 50020f200000b897
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 7
Loss of Signal Count: 7
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
LUN: 0
Vendor: SUN
Product: T300
OS Device Name: Unknown
LUN: 1
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d1s2
LUN: 2
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d2s2
LUN: 3
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d3s2
LUN: 4
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d4s2
LUN: 5
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d5s2
LUN: 6
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d6s2
LUN: 7
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d7s2
LUN: 8
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d8s2
LUN: 9
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d9s2
LUN: 10
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d10s2
LUN: 11
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d11s2
LUN: 12
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d12s2
LUN: 13
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d13s2
LUN: 14
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d14s2
LUN: 15
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d15s2
Remote Port WWN: 210100e08b27daa6
Active FC4 Types: SCSI
SCSI Target: no
Port ID: 10100
Port Symbolic Name: unknown
Node WWN: 200100e08b27daa6
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
Remote Port WWN: 210000e08b074cb5
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 10700
Port Symbolic Name: unknown
Node WWN: 200000e08b074cb5
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
Remote Port WWN: 210100e08b296060
Active FC4 Types: SCSI
SCSI Target: no
Port ID: 10600
Port Symbolic Name: unknown
Node WWN: 200100e08b296060
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
Example 14 Listing All SCSI Targets and Link Statistics
The following command lists all remote ports as well as the link sta‐
tistics and scsi-target information of each HBA on the host:
# fcinfo remote-port -ls
HBA Port WWN: 10000000c957ebdc
Count of Remote Port(s): 3
Remote Port WWN: 10000000c983b45e
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 70800
Port Symbolic Name: Emulex PPN-10:00:00:00:c9:83:b4:5e
Node WWN: 20000000c983b45e
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 7
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 20
Invalid CRC Count: 0
Remote Port WWN: 2100001b3286bc63
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 70a00
Port Symbolic Name: qlt0,0
Node WWN: 2000001b3286bc63
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
LUN: 0
Vendor: SUN
Product: COMSTAR
OS Device Name: /dev/rdsk/c0t600144F0EE9DCD00000056C136D10001d0s2
Remote Port WWN: 2101001b32a6bc63
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 70b00
Port Symbolic Name: qlt1,0
Node WWN: 2001001b32a6bc63
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
LUN: 0
Vendor: SUN
Product: COMSTAR
OS Device Name: /dev/rdsk/c0t600144F0EE9DCD00000056C136D10001d0s2
HBA Port WWN: 10000000c957ebdd
Count of Remote Port(s): 0
HBA Port WWN: 10000000c983b45e
Count of Remote Port(s): 4
Remote Port WWN: 2100001b3286bc63
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 70a00
Port Symbolic Name: qlt0,0
Node WWN: 2000001b3286bc63
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
LUN: 0
Vendor: SUN
Product: COMSTAR
OS Device Name: /dev/rdsk/c0t600144F0EE9DCD00000056C136D10001d0s2
Remote Port WWN: 2101001b32a6bc63
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 70b00
Port Symbolic Name: qlt1,0
Node WWN: 2001001b32a6bc63
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
LUN: 0
Vendor: SUN
Product: COMSTAR
OS Device Name: /dev/rdsk/c0t600144F0EE9DCD00000056C136D10001d0s2
Remote Port WWN: 201600a0b82a3846
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 70e00
Port Symbolic Name:
Node WWN: 200600a0b82a3846
Link Error Statistics:
Link Failure Count: 3
Loss of Sync Count: 13
Loss of Signal Count: 25
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 0
Invalid CRC Count: 0
LUN: 0
Vendor: SUN
Product: CSM200_R
OS Device Name: /dev/rdsk/c0t600A0B800026ECBE000061505518C92Bd0s2
LUN: 1
Vendor: SUN
Product: CSM200_R
OS Device Name: /dev/rdsk/c0t600A0B80002A3846000073FD558089ECd0s2
Remote Port WWN: 10000000c957ebdc
Active FC4 Types:
SCSI Target: no
Port ID: 70900
Port Symbolic Name:
Node WWN: 20000000c957ebdc
Link Error Statistics:
Link Failure Count: 0
Loss of Sync Count: 3
Loss of Signal Count: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 2
Invalid CRC Count: 1
HBA Port WWN: 10000000c983b45f
Count of Remote Port(s): 0
Example 15 Listing SCSI Target Information on the Given HBA
The following command lists all remote ports as well as the scsi-target
information on the given HBA port:
# fcinfo remote-port -s -p 210100e08b272ab5
HBA Port WWN: 210100e08b272ab5
Count of Remote Port(s): 7
Remote Port WWN: 210100e08b296a60
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 10d00
Port Symbolic Name: unknown
Node WWN: 200100e08b296060
Remote Port WWN: 20030003ba27d56d
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 10800
Port Symbolic Name: unknown
Node WWN: 10000003ba27d56d
LUN: 0
Vendor: SUN
Product: T4
OS Device Name: /dev/rdsk/c4t20030003BA27D56Dd0s2
LUN: 1
Vendor: SUN
Product: T4
OS Device Name: /dev/rdsk/c4t20030003BA27D56Dd1s2
Remote Port WWN: 210100e08b27f7a6
Active FC4 Types: SCSI
SCSI Target: no
Port ID: 10e00
Port Symbolic Name: unknown
Node WWN: 200100e08b27f7a6
Remote Port WWN: 50020f230000b897
Active FC4 Types: SCSI
SCSI Target: yes
Port ID: 10200
Port Symbolic Name: unknown
Node WWN: 50020f200000b897
LUN: 0
Vendor: SUN
Product: T300
OS Device Name: Unknown
LUN: 1
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d1s2
LUN: 2
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d2s2
LUN: 3
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d3s2
LUN: 4
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d4s2
LUN: 5
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d5s2
LUN: 6
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d6s2
LUN: 7
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d7s2
LUN: 8
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d8s2
LUN: 9
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d9s2
LUN: 10
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d10s2
LUN: 11
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d11s2
LUN: 12
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d12s2
LUN: 13
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d13s2
LUN: 14
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d14s2
LUN: 15
Vendor: SUN
Product: T300
OS Device Name: /dev/rdsk/c4t50020F230000B897d15s2
Remote Port WWN: 210100e08b27daa6
Active FC4 Types: SCSI
SCSI Target: no
Port ID: 10100
Port Symbolic Name: unknown
Node WWN: 200100e08b27daa6
Remote Port WWN: 210000e08b074cb5
Active FC4 Types: SCSI,IP
SCSI Target: no
Port ID: 10700
Port Symbolic Name: unknown
Node WWN: 200000e08b074cb5
Remote Port WWN: 210100e08b296060
Active FC4 Types: SCSI
SCSI Target: no
Port ID: 10600
Port Symbolic Name: unknown
Node WWN: 200100e08b296060
Example 16 Listing the Logical Unit
The following command lists the logical unit:
# fcinfo logical-unit
OS Device Name: /dev/rdsk/c0t600A0B800026ECBE000061505518C92Bd0s2
OS Device Name: /dev/rdsk/c0t600A0B80002A3846000073FD558089ECd0s2
OS Device Name: /dev/rdsk/c0t600144F0EE9DCD00000056C136D10001d0s2
Example 17 Displaying Additional Information for the Logical Unit
The following command displays additional information about the logical
unit using the -v option for device
/dev/rdsk/c0t600A0B800026ECBE000061505518C92Bd0s2:
# fcinfo logical-unit -v \
/dev/rdsk/c0t600A0B800026ECBE000061505518C92Bd0s2
OS Device Name: /dev/rdsk/c0t600A0B800026ECBE000061505518C92Bd0s2
HBA Port WWN: 10000000c983b45e
Controller: /dev/cfg/c6
Remote Port WWN: 201600a0b82a3846
LUN: 0
Class: secondary
State: online
Vendor: SUN
Product: CSM200_R
Device Type: Disk Device
Unformatted capacity: 6144.000 MBytes
Example 18 Displaying Additional Information for the Logical Unit on
the Given Remote Node WWN
The following command displays additional information about the logical
unit on the given remote node WWN by using the -v option:
# fcinfo lu -v -N 2000001b3286bc63
OS Device Name: /dev/rdsk/c0t600144F0EE9DCD00000056C136D10001d0s2
HBA Port WWN: 10000000c983b45e
Controller: /dev/cfg/c6
Remote Port WWN: 2100001b3286bc63
LUN: 0
Class: primary
State: online
HBA Port WWN: 10000000c957ebdc
Controller: /dev/cfg/c4
Remote Port WWN: 2100001b3286bc63
LUN: 0
Class: primary
State: online
Vendor: SUN
Product: COMSTAR
Device Type: Disk Device
Unformatted capacity: 2048.000 MBytes
Example 19 Displaying Additional Information for the Logical Unit on
the Given Remote Port WWN
The following command displays additional information about the logical
unit on the given remote port WWN by using the -v option.
# fcinfo lu -v -P 201600a0b82a3846
OS Device Name: /dev/rdsk/c0t600A0B800026ECBE000061505518C92Bd0s2
HBA Port WWN: 10000000c983b45e
Controller: /dev/cfg/c6
Remote Port WWN: 201600a0b82a3846
LUN: 0
Class: secondary
State: online
Vendor: SUN
Product: CSM200_R
Device Type: Disk Device
Unformatted capacity: 6144.000 MBytes
OS Device Name: /dev/rdsk/c0t600A0B80002A3846000073FD558089ECd0s2
HBA Port WWN: 10000000c983b45e
Controller: /dev/cfg/c6
Remote Port WWN: 201600a0b82a3846
LUN: 1
Class: primary
State: online
Vendor: SUN
Product: CSM200_R
Device Type: Disk Device
Unformatted capacity: 5120.000 MBytes
Example 20 Adding an NPIV Port
The following command adds an NPIV port to the physical HBA port with
port name:
210000e08b170f1c
The NPIV port has a port name of 2000000000000001 and a node name of
2100000000000001.
# fcadm create-npiv-port -p 2000000000000001 -n 2100000000000001 \
210000e08b170f1c
Created NPIV Port:
HBA Port WWN: 2000000000000001
Node WWN: 2100000000000001
Physical HBA Port WWN: 210000e08b170f1c
Example 21 Adding an NPIV Port with Random WWN
The following command adds an NPIV port with a randomly assigned port
and node name to the physical HBA port with port name 210000e08b170f1c.
# fcadm create-npiv-port 210000e08b170f1c
Created NPIV Port:
HBA Port WWN: 2038295824942801
Node WWN: 2100392849248001
Physical HBA Port WWN: 210000e08b170f1c
Example 22 Deleting an NPIV Port
The following command deletes an NPIV port.
# fcadm delete-npiv-port -p 2000000000000001 210000e08b170f1c
Example 23 Creating an FCoE Target Port
The following command creates an FCoE port associated with the MAC in‐
terface nxge0.
# fcadm create-fcoe-port -t nxge0
Example 24 Deleting an FCoE Port
The following command deletes the FCoE port associated with the MAC in‐
terface nxge0.
# fcadm delete-fcoe-port -t nxge0
Example 25 Listing Information for all FCoE Ports
The following command lists information for all FCoE ports.
# fcadm list-fcoe-ports
HBA Port WWN: 2000001b2165a630
Port Mode: Initiator
Port ID: e00033
VLAN ID: 7
Link Name: net2
MTU Size: 2500
Primary MAC Address: 00:1b:21:65:a6:30
FCoE MAC Address: 0e:fc:00:e0:00:33
Promiscuous Mode: Off
State: Online
FIP Mode: On
FCoE Hardware Offload: Supported
HBA Port WWN: 2000001b2165a631
Port Mode: Target
Port ID: e00034
VLAN ID: 7
Link Name: net3
MTU Size: 2500
Primary MAC Address: 00:1b:21:65:a6:31
FCoE MAC Address: 0e:fc:00:e0:00:34
Promiscuous Mode: Off
State: Online
FIP Mode: On
FCoE Hardware Offload: Supported
Example 26 Listing Information for all FCoE Initiator Ports
The following command lists information for all FCoE initiator ports.
# fcadm list-fcoe-ports -i
HBA Port WWN: 2000001b2165a630
Port Mode: Initiator
Port ID: e00033
VLAN ID: 7
Link Name: net2
MTU Size: 2500
Primary MAC Address: 00:1b:21:65:a6:30
FCoE MAC Address: 0e:fc:00:e0:00:33
Promiscuous Mode: Off
State: Online
FIP Mode: On
FCoE Hardware Offload: Supported
Example 27 Listing Information for all FCoE Target Ports
The following command lists information for all FCoE target ports.
# fcadm list-fcoe-ports -t
HBA Port WWN: 2000001b2165a631
Port Mode: Target
Port ID: e00034
VLAN ID: 7
Link Name: net3
MTU Size: 2500
Primary MAC Address: 00:1b:21:65:a6:31
FCoE MAC Address: 0e:fc:00:e0:00:34
Promiscuous Mode: Off
State: Online
FIP Mode: On
FCoE Hardware Offload: Supported
Example 28 Listing Verbose Information for an FCoE Port
The following command lists information for an FCoE port which is cre‐
ated upon a link name net3.
# fcadm list-fcoe-ports -v net3
HBA Port WWN: 2000001b2165a631
Port Mode: Target
Port ID: e00034
VLAN ID: 7
Link Name: net3
MTU Size: 2500
Primary MAC Address: 00:1b:21:65:a6:31
FCoE MAC Address: 0e:fc:00:e0:00:34
Promiscuous Mode: Off
State: Online
FIP Mode: On
FCoE Hardware Offload: Supported
TX CRC: On
RX CRC: On
LSO: On
LRO: On
MAX LSO Size: 65440
MAX LRO Size: 131072
Example 29 Reinitializing the Link of an FC Port
The following command forces the link connected with the port
200000144fc2d508 to reinitialize.
# fcadm force-lip 200000144fc2d508
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
TRIBUTE VALUE _ Availabilitysystem/storage/fc-utilities _ Interface
StabilityCommitted
SEE ALSO
attributes(7)
ERROR MESSAGES
Errors that can occur in addition to the errors normally associated
with system administration commands:
o HBA_port_WWN: not found
o Remote_port_WWN: not found
o HBA_port_WWN: NPIV not supported on this HBA
Oracle Solaris 11.4 20 Feb 2023 fcinfo(8)