HP-UX Reference (11i v2 07/12) - 1M System Administration Commands A-M (vol 3)
f
fcmsutil(1M) fcmsutil(1M)
test remote-N-Port-ID data_size
[count]
This option is used to send a TEST ELS on the wire. It requires two parameters, the
remote-N-Port-ID and data-size (size of packet to send). An optional third argument (count)
can be specified for the number of echo packets to be sent. If the count option is not
specified, one packet will be sent.
The command completes successfully and immediately on sending all the test packets.
Note: Packet size specified must be a multiple of 4.
read offset [pci]
This option is used to read from HBA’s internal registers. It requires one parameter, the
offset of the register to read from. The offset can be specified in either hex or in decimal
format. The offset specified is an offset from the base of the Memory Map. The user of this
command is therefore expected to have internal knowledge of the chip. Reading from the
TACHYON frame manager status register (0x01c8) is restricted.
An optional second argument (
pci) can be specified for Fibre Channel HBAs, to read from
the PCI config space. If no second argument is specified, it reads from the chip register
space.
write offset value [pci]
This option is used to write into HBA’s registers. It requires two parameters, the offset of
the register to write to and the value to be written.
An optional third argument (
pci) can be specified for the Fibre Channel HBAs, to write
into the PCI config space. If no third argument is specified, it writes into the chip register
space.
[-f] lb This option is used to perform loopback tests on the port.
Warning: This is a DESTRUCTIVE test, and DATA LOSS during the execution of this test
may occur.
The -f option can be used to suppress the warning message displayed by the Fibre Chan-
nel driver utility.
For TL and XL2 HBAs, this option requires one parameter and an optional count:
[
-f] lb {plm|crpat|cjtpat}[count]
Here plm refers to physical link module or gigabit link module, which builds the default
payload for the loopback frame. If either crpat or cjtpat is used, then the card builds
specific payloads based on the recommendations in Fibre Channel - Methodologies for Jitter
Specifications. These patterns are designed to generate bit patterns which stress the
transmit and receive channels of the card. The self test then involves sending a packet and
receiving back the packet within the adapter and checking its integrity. Since this self test
is at the adapter level, no packet goes on the fibre link.
All Fibre Channel HBAs (except TL and XL2) need to specify two parameters. Here is the
syntax:
[
-f] lb {ext|int}{crpat|cjpat}[count]
The first parameter should be either ext or int to specify whether the loopback should be
external or internal, respectively. The second parameter specifies the loopback pattern.
Only crpat and cjtpat options are supported for these cards. Frames are looped back
at the single bit interface in the Internal loopback mode. For external loopback, frames are
sent out and received from the wire. External loopback mode is supported only in Loop
topology.
NOTE: In the internal loopback mode, frames are also sent out on the wire even though
they are internally looped back at the 1 Bit interface. The receiver, however, is turned off
during this operation. Therefore, it is not safe to run Internal loopback tests when the fiber
is connected to a Switch or Hub, as the transmitted loopback frames can disrupt operation
on the SAN.
An optional third argument (count) can be specified for the number of loopback packets to
be sent. If the count option is not specified, one packet will be sent.
250 Hewlett-Packard Company − 3 − HP-UX 11i Version 2: December 2007 Update