///////////////////////////////////////////////////////////////////////////
// vim:syntax=asciidoc:tw=75:
//
// This is an asciidoc text file, which will be converted into a UNIX man
// page using asciidoc and the DocBook XSL stylesheets.
//
// If you are going to update this documentation, please modify this file
// and then regenerate the nroff formated man page using the Makefile.
///////////////////////////////////////////////////////////////////////////

fcnsq(8)
==========
:man source: Open-FCoE
:man manual: Open-FCoE Tools

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/>.