GFS_ACL_GET_FILE(3)

💖 GFS_ACL_GET_FILE 💖

okay bestie, welcome to section 3 of the Gfarm manual — this is where we keep the library calls, and this one is literally the "grab me an ACL by filename" girlie. no cap. 🎀

✨ NAME ✨

gfs_acl_get_file — get a Gfarm ACL by filename 🦋

✨ SYNOPSIS ✨

#include <gfarm/gfarm.h>

gfarm_error_t gfs_acl_get_file(const char *gfarm_url,
                               gfarm_acl_type_t type,
                               gfarm_acl_t *acl_p);

like, that's the whole vibe. three args, one error code, we move. 💅

✨ INPUT ARGUMENTS ✨

• gfarm_url — a path name in the Gfarm filesystem. yes queen, it's just a path, you already know how paths work 🌸
• type — which ACL you want, and there are exactly two choices, no more no less:
  • GFARM_ACL_TYPE_ACCESS — to get the access ACL 🔥
  • GFARM_ACL_TYPE_DEFAULT — to get the default ACL ✨
• acl_p — a pointer of ACL structure type. it's the lil out-param where your ACL lands. hand it over and let the function cook 🍓

✨ RETURN VALUES ✨

• GFARM_ERR_NO_ERROR — the function terminated successfully. we ate, no crumbs, periodt 👑
• GFARM_ERR_NO_SUCH_OBJECT — the gfarm_url does not exist, or the gfarm_url does not have the type of ACL. either way: not found, not slaying 😭
• GFARM_ERR_NO_MEMORY — insufficient memory was available. the RAM said "i'm booked and busy" 💀
• Others — an error except the above occurred. the reason is shown by gfarm_error_string(3). so go ask that one, she has the receipts 🙈

lowkey important: "Others" is not a specific code, bestie, it's the catch-all. if you get it, call gfarm_error_string(3) to find out what actually happened fr fr.

✨ SEE ALSO ✨

• gfs_acl_free(3)
• gfs_acl_get_entry(3)
• gfs_acl_set_file(3)
• gfs_attr(5)

the whole friend group, all linked up 🫶🌈

this page came to you from the Gfarm manual, dated 14 Feb 2011 — yes, Valentine's Day, because she's romantic like that 💜 stay hydrated, free your ACLs, and check the return value every single time, iykyk ✨🎀