BSDE_GET_RULE(3)

💅 BSDE_GET_RULE(3) — Library Functions Manual 💅

okay bestie, welcome to the file system firewall rules list management page — yes, we're doing this, and we're gonna keep every detail while making it cute 🫶✨

🌸 NAME 🌸

bsde_add_rule, bsde_get_rule, bsde_set_rule, bsde_delete_rule — file system firewall rules list management 🎀

🦋 LIBRARY 🦋

File System Firewall Interface Library (libugidfw, -lugidfw) — that's the exact library name and linker flag, no cap 💜

✨ SYNOPSIS ✨

#include <ugidfw.h>

int
bsde_add_rule(int *rulenum, struct mac_bsdextended_rule *rule,
    size_t buflen, char *errstr);

int
bsde_get_rule(int rulenum, struct mac_bsdextended_rule *rule,
    size_t errlen, char *errstr);

int
bsde_set_rule(int rulenum, struct mac_bsdextended_rule *rule,
    size_t errlen, char *errstr);

int
bsde_delete_rule(int rulenum, size_t errlen, char *errstr);

like, here is the include and the exact signatures, literally copy-paste exact bestie 😌

💖 DESCRIPTION 💖

okay so here's the tea on each function, one by one:

• bsde_add_rule(int *rulenum, struct mac_bsdextended_rule *rule, size_t buflen, char *errstr) — this one fills the next available rule (in struct mac_bsdextended_rule form, either from bsde_get_rule() or bsde_parse_rule(3)). If an error occurs, *errstr is filled with the error string (up to errlen characters, including the terminating NUL). If successful and rulenum is non-NULL, the rule number used will be returned in *rulenum ✨
• bsde_get_rule(int rulenum, struct mac_bsdextended_rule *rule, size_t errlen, char *errstr) — this one fills in *rule with the rule numbered rulenum. If an error occurs, *errstr is filled in with the error string (up to errlen characters, including the terminating NUL) 💅
• bsde_set_rule(int rulenum, struct mac_bsdextended_rule *rule, size_t errlen, char *errstr) — this one fills the slot numbered rulenum with the specified rule (in struct mac_bsdextended_rule form, either from bsde_get_rule() or bsde_parse_rule(3)). If an error occurs, *errstr is filled with the error string (up to errlen characters, including the terminating NUL) periodt 🎀
• bsde_delete_rule(int rulenum, size_t errlen, char *errstr) — this one deletes the rule numbered rulenum. If an error occurs, *errstr is filled with the error string (up to errlen characters, including the terminating NUL) bye-bye rule 👋

🎀 RETURN VALUES 🎀

bsde_get_rule(), bsde_set_rule(), and bsde_delete_rule() return 0 if successful; otherwise the value -1 is returned and the value of *errstr is filled in as documented in “DESCRIPTION” 😭💀

🔥 SEE ALSO 🔥

• bsde_get_rule_count(3)
• bsde_get_rule_slots(3)
• bsde_parse_rule(3)
• bsde_parse_rule_string(3)
• bsde_rule_to_string(3)
• libugidfw(3)
• mac_bsdextended(4)
• ugidfw(8)

go read those next, bestie — the linked-list of lore is real fr fr 🫶

👑 AUTHORS 👑

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 contribution behavior, honestly 🫡💜

signing off from Debian on February 24, 2004, on the BSDE_GET_RULE(3) page — mwah 💋✨