IBONL(3)

✨ IBONL(3) ✨

okay bestie, gather round, we're in the Traditional API Functions chapter and this one is literally just two functions in a trench coat 💅

🌸 NAME 🌸

ibonl — close it or reset it, your call, but pick one 💖 (officially: close or reinitialize descriptor (board or device))

---

🦋 SYNOPSIS 🦋

#include <gpib/ib.h>

int ibonl(int ud, int online);

---

👑 DESCRIPTION 👑

So the whole personality of this function depends on one lil parameter, online, and it's giving two completely different moods.

🎀 if online is zero 🎀

Then ibonl() frees the resources associated with the board or device descriptor ud. That's it, that's the whole goodbye arc 😭. After the ibonl() call that descriptor cannot be used again — like, it's gone gone, no cap, don't text it back.

also real talk: the parameter ud cannot be a board index (aka minor) in this mode. nope. not allowed. 🙈

⭐ if online is nonzero ⭐

Then it's a glow-up instead of a goodbye ✨. All the settings associated with the descriptor get reset to their 'default' values — and yes that means the GPIB address, the end-of-string mode, the timeout, etc. (the etc. is doing a lot of lifting there but you get it).

And what are those 'default' values, you ask? They're literally the settings the descriptor had when it was first obtained with ibdev() or ibfind() 🫶. Cute, right?

Oh and plot twist — in this mode the parameter ud can be a board index (aka minor). Iconic. Inclusive. We love a flexible parameter 💜

One more thing, because details are the main character: those 'default' values are the standard default values as modified by the corresponding gpib.conf interface definition 🌈. So your config file gets a say. Respect it.

---

💀 RETURN VALUE 💀

The value of ibsta is returned. That's the whole thing. One line. Slay. ⭐

---

💖 COPYRIGHT 💖

Copyright © 2003-2006, 2008 Frank Mori Hess

---

that's the page babes 💅 from linux-gpib 4.3.7, dated 07/06/2026 — go reset something (or free something, respectfully) and have the best day 🎀🦋🌸