1fcinfo(1M)              System Administration Commands              fcinfo(1M)
2
3
4

NAME

6       fcinfo, fcadm - Fibre Channel HBA Port Command Line Interface
7

SYNOPSIS

9       fcinfo hba-port [-lite] [HBA_port_WWN]...
10
11
12       fcadm hba-port [-lite] [HBA_port_WWN]...
13
14
15       fcinfo remote-port [-ls] [-p HBA_port_WWN]
16            [REMOTE_port_WWN]...
17
18
19       fcadm remote-port [-ls] [-p HBA_port_WWN]
20            [REMOTE_port_WWN]...
21
22
23       fcinfo logical-unit | lu [-v] [OS device_path]
24
25
26       fcadm logical-unit | lu [-v] [OS device_path]
27
28
29       fcadm create-npiv-port -p Virtual_Port_WWN [-n Virtual_Node_WWN]
30            PhysicalPort_port_WWN
31
32
33       fcadm delete-npiv-port -p Virtual_Port_WWN [-n Virtual_Node_WWN]
34            PhysicalPort_port_WWN
35
36
37       fcadm create-fcoe-port [-tf] -p Port_WWN [-n Node_WWN]
38            MAC_Interface
39
40
41       fcadm delete-fcoe-port MAC_Interface
42
43
44       fcadm list-fcoe-ports MAC_Interface
45
46
47       fcadm force-lip Port_WWN
48
49
50       fcinfo [-V]
51
52
53       fcadm [-V]
54
55
56       fcinfo [-?]
57
58
59       fcadm [-?]
60
61

DESCRIPTION

63       fcinfo  and  fcadm are command line interfaces that collect administra‐
64       tive information on fibre channel host bus adapter  (HBA)  ports  on  a
65       host. They also collect data on any fibre channel targets that might be
66       connected to those ports in a Storage Area Network (SAN).
67
68
69       A port can be either in initiator mode or  target  mode.  The  same  FC
70       attribute  information  and remote port information are applied to both
71       the initiator and the target modes port except that SCSI-related opera‐
72       tions described below do not apply for the target mode port.
73
74   SUBCOMMANDS
75       The following subcommands are supported by both fcinfo and fcadm:
76
77       hba-port             Lists  information  for the HBA port referenced by
78                            the specified HBA_port_WWN. If HBA_port_WWN is not
79                            specified,  all  initiator  mode  and  target mode
80                            fibre channel  HBA  ports  on  the  host  will  be
81                            listed.
82
83
84       remote-port          Lists the remote-port information for those remote
85                            ports that are specified. If no REMOTE_port_WWN is
86                            specified,  all  remote  ports  that  are  visible
87                            through HBA_port_WWN are listed.
88
89
90       logical-unit | lu    Lists the logical unit referenced by the specified
91                            device_path.  If device_path is not specified, all
92                            fibre channel logical units will be  listed.  This
93                            subcommand applies only to the initiator mode.
94
95
96
97       The  following  subcommands,  which administer N_Port ID Virtualization
98       (NPIV) HBA ports, are supported only by fcadm:
99
100       create-npiv-port
101
102           Create an NPIV virtual port on the specified adapter.
103
104
105       delete-npiv-port
106
107           Delete an NPIV virtual port.  This  delete  only  ports  create  by
108           fcadm.
109
110
111
112       The following subcommands, which administer Fibre Channel over Ethernet
113       (FCoE) ports, are supported only by fcadm:
114
115       create-fcoe-port
116
117           Creates a FCoE port associated with the given MAC interface and the
118           given Port_WWN/Node_WWN. If -p or -n is not specified, the Port WWN
119           or Node WWN will be generated automatically. If the  specified  MAC
120           interface  does  not support multiple unicast address, no FCoE port
121           will be created and you receive a message indicating that  you  can
122           add  an  -f option to force enabling promiscuous mode on the speci‐
123           fied MAC interface to enable FCoE.
124
125
126       delete-fcoe-port
127
128           Deletes the FCoE port associated with the specified MAC interface.
129
130
131       list-fcoe-ports
132
133           List information of FCoE ports.
134
135
136       force-lip
137
138           Force the link to reinitialize. When issuing  this  subcommand   on
139           the target port side, causes a reset of the target port. When issu‐
140           ing it from the host port side, resets the host port.  When  an  FC
141           switch  is  connected,  other  FC  ports in the SAN will get a RSCN
142           (Remote State Change Notification). Furthermore,  other  initiators
143           will  always  rediscover the port after this, and the FC login ses‐
144           sion will be established or reused. Also, I/Os will  be  continued.
145           This  command  is disruptive to I/Os, but it is not destructive, as
146           it does not cause any data loss.
147
148

