Skip to content

Commit

Permalink
Update README.md, add notice about perms/ownership
Browse files Browse the repository at this point in the history
  • Loading branch information
Stephen-Seo committed Jan 9, 2025
1 parent a9b29c6 commit 31cd517
Show file tree
Hide file tree
Showing 2 changed files with 7 additions and 0 deletions.
3 changes: 3 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,13 +45,16 @@ API calls.
Note that by default Username is preferred over UID
--extract-prefer-gid : Prefer GID over Group when extracting
Note that by default Group is preferred over UID
--map-user <UID/Uname>:<UID/Uname> : Maps a UID/Username to UID/Username
--map-group <GID/Gname>:<GID/Gname> : Maps a GID/Group to GID/Group
--force-file-permissions <3-octal-values> : Force set permissions for files on archive creation/extraction
Must be three octal characters like "755" or "440"
--force-dir-permissions <3-octal-values> : Force set permissions for directories on archive creation/extraction
Must be three octal characters like "755" or "440"
-- : 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 permissions/ownership/remapping is saved when archiving, but when extracting they are only preserved when extracting as root!

Note that `--compressor` and `--decompressor` cmds must accept data from stdin
and return processed data to stdout.
Expand Down
4 changes: 4 additions & 0 deletions src/parser.c
Original file line number Diff line number Diff line change
Expand Up @@ -243,6 +243,10 @@ void simple_archiver_print_usage(void) {
fprintf(
stderr,
"If extracting archive file, remaining args specify files to extract.\n");
fprintf(stderr,
"Note that permissions/ownership/remapping is saved when archiving, "
"but when extracting they are only preserved when extracting as root!"
"\n");
}

SDArchiverParsed simple_archiver_create_parsed(void) {
Expand Down

0 comments on commit 31cd517

Please sign in to comment.