Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

fcinfo(8)

Name

fcinfo, fcadm - Fibre Channel HBA Port Command Line Interface

Synopsis

fcinfo hba-port [-lite] [HBA_port_WWN]...
fcadm hba-port [-lite] [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 administrative 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 attribute 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, all initiator mode and target mode Fibre Channel HBA ports on the host will be listed.

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 specified 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 always rediscover the port after this, and the FC login session will be established or reused. Also, I/Os will be continued. This command 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 interface associated with a NIC that does not support multiple unicast address. Promiscuous mode will be enabled for the specified MAC interface.

–l, –-linkstat

Lists the link error statistics information for the port referenced by the specified HBA_port_WWN or Remote_port_WWN.

–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.

–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.

–N Remote_node_WWN, –-remote-node Remote_node_WWN

Retrieves information of all logical units on the remote port specified by Remote_node_WWN. This option applies only to the subcommand logical-unit | lu.

–P Remote_port_WWN, –-remote-port Remote_node_WWN

Retrieves information of all logical units on the remote port specified by Remote_node_WWN. This option applies only to the subcommand logical-unit | lu.

–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 applies only to an initiator mode port.

–i, –-initiator

Lists the information for initiator mode ports only.

–t, –-target

Lists the information for target mode ports only.

When used with create-fcoe-port, creates a FCoE target mode port.

–v, –-verbose

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.

–V, –-version

Displays the version information.

–?, –-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: 210000e08b074cb5
        Port Mode: Initiator
        OS Device Name: /dev/cfg/c1
        Manufacturer: QLogic Corp.
        Model: 375-3108-xx
        Firmware Version: 3.3.116
        FCode/BIOS Version: 1.13.08
        Serial Number: not available
        Driver Name: qlc
        Driver Version: 20070212-2.19
        Type: N-port
        State: online
        Supported Speeds: 1Gb 2Gb
        Current Speed: 2Gb
        Node WWN: 200000e08b074cb5
NPIV Port List:
        Virtual Port 1:
         Port WWN: 200000e08b074cb1
         Node WWN: 200000e08b074cb3
HBA Port WWN: 210100e08b274cb5
        Port Mode: Initiator
        OS Device Name: /dev/cfg/c2
        Manufacturer: QLogic Corp.
        Model: 375-3108-xx
        Firmware Version: 3.3.116
        FCode/BIOS Version: 1.13.08
        Serial Number: not available
        Driver Name: qlc
        Driver Version: 20070212-2.19
        Type: N-port
        State: online
        Supported Speeds: 1Gb 2Gb
        Current Speed: 2Gb
        Node WWN: 200100e08b274cb5
HBA Port WWN: 210000e08b072ab5
        Port Mode: Initiator
        OS Device Name: /dev/cfg/c3
        Manufacturer: QLogic Corp.
        Firmware Version: 3.3.116
        FCode/BIOS Version: 1.13.08
        Model: 375-3108-xx
        Serial Number: not available
        Driver Name: qlc
        Driver Version: 20070212-2.19
        Type: L-port
        State: online
        Supported Speeds: 1Gb 2Gb
        Current Speed: 2Gb
        Node WWN: 200000e08b072ab5
HBA Port WWN: 210100e08b272ab5
        Port Mode: Initiator
        OS Device Name: /dev/cfg/c4
        Manufacturer: QLogic Corp.
        Model: 375-3108-xx
        Firmware Version: 3.3.116
        FCode/BIOS Version: 1.13.08
        Serial Number: 0402F00-0549112808
        Driver Name: qlc
        Driver Version: 20070212-2.19
        Type: N-port
        State: online
        Supported Speeds: 1Gb 2Gb
        Current Speed: 2Gb
        Node WWN: 200100e08b272ab5    
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: 210100e08bb09221
     Port Mode: Target
     Port ID: 10700
     OS Device Name: Not Applicable
     Manufacturer: QLogic Corp.
     Model: d30ac7e0
     Firmware Version: 4.0.109
     FCode/BIOS Version: N/A
     Type: F-port
     State: online
     Supported Speeds: not established
     Current Speed: 2Gb
     Node WWN: 200100e08bb09221
  HBA Port WWN: 210000e08b909221
     Port Mode: Target
     Port ID: 10900
     OS Device Name: Not Applicable
     Manufacturer: QLogic Corp.
     Model: d37ad1e0
     Firmware Version: 4.0.109
     FCode/BIOS Version: N/A
     Type: F-port
     State: online
     Supported Speeds: not established
     Current Speed: 2Gb
     Node WWN: 200000e08b909221
  HBA Port WWN: 200000144fc2d508
     Port Mode: Target
     Port ID: 9a0025
     OS Device Name: Not Applicable
     Manufacturer: Sun Microsystems, Inc.
     Model: FCoE Virtual FC HBA
     Firmware Version: N/A
     FCode/BIOS Version: N/A
     Serial Number: N/A
     Driver Name: COMSTAR FCOET
     Driver Version: 1.0
     Type: F-port
     State: online
     Supported Speeds: 1Gb 10Gb
     Current Speed: 10Gb
     Node WWN: 100000144fc2d508
  HBA Port WWN: 200000144fc2d509
     Port Mode: Target
     Port ID: 9a0023
     OS Device Name: Not Applicable
     Manufacturer: Sun Microsystems, Inc.
     Model: FCoE Virtual FC HBA
     Firmware Version: N/A
     FCode/BIOS Version: N/A
     Serial Number: N/A
     Driver Name: COMSTAR FCOET
     Driver Version: 1.0
     Type: F-port
     State: online
     Supported Speeds: 1Gb 10Gb
     Current Speed: 10Gb
     Node WWN: 100000144fc2d509
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 210000e08b074cb5 210100e08b274cb5


HBA Port WWN: 210000e08b074cb5
        Port Mode: Initiator
        OS Device Name: /dev/cfg/c1
        Manufacturer: QLogic Corp.
        Model: 375-3108-xx
        Firmware Version: 3.3.116
        FCode/BIOS Version: 1.13.08
        Serial Number: 0402F00-0549112808
        Driver Name: qlc
        Driver Version: 20070212-2.19
        Type: N-port
        State: online
        Supported Speeds: 1Gb 2Gb
        Current Speed: 2Gb
        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
HBA Port WWN: 210100e08b274cb5
        Port Mode: Initiator
        OS Device Name: /dev/cfg/c2
        Manufacturer: QLogic Corp.
        Model: 375-3108-xx
        Firmware Version: 3.3.116
        FCode/BIOS Version: 1.13.08
        Serial Number: 0402F00-0549112808
        Driver Name: qlc
        Driver Version: 20070212-2.19
        Type: N-port
        State: online
        Supported Speeds: 1Gb 2Gb
        Current Speed: 2Gb
        Node WWN: 200100e08b274cb5
        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 4 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 5 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 6 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 7 Listing All SCSI Targets and Link Statistics on the Given HBA

The following command lists all remote ports as well as the link statistics 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 8 Listing All SCSI Targets and Link Statistics

The following command lists all remote ports as well as the link statistics 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 9 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 10 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 11 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 12 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 13 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 14 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 15 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 16 Deleting an NPIV Port

The following command deletes an NPIV port.

# fcadm delete-npiv-port -p 2000000000000001 210000e08b170f1c
Example 17 Creating an FCoE Target Port

The following command creates an FCoE port associated with the MAC interface nxge0.

# fcadm create-fcoe-port -t nxge0
Example 18 Deleting an FCoE Port

The following command deletes the FCoE port associated with the MAC interface nxge0.

# fcadm delete-fcoe-port -t nxge0
Example 19 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 20 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 21 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 22 Listing Verbose Information for an FCoE Port

The following command lists information for an FCoE port which is created 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 23 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:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/storage/fc-utilities
Interface Stability
Committed

See Also

attributes(7)

ERROR MESSAGES

Errors that can occur in addition to the errors normally associated with system administration commands:

  • HBA_port_WWN: not found

  • Remote_port_WWN: not found

  • HBA_port_WWN: NPIV not supported on this HBA