fcutil(1M)

NAME

fcutil — Fibre Channel Utility Command for the J2389 Fibre Channel Adapter

SYNOPSIS

/opt/fc/bin/fcutil device_file

/opt/fc/bin/fcutil device_file echo remote-N-Port-ID [data-size]

/opt/fc/bin/fcutil device_file test remote-N-Port-ID [data-size]

/opt/fc/bin/fcutil device_file read offset

/opt/fc/bin/fcutil device_file write offset value

/opt/fc/bin/fcutil device_file lb plm|tachyon

/opt/fc/bin/fcutil device_file get local|fabric

/opt/fc/bin/fcutil device_file get remote N-Port-ID

/opt/fc/bin/fcutil device_file get_lgn N-Port-ID

/opt/fc/bin/fcutil device_file reset [check|clear]

/opt/fc/bin/fcutil device_file stat

/opt/fc/bin/fcutil device_file stat_els

/opt/fc/bin/fcutil device_file clear_stat

/opt/fc/bin/fcutil device_file read_cr

/opt/fc/bin/fcutil device_file lgninfo_all

DESCRIPTION

The fcutil command is a diagnostic tool to be used for the J2389 Fibre Channel Adapter card. This command provides the ability to perform Fibre Channel Test and Echo functionality, provides the ability to read and write to the cards registers, etc. This command requires the use of a device file to indicate the interface over which the requested command needs to be performed. fcutil can be used only by users who have an effective user ID of 0. Some of the options require detailed knowledge of the device specific adapter.

Options

fcutil recognizes the following options as indicated in SYNOPSIS. All keywords are case-insensitive and are position dependent.

device_file

Can be used alone or with other options.

When used without any options it provides information such as the N_Port ID, Node World Wide Name and Port World Wide Name, Topology of the Fabric, the Speed of the Link, the Hard Physical Address of the Card, the Driver State, the number of Active Outbound Exchanges and number of Active Logins.

echo

This option requires two parameters, the remote-N-Port-ID and data-size (size of packet to send).

A Fibre Channel Echo packet of the specified size is sent to the remote node. The command completes successfully when an echo response is received from the remote node. The command times out if a response is not received in twice RA_TOV time.

Note: Packet size specified must be a multiple of 4.

test

This option requires two parameters, the remote-N-Port-ID and data-size (size of packet to send).

A Fibre Channel Test packet of the specified size is sent to the remote node. The command completes successfully and immediately on sending the test packet.

Note: Packet size specified must be a multiple of 4.

read

This option 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 Tachyon Memory Map. The user of this command is therefore expected to have internal knowledge of the chip.

write

This option requires two parameters, the offset of the register to write to and the value to be written (can be specified in either hex or in decimal format). The offset specified is an offset from the base of the Tachyon Memory Map. The user of this command is therefore expected to have internal knowledge of the chip.

lb

This option requires one parameter, plm or tachyon. This command performs an internal loopback test when the plm option is specified and performs an external loopback test when the tachyon option is specified. The Fibre Channel Chip is programmed in either internal loopback mode (plm) or external loopback mode (glm) based on the parameter specified. The self test then involves sending a packet and receiving back the packet and checking its integrity.

This is a destructive test and data loss during the execution of this test may occur.

get

The get option is used to obtain Fibre Channel login parameters of either the local port, the fabric port or of a remote port.

get_lgn

The get_lgn option is used to obtain detailed information maintained in the login block associated with each N_Port that this N_Port has communicated with. The remote-N-Port-ID is a required parameter for this option.

reset

This option is used to reset the card. This is a destructive test and communication to all nodes will be terminated till the reset process is completed.

stat

This option is used to obtain detailed statistics maintained by the driver. A normal user should use netstat and lanadmin to obtain statistics.

stat_els

This option is used to obtain detailed statistics maintained on Extended Link Services from the driver.

clear_stat

This option is used to initialize all of the statistics maintained by the driver to zero.

read_cr

This option can be used to read all of the readable registers on the card and format the detailed information.

lgninfo_all

This option is used to obtain a comprehensive list of nodes to which a successful login has been established.

AUTHOR

/opt/fc/bin/fcutil was developed by HP.

fcutil(1M)

Technical documentation

» Table of Contents

» Index

NAME

SYNOPSIS

DESCRIPTION

Options

AUTHOR

SEE ALSO