FCNSQ(8)

✨ FCNSQ(8) — bestie edition ✨

okay so real talk: this is fcnsq, part of the Open-FCoE Tools lineup, and it's genuinely one of my faves. it's the Fibre Channel Name Server Query Tool and it is that girl. let's get into it 💅

---

🎀 NAME 🎀

fcnsq — the Fibre Channel Name Server Query Tool. that's it, that's the name, she's iconic, she's direct, she knows what she is.

---

🌸 SYNOPSIS 🌸

like, here's how you actually talk to her:

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 ?

no cap, that's the whole vibe. five ways in, pick your fighter 🦋

---

💖 DESCRIPTION 💖

so the fcnsq command does Fibre Channel Name Server queries for a user-specified FC Host. like, you point it at a host and it goes and asks the name server stuff for you. it's giving personal assistant energy, fr fr.

the supported name server query commands include:

• Get Port Name (GPN)
• Get Node Name (GNN)
• Get Symbolic Node Name (GSNN)
• Get Symbolic Port Name (GSPN)

all of those are described in FC-GS-3 for the Common Transport (CT) services. yes bestie, it's all spec-accurate, we don't make things up here ✨

fcnsq takes the host bsg name as the input for the target host. and heads up — the host bsg name must be a valid bsg device, like e.g. "host12" as derived from /dev/bsg/fc_host12. so don't just make one up, she will know 🙈

for each name server query command, the argument is either a Port ID or a World Wide Port Name. and important: Port IDs and World Wide Names must be specified in hexadecimal. that's not a suggestion, that's the rule 💀

and if the verbose output is doing too much (it do be like that sometimes), use the --quiet option to disable it. we love a girl who can read the room.

---

✨ OPTIONS ✨

one bullet per option because we respect structure in this house 👑

• host --gpn port_id — Get Port Name by Port ID for host. the classic. the og. ask for the port name, get the port name.
• host --gnn port_id — Get Node Name by Port ID for host. same energy, but node instead of port, and still keyed off the Port ID.
• host --gspn port_id — Get Symbolic Port Name by Port ID for host. the symbolic one, port flavored. so cute.
• host --gsnn wwpn — Get Symbolic Node Name by World Wide Port Name for host. note bestie: this one takes a wwpn, not a port_id. don't mix them up, i'm begging 🫶
• -q, --quiet — Disable verbose output. when you just want the tea and not the whole conversation.
• ? — Display a help message with basic usage instructions. literally just ask her a question, she'll explain herself.

---

🌈 EXAMPLES 🌈

here's the part where we actually do it. study these, they're free 💜

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 how --gsnn gets the 0x and the others don't? yeah. that's just how she is. slay 🎀

---

🦋 SEE ALSO 🦋

• fcoeadm(8) — go say hi, she's family.

---

👑 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/. go check it out, the community is lowkey lovely 🫶

---

okay bestie that's the whole page, you're officially educated 💖 this was Open-FCoE, dated 06/09/2010, and you already know it's FCNSQ(8). go forth and query some names, you absolute main character 🌟