]> git.seodisparate.com - SimpleArchiver/commitdiff
Update README.md, add notice about perms/ownership
authorStephen Seo <seo.disparate@gmail.com>
Thu, 9 Jan 2025 07:14:32 +0000 (16:14 +0900)
committerStephen Seo <seo.disparate@gmail.com>
Thu, 9 Jan 2025 07:14:32 +0000 (16:14 +0900)
README.md
src/parser.c

index 512aa7f115c49cead269e08806cc9161c7a61913..e4d2dd0b823cfcc2ce4a1bfacb44dd70711909dc 100644 (file)
--- a/README.md
+++ b/README.md
@@ -45,6 +45,8 @@ 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
@@ -52,6 +54,7 @@ API calls.
     -- : 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.
index 3223982ec895c16c3eadcd6b928fba055e0c434b..133aa5292928b327fde9f82d9fb57cdd8d810218 100644 (file)
@@ -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) {