GFS_ACL_DELETE_DEF_F(3)

💅 GFS_ACL_DELETE_DEF_F(3) — the Gfarm manual, bestie edition 🎀

okay so bestie, welcome to section 3 of the Gfarm manual, and today's main character is gfs_acl_delete_def_file — literally the "delete a Gfarm default ACL by filename" girlie. she's giving cleanup crew, she's giving bye-bye default ACL, and honestly? iconic. 🦋

✨ NAME ✨

gfs_acl_delete_def_file — delete a Gfarm default ACL by filename. no cap, that's the whole job description. 💖

🌸 SYNOPSIS 🌸

#include <gfarm/gfarm.h>

gfarm_error_t gfs_acl_delete_def_file(const char *gfarm_url);

look at her. one include, one function, zero drama. 🫶

🍓 INPUT ARGUMENTS 🍓

• gfarm_url — a path name in the Gfarm filesystem. that's the address, that's the vibe, that's where the default ACL lives. pass it in and let her cook. ✨

👑 RETURN VALUES 👑

• GFARM_ERR_NO_ERROR — the function terminated successfully. she ate, she left no crumbs, everything went exactly how it was supposed to. 💅
• GFARM_ERR_NOT_A_DIRECTORY — files do not have a default ACL. yeah so this is the lowkey important one: default ACLs are a directory thing, so if you point this at a file you're gonna get this back. not me being shocked, fr fr. 😭
• Others — an error except the above occurred. the reason is shown by gfarm_error_string(3). so when something else goes sideways, that's your girl for the tea. 🍵

real talk: "Others" is not a specific error code, it's the catch-all bucket. if you land here, go read gfarm_error_string(3) before you spiral. 💀

🌈 SEE ALSO 🌈

• gfs_acl_get_file(3)
• gfs_acl_set_file(3)
• gfs_attr(5)

the friend group. go say hi. 🧚

Gfarm dropped this one on 14 Feb 2011, and it's still out here doing the lord's work as GFS_ACL_DELETE_DEF_F(3). mwah. 💜✨