ARCHIVE\_READ\_ADD\_PASSPHRASE(3) Library Functions Manual ARCHIVE\_READ\_ADD\_PASSPHRASE(3)

# [NAME](#NAME)

`archive_read_add_passphrase`, `archive_read_set_passphrase_callback` — functions for reading encrypted archives

# [LIBRARY](#LIBRARY)

Streaming Archive Library (libarchive, -larchive)

# [SYNOPSIS](#SYNOPSIS)

`#include <archive.h>`

`int`  
`archive_read_add_passphrase`(`struct archive *`, `const char *passphrase`);

`int`  
`archive_read_set_passphrase_callback`(`struct archive *`, `void *client_data`, `archive_passphrase_callback *`);

# [DESCRIPTION](#DESCRIPTION)

[`archive_read_add_passphrase`](#archive_read_add_passphrase)()

Register passphrases for reading an encrypted archive. If `passphrase` is `NULL` or empty, this function will do nothing and `ARCHIVE_FAILED` will be returned. Otherwise, `ARCHIVE_OK` will be returned.

[`archive_read_set_passphrase_callback`](#archive_read_set_passphrase_callback)()

Register a callback function that will be invoked to get a passphrase for decryption after trying all the passphrases registered by the `archive_read_add_passphrase`() function failed.

# [SEE ALSO](#SEE_ALSO)

[tar(1)](/man/os/libarchive/tar.1), [archive\_read(3)](/man/os/libarchive/archive_read.3), [archive\_read\_set\_options(3)](/man/os/libarchive/archive_read_set_options.3), [libarchive(3)](/man/os/libarchive/libarchive.3)

September 14, 2014 Linux 4.19.0-gvisor

---

Document: archive_read_add_passphrase(3) from libarchive 3.8.11-r0 (Chainguard OS)
Source: https://github.com/libarchive/libarchive