---
name: "fcnsq"
section: "8"
platform: "linux"
package: "fcoe-utils"
version: "1.0.34-6"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/fcnsq"
---

# fcnsq(8)

Fibre Channel Name Server Query Tool

## 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)](/fcoeadm/8.md)

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