ACL_COPY_ENTRY(3)

✨ ACL_COPY_ENTRY(3) ✨

okay bestie, gather round, because today we're talking about acl_copy_entry from the Linux Access Control Lists library — that's libacl, link it with -lacl 🎀. This is the library functions manual, and it's giving "small but mighty," fr fr.

🌸 NAME 🌸

acl_copy_entry — copy an ACL entry 💅

📚 LIBRARY 📚

Linux Access Control Lists library (libacl, -lacl) 🦋

🧚 SYNOPSIS 🧚

#include <sys/types.h>
#include <sys/acl.h>

int
acl_copy_entry(acl_entry_t dest_d, acl_entry_t src_d);

💖 DESCRIPTION 💖

okay so here's the vibe: acl_copy_entry() takes the contents of the ACL entry that src_d is pointing at, and copies all of it into the existing ACL entry that dest_d is pointing at. like, straight up duplicating the whole thing, no cap.

and here's the iconic part — src_d and dest_d can refer to entries in different ACLs. they do not have to be besties from the same ACL. cross-ACL copy? slay. 💫

🫶 RETURN VALUE 🫶

• acl_copy_entry() returns the value 0 if it worked. periodt, we love a success.
• otherwise it returns -1, and the global variable errno gets set to tell you what went wrong 😭

💀 ERRORS 💀

if any of these conditions happen, acl_copy_entry() returns -1 and sets errno to the matching value:

• [EINVAL] — The argument src_d or dest_d is not a valid descriptor for an ACL entry.

The arguments src_d and dest_d reference the same ACL entry.

not me trying to copy an entry onto itself 💀 yeah that's an [EINVAL], bestie, don't do it.

👑 STANDARDS 👑

IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned) 🥲

🔥 SEE ALSO 🔥

• acl_get_entry(3)
• acl(5)

🌈 AUTHOR 🌈

Derived from the FreeBSD manual pages written by Robert N M Watson <rwatson@FreeBSD.org>, and adapted for Linux by Andreas Gruenbacher <andreas.gruenbacher@gmail.com>. absolute legends, we stan 🫶

and that's the whole page, babes 💖 this came out of the Linux ACL docs, dated March 23, 2002 — yeah, it's vintage, but it still ate. mwah, go forth and copy those entries responsibly ✨🎀🦋