MSA(3)

🎀 MSA(3) — Utility Functions 🎀

okay bestie, welcome to the linux-gpib corner of the manual where we make my secondary address bytes happen 💅 this one lives in section 3, the utility functions section, and it's genuinely so cute and so small you're gonna be obsessed.

---

✨ NAME ✨

MSA — generate 'my secondary address' command byte 🦋

---

✨ SYNOPSIS ✨

#include <gpib/ib.h>

uint8_t MSA(unsigned int address);

---

✨ DESCRIPTION ✨

so like, MSA() hands you back a 'my secondary address' command byte that matches up with whatever you passed in as the address argument. very demure, very mindful. 💖

the address can be anywhere from 0 to 31 — that's the whole range, no sneaky extras, no surprises.

and here's the part that's lowkey the best thing about it: this macro is also super useful for mangling secondary addresses, going from the 'real' values between 0 and 31 over into the range 0x60 to 0x7f that most of the library's functions actually use. so if you're out here with a plain little 0–31 number and half the library is looking at you like "where's my 0x60s at", this is the girl to call. 🫶✨

---

✨ RETURN VALUE ✨

you get the appropriate MSA command byte back. that's it. that's the whole gift. 🎁 no error codes, no drama, just the byte you asked for. periodt. 👑

---

✨ COPYRIGHT ✨

Copyright © 2003-2006, 2008 Frank Mori Hess — ty king for your service 🙇‍♀️💜

---

no cap, this page came straight out of linux-gpib 4.3.7, dated 07/06/2026, and it's literally just MSA(3) doing its little thing in section 3. now go mangle those secondary addresses bestie, i believe in you 💖✨🎀🦋