BSDE_GET_RULE_COUNT(3)

💅 BSDE_GET_RULE_COUNT(3) 💅

okay bestie, so this is a Library Functions Manual page (that's the manual name btw, in case you were wondering) and honestly? it's giving "tiny but mighty". let's get into it 🫶

---

✨ NAME ✨

bsde_get_rule_count, bsde_get_rule_slots — file system firewall statistics 🎀

like… it's literally the stats girlies of the file system firewall world. no cap.

---

📚 LIBRARY 📚

File System Firewall Interface Library (libugidfw, -lugidfw) — yes you gotta link it, that's the vibe 💜

---

🌸 SYNOPSIS 🌸

#include <ugidfw.h>

int
bsde_get_rule_count(size_t errlen, char *errstr);

int
bsde_get_rule_slots(size_t errlen, char *errstr);

two functions, same shape, both returning int. slay ✨

---

🦋 DESCRIPTION 🦋

so here's the tea, bestie ☕:

• bsde_get_rule_count() returns the total number of enforced rules. periodt.
• bsde_get_rule_slots() returns the total number of used rule slots. also periodt.

they're two icons doing two different jobs and honestly I respect that 💅

and if something goes wrong? 😭 *errstr gets filled in with the error string — up to errlen characters, including the terminating NUL. so like, budget your buffer accordingly, don't be doing the most with too few bytes 🙈

ngl errlen counting the NUL is the kind of detail that'll bite you if you're not paying attention. read it twice. love u 💖

---

🔥 RETURN VALUES 🔥

• on success: bsde_get_rule_count() hands you the number of enforced rules, and bsde_get_rule_slots() hands you the number of rule slots (respectively, obviously — they don't swap jobs, this isn't that kind of library) 💀
• on failure: the return value is -1 and *errstr gets filled in as documented in “DESCRIPTION” up above 👆

so basically: -1 = check your errstr, bestie. that's the whole signal. 🚩

---

🌈 SEE ALSO 🌈

the whole friend group, honestly — go say hi 👑

• bsde_delete_rule(3)
• bsde_get_rule(3)
• bsde_parse_rule(3)
• bsde_parse_rule_string(3)
• bsde_rule_to_string(3)
• bsde_set_rule(3)
• libugidfw(3)
• mac_bsdextended(4)
• ugidfw(8)

like literally the entire squad. iykyk 🧚

---

🎀 AUTHORS 🎀

okay so this software was contributed to the FreeBSD Project by Network Associates Labs, the Security Research Division of Network Associates Inc., under DARPA/SPAWAR contract N66001-01-C-8035 (“CBOSS”), as part of the DARPA CHATS research program. iconic sponsorship moment, we love to see it ⭐

---

and that's the whole page bestie! this one's from Debian, dated January 7, 2003 — vintage but still absolutely eating 💖🦋🌸 no cap, go read ugidfw(8) next 🫶