Brocade Fabric OS Command Reference Guide v6.1.0 (53-1000599-02, June 2008)

152 Fabric OS Command Reference
53-1000599-02
fcPing
2
fcPing
Sends a Fibre Channel Extended Link Service (ELS) Echo request to a pair of ports.
Synopsis fcping [-h -b -q][-n frames][-l length][-i wait][-p pattern] source destination
Description Use this command to perform a zoning check between the source and destination. In addition, two
Fibre Channel ELS requests are generated. The first ELS request is from the domain controller to
the source port identifier. The second ELS request is from the domain controller to the destination
port identifier. The ELS Echo request elicits an ELS Echo response from a port identifier in the
fabric and is useful for validating link connectivity.
The source and destination port identifiers can be specified as a 24-bit Fibre Channel port
identifiers, port World Wide Names, or node World Wide Names. The two port identifiers are then
used to determine if the identifiers are zoned together.
The ELS Echo requests contains a 24-byte Fibre Channel frame header, a 4-byte ELS Echo request
header, an 8-byte timestamp from getTimeOfDay, and an arbitrary number of bytes as specified by
-l length to fill out the request frame. The source identifier in the ELS Echo request is the domain
controller and the destination identifier is either source or destination.
The echo ELS may not be supported on all devices. In such cases, the response could be either an
ELS reject or a request timeout.
By default, fcPing sends five ELS Echo requests to each port. When a device does not respond to
the ELS Echo request, further debugging is necessary to determine whether the device does not
support ELS Echo or the request is rejected for some other reason. Do not assume that the device
is not FC-connected.
Operands This command has the following operands:
-h Causes the program to display the proper command line usage syntax
information and then terminate.
-b Specifies to bypass the zone check functionality.
-q Specifies quiet output. Only the zoning information and the summary line
display on program termination.
-n frames Specifies the number of ELS Echo requests to send.
-l length Specifies requests containing length bytes of data. The default is 0 bytes of
data. Without data, the Fibre Channel Echo request frame size is 12 bytes.
This byte count includes four bytes from the Echo request header and eight
bytes from the timestamp. The maximum allowed value is 2,036 bytes. The
length must be word-aligned.
-i wait Specifies the interval, in seconds, between successive ELS Echo requests.
The default is 0 seconds.
-p pattern Specifies up to 16 "pad" bytes, which are used to fill out the request frame
payload sent. This is useful for diagnosing data-dependent problems in the
fabric link. The pattern bytes are specified as hexadecimal characters. For
example, -p ff causes the request frame to be filled with all 1s.
source Specifies the source port ID, port WWN, or node WWN.
destination Specifies the destination port ID, port WWN, or node WWN.