1FCNSQ(8)                        Open-FCoE Tools                       FCNSQ(8)
2
3
4

NAME

6       fcnsq - Fibre Channel Name Server Query Tool
7

SYNOPSIS

9       fcnsq host --gpn port_id [-q | --quiet]
10
11       fcnsq host --gnn port_id [-q | --quiet]
12
13       fcnsq host --gspn port_id [-q | --quiet]
14
15       fcnsq host --gsnn wwpn [-q | --quiet]
16
17       fcnsq ?
18

DESCRIPTION

20       The fcnsq command performs Fibre Channel Name Server queries for a
21       user-specified FC Host. The supported name server query commands
22       include: Get Port Name (GPN), Get Node Name (GNN), Get Symbolic Node
23       Name (GSNN), and Get Symbolic Port Name (GSPN) as described in FC-GS-3
24       for the Common Transport (CT) services.
25
26       fcnsq takes the host bsg name as the input for the target host. Host
27       bsg name must be a valid bsg device, e.g., "host12" as derived from
28       /dev/bsg/fc_host12. For each name server query command, the argument is
29       either a Port ID or a World Wide Port Name. Port IDs and World Wide
30       Names must be specified in hexadecimal. To disable verbose output, use
31       the --quiet option.
32

OPTIONS

34       host --gpn port_id
35           Get Port Name by Port ID for host.
36
37       host --gnn port_id
38           Get Node Name by Port ID for host.
39
40       host --gspn port_id
41           Get Symbolic Port Name by Port ID for host.
42
43       host --gsnn wwpn
44           Get Symbolic Node Name by World Wide Port Name for host.
45
46       -q, --quiet
47           Disable verbose output.
48
49       ?
50           Display a help message with basic usage instructions.
51

EXAMPLES

53       Query Get Port Name (GPN) from host12 for Port ID 0xbf0027
54
55           fcnsq host12 --gpn bf0027
56
57       Query Get Node Name (GNN) from host12 for Port ID 0xbf0027
58
59           fcnsq host12 --gnn bf0027
60
61       Query Get Symbolic Port Name (GSPN) from host12 for Port ID 0xbf0027
62
63           fcnsq host12 --gspn bf0027
64
65       Query Get Symbolic Node Name (GSNN) from host12 for WWWPN
66       0x1000001B213C9DDA
67
68           fcnsq host12 --gsnn 0x1000001B213C9DDA
69

SEE ALSO

71       fcoeadm(8)
72

SUPPORT

74       fcnsq is part of the fcoe-utils package, maintained through the
75       Open-FCoE project. Resources for both developers and users can be found
76       at the Open-FCoE website http://open-fcoe.org/.
77
78
79
80Open-FCoE                         06/09/2010                          FCNSQ(8)
Impressum