Portable Network Archive (PNA)

Portable Network Archive (PNA) is a flexible, secure, and cross-platform archive format inspired by the PNG data structure. It combines the simplicity of ZIP with the robustness of TAR, providing efficient compression, strong encryption, and seamless splitting and streaming capabilities.

Why PNA?

Portable Network Archive (PNA): A Flexible, Secure, and Cross-Platform Archive Format

• Portability: Works seamlessly across multiple platforms, combining the strengths of TAR and ZIP formats.
• Compression Flexibility: Advanced per-file and archive-wide compression options reduce the need for full archive decompression.
• Encryption & Security: Supports 256-bit AES and Camellia for robust protection of sensitive data.
• Splittable Structure: Based on PNG’s data unit structure, enabling the easy division of large archives into smaller parts.
• Streamability: Supports serial read and write operations, making it suitable for streaming processing, similar to a TAR format.
• Extensibility: Designed to accommodate future extensions and private add-ons, ensuring compatibility with the basic PNA format while allowing for flexible customization.
• Error Resilience: File integrity checks and error detection ensure data is secure during transmission.

Additionally, the PNA specification includes a rationale appendix to help developers understand key design choices, making implementation more straightforward.

Features

• File Compression and Decompression

  • Supports zlib, zstd, and xz.

• File Encryption and Decryption

  • Supports 256-bit AES and 256-bit Camellia.

• Solid Mode

  • Compresses and encrypts the entire archive as a single block.

• File Attribute Preservation (Maintains and restores)

  • File permissions.
  • File timestamps.
  • Extended attributes.
  • Access Control Lists (ACLs) (experimental).

CLI Supported Platform

• Cross-platform support including Windows, Linux, macOS, and FreeBSD
  (Support for additional platforms planned.)

Installation

Via Cargo

cargo install portable-network-archive

From Source (via Cargo)

cargo install --git https://github.com/ChanTsune/Portable-Network-Archive.git portable-network-archive

Basic Usage

Create an archive:

pna create <ARCHIVE> [FILES]...

Extract an archive:

pna extract <ARCHIVE>

List archive contents:

pna list <ARCHIVE>

For more commands and options:

pna --help

Specification

Detailed information is available in the Specification document.

License

This project is licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.