"Fossies" - the Fresh Open Source Software Archive

Member "open-fcoe-3.19/fcoe-utils/doc/fcnsq.txt" (15 Apr 2015, 2594 Bytes) of package /linux/misc/open-fcoe-3.19.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 ///////////////////////////////////////////////////////////////////////////
    2 // vim:syntax=asciidoc:tw=75:
    3 //
    4 // This is an asciidoc text file, which will be converted into a UNIX man
    5 // page using asciidoc and the DocBook XSL stylesheets.
    6 //
    7 // If you are going to update this documentation, please modify this file
    8 // and then regenerate the nroff formated man page using the Makefile.
    9 ///////////////////////////////////////////////////////////////////////////
   10 
   11 fcnsq(8)
   12 ==========
   13 :man source: Open-FCoE
   14 :man manual: Open-FCoE Tools
   15 
   16 NAME
   17 ----
   18 fcnsq - Fibre Channel Name Server Query Tool
   19 
   20 SYNOPSIS
   21 --------
   22 *fcnsq* _host_ --gpn _port_id_ [-q | --quiet]
   23 
   24 *fcnsq* _host_ --gnn _port_id_ [-q | --quiet]
   25 
   26 *fcnsq* _host_ --gspn _port_id_ [-q | --quiet]
   27 
   28 *fcnsq* _host_ --gsnn _wwpn_ [-q | --quiet]
   29 
   30 *fcnsq* ?
   31 
   32 DESCRIPTION
   33 -----------
   34 The *fcnsq* command performs Fibre Channel Name Server queries
   35 for a user-specified FC Host. The supported name server query commands
   36 include: Get Port Name (GPN), Get Node Name (GNN), Get Symbolic Node Name
   37 (GSNN), and Get Symbolic Port Name (GSPN) as described in FC-GS-3 for the
   38 Common Transport (CT) services.
   39 
   40 *fcnsq* takes the host bsg name as the input for the target host.  Host
   41 bsg name must be a valid bsg device, e.g., "host12" as derived from
   42 /dev/bsg/fc_host12.  For each name server query command, the argument is
   43 either a Port ID or a World Wide Port Name.  Port IDs and World Wide Names
   44 must be specified in hexadecimal. To disable verbose output, use the *--quiet*
   45 option.
   46 
   47 OPTIONS
   48 -------
   49 *host* *--gpn* _port_id_::
   50 	Get Port Name by Port ID for _host_.
   51 
   52 *host* *--gnn* _port_id_::
   53 	Get Node Name by Port ID for _host_.
   54 
   55 *host* *--gspn* _port_id_::
   56 	Get Symbolic Port Name by Port ID for _host_.
   57 
   58 *host* *--gsnn* _wwpn_::
   59 	Get Symbolic Node Name by World Wide Port Name for _host_.
   60 
   61 *-q*, *--quiet*::
   62 	Disable verbose output.
   63 
   64 *?*::
   65 	Display a help message with basic usage instructions.
   66 
   67 EXAMPLES
   68 --------
   69 Query Get Port Name (GPN) from host12 for Port ID 0xbf0027
   70 
   71 	fcnsq host12 --gpn bf0027
   72 
   73 Query Get Node Name (GNN) from host12 for Port ID 0xbf0027
   74 
   75 	fcnsq host12 --gnn bf0027
   76 
   77 Query Get Symbolic Port Name (GSPN) from host12 for Port ID 0xbf0027
   78 
   79 	fcnsq host12 --gspn bf0027
   80 
   81 Query Get Symbolic Node Name (GSNN) from host12 for WWWPN 0x1000001B213C9DDA
   82 
   83 	fcnsq host12 --gsnn 0x1000001B213C9DDA
   84 
   85 SEE ALSO
   86 --------
   87 *fcoeadm*(8)
   88 
   89 SUPPORT
   90 -------
   91 *fcnsq* is part of the _fcoe-utils_ package, maintained through the
   92 _Open-FCoE_ project. Resources for both developers and users can be found
   93 at the _Open-FCoE_ website <http://open-fcoe.org/>.