GFS_ACL_TO_TEXT(3)

💖 gfs_acl_to_text — the Gfarm ACL glow-up page 💖

okay bestie, welcome to the gfs_acl_to_text(3) era of the Gfarm manual — section 3, library functions, we're in our reference-page bag ✨

🌸 NAME 🌸

gfs_acl_to_text — convert a Gfarm ACL to text. that's it, that's the whole vibe: ACL goes in, text comes out, slay 💅

✨ SYNOPSIS ✨

#include <gfarm/gfarm.h>

gfarm_error_t gfs_acl_to_text(gfarm_acl_t acl, char **str_p,
                              size_t *len_p);

no cap, that's the entire signature. copy it exactly, don't freestyle it 🎀

🦋 INPUT ARGUMENTS 🦋

• acl — an ACL structure type. this is the thing you're converting, the main character of the whole operation 👑
• str_p — a pointer to the long text form string of the ACL. so like, the function hands you back the text through here 🫶
• len_p — if this pointer is not NULL, the function returns the length of the string, not including the terminating '\0' character. so if you're counting, bestie, the null byte does NOT count. periodt 💀

🔥 RETURN VALUES 🔥

• GFARM_ERR_NO_ERROR — the function terminated successfully. we ate, we left no crumbs, iconic 🌈
• GFARM_ERR_NO_MEMORY — insufficient memory was available. it's giving broke, lowkey tragic 😭
• Others — an error except the above occurred. the reason is shown by gfarm_error_string(3). so go check that one, iykyk 🔍

ngl, always check your return value, bestie. the function is literally telling you how it went — don't leave it on read 🙈

💜 SEE ALSO 💜

• free(3)
• gfs_acl_to_any_text(3)

go read those too, they're part of the extended universe 🧚

and that's the whole page, bestie — you understood the assignment 💖

this one came straight from the Gfarm crew, dated 14 Feb 2011 — yes, valentine's day, romantic of them 🍓 — and it's the GFS_ACL_TO_TEXT(3) page from the Gfarm manual. mwah 💅✨