An archiver which is like a tar alternative.
Find a file
Stephen Seo fb1c24ba2c
All checks were successful
Run Unit Tests / build-and-run-unit-tests (push) Successful in 6s
Safe-links enforce on extract, fixes/refactorings
Resolves #20
2024-10-24 13:40:29 +09:00
.forgejo/workflows Add action/workflow to build/release tags 2024-10-08 12:56:05 +09:00
cosmopolitan Impl. basic functionality "MVP" 2024-07-16 16:16:58 +09:00
src Safe-links enforce on extract, fixes/refactorings 2024-10-24 13:40:29 +09:00
test_files Cleanup of example test files 2024-10-08 14:04:36 +09:00
.gitignore Impl. parser (TODO Fix invalid free crash) 2024-06-27 11:57:29 +09:00
Changelog.md Version 1.5, update Changelog.md 2024-10-21 17:38:53 +09:00
CMakeLists.txt Impl. pre-sort files by size before put in chunks 2024-10-08 15:12:44 +09:00
file_format.md Impl. safe-link checking for v1 file format 2024-10-21 17:12:48 +09:00
LICENSE Switch to ISC License 2024-08-30 11:36:11 +09:00
README.md Update README.md 2024-10-21 17:22:08 +09:00

Simple Archiver

This program is not yet almost basically finished! Basic Necessary functionality is implemented and only some advanced features are missing some extra features are not yet implemented. You can track progress here.

This program exists because I could not get tar or ar to compile with Cosmopolitan. Thus, this archiver will be written with support for Cosmopolitan in mind. This means sticking to the C programming language and possibly using Cosmopolitan-specfic API calls.

Usage

Usage flags:
-c : create archive file
-x : extract archive file
-t : examine archive file
-f <filename> : filename to work on
  Use "-f -" to work on stdout when creating archive or stdin when reading archive
  NOTICE: "-f" is not affected by "-C"!
-C <dir> : Change current working directory before archiving/extracting
--compressor <full_compress_cmd> : requires --decompressor and cmd must use stdin/stdout
--decompressor <full_decompress_cmd> : requires --compressor and cmd must use stdin/stdout
  Specifying "--decompressor" when extracting overrides archive file's stored decompressor cmd
--overwrite-create : allows overwriting an archive file
--overwrite-extract : allows overwriting when extracting
--no-abs-symlink : do not store absolute paths for symlinks
--no-safe-links : keep symlinks that link to outside archive contents
--temp-files-dir <dir> : where to store temporary files created when compressing (defaults to current working directory)
--write-version <version> : Force write version file format (default 1)
--chunk-min-size <bytes> : v1 file format minimum chunk size (default 4194304 or 4MiB)
--no-pre-sort-files : do NOT pre-sort files by size (by default enabled so that the first file is the largest)
-- : specifies remaining arguments are files to archive/extract
If creating archive file, remaining args specify files to archive.
If extracting archive file, remaining args specify files to extract.

Note that --compressor and --decompressor cmds must accept data from stdin and return processed data to stdout.

Changes

See the Changelog.

LICENSE Information

Uses the ISC License.