SMCD-LINKGROUP(8)

✨ NAME ✨

okay so bestie, listen up, because this page is literally two manual pages sharing one vibe 💖

smcd-linkgroup — prints all the info about SMC-D link groups.

smcr-linkgroup — prints all the info about SMC-R link groups and links.

both of them? on this one page? iconic behavior honestly 🎀

---

🌸 SYNOPSIS 🌸

smcd [ OPTIONS ] linkgroup  { COMMAND | help }

smcd linkgroup [ show ] [ all | LG-ID ]

smcr [ OPTIONS ] linkgroup  { COMMAND | help }

smcr linkgroup { show | link-show } [ all | LG-ID ] [ netdev NETDEV ] [
        ibdev IBDEV ]

---

💫 DESCRIPTION 💫

so the smcd linkgroup command shows you SMC-D link groups and all their little properties. and the smcr linkgroup command shows you SMC-R link groups and links with all their properties. it's giving "tell me everything" and we love that for us 🦋

🌈 smcd,smcr linkgroup show

go inspect the link group properties, bestie 🔍

• all (this is the default btw) — show all the link groups. every single one. no skips.
• LG-ID — show just the link group with the ID LG-ID.
• netdev NETDEV — SMC-R only: list the link groups for the specified network device.
• ibdev IBDEV — SMC-R only: list the link groups for the specified RoCE device.

🧚 smcr linkgroup link-show

SMC-R only: go inspect the link properties ✨

• all (default, again, as a treat) — list all links of all link groups.
• LG-ID — show the links of the link group with the id LG-ID.
• netdev NETDEV — list the links of the link groups for the specified network device.
• ibdev IBDEV — list the links of the link groups for the specified RoCE device.

---

👑 OUTPUT 👑

here's what all those little fields actually mean, bestie. read carefully, this is the good part 🫶

🌟 LG-ID

ID of the link group.

🌟 LG-Role

Role of the link group.

• SERV — the link group has a SERVER role.
• CLNT — the link group has a CLIENT role.

🌟 LG-Type

Type of the link group.

• NONE — the link group has the initial type.
• SINGLE — the link group has only a single link, i.e. the local and the peer system can offer one device port only for this link group, which means a link outage on either side cannot be recovered.
• SYM — the link group has two symmetric links, i.e. the local and the peer system can offer two device ports for this link group, which means a link outage on either side can be recovered.
• ASYMP — the link group has asymmetric links, i.e. the peer system can offer one device port only for this link group, which means a link outage on the peer side cannot be recovered.
• ASYML — the link group has asymmetric links, i.e. the local system can offer one device port only for this link group, which means a link outage on the local side cannot be recovered.

🌟 VLAN

The VLAN to which the link group belongs.

🌟 #Conns

Number of connections(sockets) running on the link or link group.

🌟 PNET-ID

PNET ID of the link group. Asterisk "*" means PNET ID is set by the user.

🌟 Net-Dev

Network device name corresponding to the link.

🌟 Link-State

The state of the link.

• LINK_UNUSED — the link is not in use and in initial state.
• LINK_INACTIVE — the link is inactive and will go away.
• LINK_ACTIVATING — the link is being activated with the peer.
• LINK_ACTIVE — the link is active and operates on an established link with the peer. Data is being exchanged via RDMA. 🔥

🌟 Link-UID

Unique identifier of the link. This identifier consists of link group id and link id.

🌟 Peer-UID

Unique identifier of the link on the peer side. This identifier consists of link group id and link id.

🌟 IB-Dev

Name of the RoCE device used by the link.

🌟 IB-P

Port of the RoCE device used by the link.

🌟 Local-GID

GID of the RoCE port used by the link.

🌟 Peer-GID

GID of the peer RoCE port used by the link.

---

🍓 EXAMPLES 🍓

copy-paste these, bestie, they just work 💅

1. Show all SMC-D link groups:

# smcd linkgroup show all

2. Show all SMC-D link groups with link group id 50:

# smcd linkgroup show 50

3. Show all SMC-R links:

# smcr linkgroup link-show all

4. Show all SMC-R links with link group ID 40:

# smcr linkgroup link-show 40

5. Show all SMC-R links on RoCE device "mlx4_0":

# smcr linkgroup link-show ibdev mlx4_0

6. Show all SMC-R links on network device "eth0":

# smcr linkgroup link-show netdev eth0

---

🔗 SEE ALSO 🔗

smcd(8), smcr(8) — go read those too, iykyk 💜

---

okay that's the whole page, no cap 🎀 this was smc-tools, from June 2020, and the page you just read is SMCD-LINKGROUP(8). slay, you're all caught up. periodt. 💖✨