GFS_ACL_GET_ENTRY(3)

✨ GFS_ACL_GET_ENTRY ✨

okay so bestie, this is a page from the Gfarm manual β€” section 3, the library-call girlies β€” and it's all about gfs_acl_get_entry, aka get a Gfarm ACL entry. it's giving "walk the list, queen." πŸšΆβ™€οΈπŸ’…


πŸŽ€ NAME πŸŽ€

gfs_acl_get_entry β€” get a Gfarm ACL entry. that's it, that's the whole job, and she does it flawlessly. πŸ’–


🌸 SYNOPSIS 🌸

#include <gfarm/gfarm.h>

gfarm_error_t gfs_acl_get_entry(gfarm_acl_t acl, int entry_id,
                                gfarm_acl_entry_t *entry_p);

look at her. three args, returns a gfarm_error_t. iconic. no cap. ✨


πŸ¦‹ INPUT ARGUMENTS πŸ¦‹

  • acl β€” an ACL structure type. the main character of this whole operation, honestly. πŸ‘‘
  • entry_id β€” which entry you want, and there are exactly two vibes to pick from:
    • GFARM_ACL_FIRST_ENTRY β€” to get first ACL entry. start at the top, bestie. πŸ₯‡
    • GFARM_ACL_NEXT_ENTRY β€” to get next ACL entry. keep it moving. ➑️
  • entry_p β€” pointer to get the ACL entry. she's your output, she holds the goods. 🫢

πŸ’œ RETURN VALUES πŸ’œ

  • GFARM_ERR_NO_ERROR β€” the function terminated successfully. we love a clean win, fr fr. βœ…πŸŽ‰
  • GFARM_ERR_NO_SUCH_OBJECT β€” the ACL does not have ACL entries anymore. (End of ACL). that's the "we're done here, no more entries, go home" signal. πŸ’€πŸ”š
  • Others β€” an error except the above occurred. the reason is shown by gfarm_error_string(3). so like, go ask her, she'll tell you what went wrong. πŸ˜­πŸ“–

🌈 SEE ALSO 🌈

the girlies in this friend group, go say hi:


and that's the whole page, bestie!! πŸ’… this one's brought to you by the good people of Gfarm, dated 14 Feb 2011 β€” a literal valentine to ACL entries, we love to see it. πŸŽ€πŸ’Œ stay slaying, and remember: always check your entry_id. periodt. ✨