User Tools

Site Tools


fcnsq

FCNSQ

NAME

fcnsq - Fibre Channel Name Server Query Tool

SYNOPSIS

fcnsq host –gpn port_id [-q | –quiet]

fcnsq host –gnn port_id [-q | –quiet]

fcnsq host –gspn port_id [-q | –quiet]

fcnsq host –gsnn wwpn [-q | –quiet]

fcnsq ?

DESCRIPTION

The fcnsq command performs Fibre Channel Name Server queries for a user-specified FC Host. The supported name server query commands include: Get Port Name (GPN), Get Node Name (GNN), Get Symbolic Node Name (GSNN), and Get Symbolic Port Name (GSPN) as described in FC-GS-3 for the Common Transport (CT) services.

fcnsq takes the host bsg name as the input for the target host. Host bsg name must be a valid bsg device, e.g., “host12” as derived from /dev/bsg/fc_host12. For each name server query command, the argument is either a Port ID or a World Wide Port Name. Port IDs and World Wide Names must be specified in hexadecimal. To disable verbose output, use the –quiet option.

OPTIONS

host –gpn port_id

Get Port Name by Port ID for host.

host –gnn port_id

Get Node Name by Port ID for host.

host –gspn port_id

Get Symbolic Port Name by Port ID for host.

host –gsnn wwpn

Get Symbolic Node Name by World Wide Port Name for host.

-q, –quiet

Disable verbose output.

?

Display a help message with basic usage instructions.

EXAMPLES

Query Get Port Name (GPN) from host12 for Port ID 0xbf0027

fcnsq host12 --gpn bf0027

Query Get Node Name (GNN) from host12 for Port ID 0xbf0027

fcnsq host12 --gnn bf0027

Query Get Symbolic Port Name (GSPN) from host12 for Port ID 0xbf0027

fcnsq host12 --gspn bf0027

Query Get Symbolic Node Name (GSNN) from host12 for WWWPN 0x1000001B213C9DDA

fcnsq host12 --gsnn 0x1000001B213C9DDA

SEE ALSO

fcoeadm(8)

SUPPORT

fcnsq is part of the fcoe-utils package, maintained through the Open-FCoE project. Resources for both developers and users can be found at the Open-FCoE website http://open-fcoe.org/.

This document was created by man2html, using the manual pages.
Time: 18:47:31 GMT, January 24, 2013

fcnsq.txt · Last modified: 2013/01/24 18:48 by rbbratta