OPTIONS

150       The following options are supported:
151
152       -e, --fcoe
153
154           Lists the information for all FCoE ports.
155
156
157       -f, --fcoe-promiscuous
158
159           Used with create-fcoe-port to create an FCoE port on a  MAC  inter‐
160           face  associated  with a NIC that does not support multiple unicast
161           address. Promiscuous mode will be enabled  for  the  specified  MAC
162           interface.
163
164
165       -l, --linkstat
166
167           Lists the link error statistics information for the port referenced
168           by the specified HBA_port_WWN or REMOTE_port_WWN.
169
170
171       -n HBA_node_WWN, --node HBA_node_WWN
172
173           When used with NPIV options, specify a virtual node  WWN.  If  used
174           with  create-npiv-port,  it  can be omitted, and a random based WWN
175           will be used. It is mandatory for delete-npiv-port.
176
177           When used with create-fcoe-port subcommand, specify  the  node  WWN
178           for  the  FCoE port. It can be omitted, in which case a WWN will be
179           generated based on the MAC address of the specified MAC interface.
180
181
182       -p HBA_port_WWN, --port HBA_port_WWN
183
184           Retrieve remote port information from the HBA_port_WWN of the local
185           HBA  port  on  the host. When used with the remote-port subcommand,
186           the -p option is mandatory.
187
188           When used with NPIV options, specify a virtual port  WWN.  If  used
189           with  create-npiv-port,  it  can be omitted, and a random based WWN
190           will be used. It is mandatory for delete-npiv-port.
191
192           When used with create-fcoe-port subcommand, specify  the  port  WWN
193           for  the  FCoE port. It can be omitted, in which case a WWN will be
194           generated based on the MAC address of the specified MAC interface.
195
196
197       -s, --scsi-target
198
199           Lists the SCSI target information for all remote ports the user has
200           asked  for. The -p, --port option must always be specified and must
201           be a valid HBA port on the host. This HBA port will be used as  the
202           initiator  for which to retrieve the SCSI level target information.
203           Note that this will only function  on  remote  port  fibre  channel
204           World-Wide  Names  that  support  an  FC4 type of SCSI. This option
205           applies only to an initiator mode port.
206
207
208       -t [HBA_node_WWN], -target [HBA_node_WWN]
209
210           Lists the information for the port with the target mode  referenced
211           by  the  specified HBA_node_WWN or all target mode ports discovered
212           in the host.
213
214           When used with create-fcoe-port, create a FCoE target mode port.
215
216
217       -v, --verbose
218
219           When used with the logical-unit subcommand, the -v  displays  addi‐
220           tional  information for the logical unit, including SCSI vendor and
221           product information and device type as well as  the  FC  World-Wide
222           names  for  the  local and remote fibre channel ports to which this
223           device is attached.
224
225
226       -V, --version
227
228           Displays the version information.
229
230
231       -?, --help
232
233           Displays the usage information.
234
235

EXAMPLES

