GFS_ACL_GET_PERM(3)

📦 version 2.7.20, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 GFS_ACL_GET_PERM(3) — the Gfarm girlies' guide 💖

okay so bestie, welcome to gfs_acl_get_perm, a little function from the Gfarm manual, section 3. it does exactly one job and it does it flawlessly: it checks whether a permission is sitting inside a Gfarm ACL permission set. that's it. that's the whole vibe. 🎀

✨ NAME ✨

gfs_acl_get_perm — test for a permission in a Gfarm ACL permission set

like... it's giving "is this perm in the permset or not" and honestly? iconic. 💅

🌸 SYNOPSIS 🌸

#include <gfarm/gfarm.h>

gfarm_error_t gfs_acl_get_perm(gfarm_acl_permset_t permset_d,
                               gfarm_acl_perm_t perm, int *bool_p);

look at her. three args, returns a gfarm_error_t, no drama. 🦋

🫶 INPUT ARGUMENTS 🫶

  • permset_d — an ACL permission set. the lil collection we're snooping through. it's the main character here, no cap.
  • perm — this one has to be one of GFARM_ACL_READ or GFARM_ACL_WRITE or GFARM_ACL_EXECUTE. those three, bestie, pick one. 🔥
  • bool_p — the answer slot. if *bool_p is 1, the ACL permission set has the perm. if *bool_p is 0, the ACL permission set does not have the perm. literally a yes/no girlie. ✨

💜 RETURN VALUES 💜

  • GFARM_ERR_NO_ERROR — the function terminated successfully. slay, we love a clean run. 👑
  • Others — an error except the above occurred. the reason is shown by gfarm_error_string(3). not me getting a mystery error and having to go read another manpage 😭 but that's where the lore lives.

🌈 SEE ALSO 🌈

the whole ACL friend group fr fr — go read them too, they ate. 💖

heads up bestie: bool_p is a pointer, so you're writing into *bool_p, not bool_p. do not forget the star, i'm begging 🙈

and that's the tea! 🍓 this lil page came from the Gfarm manual, dated 14 Feb 2011 (yes, valentine's day, romantic of her 💌), and it lives under the name GFS_ACL_GET_PERM(3). periodt. 💅✨

📦 where this page comes from