ARCHIVE_WRITE_FINISH_ENTRY(3)

💖 ARCHIVE_WRITE_FINISH_ENTRY(3) 💖

okay bestie, welcome to the Library Functions Manual, section 3 — this one's literally called archive_write_finish_entry, and it's giving "functions for creating archives". no cap.

✨ NAME ✨

archive_write_finish_entry — functions for creating archives 🎀

📚 LIBRARY 📚

Streaming Archive Library (libarchive, -larchive) 🦋

🌸 SYNOPSIS 🌸

#include <archive.h>

int
archive_write_finish_entry(struct archive *);

💅 DESCRIPTION 💅

So what this does is close out the entry you just wrote. iconic behavior. specifically, it writes out the final padding that some formats require — like, the lil finishing touch bestie, the ribbon on the gift. 🎁

Ordinarily, clients never need to call this, because archive_write_header() and archive_write_close() call it automatically as needed. so like, it's the friend who shows up to the party without being invited, but in a helpful way. 🫶

For archive_write_disk handles, though? this one flushes pending file attribute changes — things like modification time. the way that it just... commits the vibe. ⏰✨

🔥 RETURN VALUES 🔥

This function returns ARCHIVE_OK on success, or one of several non-zero error codes when things go sideways. 😭 specific error codes include:

• ARCHIVE_RETRY — for operations that might succeed if retried. (so like... try again bestie, it might slay the second time 💀)
• ARCHIVE_WARN — for unusual conditions that do not prevent further operations. (weird but we move 🚶♀️)
• ARCHIVE_FATAL — for serious errors that make remaining operations impossible. (it's over, no notes, we cannot recover 🙈)

💀 ERRORS 💀

Detailed error codes and textual descriptions are available from the archive_errno() and archive_error_string() functions. go read those, they'll tell you exactly what went wrong. 👑

👀 SEE ALSO 👀

tar(1), archive_write_data(3), archive_write_set_options(3), libarchive(3), cpio(5), mtree(5), tar(5) 🌈

mwah, that's the whole page bestie — every flag, every code, every vibe, untouched. periodt. 💖

this lil gem came from Debian, dated February 28, 2017, and it lives in the Library Functions Manual section 3. stan an icon, stan ARCHIVE_WRITE_FINISH_ENTRY(3). 👑✨