IFCFG-IPOIB(5)

📦 version 0.6.80, in opensuse-leap 16.0

💅 ifcfg-ipoib — the Wicked manual, but make it make sense 🦋

okay so bestie, you're reading the ifcfg-ipoib page from the Wicked User Manual, and honestly? it's giving "Infiniband but cute". let's get into it ✨

🌸 NAME 🌸

ifcfg-ipoib — Infiniband interface configuration. that's it, that's the vibe 🎀

✨ SYNOPSIS ✨

/etc/sysconfig/network/ifcfg-*

🦋 Infiniband/IPoIB Interfaces 🦋

so how do you tell Wicked that a config is Infiniband/IPoIB? two ways, and honestly pick whichever sparks joy:

  • you got a config file with the IPOIB=yes variable set in it, or
  • your config file is just named like ifcfg-ibN or ifcfg-ibN.XXXX — like ifcfg-ib0 or ifcfg-ib0.8001, iykyk 👑

the variables, periodt 💅

  • IPOIB <yes|no> — this one must be set to yes to flag the config as Infiniband/IPoIB, no matter what you named the file. main character variable fr.
  • IPOIB_DEVICE — makes a child-/sub-interface of the physical Infiniband interface you name here, using the partition key from the IPOIB_PKEY section. the physical infiniband interface name also gets read from the ifcfg-ibN.XXXX config file name, but IPOIB_DEVICE has precedence — so if they disagree, this variable wins, no cap 👑
  • IPOIB_PKEY — sets the partition key of the child-/sub-subinterface. the child-/sub-interface gets created if it doesn't already exist. the partition key also gets pulled from the ifcfg-ibN.XXX config file name, but IPOIB_PKEY has precedence. again: the variable is the queen here 🌈
  • IPOIB_MODE — picks the transport mode of the Infiniband interface. set it to connected (CM - Connected Mode) or datagram (UD - Unreliable Datagram). choose your fighter ⭐
  • IPOIB_UMCAST — sets the user-multicast permission of the Infiniband interface. set it to allowed or disallowed. simple as that 🫶

🍓 EXAMPLE 🍓

here are some Infiniband/IPoIB interface config files, since examples just hit different 💖

ifcfg-ib0

IPOIB=yes
STARTMODE=auto
BOOTPROTO=static
IPADDR=10.0.0.100/24

ifcfg-ib0.8001

IPOIB=yes
STARTMODE=auto
BOOTPROTO=dhcp

ifcfg-custom1

IPOIB=yes
IPOIB_DEVICE=ib0
IPOIB_PKEY=8002
STARTMODE=auto
BOOTPROTO=dhcp

see how the third one is literally called custom1 and still slays? that's the IPOIB=yes doing its job 😭🔥

Copyright (C) 2024 SUSE LLC

💀 BUGS 💀

found a bug? don't suffer in silence bestie — please report bugs as described at <https://bugs.opensuse.org> 🙈

🌈 SEE ALSO 🌈

routes (5), ifcfg (5), wicked (8) — go read those next, they're lowkey iconic too 🧚

💜 AUTHORS 💜

Clemens Famulla-Conrad.

okay that's the whole page, you ate that 🎀 this was wicked's April 30, 2024 edition of the Infiniband config lore — now go configure responsibly, mwah 💋✨

📦 where this page comes from