FCNSQ(8) Open-FCoE Tools FCNSQ(8)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/.
Open-FCoE 06/09/2010 FCNSQ(8)
Check Out this Related Man Page
net_adm(3erl) Erlang Module Definition net_adm(3erl)NAME
net_adm - Various Erlang Net Administration Routines
DESCRIPTION
This module contains various network utility functions.
EXPORTS
dns_hostname(Host) -> {ok, Name} | {error, Host}
Types Host = atom() | string()
Name = string()
Returns the official name of Host , or {error, Host} if no such name is found. See also inet(3erl) .
host_file() -> Hosts | {error, Reason}
Types Hosts = [Host]
Host = atom()
Reason = term()
Reads the .hosts.erlang file, see the section Files below. Returns the hosts in this file as a list, or returns {error, Reason} if
the file could not be read. See file(3erl) for possible values of Reason .
localhost() -> Name
Types Name = string()
Returns the name of the local host. If Erlang was started with the -name command line flag, Name is the fully qualified name.
names() -> {ok, [{Name, Port}]} | {error, Reason}
names(Host) -> {ok, [{Name, Port}]} | {error, Reason}
Types Name = string()
Port = int()
Reason = address | term()
Similar to epmd -names , see epmd(1) . Host defaults to the local host. Returns the names and associated port numbers of the Erlang
nodes that epmd at the specified host has registered.
Returns {error, address} if epmd is not running. See inet(3erl) for other possible values of Reason .
(arne@dunn)1> net_adm:names().
{ok,[{"arne",40262}]}
ping(Node) -> pong | pang
Types Node = node()
Tries to set up a connection to Node . Returns pang if it fails, or pong if it is successful.
world() -> [node()]
world(Arg) -> [node()]
Types Arg = silent | verbose
This function calls names(Host) for all hosts which are specified in the Erlang host file .hosts.erlang , collects the replies and
then evaluates ping(Node) on all those nodes. Returns the list of all nodes that were, successfully pinged.
Arg defaults to silent . If Arg == verbose , the function writes information about which nodes it is pinging to stdout.
This function can be useful when a node is started, and the names of the other nodes in the network are not initially known.
Failure: {error, Reason} if host_file() returns {error, Reason} .
world_list(Hosts) -> [node()]
world_list(Hosts, Arg) -> [node()]
Types Hosts = [Host]
Host = atom()
Arg = silent | verbose
As world/0,1 , but the hosts are given as argument instead of being read from .hosts.erlang .
FILES
The .hosts.erlang file consists of a number of host names written as Erlang terms. It is looked for in the current work directory, the
user's home directory, and $OTP_ROOT (the root directory of Erlang/OTP), in that order.
The format of the .hosts.erlang file must be one host name per line. The host names must be within quotes as shown in the following exam-
ple:
^ (new line)
Ericsson AB kernel 2.14.3 net_adm(3erl)