Fcping - Brocade Communications Systems A7533A - Brocade 4Gb SAN Switch Base Command Reference Manual

fcPing

Sends a Fibre Channel Extended Link Service (ELS) Echo request to a pair of ports.
Synopsis fcping [-hbq][-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 request 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
identifiers. 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 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 comprise 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 might 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
understand if this is due to the device not supporting this ELS Echo request. Do not assume that
the device is not FC-connected.
The execution of this command is subject to Admin Domain restrictions that may be in place.
Operands This command has the following operands:
-n frames
-l length
-h
-i wait
-p pattern
-b
-q
source
Fabric OS Command Reference
53-1000599-01
Specifies the number of ELS Echo requests to send.
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 total
bytes. This is a combination of 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.
Causes the program to display the proper command line usage syntax
information and then terminate.
Specifies the interval, in seconds, between successive ELS Echo requests.
The default is 0 seconds.
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.
Specifies to bypass the zone check functionality.
Specifies quiet output. Only the zoning information and the summary line
display on program termination.
Specifies the source port ID, port WWN, or node WWN.
2
fcPing
161