zip_get_archive_flag(3)

zip_get_archive_flag3

Get status flags for zip

Usage

#include <zip.h>

int

zip_get_archive_flag(zip_t *archive, zip_flags_t flag, zip_flags_t flags);

Library

libzip (-lzip)

Overview

The zip_get_archive_flag() function returns if the flag flag is set for the archive archive. The archive flags might have been changed with zip_set_archive_flag(); if flags is set to ZIP_FL_UNCHANGED, the original unchanged flags are tested.

Supported flags are:

ZIP_AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE

If this flag is cleared, the archive file will be removed if the archive is empty. If it is set, an empty archive will be created, which is not recommended by the zip specification. This flag is always cleared unless explicitly set by the user with zip_set_archive_flag(3).

ZIP_AFL_IS_TORRENTZIP

The archive is in torrentzip format.

ZIP_AFL_RDONLY

The archive is read-only.

ZIP_AFL_WANT_TORRENTZIP

If the flag is set, the archive will be written in torrentzip format. This flag is always cleared unless explicitly set by the user with zip_set_archive_flag(3).

Return values

zip_get_archive_flag() returns 1 if flag is set for archive, 0 if not, and -1 if an error occurred.

Releases

9 releases since Debian 6.0 (Squeeze); the text changed 4 times.

  1. 6.0–7
  2. 8
  3. 9
  4. 10–12
  5. 13–Arch

History

zip_get_archive_flag() was added in libzip 0.9. In libzip 0.11 the type of flag was changed from int to zip_flags_t m and the type of flags was changed from int to zip_flags_t. ZIP_AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE, ZIP_AFL_IS_TORRENTZIP, and ZIP_AFL_WANT_TORRENTZIP were added in libzip 1.10.0.

Authors

Dieter Baron ⟨[email protected]⟩ and Thomas Klausner ⟨[email protected]⟩

From libzip 1.11.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's mdoc source.