1FCPING(8)                       Open-FCoE Tools                      FCPING(8)
2
3
4

NAME

6       fcping - Fibre Channel Ping (ELS ECHO) tool
7

SYNOPSIS

9       fcping [-fqx] [ -i interval ] [ -c count ] [ -s size ] -h source target
10
11       source = interface | MAC | WWPN | FC-ID
12
13       target = -P WWPN | -N WWPN | -F FC-ID
14

DESCRIPTION

16       The  fcping command performs the Fibre Channel FC-LS-2 ECHO ELS command
17       and displays the reply. The max payload for fcping is 2108 bytes.  When
18       no -c is given, fcping will continue until user interrupts.
19

OPTIONS

21       -f
22           Flood ping
23
24       -q
25           Quiet! just print summary
26
27       -x
28           Hex dump of responses
29
30       -i interval
31           Wait interval seconds between each ping
32
33       -c count
34           Stop after sending count pings
35
36       -h source
37           Source is interface like ethX, MAC address, WWPN, or FC-ID
38
39       -s size
40           Byte-length of ping request payload (max 2108)
41
42       -F FC-ID
43           Destination port ID
44
45       -P WWPN
46           Destination world-wide port name
47
48       -N WWNN
49           Destination world-wide node name
50

EXAMPLES

52       Sends  ELS ECHO to Port FC-ID 0xbf0027 from interface n0.170 with max 3
53       pings.
54
55           fcping -c 3 -h n0.170 -F 0xbf0027
56
57           sending echo to 0xBF0027
58           echo    1 accepted                       16.170 ms
59           echo    2 accepted                        7.053 ms
60           echo    3 accepted                        6.803 ms
61           3 frames sent, 3 received 0 errors, 0.000% loss, avg. rt time 10.009 ms
62
63       Sends ELS ECHO to WWNN 0x1000001B213C9DDA from  interface  n0.170  with
64       max 3 pings and payload size 1500 bytes
65
66           fcping -c 3 -h n0.170 -s 1500 -N 0x1000001B213C9DDA
67
68           sending echo to 0xBF0027
69           echo    1 accepted                        6.597 ms
70           echo    2 accepted                        6.925 ms
71           echo    3 accepted                       12.419 ms
72           3 frames sent, 3 received 0 errors, 0.000% loss, avg. rt time 8.647 ms
73
74       Sends  ELS  ECHO  to  WWNN  0x1000001B213C9DDA  from  interface  n0.170
75       continuously with payload of 32 bytes and hex-dump  the  reply  to  the
76       screen
77
78           fcping -x -h n0.170 -s 32 -N 0x1000001B213C9DDA
79
80           sending echo to 0xBF0027
81           echo    1 accepted                        6.937 ms
82           response length 32
83                0 02000000 00000001 00010203 04050607
84               10 08090a0b 0c0d0e0f 10111213 14151617
85
86           echo    2 accepted                        6.923 ms
87           response length 32
88                0 02000000 00000002 00010203 04050607
89               10 08090a0b 0c0d0e0f 10111213 14151617
90
91           echo    3 accepted                       84.929 ms
92           response length 32
93                0 02000000 00000003 00010203 04050607
94               10 08090a0b 0c0d0e0f 10111213 14151617
95

SEE ALSO

97       fcoeadm(8)
98

SUPPORT

100       fcping  is  part  of  the  fcoe-utils  package,  maintained through the
101       Open-FCoE project. Resources for both developers and users can be found
102       at the Open-FCoE website http://open-fcoe.org/.
103
104
105
106Open-FCoE                         05/24/2011                         FCPING(8)