IBADDR(8)

✨ IBADDR ✨

okay bestie, welcome to ibaddr from the OpenIB Diagnostics crew 💅 this is your little address-resolver baddie for InfiniBand, and honestly? iconic.

---

💖 NAME 💖

IBADDR — query InfiniBand address(es). that's it. that's the whole vibe. 🌸

---

🦋 SYNOPSIS 🦋

ibaddr [options]

---

👑 DESCRIPTION 👑

so what does she do? she displays the lid (and the range) plus the GID address of the port you point at — and you can point at it by DR path, by lid, or by GUID — or, if you're feeling low-effort (we love that), she just does the local port by default. no thoughts, just vibes. 🧚

💡 Note: this utility can be used as a simple address resolver. like, that's her whole job and she's the main character about it.

---

✨ OPTIONS ✨

• --gid_show, -g — show gid address only. gid and nothing else, she's monogamous 💜
• --lid_show, -l — show lid range only.
• --Lid_show, -L — show lid range (in decimal) only. yes the capital L is a different flag, they are sisters not twins 🙈

🎀 Addressing Flags 🎀

• -D, --Direct — the address you specified is a directed route. very "I know exactly where I'm going" of you.

Examples:

[options] -D [options] "0"          # self port
[options] -D [options] "0,1,2,1,4"  # out via port 1, then 2, ...

⚠️ Note the second number in the path specified must match the port being used. This can be specified using the port selection flag -P or the port found through the automatic selection process. don't skip this bestie, she will not be happy 😭

• -G, --Guid — the address you specified is a Port GUID.
• -s, --sm_port <smlid> — use smlid as the target lid for SA queries.

💀 Debugging flags 💀

• -d — raise the IB debugging level. May be used several times (-ddd or -d -d -d). go off, stack them.
• -e — show send and receive errors (timeouts and others). the receipts 🧾
• -h, --help — show the usage message.
• -v, --verbose — increase the application verbosity level. May be used several times (-vv or -v -v -v). she will NOT stop talking and we respect her for it.
• -V, --version — show the version info.

🌈 Port Selection flags 🌈

• -C, --Ca <ca_name> — use the specified ca_name.
• -P, --Port <ca_port> — use the specified ca_port.
• -Y, --pkey-idx <idx> — P_Key table index (0-65535, default 0) used for the outgoing SA/GMP MADs. SMP (SMI directed-route/LID-routed) MADs always use P_Key index 0. periodt. no exceptions, she's very firm about this one.

🌸 Local port Selection 🌸

Multiple port/Multiple CA support: when no IB device or port is specified (see the "local umad parameters" below), the libibumad library selects the port to use by the following criteria:

1. the first port that is ACTIVE.
2. if not found, the first port that is UP (physical link up).

If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. (she tried her best, okay 😭)

For example:

ibaddr                 # use the first port (criteria #1 above)
ibaddr -C mthca1       # pick the best port from "mthca1" only.
ibaddr -P 2            # use the second (active/up) port from the first available IB device.
ibaddr -C mthca0 -P 2  # use the specified port only.

⭐ Configuration flags ⭐

• -y, --m_key <key> — use the specified M_key for requests. If a non-numeric value (like 'x') is specified then a value will be prompted for. she's asking nicely 🥺
• -t, --timeout <timeout_ms> — override the default timeout for the solicited mads.
• --config, -z <config_file> — specify alternate config file. Default: /etc/infiniband-diags/ibdiag.conf

---

🫶 FILES 🫶

🍓 CONFIG FILE 🍓

/etc/infiniband-diags/ibdiag.conf

A global config file is provided to set some of the common options for all tools. See supplied config file for details. (iykyk, go read it 💜)

---

🔥 EXAMPLES 🔥

ibaddr                  # local port\'s address
ibaddr 32               # show lid range and gid of lid 32
ibaddr -G 0x8f1040023   # same but using guid address
ibaddr -l 32            # show lid range only
ibaddr -L 32            # show decimal lid range only
ibaddr -g 32            # show gid address only

look at her go 😭 she ate and left no crumbs.

---

👀 SEE ALSO 👀

ibroute (8), ibtracert (8) — go say hi besties, they're all in the same group chat.

---

💅 AUTHOR 💅

Hal Rosenstock < <halr@voltaire.com> >

---

and that's the whole page, sweetie ✨ this was dropped on 2013-10-11 by the OpenIB Diagnostics girlies — mwah, drink water, and always double check your DR path 💖🦋👑