fcinfo man page on OpenIndiana

Man page or keyword search:  
man Server   20441 pages
apropos Keyword Search (all sections)
Output format
OpenIndiana logo
[printable version]

fcinfo(1M)		System Administration Commands		    fcinfo(1M)

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] [OS device_path]

       fcadm logical-unit | lu [-v] [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 MAC_Interface

       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
       attribute  information  and remote port information are applied to both
       the initiator and the target modes port except that SCSI-related opera‐
       tions 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 HBA_port_WWN is 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.

       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  delete  only  ports  create  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 issu‐
	   ing 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 ses‐
	   sion 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	inter‐
	   face	 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. It is mandatory for delete-npiv-port.

	   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.

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

       -t [HBA_node_WWN], -target [HBA_node_WWN]

	   Lists the information for the port with the target mode  referenced
	   by  the  specified HBA_node_WWN or all target mode ports discovered
	   in the host.

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

       -v, --verbose

	   When used with the logical-unit subcommand, the -v  displays	 addi‐
	   tional  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 All HBA Ports

       The following command lists all initiator mode fibre channel HBA	 ports
       on the host:

	 # fcinfo hba-port

	 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
       the given HBA port:

	 # fcinfo remote-port -p 210100e08b274cb5

	 Remote Port WWN: 50020f230000b4af
		 Active FC4 Types: SCSI
		 SCSI Target: yes
		 Port Symbolic Name: unknown
		 Node WWN: 50020f200000b4af
	 Remote Port WWN: 210000e08b07daa6
		 Active FC4 Types: SCSI
		 SCSI Target: no
		 Port Symbolic Name: unknown
		 Node WWN: 200000e08b07daa6
	 Remote Port WWN: 20030003ba27c788
		 Active FC4 Types: SCSI
		 SCSI Target: yes
		 Port Symbolic Name: unknown
		 Node WWN: 10000003ba27c788
	 Remote Port WWN: 210000e08b096a60
		 Active FC4 Types: SCSI,IP
		 SCSI Target: no
		 Port Symbolic Name: unknown
		 Node WWN: 200000e08b096a60

       Example 5 Listing Remote Ports and Link Statistics

       The following command lists information for the remote  ports  and  the
       link statistics for those ports:

	 # fcinfo remote-port -l -p 210100e08b272ab5

	 Remote Port WWN: 210100e08b296a60
		 Active FC4 Types: SCSI,IP
		 SCSI Target: no
		 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 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 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 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 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 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 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 6 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:

	 # fcinfo remote-port  -sl -p 210100e08b272ab5

	 Remote Port WWN: 210100e08b296a60
		 Active FC4 Types: SCSI,IP
		 SCSI Target: no
		 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 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 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 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 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 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 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 SCSI Target Information

       The following command lists all remote ports as well as the scsi-target
       information:

	 # fcinfo remote-port  -s -p 210100e08b272ab5

	 Remote Port WWN: 210100e08b296a60
		 Active FC4 Types: SCSI,IP
		 SCSI Target: no
		 Port Symbolic Name: unknown
		 Node WWN: 200100e08b296060
	 Remote Port WWN: 20030003ba27d56d
		 Active FC4 Types: SCSI
		 SCSI Target: yes
		 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 Symbolic Name: unknown
		 Node WWN: 200100e08b27f7a6
	 Remote Port WWN: 50020f230000b897
		 Active FC4 Types: SCSI
		 SCSI Target: yes
		 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 Symbolic Name: unknown
		 Node WWN: 200100e08b27daa6
	 Remote Port WWN: 210000e08b074cb5
		 Active FC4 Types: SCSI,IP
		 SCSI Target: no
		 Port Symbolic Name: unknown
		 Node WWN: 200000e08b074cb5
	 Remote Port WWN: 210100e08b296060
		 Active FC4 Types: SCSI
		 SCSI Target: no
		 Port Symbolic Name: unknown
		 Node WWN: 200100e08b296060

       Example 8 Listing the Logical Unit

       The following command lists the logical unit:

	 # fcinfo logical-unit

	 /dev/rdsk/c0t600C0FF0000000000036223AE73EB705d0s2
	 /dev/rdsk/c0t600C0FF00000000000362272539E5B03d0s2
	 /dev/rmt/0n

       Example 9 Displaying Additional Information for the Logical Unit

       The following command displays additional information about the logical
       unit using the -v option for device /dev/rmt/On:

	 # fcinfo lu -v /dev/rmt/On

	  OS Device Name: /dev/rmt/0n
		 HBA Port WWN: 210000e07c030b91
			 Remote Port WWN: 21010003b7830a6
				LUN: 0
		 Vendor: STK
		 Product: 9940A
		 Device Type: Tape device

       The following command displays additional information about the logical
       unit	  using	      the	-v	 option	      for	device
       /dev/rdsk/c0t600C0FF0000000000036223AE73EB705d0s2

	 # fcinfo logical-unit -v \
	      /dev/rdsk/c0t600C0FF0000000000036223AE73EB705d0s2

	  OS Device Name: /dev/rdsk/c0t600C0FF0000000000036223AE73EB705d0s2
		 HBA Port WWN: 210100e08b27a8a1
			 Remote Port WWN: 256000c0ffc03622
				 LUN: 0
			 Remote Port WWN: 216000c0ff803622
				 LUN: 0
		 HBA Port WWN: 210000e08b07a8a1
			 Remote Port WWN: 256000c0ffc03622
				 LUN: 0
			 Remote Port WWN: 216000c0ff803622
				 LUN: 0
		 Vendor: SUN
		 Product: StorEdge 3510
		 Device Type: Disk device

       Example 10 Adding an NIPV Port

       The following command adds an NPIV port to the HBA with a 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 11 Adding an NIPV Port with Random WWN

       The  following  command	adds  an  NPIV port to the HBA with a randomly
       assigned port name of 210000e08b170f1c.

	 # fcadm create-npiv-port 210000e08b170f1c

	 Created NPIV Port:
	     HBA Port WWN: 2038295824942801
	     Node WWN: 2100392849248001
	     Physical HBA Port WWN: 210000e08b170f1c

       Example 12 Deleting an NIPV Port

       The following command deletes an NPIV port.

	 # fcadm delete-npiv-port -p 2000000000000001 -w 2100000000000001 \
	 210000e08b170f1c

       Example 13 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 14 Deleting an FCoE Port

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

	 # fcadm delete-fcoe-port -t nxge0

       Example 15 Listing Information for an FCoE Port

       The following command lists information for FCoE ports.

	 # fcadm list-fcoe-ports
	 HBA Port WWN: 200000144fc2d508
		 Port Type: Target
		 MAC Name: nxge0
		 MTU Size: 9194
		 MAC Factory Address: 00144fc2d508
		 MAC Current Address: 00144fc2d508
	 HBA Port WWN: 200000144fc2d509
		 Port Type: Target
		 MAC Name: nxge1
		 MTU Size: 9194
		 MAC Factory Address: 00144fc2d509
		 MAC Current Address: 00144fc2d509

       Example 16 Reinitializing the Link of an FC Port

       The  following  command	forces	the  link  connected  with  the	  port
       200000144fc2d508 to reinitialize.

	 # fcadm force-lip 200000144fc2d508

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Availability		     │system/storage/fibre-chan‐   │
       │			     │nel/port-utility		   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Committed			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       attributes(5)

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

SunOS 5.11			  26 Jul 2009			    fcinfo(1M)
[top]

List of man pages available for OpenIndiana

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net