zfcp_show(8)

📦 version 3.0.3, in opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 NAME 💖

Bestie, welcome to zfcp_show(8) from the System Manager's Manual — it's the little icon that shows you information about the SAN environment. 💅

✨ SYNOPSIS ✨

zfcp_show [-oOtnvcdh] [-a <busid|fc_host|S_ID|WWPN>] [-i <domain-ID>]
[-p <attached-port>]

🦋 DESCRIPTION 🦋

Okay so the main character energy of zfcp_show is literally just: give you the big-picture overview of your connected storage area network. 🌈

Depending on which command line switches you hand it, the info it spits back includes:

  • the names of the participating interconnect elements,
  • their type (think switch, bridge, hub, the whole crew),
  • how many ports are available,
  • their status,
  • and the potentially connected node ports, along with their port name (WWPN) and node port ID. 🫶

On top of that, you can also get the topology of the SAN, by feeding it the interconnect element ports that are used to link between the switches. 🕸️

Heads up though — the info it provides can become very huge, like genuinely overwhelming. That's exactly why a variety of switches are provided, so you can limit the output down to just the data of interest. no cap. 💀

🎀 OPTIONS 🎀

  • -a <adapter> — source adapter, specified by busid, fc_host, S_ID or WWPN. pick your fave way to name it, it gets it. ✨
  • -i <ID> — show only information about domain <ID>.
  • -p <port> — show only information about attached port <port>.
  • -o — show online ports only. (online era only 💅)
  • -O — show offline ports only.
  • -t — show topology information only.
  • -n — show local name server information only.
  • -c — provide the information as CSV output. spreadsheet girlies rise 🍓
  • -v — Generate verbose output. (capital G, we respect it)
  • -d — provide some debug output. 🙈
  • -h — Print help message and exit.

🌸 EXAMPLES 🌸

zfcp_show -t

Only show the topology information. The output is a brief listing describing how the various switches, bridges etc are connected to each other to form the storage area network (SAN). it's giving family tree but for switches. 🌳

zfcp_show -a 0.0.3c02

Provide the standard information but use the adapter with the busid 0.0.3c02 to send the request.

zfcp_show -a host0

Provide the standard information but use the adapter with the fc_host host0 to send the request.

zfcp_show -a 0x656000

Provide the standard information but use the adapter with the S_ID h0x656000 to send the request.

zfcp_show -a 0x500507630300c562

Provide the standard information but use the adapter with the WWPN 0x500507630300c562 to send the request.

zfcp_show -d

This command line switch is only to be used in case the raw requests and responses send and received from the management server are required. literally only for that. 🔍

zfcp_show -n

The local name server (directory server) query can be used to receive basic information about the attached SAN when no management server access is available. The output shows all ports of the local zone with their corresponding WWPN, D_ID (destiantion ID), the port type and, if available, the supported protocols. honestly iconic for when you're locked out of the management server. 🔥

that's the whole page, bestie — every flag, every example, nothing skipped, we ate and left no crumbs. 👑

this gem came to you courtesy of zfcp_hbaapi-2, dated Jan 2010, from the System Manager's Manual. 🎀✨

📦 where this page comes from