usr/src/man/man1m/fcinfo.1m

   1 '\" te
   2 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
   4 .\"  See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with
   5 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH FCINFO 1M "Jul 26, 2009"
   7 .SH NAME
   8 fcinfo, fcadm \- Fibre Channel HBA Port Command Line Interface
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBfcinfo\fR hba-port [\fB-lite\fR] [\fIHBA_port_WWN\fR]...
  13 .fi
  14
  15 .LP
  16 .nf
  17 \fBfcadm\fR hba-port [\fB-lite\fR] [\fIHBA_port_WWN\fR]...
  18 .fi
  19
  20 .LP
  21 .nf
  22 \fBfcinfo\fR remote-port [\fB-ls\fR] [\fB-p\fR \fIHBA_port_WWN\fR]
  23      [\fIREMOTE_port_WWN\fR]...
  24 .fi
  25
  26 .LP
  27 .nf
  28 \fBfcadm\fR remote-port [\fB-ls\fR] [\fB-p\fR \fIHBA_port_WWN\fR]
  29      [\fIREMOTE_port_WWN\fR]...
  30 .fi
  31
  32 .LP
  33 .nf
  34 \fBfcinfo\fR logical-unit | lu [\fB-v\fR] [OS \fIdevice_path\fR]
  35 .fi
  36
  37 .LP
  38 .nf
  39 \fBfcadm\fR logical-unit | lu [\fB-v\fR] [OS \fIdevice_path\fR]
  40 .fi
  41
  42 .LP
  43 .nf
  44 \fBfcadm\fR create-npiv-port \fB-p\fR \fIVirtual_Port_WWN\fR [\fB-n\fR \fIVirtual_Node_WWN\fR]
  45      \fIPhysicalPort_port_WWN\fR
  46 .fi
  47
  48 .LP
  49 .nf
  50 \fBfcadm\fR delete-npiv-port \fB-p\fR \fIVirtual_Port_WWN\fR [\fB-n\fR \fIVirtual_Node_WWN\fR]
  51      \fIPhysicalPort_port_WWN\fR
  52 .fi
  53
  54 .LP
  55 .nf
  56 \fBfcadm\fR create-fcoe-port [\fB-tf\fR] \fB-p\fR \fIPort_WWN\fR [\fB-n\fR \fINode_WWN\fR]
  57      \fIMAC_Interface\fR
  58 .fi
  59
  60 .LP
  61 .nf
  62 \fBfcadm\fR delete-fcoe-port \fIMAC_Interface\fR
  63 .fi
  64
  65 .LP
  66 .nf
  67 \fBfcadm\fR list-fcoe-ports \fIMAC_Interface\fR
  68 .fi
  69
  70 .LP
  71 .nf
  72 \fBfcadm\fR force-lip \fIPort_WWN\fR
  73 .fi
  74
  75 .LP
  76 .nf
  77 \fBfcinfo\fR [\fB-V\fR]
  78 .fi
  79
  80 .LP
  81 .nf
  82 \fBfcadm\fR [\fB-V\fR]
  83 .fi
  84
  85 .LP
  86 .nf
  87 \fBfcinfo\fR [\fB-?\fR]
  88 .fi
  89
  90 .LP
  91 .nf
  92 \fBfcadm\fR [\fB-?\fR]
  93 .fi
  94
  95 .SH DESCRIPTION
  96 .sp
  97 .LP
  98 \fBfcinfo\fR and \fBfcadm\fR are command line interfaces that collect
  99 administrative information on fibre channel host bus adapter (\fBHBA\fR) ports
 100 on a host. They also collect data on any fibre channel targets that might be
 101 connected to those ports in a Storage Area Network (\fBSAN\fR).
 102 .sp
 103 .LP
 104 A port can be either in initiator mode or target mode. The same FC attribute
 105 information and remote port information are applied to both the initiator and
 106 the target modes port except that SCSI-related operations described below do
 107 not apply for the target mode port.
 108 .SS "SUBCOMMANDS"
 109 .sp
 110 .LP
 111 The following subcommands are supported by both \fBfcinfo\fR and \fBfcadm\fR:
 112 .sp
 113 .ne 2
 114 .na
 115 \fB\fBhba-port\fR\fR
 116 .ad
 117 .RS 21n
 118 Lists information for the \fBHBA\fR port referenced by the specified
 119 \fIHBA_port_WWN\fR. If \fIHBA_port_WWN\fR is not specified, all initiator mode
 120 and target mode fibre channel \fBHBA\fR ports on the host will be listed.
 121 .RE
 122
 123 .sp
 124 .ne 2
 125 .na
 126 \fB\fBremote-port\fR\fR
 127 .ad
 128 .RS 21n
 129 Lists the \fIremote-port\fR information for those remote ports that are
 130 specified. If no \fIREMOTE_port_WWN\fR is specified, all remote ports that are
 131 visible through \fIHBA_port_WWN\fR are listed.
 132 .RE
 133
 134 .sp
 135 .ne 2
 136 .na
 137 \fB\fBlogical-unit\fR | \fBlu\fR\fR
 138 .ad
 139 .RS 21n
 140 Lists the logical unit referenced by the specified \fIdevice_path\fR. If
 141 \fIdevice_path\fR is not specified, all fibre channel logical units will be
 142 listed. This subcommand applies only to the initiator mode.
 143 .RE
 144
 145 .sp
 146 .LP
 147 The following subcommands, which administer N_Port ID Virtualization (NPIV) HBA
 148 ports, are supported only by \fBfcadm\fR:
 149 .sp
 150 .ne 2
 151 .na
 152 \fB\fBcreate-npiv-port\fR\fR
 153 .ad
 154 .sp .6
 155 .RS 4n
 156 Create an NPIV virtual port on the specified adapter.
 157 .RE
 158
 159 .sp
 160 .ne 2
 161 .na
 162 \fB\fBdelete-npiv-port\fR\fR
 163 .ad
 164 .sp .6
 165 .RS 4n
 166 Delete an NPIV virtual port. This delete only ports create by \fBfcadm\fR.
 167 .RE
 168
 169 .sp
 170 .LP
 171 The following subcommands, which administer Fibre Channel over Ethernet (FCoE)
 172 ports, are supported only by \fBfcadm\fR:
 173 .sp
 174 .ne 2
 175 .na
 176 \fB\fBcreate-fcoe-port\fR\fR
 177 .ad
 178 .sp .6
 179 .RS 4n
 180 Creates a FCoE port associated with the given MAC interface and the given
 181 \fIPort_WWN\fR/\fINode_WWN\fR. If \fB-p\fR or \fB-n\fR is not specified, the
 182 Port WWN or Node WWN will be generated automatically. If the specified MAC
 183 interface does not support multiple unicast address, no FCoE port will be
 184 created and you receive a message indicating that you can add an \fB-f\fR
 185 option to force enabling promiscuous mode on the specified MAC interface to
 186 enable FCoE.
 187 .RE
 188
 189 .sp
 190 .ne 2
 191 .na
 192 \fB\fBdelete-fcoe-port\fR\fR
 193 .ad
 194 .sp .6
 195 .RS 4n
 196 Deletes the FCoE port associated with the specified MAC interface.
 197 .RE
 198
 199 .sp
 200 .ne 2
 201 .na
 202 \fB\fBlist-fcoe-ports\fR\fR
 203 .ad
 204 .sp .6
 205 .RS 4n
 206 List information of FCoE ports.
 207 .RE
 208
 209 .sp
 210 .ne 2
 211 .na
 212 \fB\fBforce-lip\fR\fR
 213 .ad
 214 .sp .6
 215 .RS 4n
 216 Force the link to reinitialize. When issuing this subcommand  on the target
 217 port side, causes a reset of the target port. When issuing it from the host
 218 port side, resets the host port. When an FC switch is connected, other FC ports
 219 in the SAN will get a RSCN (Remote State Change Notification). Furthermore,
 220 other initiators  will always rediscover the port after this, and the FC login
 221 session will be established or reused. Also, I/Os will be continued. This
 222 command is disruptive to I/Os, but it is not destructive, as it does not cause
 223 any data loss.
 224 .RE
 225
 226 .SH OPTIONS
 227 .sp
 228 .LP
 229 The following options are supported:
 230 .sp
 231 .ne 2
 232 .na
 233 \fB\fB-e\fR, \fB--fcoe\fR\fR
 234 .ad
 235 .sp .6
 236 .RS 4n
 237 Lists the information for all FCoE ports.
 238 .RE
 239
 240 .sp
 241 .ne 2
 242 .na
 243 \fB\fB-f\fR, \fB--fcoe-promiscuous\fR\fR
 244 .ad
 245 .sp .6
 246 .RS 4n
 247 Used with \fBcreate-fcoe-port\fR to create an FCoE port on a MAC interface
 248 associated with a NIC that does not support multiple unicast address.
 249 Promiscuous mode will be enabled for the specified MAC interface.
 250 .RE
 251
 252 .sp
 253 .ne 2
 254 .na
 255 \fB\fB-l\fR, \fB--linkstat\fR\fR
 256 .ad
 257 .sp .6
 258 .RS 4n
 259 Lists the link error statistics information for the port referenced by the
 260 specified \fIHBA_port_WWN\fR or \fIREMOTE_port_WWN\fR.
 261 .RE
 262
 263 .sp
 264 .ne 2
 265 .na
 266 \fB\fB-n\fR \fIHBA_node_WWN\fR, \fB--node\fR \fIHBA_node_WWN\fR\fR
 267 .ad
 268 .sp .6
 269 .RS 4n
 270 When used with NPIV options, specify a virtual node WWN. If used with
 271 \fBcreate-npiv-port\fR, it can be omitted, and a random based WWN will be used.
 272 It is mandatory for \fBdelete-npiv-port\fR.
 273 .sp
 274 When used with \fBcreate-fcoe-port\fR subcommand, specify the node WWN for the
 275 FCoE port. It can be omitted, in which case a WWN will be generated based on
 276 the MAC address of the specified MAC interface.
 277 .RE
 278
 279 .sp
 280 .ne 2
 281 .na
 282 \fB\fB-p\fR \fIHBA_port_WWN\fR, \fB--port\fR \fIHBA_port_WWN\fR\fR
 283 .ad
 284 .sp .6
 285 .RS 4n
 286 Retrieve remote port information from the \fIHBA_port_WWN\fR of the local
 287 \fBHBA\fR port on the host. When used with the \fBremote-port\fR subcommand,
 288 the \fB-p\fR option is mandatory.
 289 .sp
 290 When used with NPIV options, specify a virtual port WWN. If used with
 291 \fBcreate-npiv-port\fR, it can be omitted, and a random based WWN will be used.
 292 It is mandatory for \fBdelete-npiv-port\fR.
 293 .sp
 294 When used with \fBcreate-fcoe-port\fR subcommand, specify the port WWN for the
 295 FCoE port. It can be omitted, in which case a WWN will be generated based on
 296 the MAC address of the specified MAC interface.
 297 .RE
 298
 299 .sp
 300 .ne 2
 301 .na
 302 \fB\fB-s\fR, \fB--scsi-target\fR\fR
 303 .ad
 304 .sp .6
 305 .RS 4n
 306 Lists the \fBSCSI\fR target information for all remote ports the user has asked
 307 for. The \fB-p\fR, \fB--port\fR option must always be specified and must be a
 308 valid \fBHBA\fR port on the host. This \fBHBA\fR port will be used as the
 309 initiator for which to retrieve the \fBSCSI\fR level target information. Note
 310 that this will only function on remote port fibre channel World-Wide Names that
 311 support an FC4 type of \fBSCSI\fR. This option applies only to an initiator
 312 mode port.
 313 .RE
 314
 315 .sp
 316 .ne 2
 317 .na
 318 \fB\fB-t\fR [\fIHBA_node_WWN\fR], \fB-target\fR [\fIHBA_node_WWN\fR]\fR
 319 .ad
 320 .sp .6
 321 .RS 4n
 322 Lists the information for the port with the target mode referenced by the
 323 specified \fIHBA_node_WWN\fR or all target mode ports discovered in the host.
 324 .sp
 325 When used with \fBcreate-fcoe-port\fR, create a FCoE target mode port.
 326 .RE
 327
 328 .sp
 329 .ne 2
 330 .na
 331 \fB\fB-v\fR, \fB--verbose\fR\fR
 332 .ad
 333 .sp .6
 334 .RS 4n
 335 When used with the \fBlogical-unit\fR subcommand, the \fB-v\fR displays
 336 additional information for the logical unit, including \fBSCSI\fR vendor and
 337 product information and device type as well as the \fBFC\fR World-Wide names
 338 for the local and remote fibre channel ports to which this device is attached.
 339 .RE
 340
 341 .sp
 342 .ne 2
 343 .na
 344 \fB\fB-V\fR, \fB--version\fR\fR
 345 .ad
 346 .sp .6
 347 .RS 4n
 348 Displays the version information.
 349 .RE
 350
 351 .sp
 352 .ne 2
 353 .na
 354 \fB\fB-?\fR, \fB--help\fR\fR
 355 .ad
 356 .sp .6
 357 .RS 4n
 358 Displays the usage information.
 359 .RE
 360
 361 .SH EXAMPLES
 362 .LP
 363 \fBExample 1 \fRListing All HBA Ports
 364 .sp
 365 .LP
 366 The following command lists all initiator mode fibre channel \fBHBA\fR ports on
 367 the host:
 368
 369 .sp
 370 .in +2
 371 .nf
 372 # \fBfcinfo hba-port\fR
 373
 374 HBA Port WWN: 210000e08b074cb5
 375         Port Mode: Initiator
 376         OS Device Name: /dev/cfg/c1
 377         Manufacturer: QLogic Corp.
 378         Model: 375-3108-xx
 379         Firmware Version: 3.3.116
 380         FCode/BIOS Version: 1.13.08
 381         Serial Number: not available
 382         Driver Name: qlc
 383         Driver Version: 20070212-2.19
 384         Type: N-port
 385         State: online
 386         Supported Speeds: 1Gb 2Gb
 387         Current Speed: 2Gb
 388         Node WWN: 200000e08b074cb5
 389 NPIV Port List:
 390         Virtual Port 1:
 391          Port WWN: 200000e08b074cb1
 392          Node WWN: 200000e08b074cb3
 393 HBA Port WWN: 210100e08b274cb5
 394         Port Mode: Initiator
 395         OS Device Name: /dev/cfg/c2
 396         Manufacturer: QLogic Corp.
 397         Model: 375-3108-xx
 398         Firmware Version: 3.3.116
 399         FCode/BIOS Version: 1.13.08
 400         Serial Number: not available
 401         Driver Name: qlc
 402         Driver Version: 20070212-2.19
 403         Type: N-port
 404         State: online
 405         Supported Speeds: 1Gb 2Gb
 406         Current Speed: 2Gb
 407         Node WWN: 200100e08b274cb5
 408 HBA Port WWN: 210000e08b072ab5
 409         Port Mode: Initiator
 410         OS Device Name: /dev/cfg/c3
 411         Manufacturer: QLogic Corp.
 412         Firmware Version: 3.3.116
 413         FCode/BIOS Version: 1.13.08
 414         Model: 375-3108-xx
 415         Serial Number: not available
 416         Driver Name: qlc
 417         Driver Version: 20070212-2.19
 418         Type: L-port
 419         State: online
 420         Supported Speeds: 1Gb 2Gb
 421         Current Speed: 2Gb
 422         Node WWN: 200000e08b072ab5
 423 HBA Port WWN: 210100e08b272ab5
 424         Port Mode: Initiator
 425         OS Device Name: /dev/cfg/c4
 426         Manufacturer: QLogic Corp.
 427         Model: 375-3108-xx
 428         Firmware Version: 3.3.116
 429         FCode/BIOS Version: 1.13.08
 430         Serial Number: 0402F00-0549112808
 431         Driver Name: qlc
 432         Driver Version: 20070212-2.19
 433         Type: N-port
 434         State: online
 435         Supported Speeds: 1Gb 2Gb
 436         Current Speed: 2Gb
 437         Node WWN: 200100e08b272ab5
 438 .fi
 439 .in -2
 440 .sp
 441
 442 .LP
 443 \fBExample 2 \fRListing Target Mode HBA Ports
 444 .sp
 445 .LP
 446 The following command lists all target mode fibre channel HBA ports on the
 447 host:
 448
 449 .sp
 450 .in +2
 451 .nf
 452 # \fBfcinfo hba-port -t\fR
 453   HBA Port WWN: 210100e08bb09221
 454      Port Mode: Target
 455      Port ID: 10700
 456      OS Device Name: Not Applicable
 457      Manufacturer: QLogic Corp.
 458      Model: d30ac7e0
 459      Firmware Version: 4.0.109
 460      FCode/BIOS Version: N/A
 461      Type: F-port
 462      State: online
 463      Supported Speeds: not established
 464      Current Speed: 2Gb
 465      Node WWN: 200100e08bb09221
 466   HBA Port WWN: 210000e08b909221
 467      Port Mode: Target
 468      Port ID: 10900
 469      OS Device Name: Not Applicable
 470      Manufacturer: QLogic Corp.
 471      Model: d37ad1e0
 472      Firmware Version: 4.0.109
 473      FCode/BIOS Version: N/A
 474      Type: F-port
 475      State: online
 476      Supported Speeds: not established
 477      Current Speed: 2Gb
 478      Node WWN: 200000e08b909221
 479   HBA Port WWN: 200000144fc2d508
 480      Port Mode: Target
 481      Port ID: 9a0025
 482      OS Device Name: Not Applicable
 483      Manufacturer: Sun Microsystems, Inc.
 484      Model: FCoE Virtual FC HBA
 485      Firmware Version: N/A
 486      FCode/BIOS Version: N/A
 487      Serial Number: N/A
 488      Driver Name: COMSTAR FCOET
 489      Driver Version: 1.0
 490      Type: F-port
 491      State: online
 492      Supported Speeds: 1Gb 10Gb
 493      Current Speed: 10Gb
 494      Node WWN: 100000144fc2d508
 495   HBA Port WWN: 200000144fc2d509
 496      Port Mode: Target
 497      Port ID: 9a0023
 498      OS Device Name: Not Applicable
 499      Manufacturer: Sun Microsystems, Inc.
 500      Model: FCoE Virtual FC HBA
 501      Firmware Version: N/A
 502      FCode/BIOS Version: N/A
 503      Serial Number: N/A
 504      Driver Name: COMSTAR FCOET
 505      Driver Version: 1.0
 506      Type: F-port
 507      State: online
 508      Supported Speeds: 1Gb 10Gb
 509      Current Speed: 10Gb
 510      Node WWN: 100000144fc2d509
 511 .fi
 512 .in -2
 513 .sp
 514
 515 .LP
 516 \fBExample 3 \fRListing HBA Ports and Link Statistics
 517 .sp
 518 .LP
 519 The following command lists information for the \fBHBA\fR ports and the link
 520 statistics for those ports:
 521
 522 .sp
 523 .in +2
 524 .nf
 525 # \fBfcinfo hba-port -l 210000e08b074cb5 210100e08b274cb5\fR
 526
 527 HBA Port WWN: 210000e08b074cb5
 528         Port Mode: Initiator
 529         OS Device Name: /dev/cfg/c1
 530         Manufacturer: QLogic Corp.
 531         Model: 375-3108-xx
 532         Firmware Version: 3.3.116
 533         FCode/BIOS Version: 1.13.08
 534         Serial Number: 0402F00-0549112808
 535         Driver Name: qlc
 536         Driver Version: 20070212-2.19
 537         Type: N-port
 538         State: online
 539         Supported Speeds: 1Gb 2Gb
 540         Current Speed: 2Gb
 541         Node WWN: 200000e08b074cb5
 542         Link Error Statistics:
 543                 Link Failure Count: 0
 544                 Loss of Sync Count: 0
 545                 Loss of Signal Count: 0
 546                 Primitive Seq Protocol Error Count: 0
 547                 Invalid Tx Word Count: 0
 548                 Invalid CRC Count: 0
 549 HBA Port WWN: 210100e08b274cb5
 550         Port Mode: Initiator
 551         OS Device Name: /dev/cfg/c2
 552         Manufacturer: QLogic Corp.
 553         Model: 375-3108-xx
 554         Firmware Version: 3.3.116
 555         FCode/BIOS Version: 1.13.08
 556         Serial Number: 0402F00-0549112808
 557         Driver Name: qlc
 558         Driver Version: 20070212-2.19
 559         Type: N-port
 560         State: online
 561         Supported Speeds: 1Gb 2Gb
 562         Current Speed: 2Gb
 563         Node WWN: 200100e08b274cb5
 564         Link Error Statistics:
 565                 Link Failure Count: 0
 566                 Loss of Sync Count: 0
 567                 Loss of Signal Count: 0
 568                 Primitive Seq Protocol Error Count: 0
 569                 Invalid Tx Word Count: 0
 570                 Invalid CRC Count: 0
 571 .fi
 572 .in -2
 573 .sp
 574
 575 .LP
 576 \fBExample 4 \fRListing All Remote Ports
 577 .sp
 578 .LP
 579 The following command lists all remote ports that are visible through the given
 580 \fBHBA\fR port:
 581
 582 .sp
 583 .in +2
 584 .nf
 585 # \fBfcinfo remote-port -p 210100e08b274cb5\fR
 586
 587 Remote Port WWN: 50020f230000b4af
 588         Active FC4 Types: SCSI
 589         SCSI Target: yes
 590         Port Symbolic Name: unknown
 591         Node WWN: 50020f200000b4af
 592 Remote Port WWN: 210000e08b07daa6
 593         Active FC4 Types: SCSI
 594         SCSI Target: no
 595         Port Symbolic Name: unknown
 596         Node WWN: 200000e08b07daa6
 597 Remote Port WWN: 20030003ba27c788
 598         Active FC4 Types: SCSI
 599         SCSI Target: yes
 600         Port Symbolic Name: unknown
 601         Node WWN: 10000003ba27c788
 602 Remote Port WWN: 210000e08b096a60
 603         Active FC4 Types: SCSI,IP
 604         SCSI Target: no
 605         Port Symbolic Name: unknown
 606         Node WWN: 200000e08b096a60
 607 .fi
 608 .in -2
 609 .sp
 610
 611 .LP
 612 \fBExample 5 \fRListing Remote Ports and Link Statistics
 613 .sp
 614 .LP
 615 The following command lists information for the remote ports and the link
 616 statistics for those ports:
 617
 618 .sp
 619 .in +2
 620 .nf
 621 # \fBfcinfo remote-port -l -p 210100e08b272ab5\fR
 622
 623 Remote Port WWN: 210100e08b296a60
 624         Active FC4 Types: SCSI,IP
 625         SCSI Target: no
 626         Port Symbolic Name: unknown
 627         Node WWN: 200100e08b296a60
 628         Link Error Statistics:
 629                 Link Failure Count: 0
 630                 Loss of Sync Count: 0
 631                 Loss of Signal Count: 0
 632                 Primitive Seq Protocol Error Count: 0
 633                 Invalid Tx Word Count: 0
 634                 Invalid CRC Count: 0
 635 Remote Port WWN: 20030003ba27d56d
 636         Active FC4 Types: SCSI
 637         SCSI Target: yes
 638         Port Symbolic Name: unknown
 639         Node WWN: 10000003ba27d56d
 640         Link Error Statistics:
 641                 Link Failure Count: 0
 642                 Loss of Sync Count: 4765165
 643                 Loss of Signal Count: 4765165
 644                 Primitive Seq Protocol Error Count: 0
 645                 Invalid Tx Word Count: 0
 646                 Invalid CRC Count: 0
 647 Remote Port WWN: 210100e08b27f7a6
 648         Active FC4 Types: SCSI
 649         SCSI Target: no
 650         Port Symbolic Name: unknown
 651         Node WWN: 200100e08b27f7a6
 652         Link Error Statistics:
 653                 Link Failure Count: 0
 654                 Loss of Sync Count: 0
 655                 Loss of Signal Count: 0
 656                 Primitive Seq Protocol Error Count: 0
 657                 Invalid Tx Word Count: 0
 658                 Invalid CRC Count: 0
 659 Remote Port WWN: 50020f230000b897
 660         Active FC4 Types: SCSI
 661         SCSI Target: yes
 662         Port Symbolic Name: unknown
 663         Node WWN: 50020f200000b897
 664         Link Error Statistics:
 665                 Link Failure Count: 0
 666                 Loss of Sync Count: 7
 667                 Loss of Signal Count: 7
 668                 Primitive Seq Protocol Error Count: 0
 669                 Invalid Tx Word Count: 0
 670                 Invalid CRC Count: 0
 671 Remote Port WWN: 210100e08b27daa6
 672         Active FC4 Types: SCSI
 673         SCSI Target: no
 674         Port Symbolic Name: unknown
 675         Node WWN: 200100e08b27daa6
 676         Link Error Statistics:
 677                 Link Failure Count: 0
 678                 Loss of Sync Count: 0
 679                 Loss of Signal Count: 0
 680                 Primitive Seq Protocol Error Count: 0
 681                 Invalid Tx Word Count: 0
 682                 Invalid CRC Count: 0
 683 Remote Port WWN: 210000e08b074cb5
 684         Active FC4 Types: SCSI,IP
 685         SCSI Target: no
 686         Port Symbolic Name: unknown
 687         Node WWN: 200000e08b074cb5
 688         Link Error Statistics:
 689                 Link Failure Count: 0
 690                 Loss of Sync Count: 0
 691                 Loss of Signal Count: 0
 692                 Primitive Seq Protocol Error Count: 0
 693                 Invalid Tx Word Count: 0
 694                 Invalid CRC Count: 0
 695 Remote Port WWN: 210100e08b296060
 696         Active FC4 Types: SCSI
 697         SCSI Target: no
 698         Port Symbolic Name: unknown
 699         Node WWN: 200100e08b296060
 700         Link Error Statistics:
 701                 Link Failure Count: 0
 702                 Loss of Sync Count: 0
 703                 Loss of Signal Count: 0
 704                 Primitive Seq Protocol Error Count: 0
 705                 Invalid Tx Word Count: 0
 706                 Invalid CRC Count: 0
 707 .fi
 708 .in -2
 709 .sp
 710
 711 .LP
 712 \fBExample 6 \fRListing All SCSI Targets and Link Statistics
 713 .sp
 714 .LP
 715 The following command lists all remote ports as well as the link statistics and
 716 \fIscsi-target\fR information:
 717
 718 .sp
 719 .in +2
 720 .nf
 721 # \fBfcinfo remote-port  -sl -p 210100e08b272ab5\fR
 722
 723 Remote Port WWN: 210100e08b296a60
 724         Active FC4 Types: SCSI,IP
 725         SCSI Target: no
 726         Port Symbolic Name: unknown
 727         Node WWN: 200100e08b296a60
 728         Link Error Statistics:
 729                 Link Failure Count: 0
 730                 Loss of Sync Count: 0
 731                 Loss of Signal Count: 0
 732                 Primitive Seq Protocol Error Count: 0
 733                 Invalid Tx Word Count: 0
 734                 Invalid CRC Count: 0
 735 Remote Port WWN: 20030003ba27d56d
 736         Active FC4 Types: SCSI
 737         SCSI Target: yes
 738         Port Symbolic Name: unknown
 739         Node WWN: 10000003ba27d56d
 740         Link Error Statistics:
 741                 Link Failure Count: 0
 742                 Loss of Sync Count: 4765165
 743                 Loss of Signal Count: 4765165
 744                 Primitive Seq Protocol Error Count: 0
 745                 Invalid Tx Word Count: 0
 746                 Invalid CRC Count: 0
 747         LUN: 0
 748           Vendor: SUN
 749           Product: T4
 750           OS Device Name: /dev/rdsk/c4t20030003BA27D56Dd0s2
 751         LUN: 1
 752           Vendor: SUN
 753           Product: T4
 754           OS Device Name: /dev/rdsk/c4t20030003BA27D56Dd1s2
 755 Remote Port WWN: 210100e08b27f7a6
 756         Active FC4 Types: SCSI
 757         SCSI Target: no
 758         Port Symbolic Name: unknown
 759         Node WWN: 200100e08b27f7a6
 760         Link Error Statistics:
 761                 Link Failure Count: 0
 762                 Loss of Sync Count: 0
 763                 Loss of Signal Count: 0
 764                 Primitive Seq Protocol Error Count: 0
 765                 Invalid Tx Word Count: 0
 766                 Invalid CRC Count: 0
 767 Remote Port WWN: 50020f230000b897
 768         Active FC4 Types: SCSI
 769         SCSI Target: yes
 770         Port Symbolic Name: unknown
 771         Node WWN: 50020f200000b897
 772         Link Error Statistics:
 773                 Link Failure Count: 0
 774                 Loss of Sync Count: 7
 775                 Loss of Signal Count: 7
 776                 Primitive Seq Protocol Error Count: 0
 777                 Invalid Tx Word Count: 0
 778                 Invalid CRC Count: 0
 779         LUN: 0
 780           Vendor: SUN
 781           Product: T300
 782           OS Device Name: Unknown
 783         LUN: 1
 784           Vendor: SUN
 785           Product: T300
 786           OS Device Name: /dev/rdsk/c4t50020F230000B897d1s2
 787         LUN: 2
 788           Vendor: SUN
 789           Product: T300
 790           OS Device Name: /dev/rdsk/c4t50020F230000B897d2s2
 791         LUN: 3
 792           Vendor: SUN
 793           Product: T300
 794           OS Device Name: /dev/rdsk/c4t50020F230000B897d3s2
 795         LUN: 4
 796           Vendor: SUN
 797           Product: T300
 798           OS Device Name: /dev/rdsk/c4t50020F230000B897d4s2
 799         LUN: 5
 800           Vendor: SUN
 801           Product: T300
 802           OS Device Name: /dev/rdsk/c4t50020F230000B897d5s2
 803         LUN: 6
 804           Vendor: SUN
 805           Product: T300
 806           OS Device Name: /dev/rdsk/c4t50020F230000B897d6s2
 807         LUN: 7
 808           Vendor: SUN
 809           Product: T300
 810           OS Device Name: /dev/rdsk/c4t50020F230000B897d7s2
 811         LUN: 8
 812           Vendor: SUN
 813           Product: T300
 814           OS Device Name: /dev/rdsk/c4t50020F230000B897d8s2
 815         LUN: 9
 816           Vendor: SUN
 817           Product: T300
 818           OS Device Name: /dev/rdsk/c4t50020F230000B897d9s2
 819         LUN: 10
 820           Vendor: SUN
 821           Product: T300
 822           OS Device Name: /dev/rdsk/c4t50020F230000B897d10s2
 823         LUN: 11
 824           Vendor: SUN
 825           Product: T300
 826           OS Device Name: /dev/rdsk/c4t50020F230000B897d11s2
 827         LUN: 12
 828           Vendor: SUN
 829           Product: T300
 830           OS Device Name: /dev/rdsk/c4t50020F230000B897d12s2
 831         LUN: 13
 832           Vendor: SUN
 833           Product: T300
 834           OS Device Name: /dev/rdsk/c4t50020F230000B897d13s2
 835         LUN: 14
 836           Vendor: SUN
 837           Product: T300
 838           OS Device Name: /dev/rdsk/c4t50020F230000B897d14s2
 839         LUN: 15
 840           Vendor: SUN
 841           Product: T300
 842           OS Device Name: /dev/rdsk/c4t50020F230000B897d15s2
 843 Remote Port WWN: 210100e08b27daa6
 844         Active FC4 Types: SCSI
 845         SCSI Target: no
 846         Port Symbolic Name: unknown
 847         Node WWN: 200100e08b27daa6
 848         Link Error Statistics:
 849                 Link Failure Count: 0
 850                 Loss of Sync Count: 0
 851                 Loss of Signal Count: 0
 852                 Primitive Seq Protocol Error Count: 0
 853                 Invalid Tx Word Count: 0
 854                 Invalid CRC Count: 0
 855 Remote Port WWN: 210000e08b074cb5
 856         Active FC4 Types: SCSI,IP
 857         SCSI Target: no
 858         Port Symbolic Name: unknown
 859         Node WWN: 200000e08b074cb5
 860         Link Error Statistics:
 861                 Link Failure Count: 0
 862                 Loss of Sync Count: 0
 863                 Loss of Signal Count: 0
 864                 Primitive Seq Protocol Error Count: 0
 865                 Invalid Tx Word Count: 0
 866                 Invalid CRC Count: 0
 867 Remote Port WWN: 210100e08b296060
 868         Active FC4 Types: SCSI
 869         SCSI Target: no
 870         Port Symbolic Name: unknown
 871         Node WWN: 200100e08b296060
 872         Link Error Statistics:
 873                 Link Failure Count: 0
 874                 Loss of Sync Count: 0
 875                 Loss of Signal Count: 0
 876                 Primitive Seq Protocol Error Count: 0
 877                 Invalid Tx Word Count: 0
 878                 Invalid CRC Count: 0
 879 .fi
 880 .in -2
 881 .sp
 882
 883 .LP
 884 \fBExample 7 \fRListing SCSI Target Information
 885 .sp
 886 .LP
 887 The following command lists all remote ports as well as the \fIscsi-target\fR
 888 information:
 889
 890 .sp
 891 .in +2
 892 .nf
 893 # \fBfcinfo remote-port  -s -p 210100e08b272ab5\fR
 894
 895 Remote Port WWN: 210100e08b296a60
 896         Active FC4 Types: SCSI,IP
 897         SCSI Target: no
 898         Port Symbolic Name: unknown
 899         Node WWN: 200100e08b296060
 900 Remote Port WWN: 20030003ba27d56d
 901         Active FC4 Types: SCSI
 902         SCSI Target: yes
 903         Port Symbolic Name: unknown
 904         Node WWN: 10000003ba27d56d
 905         LUN: 0
 906           Vendor: SUN
 907           Product: T4
 908           OS Device Name: /dev/rdsk/c4t20030003BA27D56Dd0s2
 909         LUN: 1
 910           Vendor: SUN
 911           Product: T4
 912           OS Device Name: /dev/rdsk/c4t20030003BA27D56Dd1s2
 913 Remote Port WWN: 210100e08b27f7a6
 914         Active FC4 Types: SCSI
 915         SCSI Target: no
 916         Port Symbolic Name: unknown
 917         Node WWN: 200100e08b27f7a6
 918 Remote Port WWN: 50020f230000b897
 919         Active FC4 Types: SCSI
 920         SCSI Target: yes
 921         Port Symbolic Name: unknown
 922         Node WWN: 50020f200000b897
 923         LUN: 0
 924           Vendor: SUN
 925           Product: T300
 926           OS Device Name: Unknown
 927         LUN: 1
 928           Vendor: SUN
 929           Product: T300
 930           OS Device Name: /dev/rdsk/c4t50020F230000B897d1s2
 931         LUN: 2
 932           Vendor: SUN
 933           Product: T300
 934           OS Device Name: /dev/rdsk/c4t50020F230000B897d2s2
 935         LUN: 3
 936           Vendor: SUN
 937           Product: T300
 938           OS Device Name: /dev/rdsk/c4t50020F230000B897d3s2
 939         LUN: 4
 940           Vendor: SUN
 941           Product: T300
 942           OS Device Name: /dev/rdsk/c4t50020F230000B897d4s2
 943         LUN: 5
 944           Vendor: SUN
 945           Product: T300
 946           OS Device Name: /dev/rdsk/c4t50020F230000B897d5s2
 947         LUN: 6
 948           Vendor: SUN
 949           Product: T300
 950           OS Device Name: /dev/rdsk/c4t50020F230000B897d6s2
 951         LUN: 7
 952           Vendor: SUN
 953           Product: T300
 954           OS Device Name: /dev/rdsk/c4t50020F230000B897d7s2
 955         LUN: 8
 956           Vendor: SUN
 957           Product: T300
 958           OS Device Name: /dev/rdsk/c4t50020F230000B897d8s2
 959         LUN: 9
 960           Vendor: SUN
 961           Product: T300
 962           OS Device Name: /dev/rdsk/c4t50020F230000B897d9s2
 963         LUN: 10
 964           Vendor: SUN
 965           Product: T300
 966           OS Device Name: /dev/rdsk/c4t50020F230000B897d10s2
 967         LUN: 11
 968           Vendor: SUN
 969           Product: T300
 970           OS Device Name: /dev/rdsk/c4t50020F230000B897d11s2
 971         LUN: 12
 972           Vendor: SUN
 973           Product: T300
 974           OS Device Name: /dev/rdsk/c4t50020F230000B897d12s2
 975         LUN: 13
 976           Vendor: SUN
 977           Product: T300
 978           OS Device Name: /dev/rdsk/c4t50020F230000B897d13s2
 979         LUN: 14
 980           Vendor: SUN
 981           Product: T300
 982           OS Device Name: /dev/rdsk/c4t50020F230000B897d14s2
 983         LUN: 15
 984           Vendor: SUN
 985           Product: T300
 986           OS Device Name: /dev/rdsk/c4t50020F230000B897d15s2
 987 Remote Port WWN: 210100e08b27daa6
 988         Active FC4 Types: SCSI
 989         SCSI Target: no
 990         Port Symbolic Name: unknown
 991         Node WWN: 200100e08b27daa6
 992 Remote Port WWN: 210000e08b074cb5
 993         Active FC4 Types: SCSI,IP
 994         SCSI Target: no
 995         Port Symbolic Name: unknown
 996         Node WWN: 200000e08b074cb5
 997 Remote Port WWN: 210100e08b296060
 998         Active FC4 Types: SCSI
 999         SCSI Target: no