237       Example 1 Listing All HBA Ports
238
239
240       The following command lists all initiator mode fibre channel HBA  ports
241       on the host:
242
243
244         # fcinfo hba-port
245
246         HBA Port WWN: 210000e08b074cb5
247                 Port Mode: Initiator
248                 OS Device Name: /dev/cfg/c1
249                 Manufacturer: QLogic Corp.
250                 Model: 375-3108-xx
251                 Firmware Version: 3.3.116
252                 FCode/BIOS Version: 1.13.08
253                 Serial Number: not available
254                 Driver Name: qlc
255                 Driver Version: 20070212-2.19
256                 Type: N-port
257                 State: online
258                 Supported Speeds: 1Gb 2Gb
259                 Current Speed: 2Gb
260                 Node WWN: 200000e08b074cb5
261         NPIV Port List:
262                 Virtual Port 1:
263                  Port WWN: 200000e08b074cb1
264                  Node WWN: 200000e08b074cb3
265         HBA Port WWN: 210100e08b274cb5
266                 Port Mode: Initiator
267                 OS Device Name: /dev/cfg/c2
268                 Manufacturer: QLogic Corp.
269                 Model: 375-3108-xx
270                 Firmware Version: 3.3.116
271                 FCode/BIOS Version: 1.13.08
272                 Serial Number: not available
273                 Driver Name: qlc
274                 Driver Version: 20070212-2.19
275                 Type: N-port
276                 State: online
277                 Supported Speeds: 1Gb 2Gb
278                 Current Speed: 2Gb
279                 Node WWN: 200100e08b274cb5
280         HBA Port WWN: 210000e08b072ab5
281                 Port Mode: Initiator
282                 OS Device Name: /dev/cfg/c3
283                 Manufacturer: QLogic Corp.
284                 Firmware Version: 3.3.116
285                 FCode/BIOS Version: 1.13.08
286                 Model: 375-3108-xx
287                 Serial Number: not available
288                 Driver Name: qlc
289                 Driver Version: 20070212-2.19
290                 Type: L-port
291                 State: online
292                 Supported Speeds: 1Gb 2Gb
293                 Current Speed: 2Gb
294                 Node WWN: 200000e08b072ab5
295         HBA Port WWN: 210100e08b272ab5
296                 Port Mode: Initiator
297                 OS Device Name: /dev/cfg/c4
298                 Manufacturer: QLogic Corp.
299                 Model: 375-3108-xx
300                 Firmware Version: 3.3.116
301                 FCode/BIOS Version: 1.13.08
302                 Serial Number: 0402F00-0549112808
303                 Driver Name: qlc
304                 Driver Version: 20070212-2.19
305                 Type: N-port
306                 State: online
307                 Supported Speeds: 1Gb 2Gb
308                 Current Speed: 2Gb
309                 Node WWN: 200100e08b272ab5
310
311
312
313       Example 2 Listing Target Mode HBA Ports
314
315
316       The  following command lists all target mode fibre channel HBA ports on
317       the host:
318
319
320         # fcinfo hba-port -t
321           HBA Port WWN: 210100e08bb09221
322              Port Mode: Target
323              Port ID: 10700
324              OS Device Name: Not Applicable
325              Manufacturer: QLogic Corp.
326              Model: d30ac7e0
327              Firmware Version: 4.0.109
328              FCode/BIOS Version: N/A
329              Type: F-port
330              State: online
331              Supported Speeds: not established
332              Current Speed: 2Gb
333              Node WWN: 200100e08bb09221
334           HBA Port WWN: 210000e08b909221
335              Port Mode: Target
336              Port ID: 10900
337              OS Device Name: Not Applicable
338              Manufacturer: QLogic Corp.
339              Model: d37ad1e0
340              Firmware Version: 4.0.109
341              FCode/BIOS Version: N/A
342              Type: F-port
343              State: online
344              Supported Speeds: not established
345              Current Speed: 2Gb
346              Node WWN: 200000e08b909221
347           HBA Port WWN: 200000144fc2d508
348              Port Mode: Target
349              Port ID: 9a0025
350              OS Device Name: Not Applicable
351              Manufacturer: Sun Microsystems, Inc.
352              Model: FCoE Virtual FC HBA
353              Firmware Version: N/A
354              FCode/BIOS Version: N/A
355              Serial Number: N/A
356              Driver Name: COMSTAR FCOET
357              Driver Version: 1.0
358              Type: F-port
359              State: online
360              Supported Speeds: 1Gb 10Gb
361              Current Speed: 10Gb
362              Node WWN: 100000144fc2d508
363           HBA Port WWN: 200000144fc2d509
364              Port Mode: Target
365              Port ID: 9a0023
366              OS Device Name: Not Applicable
367              Manufacturer: Sun Microsystems, Inc.
368              Model: FCoE Virtual FC HBA
369              Firmware Version: N/A
370              FCode/BIOS Version: N/A
371              Serial Number: N/A
372              Driver Name: COMSTAR FCOET
373              Driver Version: 1.0
374              Type: F-port
375              State: online
376              Supported Speeds: 1Gb 10Gb
377              Current Speed: 10Gb
378              Node WWN: 100000144fc2d509
379
380
381
382       Example 3 Listing HBA Ports and Link Statistics
383
384
385       The following command lists information for the HBA ports and the  link
386       statistics for those ports:
387
388
389         # fcinfo hba-port -l 210000e08b074cb5 210100e08b274cb5
390
391         HBA Port WWN: 210000e08b074cb5
392                 Port Mode: Initiator
393                 OS Device Name: /dev/cfg/c1
394                 Manufacturer: QLogic Corp.
395                 Model: 375-3108-xx
396                 Firmware Version: 3.3.116
397                 FCode/BIOS Version: 1.13.08
398                 Serial Number: 0402F00-0549112808
399                 Driver Name: qlc
400                 Driver Version: 20070212-2.19
401                 Type: N-port
402                 State: online
403                 Supported Speeds: 1Gb 2Gb
404                 Current Speed: 2Gb
405                 Node WWN: 200000e08b074cb5
406                 Link Error Statistics:
407                         Link Failure Count: 0
408                         Loss of Sync Count: 0
409                         Loss of Signal Count: 0
410                         Primitive Seq Protocol Error Count: 0
411                         Invalid Tx Word Count: 0
412                         Invalid CRC Count: 0
413         HBA Port WWN: 210100e08b274cb5
414                 Port Mode: Initiator
415                 OS Device Name: /dev/cfg/c2
416                 Manufacturer: QLogic Corp.
417                 Model: 375-3108-xx
418                 Firmware Version: 3.3.116
419                 FCode/BIOS Version: 1.13.08
420                 Serial Number: 0402F00-0549112808
421                 Driver Name: qlc
422                 Driver Version: 20070212-2.19
423                 Type: N-port
424                 State: online
425                 Supported Speeds: 1Gb 2Gb
426                 Current Speed: 2Gb
427                 Node WWN: 200100e08b274cb5
428                 Link Error Statistics:
429                         Link Failure Count: 0
430                         Loss of Sync Count: 0
431                         Loss of Signal Count: 0
432                         Primitive Seq Protocol Error Count: 0
433                         Invalid Tx Word Count: 0
434                         Invalid CRC Count: 0
435
436
437
438       Example 4 Listing All Remote Ports
439
440
441       The  following  command lists all remote ports that are visible through
442       the given HBA port:
443
444
445         # fcinfo remote-port -p 210100e08b274cb5
446
447         Remote Port WWN: 50020f230000b4af
448                 Active FC4 Types: SCSI
449                 SCSI Target: yes
450                 Port Symbolic Name: unknown
451                 Node WWN: 50020f200000b4af
452         Remote Port WWN: 210000e08b07daa6
453                 Active FC4 Types: SCSI
454                 SCSI Target: no
455                 Port Symbolic Name: unknown
456                 Node WWN: 200000e08b07daa6
457         Remote Port WWN: 20030003ba27c788
458                 Active FC4 Types: SCSI
459                 SCSI Target: yes
460                 Port Symbolic Name: unknown
461                 Node WWN: 10000003ba27c788
462         Remote Port WWN: 210000e08b096a60
463                 Active FC4 Types: SCSI,IP
464                 SCSI Target: no
465                 Port Symbolic Name: unknown
466                 Node WWN: 200000e08b096a60
467
468
469
470       Example 5 Listing Remote Ports and Link Statistics
471
472
473       The following command lists information for the remote  ports  and  the
474       link statistics for those ports:
475
476
477         # fcinfo remote-port -l -p 210100e08b272ab5
478
479         Remote Port WWN: 210100e08b296a60
480                 Active FC4 Types: SCSI,IP
481                 SCSI Target: no
482                 Port Symbolic Name: unknown
483                 Node WWN: 200100e08b296a60
484                 Link Error Statistics:
485                         Link Failure Count: 0
486                         Loss of Sync Count: 0
487                         Loss of Signal Count: 0
488                         Primitive Seq Protocol Error Count: 0
489                         Invalid Tx Word Count: 0
490                         Invalid CRC Count: 0
491         Remote Port WWN: 20030003ba27d56d
492                 Active FC4 Types: SCSI
493                 SCSI Target: yes
494                 Port Symbolic Name: unknown
495                 Node WWN: 10000003ba27d56d
496                 Link Error Statistics:
497                         Link Failure Count: 0
498                         Loss of Sync Count: 4765165
499                         Loss of Signal Count: 4765165
500                         Primitive Seq Protocol Error Count: 0
501                         Invalid Tx Word Count: 0
502                         Invalid CRC Count: 0
503         Remote Port WWN: 210100e08b27f7a6
504                 Active FC4 Types: SCSI
505                 SCSI Target: no
506                 Port Symbolic Name: unknown
507                 Node WWN: 200100e08b27f7a6
508                 Link Error Statistics:
509                         Link Failure Count: 0
510                         Loss of Sync Count: 0
511                         Loss of Signal Count: 0
512                         Primitive Seq Protocol Error Count: 0
513                         Invalid Tx Word Count: 0
514                         Invalid CRC Count: 0
515         Remote Port WWN: 50020f230000b897
516                 Active FC4 Types: SCSI
517                 SCSI Target: yes
518                 Port Symbolic Name: unknown
519                 Node WWN: 50020f200000b897
520                 Link Error Statistics:
521                         Link Failure Count: 0
522                         Loss of Sync Count: 7
523                         Loss of Signal Count: 7
524                         Primitive Seq Protocol Error Count: 0
525                         Invalid Tx Word Count: 0
526                         Invalid CRC Count: 0
527         Remote Port WWN: 210100e08b27daa6
528                 Active FC4 Types: SCSI
529                 SCSI Target: no
530                 Port Symbolic Name: unknown
531                 Node WWN: 200100e08b27daa6
532                 Link Error Statistics:
533                         Link Failure Count: 0
534                         Loss of Sync Count: 0
535                         Loss of Signal Count: 0
536                         Primitive Seq Protocol Error Count: 0
537                         Invalid Tx Word Count: 0
538                         Invalid CRC Count: 0
539         Remote Port WWN: 210000e08b074cb5
540                 Active FC4 Types: SCSI,IP
541                 SCSI Target: no
542                 Port Symbolic Name: unknown
543                 Node WWN: 200000e08b074cb5
544                 Link Error Statistics:
545                         Link Failure Count: 0
546                         Loss of Sync Count: 0
547                         Loss of Signal Count: 0
548                         Primitive Seq Protocol Error Count: 0
549                         Invalid Tx Word Count: 0
550                         Invalid CRC Count: 0
551         Remote Port WWN: 210100e08b296060
552                 Active FC4 Types: SCSI
553                 SCSI Target: no
554                 Port Symbolic Name: unknown
555                 Node WWN: 200100e08b296060
556                 Link Error Statistics:
557                         Link Failure Count: 0
558                         Loss of Sync Count: 0
559                         Loss of Signal Count: 0
560                         Primitive Seq Protocol Error Count: 0
561                         Invalid Tx Word Count: 0
562                         Invalid CRC Count: 0
563
564
565
566       Example 6 Listing All SCSI Targets and Link Statistics
567
568
569       The  following  command lists all remote ports as well as the link sta‐
570       tistics and scsi-target information:
571
572
573         # fcinfo remote-port  -sl -p 210100e08b272ab5
574
575         Remote Port WWN: 210100e08b296a60
576                 Active FC4 Types: SCSI,IP
577                 SCSI Target: no
578                 Port Symbolic Name: unknown
579                 Node WWN: 200100e08b296a60
580                 Link Error Statistics:
581                         Link Failure Count: 0
582                         Loss of Sync Count: 0
583                         Loss of Signal Count: 0
584                         Primitive Seq Protocol Error Count: 0
585                         Invalid Tx Word Count: 0
586                         Invalid CRC Count: 0
587         Remote Port WWN: 20030003ba27d56d
588                 Active FC4 Types: SCSI
589                 SCSI Target: yes
590                 Port Symbolic Name: unknown
591                 Node WWN: 10000003ba27d56d
592                 Link Error Statistics:
593                         Link Failure Count: 0
594                         Loss of Sync Count: 4765165
595                         Loss of Signal Count: 4765165
596                         Primitive Seq Protocol Error Count: 0
597                         Invalid Tx Word Count: 0
598                         Invalid CRC Count: 0
599                 LUN: 0
600                   Vendor: SUN
601                   Product: T4
602                   OS Device Name: /dev/rdsk/c4t20030003BA27D56Dd0s2
603                 LUN: 1
604                   Vendor: SUN
605                   Product: T4
606                   OS Device Name: /dev/rdsk/c4t20030003BA27D56Dd1s2
607         Remote Port WWN: 210100e08b27f7a6
608                 Active FC4 Types: SCSI
609                 SCSI Target: no
610                 Port Symbolic Name: unknown
611                 Node WWN: 200100e08b27f7a6
612                 Link Error Statistics:
613                         Link Failure Count: 0
614                         Loss of Sync Count: 0
615                         Loss of Signal Count: 0
616                         Primitive Seq Protocol Error Count: 0
617                         Invalid Tx Word Count: 0
618                         Invalid CRC Count: 0
619         Remote Port WWN: 50020f230000b897
620                 Active FC4 Types: SCSI
621                 SCSI Target: yes
622                 Port Symbolic Name: unknown
623                 Node WWN: 50020f200000b897
624                 Link Error Statistics:
625                         Link Failure Count: 0
626                         Loss of Sync Count: 7
627                         Loss of Signal Count: 7
628                         Primitive Seq Protocol Error Count: 0
629                         Invalid Tx Word Count: 0
630                         Invalid CRC Count: 0
631                 LUN: 0
632                   Vendor: SUN
633                   Product: T300
634                   OS Device Name: Unknown
635                 LUN: 1
636                   Vendor: SUN
637                   Product: T300
638                   OS Device Name: /dev/rdsk/c4t50020F230000B897d1s2
639                 LUN: 2
640                   Vendor: SUN
641                   Product: T300
642                   OS Device Name: /dev/rdsk/c4t50020F230000B897d2s2
643                 LUN: 3
644                   Vendor: SUN
645                   Product: T300
646                   OS Device Name: /dev/rdsk/c4t50020F230000B897d3s2
647                 LUN: 4
648                   Vendor: SUN
649                   Product: T300
650                   OS Device Name: /dev/rdsk/c4t50020F230000B897d4s2
651                 LUN: 5
652                   Vendor: SUN
653                   Product: T300
654                   OS Device Name: /dev/rdsk/c4t50020F230000B897d5s2
655                 LUN: 6
656                   Vendor: SUN
657                   Product: T300
658                   OS Device Name: /dev/rdsk/c4t50020F230000B897d6s2
659                 LUN: 7
660                   Vendor: SUN
661                   Product: T300
662                   OS Device Name: /dev/rdsk/c4t50020F230000B897d7s2
663                 LUN: 8
664                   Vendor: SUN
665                   Product: T300
666                   OS Device Name: /dev/rdsk/c4t50020F230000B897d8s2
667                 LUN: 9
668                   Vendor: SUN
669                   Product: T300
670                   OS Device Name: /dev/rdsk/c4t50020F230000B897d9s2
671                 LUN: 10
672                   Vendor: SUN
673                   Product: T300
674                   OS Device Name: /dev/rdsk/c4t50020F230000B897d10s2
675                 LUN: 11
676                   Vendor: SUN
677                   Product: T300
678                   OS Device Name: /dev/rdsk/c4t50020F230000B897d11s2
679                 LUN: 12
680                   Vendor: SUN
681                   Product: T300
682                   OS Device Name: /dev/rdsk/c4t50020F230000B897d12s2
683                 LUN: 13
684                   Vendor: SUN
685                   Product: T300
686                   OS Device Name: /dev/rdsk/c4t50020F230000B897d13s2
687                 LUN: 14
688                   Vendor: SUN
689                   Product: T300
690                   OS Device Name: /dev/rdsk/c4t50020F230000B897d14s2
691                 LUN: 15
692                   Vendor: SUN
693                   Product: T300
694                   OS Device Name: /dev/rdsk/c4t50020F230000B897d15s2
695         Remote Port WWN: 210100e08b27daa6
696                 Active FC4 Types: SCSI
697                 SCSI Target: no
698                 Port Symbolic Name: unknown
699                 Node WWN: 200100e08b27daa6
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         Remote Port WWN: 210000e08b074cb5
708                 Active FC4 Types: SCSI,IP
709                 SCSI Target: no
710                 Port Symbolic Name: unknown
711                 Node WWN: 200000e08b074cb5
712                 Link Error Statistics:
713                         Link Failure Count: 0
714                         Loss of Sync Count: 0
715                         Loss of Signal Count: 0
716                         Primitive Seq Protocol Error Count: 0
717                         Invalid Tx Word Count: 0
718                         Invalid CRC Count: 0
719         Remote Port WWN: 210100e08b296060
720                 Active FC4 Types: SCSI
721                 SCSI Target: no
722                 Port Symbolic Name: unknown
723                 Node WWN: 200100e08b296060
724                 Link Error Statistics:
725                         Link Failure Count: 0
726                         Loss of Sync Count: 0
727                         Loss of Signal Count: 0
728                         Primitive Seq Protocol Error Count: 0
729                         Invalid Tx Word Count: 0
730                         Invalid CRC Count: 0
731
732
733
734       Example 7 Listing SCSI Target Information
735
736
737       The following command lists all remote ports as well as the scsi-target
738       information:
739
740
741         # fcinfo remote-port  -s -p 210100e08b272ab5
742
743         Remote Port WWN: 210100e08b296a60
744                 Active FC4 Types: SCSI,IP
745                 SCSI Target: no
746                 Port Symbolic Name: unknown
747                 Node WWN: 200100e08b296060
748         Remote Port WWN: 20030003ba27d56d
749                 Active FC4 Types: SCSI
750                 SCSI Target: yes
751                 Port Symbolic Name: unknown
752                 Node WWN: 10000003ba27d56d
753                 LUN: 0
754                   Vendor: SUN
755                   Product: T4
756                   OS Device Name: /dev/rdsk/c4t20030003BA27D56Dd0s2
757                 LUN: 1
758                   Vendor: SUN
759                   Product: T4
760                   OS Device Name: /dev/rdsk/c4t20030003BA27D56Dd1s2
761         Remote Port WWN: 210100e08b27f7a6
762                 Active FC4 Types: SCSI
763                 SCSI Target: no
764                 Port Symbolic Name: unknown
765                 Node WWN: 200100e08b27f7a6
766         Remote Port WWN: 50020f230000b897
767                 Active FC4 Types: SCSI
768                 SCSI Target: yes
769                 Port Symbolic Name: unknown
770                 Node WWN: 50020f200000b897
771                 LUN: 0
772                   Vendor: SUN
773                   Product: T300
774                   OS Device Name: Unknown
775                 LUN: 1
776                   Vendor: SUN
777                   Product: T300
778                   OS Device Name: /dev/rdsk/c4t50020F230000B897d1s2
779                 LUN: 2
780                   Vendor: SUN
781                   Product: T300
782                   OS Device Name: /dev/rdsk/c4t50020F230000B897d2s2
783                 LUN: 3
784                   Vendor: SUN
785                   Product: T300
786                   OS Device Name: /dev/rdsk/c4t50020F230000B897d3s2
787                 LUN: 4
788                   Vendor: SUN
789                   Product: T300
790                   OS Device Name: /dev/rdsk/c4t50020F230000B897d4s2
791                 LUN: 5
792                   Vendor: SUN
793                   Product: T300
794                   OS Device Name: /dev/rdsk/c4t50020F230000B897d5s2
795                 LUN: 6
796                   Vendor: SUN
797                   Product: T300
798                   OS Device Name: /dev/rdsk/c4t50020F230000B897d6s2
799                 LUN: 7
800                   Vendor: SUN
801                   Product: T300
802                   OS Device Name: /dev/rdsk/c4t50020F230000B897d7s2
803                 LUN: 8
804                   Vendor: SUN
805                   Product: T300
806                   OS Device Name: /dev/rdsk/c4t50020F230000B897d8s2
807                 LUN: 9
808                   Vendor: SUN
809                   Product: T300
810                   OS Device Name: /dev/rdsk/c4t50020F230000B897d9s2
811                 LUN: 10
812                   Vendor: SUN
813                   Product: T300
814                   OS Device Name: /dev/rdsk/c4t50020F230000B897d10s2
815                 LUN: 11
816                   Vendor: SUN
817                   Product: T300
818                   OS Device Name: /dev/rdsk/c4t50020F230000B897d11s2
819                 LUN: 12
820                   Vendor: SUN
821                   Product: T300
822                   OS Device Name: /dev/rdsk/c4t50020F230000B897d12s2
823                 LUN: 13
824                   Vendor: SUN
825                   Product: T300
826                   OS Device Name: /dev/rdsk/c4t50020F230000B897d13s2
827                 LUN: 14
828                   Vendor: SUN
829                   Product: T300
830                   OS Device Name: /dev/rdsk/c4t50020F230000B897d14s2
831                 LUN: 15
832                   Vendor: SUN
833                   Product: T300
834                   OS Device Name: /dev/rdsk/c4t50020F230000B897d15s2
835         Remote Port WWN: 210100e08b27daa6
836                 Active FC4 Types: SCSI
837                 SCSI Target: no
838                 Port Symbolic Name: unknown
839                 Node WWN: 200100e08b27daa6
840         Remote Port WWN: 210000e08b074cb5
841                 Active FC4 Types: SCSI,IP
842                 SCSI Target: no
843                 Port Symbolic Name: unknown
844                 Node WWN: 200000e08b074cb5
845         Remote Port WWN: 210100e08b296060
846                 Active FC4 Types: SCSI
847                 SCSI Target: no
848                 Port Symbolic Name: unknown
849                 Node WWN: 200100e08b296060
850
851
852
853       Example 8 Listing the Logical Unit
854
855
856       The following command lists the logical unit:
857
858
859         # fcinfo logical-unit
860
861         /dev/rdsk/c0t600C0FF0000000000036223AE73EB705d0s2
862         /dev/rdsk/c0t600C0FF00000000000362272539E5B03d0s2
863         /dev/rmt/0n
864
865
866
867       Example 9 Displaying Additional Information for the Logical Unit
868
869
870       The following command displays additional information about the logical
871       unit using the -v option for device /dev/rmt/On:
872
873
874         # fcinfo lu -v /dev/rmt/On
875
876          OS Device Name: /dev/rmt/0n
877                 HBA Port WWN: 210000e07c030b91
878                         Remote Port WWN: 21010003b7830a6
879                                LUN: 0
880                 Vendor: STK
881                 Product: 9940A
882                 Device Type: Tape device
883
884
885
886
887       The following command displays additional information about the logical
888       unit       using       the       -v       option       for       device
889       /dev/rdsk/c0t600C0FF0000000000036223AE73EB705d0s2
890
891
892         # fcinfo logical-unit -v \
893              /dev/rdsk/c0t600C0FF0000000000036223AE73EB705d0s2
894
895          OS Device Name: /dev/rdsk/c0t600C0FF0000000000036223AE73EB705d0s2
896                 HBA Port WWN: 210100e08b27a8a1
897                         Remote Port WWN: 256000c0ffc03622
898                                 LUN: 0
899                         Remote Port WWN: 216000c0ff803622
900                                 LUN: 0
901                 HBA Port WWN: 210000e08b07a8a1
902                         Remote Port WWN: 256000c0ffc03622
903                                 LUN: 0
904                         Remote Port WWN: 216000c0ff803622
905                                 LUN: 0
906                 Vendor: SUN
907                 Product: StorEdge 3510
908                 Device Type: Disk device
909
910
911
912       Example 10 Adding an NIPV Port
913
914
915       The following command adds an NPIV port to the HBA with a port name:
916
917
918         210000e08b170f1c
919
920
921
922
923       The NPIV port has a port name of 2000000000000001 and a  node  name  of
924       2100000000000001.
925
926
927         # fcadm create-npiv-port  -p 2000000000000001 -n 2100000000000001 \
928         210000e08b170f1c
929
930         Created NPIV Port:
931             HBA Port WWN: 2000000000000001
932             Node WWN: 2100000000000001
933             Physical HBA Port WWN: 210000e08b170f1c
934
935
936
937       Example 11 Adding an NIPV Port with Random WWN
938
939
940       The  following  command  adds  an  NPIV port to the HBA with a randomly
941       assigned port name of 210000e08b170f1c.
942
943
944         # fcadm create-npiv-port 210000e08b170f1c
945
946         Created NPIV Port:
947             HBA Port WWN: 2038295824942801
948             Node WWN: 2100392849248001
949             Physical HBA Port WWN: 210000e08b170f1c
950
951
952
953       Example 12 Deleting an NIPV Port
954
955
956       The following command deletes an NPIV port.
957
958
959         # fcadm delete-npiv-port -p 2000000000000001 -w 2100000000000001 \
960         210000e08b170f1c
961
962
963
964       Example 13 Creating an FCoE Target Port
965
966
967       The following command creates an FCoE  port  associated  with  the  MAC
968       interface nxge0.
969
970
971         # fcadm create-fcoe-port -t nxge0
972
973
974
975       Example 14 Deleting an FCoE Port
976
977
978       The  following  command  deletes  the FCoE port associated with the MAC
979       interface nxge0.
980
981
982         # fcadm delete-fcoe-port -t nxge0
983
984
985
986       Example 15 Listing Information for an FCoE Port
987
988
989       The following command lists information for FCoE ports.
990
991
992         # fcadm list-fcoe-ports
993         HBA Port WWN: 200000144fc2d508
994                 Port Type: Target
995                 MAC Name: nxge0
996                 MTU Size: 9194
997                 MAC Factory Address: 00144fc2d508
998                 MAC Current Address: 00144fc2d508
999         HBA Port WWN: 200000144fc2d509
1000                 Port Type: Target
1001                 MAC Name: nxge1
1002                 MTU Size: 9194
1003                 MAC Factory Address: 00144fc2d509
1004                 MAC Current Address: 00144fc2d509
1005
1006
1007
1008       Example 16 Reinitializing the Link of an FC Port
1009
1010
1011       The  following  command  forces  the  link  connected  with  the   port
1012       200000144fc2d508 to reinitialize.
1013
1014
1015         # fcadm force-lip 200000144fc2d508
1016
1017
1018

ATTRIBUTES

1020       See attributes(5) for descriptions of the following attributes:
1021
1022
1023
1024
1025       ┌─────────────────────────────┬─────────────────────────────┐
1026       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
1027       ├─────────────────────────────┼─────────────────────────────┤
1028       │Availability                 │SUNWfcprt                    │
1029       ├─────────────────────────────┼─────────────────────────────┤
1030       │Interface Stability          │Committed                    │
1031       └─────────────────────────────┴─────────────────────────────┘
1032

SEE ALSO

1034       attributes(5)
1035

ERROR MESSAGES

1037       Errors  that  can  occur  in addition to the errors normally associated
1038       with system administration commands:
1039
1040           o      HBA_port_WWN: not found
1041
1042           o      Remote_port_WWN: not found
1043
1044           o      HBA_port_WWN: NPIV not supported on this HBA
1045
1046
1047
1048SunOS 5.11                        26 Jul 2009                       fcinfo(1M)
Impressum