ZIP_FILE_SET_EXTERNAL_ATTRIBUTES(3)

💅 ZIP_FILE_SET_EXTERNAL_ATTRIBUTES 💅

okay bestie, we're in the Library Functions Manual section of the libzip cinematic universe, and today's main character is zip_file_set_external_attributes — yes that name is a mouthful, no we are not shortening it, it's iconic actually. 🎀

---

✨ NAME ✨

zip_file_set_external_attributes — set external attributes for a file in a zip 🗂️✨

---

📚 LIBRARY 📚

libzip (-lzip) 🫶

---

🦋 SYNOPSIS 🦋

#include <zip.h>

int
zip_file_set_external_attributes(zip_t *archive, zip_uint64_t index,
    zip_flags_t flags, zip_uint8_t opsys, zip_uint32_t attributes);

---

🌸 DESCRIPTION 🌸

so the zip_file_set_external_attributes() function does exactly what it says on the tin, no cap: it sets the operating system and the external attributes for the file sitting at position index inside the zip archive. 📍

and like, right now? no flags are supported. zero. none. the flags param is lowkey just vibing there. 🙈

if you wanna know which opsys values are even legal to pass, go check out zip_file_get_external_attributes(3) — it's the whole lore drop. 📖✨

---

💖 RETURN VALUES 💖

• if everything goes slay: 0 is returned. periodt. ✅
• if it does NOT go slay: -1 is returned, and the error info inside archive gets set to tell you what went wrong. 💀

---

🔥 ERRORS 🔥

zip_file_set_external_attributes() fails — like, actually gives up — if:

• [ZIP_ER_INVAL] — index is not a valid file index in archive. 🚫
• [ZIP_ER_MEMORY] — the memory it needed could not be allocated. 😭
• [ZIP_ER_RDONLY] — the archive was opened in read-only mode, so bestie… you literally cannot write to it. 🙅‍♀️

---

👀 SEE ALSO 👀

libzip(3), zip_file_get_external_attributes(3) 🫶

---

🕰️ HISTORY 🕰️

zip_file_set_external_attributes() was added in libzip 0.11.2 — a true veteran, we stan an OG. 👑

---

👑 AUTHORS 👑

Dieter Baron <dillo@nih.at> and Thomas Klausner <wiz@gatalith.at> — the two icons who made this happen, show them some respect fr fr. 💜

---

and that's the whole page, bestie!! this lil beauty comes to you courtesy of Debian, dated December 18 — so go forth, set those external attributes, and stay iconic. mwah. 💅✨🎀