1000         Port Symbolic Name: unknown
1001         Node WWN: 200100e08b296060
1002 .fi
1003 .in -2
1004 .sp
1005
1006 .LP
1007 \fBExample 8 \fRListing the Logical Unit
1008 .sp
1009 .LP
1010 The following command lists the logical unit:
1011
1012 .sp
1013 .in +2
1014 .nf
1015 # \fBfcinfo logical-unit\fR
1016
1017 /dev/rdsk/c0t600C0FF0000000000036223AE73EB705d0s2
1018 /dev/rdsk/c0t600C0FF00000000000362272539E5B03d0s2
1019 /dev/rmt/0n
1020 .fi
1021 .in -2
1022 .sp
1023
1024 .LP
1025 \fBExample 9 \fRDisplaying Additional Information for the Logical Unit
1026 .sp
1027 .LP
1028 The following command displays additional information about the logical unit
1029 using the \fB-v\fR option for device \fB/dev/rmt/On\fR:
1030
1031 .sp
1032 .in +2
1033 .nf
1034 # \fBfcinfo lu -v /dev/rmt/On\fR
1035
1036  OS Device Name: /dev/rmt/0n
1037         HBA Port WWN: 210000e07c030b91
1038                       Remote Port WWN: 21010003b7830a6
1039                        LUN: 0
1040         Vendor: STK
1041         Product: 9940A
1042         Device Type: Tape device
1043 .fi
1044 .in -2
1045 .sp
1046
1047 .sp
1048 .LP
1049 The following command displays additional information about the logical unit
1050 using the \fB-v\fR option for device
1051 \fB/dev/rdsk/c0t600C0FF0000000000036223AE73EB705d0s2\fR
1052
1053 .sp
1054 .in +2
1055 .nf
1056 # \fBfcinfo logical-unit -v \e\fR
1057      \fB/dev/rdsk/c0t600C0FF0000000000036223AE73EB705d0s2\fR
1058
1059  OS Device Name: /dev/rdsk/c0t600C0FF0000000000036223AE73EB705d0s2
1060         HBA Port WWN: 210100e08b27a8a1
1061                 Remote Port WWN: 256000c0ffc03622
1062                         LUN: 0
1063                 Remote Port WWN: 216000c0ff803622
1064                         LUN: 0
1065         HBA Port WWN: 210000e08b07a8a1
1066                 Remote Port WWN: 256000c0ffc03622
1067                         LUN: 0
1068                 Remote Port WWN: 216000c0ff803622
1069                         LUN: 0
1070         Vendor: SUN
1071         Product: StorEdge 3510
1072         Device Type: Disk device
1073 .fi
1074 .in -2
1075 .sp
1076
1077 .LP
1078 \fBExample 10 \fRAdding an NIPV Port
1079 .sp
1080 .LP
1081 The following command adds an NPIV port to the HBA with a port name:
1082
1083 .sp
1084 .in +2
1085 .nf
1086 210000e08b170f1c
1087 .fi
1088 .in -2
1089 .sp
1090
1091 .sp
1092 .LP
1093 The NPIV port has a port name of \fB2000000000000001\fR and a node name of
1094 \fB2100000000000001\fR.
1095
1096 .sp
1097 .in +2
1098 .nf
1099 # \fBfcadm create-npiv-port  -p 2000000000000001 -n 2100000000000001 \e
1100 210000e08b170f1c\fR
1101
1102 Created NPIV Port:
1103     HBA Port WWN: 2000000000000001
1104     Node WWN: 2100000000000001
1105     Physical HBA Port WWN: 210000e08b170f1c
1106 .fi
1107 .in -2
1108 .sp
1109
1110 .LP
1111 \fBExample 11 \fRAdding an NIPV Port with Random WWN
1112 .sp
1113 .LP
1114 The following command adds an NPIV port to the HBA with a randomly assigned
1115 port name of \fB210000e08b170f1c\fR.
1116
1117 .sp
1118 .in +2
1119 .nf
1120 # \fBfcadm create-npiv-port 210000e08b170f1c\fR
1121
1122 Created NPIV Port:
1123     HBA Port WWN: 2038295824942801
1124     Node WWN: 2100392849248001
1125     Physical HBA Port WWN: 210000e08b170f1c
1126 .fi
1127 .in -2
1128 .sp
1129
1130 .LP
1131 \fBExample 12 \fRDeleting an NIPV Port
1132 .sp
1133 .LP
1134 The following command deletes an NPIV port.
1135
1136 .sp
1137 .in +2
1138 .nf
1139 # \fBfcadm delete-npiv-port -p 2000000000000001 -w 2100000000000001 \e
1140 210000e08b170f1c\fR
1141 .fi
1142 .in -2
1143 .sp
1144
1145 .LP
1146 \fBExample 13 \fRCreating an FCoE Target Port
1147 .sp
1148 .LP
1149 The following command creates an FCoE port associated with the MAC interface
1150 \fBnxge0\fR.
1151
1152 .sp
1153 .in +2
1154 .nf
1155 # \fBfcadm create-fcoe-port -t nxge0\fR
1156 .fi
1157 .in -2
1158 .sp
1159
1160 .LP
1161 \fBExample 14 \fRDeleting an FCoE Port
1162 .sp
1163 .LP
1164 The following command deletes the FCoE port associated with the MAC interface
1165 \fBnxge0\fR.
1166
1167 .sp
1168 .in +2
1169 .nf
1170 # \fBfcadm delete-fcoe-port -t nxge0\fR
1171 .fi
1172 .in -2
1173 .sp
1174
1175 .LP
1176 \fBExample 15 \fRListing Information for an FCoE Port
1177 .sp
1178 .LP
1179 The following command lists information for FCoE ports.
1180
1181 .sp
1182 .in +2
1183 .nf
1184 # \fBfcadm list-fcoe-ports\fR
1185 HBA Port WWN: 200000144fc2d508
1186         Port Type: Target
1187         MAC Name: nxge0
1188         MTU Size: 9194
1189         MAC Factory Address: 00144fc2d508
1190         MAC Current Address: 00144fc2d508
1191 HBA Port WWN: 200000144fc2d509
1192         Port Type: Target
1193         MAC Name: nxge1
1194         MTU Size: 9194
1195         MAC Factory Address: 00144fc2d509
1196         MAC Current Address: 00144fc2d509
1197 .fi
1198 .in -2
1199 .sp
1200
1201 .LP
1202 \fBExample 16 \fRReinitializing the Link of an FC Port
1203 .sp
1204 .LP
1205 The following command forces the link connected with the port
1206 \fB200000144fc2d508\fR to reinitialize.
1207
1208 .sp
1209 .in +2
1210 .nf
1211 # \fBfcadm force-lip 200000144fc2d508\fR
1212 .fi
1213 .in -2
1214 .sp
1215
1216 .SH ATTRIBUTES
1217 .sp
1218 .LP
1219 See \fBattributes\fR(5) for descriptions of the following attributes:
1220 .sp
1221
1222 .sp
1223 .TS
1224 box;
1225 c | c
1226 l | l .
1227 ATTRIBUTE TYPE  ATTRIBUTE VALUE
1228 _
1229 Interface Stability     Committed
1230 .TE
1231
1232 .SH SEE ALSO
1233 .sp
1234 .LP
1235 \fBattributes\fR(5)
1236 .SH ERROR MESSAGES
1237 .sp
1238 .LP
1239 Errors that can occur in addition to the errors normally associated with system
1240 administration commands:
1241 .RS +4
1242 .TP
1243 .ie t \(bu
1244 .el o
1245 \fB\fIHBA_port_WWN\fR: not found\fR
1246 .RE
1247 .RS +4
1248 .TP
1249 .ie t \(bu
1250 .el o
1251 \fB\fIRemote_port_WWN\fR: not found\fR
1252 .RE
1253 .RS +4
1254 .TP
1255 .ie t \(bu
1256 .el o
1257 \fB\fIHBA_port_WWN\fR: NPIV not supported on this HBA\fR
1258 .RE