+static struct argp_option options[] = {
+ {NULL, 0, NULL, 0,
+ N_("Main operation mode:"), 0},
+
+ {"list", 't', 0, 0,
+ N_("list the contents of an archive"), 10 },
+ {"extract", 'x', 0, 0,
+ N_("extract files from an archive"), 10 },
+ {"get", 0, 0, OPTION_ALIAS, NULL, 0 },
+ {"create", 'c', 0, 0,
+ N_("create a new archive"), 10 },
+ {"diff", 'd', 0, 0,
+ N_("find differences between archive and file system"), 10 },
+ {"compare", 0, 0, OPTION_ALIAS, NULL, 10},
+ {"append", 'r', 0, 0,
+ N_("append files to the end of an archive"), 10 },
+ {"update", 'u', 0, 0,
+ N_("only append files newer than copy in archive"), 10 },
+ {"catenate", 'A', 0, 0,
+ N_("append tar files to an archive"), 10 },
+ {"concatenate", 0, 0, OPTION_ALIAS, NULL, 10},
+ {"delete", DELETE_OPTION, 0, 0,
+ N_("delete from the archive (not on mag tapes!)"), 10 },
+ {"test-label", TEST_LABEL_OPTION, NULL, 0,
+ N_("Test archive volume label and exit"), 10 },
+
+ {NULL, 0, NULL, 0,
+ N_("Operation modifiers:"), 20},
+
+ {"sparse", 'S', 0, 0,
+ N_("handle sparse files efficiently"), 21 },
+ {"incremental", 'G', 0, 0,
+ N_("handle old GNU-format incremental backup"), 21 },
+ {"listed-incremental", 'g', N_("FILE"), 0,
+ N_("handle new GNU-format incremental backup"), 21 },
+ {"ignore-failed-read", IGNORE_FAILED_READ_OPTION, 0, 0,
+ N_("do not exit with nonzero on unreadable files"), 21 },
+ {"occurrence", OCCURRENCE_OPTION, N_("NUMBER"), OPTION_ARG_OPTIONAL,
+ N_("process only the NUMBERth occurrence of each file in the archive. This option is valid only in conjunction with one of the subcommands --delete, --diff, --extract or --list and when a list of files is given either on the command line or via -T option. NUMBER defaults to 1."), 21 },
+ {"seek", 'n', NULL, 0,
+ N_("archive is seekable"), 21 },
+
+ {NULL, 0, NULL, 0,
+ N_("Overwrite control:"), 30},
+
+ {"verify", 'W', 0, 0,
+ N_("attempt to verify the archive after writing it"), 31 },
+ {"remove-files", REMOVE_FILES_OPTION, 0, 0,
+ N_("remove files after adding them to the archive"), 31 },
+ {"keep-old-files", 'k', 0, 0,
+ N_("don't replace existing files when extracting"), 31 },
+ {"keep-newer-files", KEEP_NEWER_FILES_OPTION, 0, 0,
+ N_("don't replace existing files that are newer than their archive copies"), 31 },
+ {"overwrite", OVERWRITE_OPTION, 0, 0,
+ N_("overwrite existing files when extracting"), 31 },
+ {"unlink-first", 'U', 0, 0,
+ N_("remove each file prior to extracting over it"), 31 },
+ {"recursive-unlink", RECURSIVE_UNLINK_OPTION, 0, 0,
+ N_("empty hierarchies prior to extracting directory"), 31 },
+ {"no-overwrite-dir", NO_OVERWRITE_DIR_OPTION, 0, 0,
+ N_("preserve metadata of existing directories"), 31 },
+
+ {NULL, 0, NULL, 0,
+ N_("Select output stream:"), 40},
+
+ {"to-stdout", 'O', 0, 0,
+ N_("extract files to standard output"), 41 },
+ {"to-command", TO_COMMAND_OPTION, N_("COMMAND"), 0,
+ N_("pipe extracted files to another program"), 41 },
+ {"ignore-command-error", IGNORE_COMMAND_ERROR_OPTION, 0, 0,
+ N_("ignore exit codes of children"), 41 },
+ {"no-ignore-command-error", NO_IGNORE_COMMAND_ERROR_OPTION, 0, 0,
+ N_("treat non-zero exit codes of children as error"), 41 },
+
+ {NULL, 0, NULL, 0,
+ N_("Handling of file attributes:"), 50 },
+
+ {"owner", OWNER_OPTION, N_("NAME"), 0,
+ N_("force NAME as owner for added files"), 51 },
+ {"group", GROUP_OPTION, N_("NAME"), 0,
+ N_("force NAME as group for added files"), 51 },
+ {"mode", MODE_OPTION, N_("CHANGES"), 0,
+ N_("force (symbolic) mode CHANGES for added files"), 51 },
+ {"atime-preserve", ATIME_PRESERVE_OPTION, 0, 0,
+ N_("don't change access times on dumped files"), 51 },
+ {"touch", 'm', 0, 0,
+ N_("don't extract file modified time"), 51 },
+ {"same-owner", SAME_OWNER_OPTION, 0, 0,
+ N_("try extracting files with the same ownership"), 51 },
+ {"no-same-owner", NO_SAME_OWNER_OPTION, 0, 0,
+ N_("extract files as yourself"), 51 },
+ {"numeric-owner", NUMERIC_OWNER_OPTION, 0, 0,
+ N_("always use numbers for user/group names"), 51 },
+ {"preserve-permissions", 'p', 0, 0,
+ N_("extract information about file permissions (default for superuser)"),
+ 51 },
+ {"same-permissions", 0, 0, OPTION_ALIAS, NULL, 51 },
+ {"no-same-permissions", NO_SAME_PERMISSIONS_OPTION, 0, 0,
+ N_("apply the user's umask when extracting permissions from the archive (default for ordinary users)"), 51 },
+ {"preserve-order", 's', 0, 0,
+ N_("sort names to extract to match archive"), 51 },
+ {"same-order", 0, 0, OPTION_ALIAS, NULL, 51 },
+ {"preserve", PRESERVE_OPTION, 0, 0,
+ N_("same as both -p and -s"), 51 },
+
+ {NULL, 0, NULL, 0,
+ N_("Device selection and switching:"), 60 },
+
+ {"file", 'f', N_("ARCHIVE"), 0,
+ N_("use archive file or device ARCHIVE"), 61 },
+ {"force-local", FORCE_LOCAL_OPTION, 0, 0,
+ N_("archive file is local even if it has a colon"), 61 },
+ {"rmt-command", RMT_COMMAND_OPTION, N_("COMMAND"), 0,
+ N_("use given rmt COMMAND instead of rmt"), 61 },
+ {"rsh-command", RSH_COMMAND_OPTION, N_("COMMAND"), 0,
+ N_("use remote COMMAND instead of rsh"), 61 },
+#ifdef DEVICE_PREFIX
+ {"-[0-7][lmh]", 0, NULL, OPTION_DOC, /* It is OK, since `name' will never be
+ translated */
+ N_("specify drive and density"), 61 },
+#endif
+ {NULL, '0', NULL, OPTION_HIDDEN, NULL, 61 },
+ {NULL, '1', NULL, OPTION_HIDDEN, NULL, 61 },
+ {NULL, '2', NULL, OPTION_HIDDEN, NULL, 61 },
+ {NULL, '3', NULL, OPTION_HIDDEN, NULL, 61 },
+ {NULL, '4', NULL, OPTION_HIDDEN, NULL, 61 },
+ {NULL, '5', NULL, OPTION_HIDDEN, NULL, 61 },
+ {NULL, '6', NULL, OPTION_HIDDEN, NULL, 61 },
+ {NULL, '7', NULL, OPTION_HIDDEN, NULL, 61 },
+ {NULL, '8', NULL, OPTION_HIDDEN, NULL, 61 },
+ {NULL, '9', NULL, OPTION_HIDDEN, NULL, 61 },
+
+ {"multi-volume", 'M', 0, 0,
+ N_("create/list/extract multi-volume archive"), 61 },
+ {"tape-length", 'L', N_("NUMBER"), 0,
+ N_("change tape after writing NUMBER x 1024 bytes"), 61 },
+ {"info-script", 'F', N_("NAME"), 0,
+ N_("run script at end of each tape (implies -M)"), 61 },
+ {"new-volume-script", 0, 0, OPTION_ALIAS, NULL, 61 },
+ {"volno-file", VOLNO_FILE_OPTION, N_("FILE"), 0,
+ N_("use/update the volume number in FILE"), 61 },
+
+ {NULL, 0, NULL, 0,
+ N_("Device blocking:"), 70 },
+
+ {"blocking-factor", 'b', N_("BLOCKS"), 0,
+ N_("BLOCKS x 512 bytes per record"), 71 },
+ {"record-size", RECORD_SIZE_OPTION, N_("NUMBER"), 0,
+ N_("NUMBER of bytes per record, multiple of 512"), 71 },
+ {"ignore-zeros", 'i', 0, 0,
+ N_("ignore zeroed blocks in archive (means EOF)"), 71 },
+ {"read-full-records", 'B', 0, 0,
+ N_("reblock as we read (for 4.2BSD pipes)"), 71 },
+
+ {NULL, 0, NULL, 0,
+ N_("Archive format selection:"), 80 },
+
+ {"format", 'H', N_("FORMAT"), 0,
+ N_("create archive of the given format."), 81 },
+
+ {NULL, 0, NULL, 0, N_("FORMAT is one of the following:"), 82 },
+ {" v7", 0, NULL, OPTION_DOC|OPTION_NO_TRANS, N_("old V7 tar format"), 83},
+ {" oldgnu", 0, NULL, OPTION_DOC|OPTION_NO_TRANS,
+ N_("GNU format as per tar <= 1.12"), 83},
+ {" gnu", 0, NULL, OPTION_DOC|OPTION_NO_TRANS,
+ N_("GNU tar 1.13.x format"), 83},
+ {" ustar", 0, NULL, OPTION_DOC|OPTION_NO_TRANS,
+ N_("POSIX 1003.1-1988 (ustar) format"), 83 },
+ {" pax", 0, NULL, OPTION_DOC|OPTION_NO_TRANS,
+ N_("POSIX 1003.1-2001 (pax) format"), 83 },
+ {" posix", 0, NULL, OPTION_DOC|OPTION_NO_TRANS, N_("same as pax"), 83 },
+
+ {"old-archive", OLD_ARCHIVE_OPTION, 0, 0, /* FIXME */
+ N_("same as --format=v7"), 88 },
+ {"portability", 0, 0, OPTION_ALIAS, NULL, 88 },
+ {"posix", POSIX_OPTION, 0, 0,
+ N_("same as --format=posix"), 88 },
+ {"pax-option", PAX_OPTION, N_("keyword[[:]=value][,keyword[[:]=value], ...]"), 0,
+ N_("control pax keywords"), 88 },
+ {"label", 'V', N_("TEXT"), 0,
+ N_("create archive with volume name TEXT. At list/extract time, use TEXT as a globbing pattern for volume name"), 88 },
+ {"bzip2", 'j', 0, 0,
+ N_("filter the archive through bzip2"), 88 },
+ {"gzip", 'z', 0, 0,
+ N_("filter the archive through gzip"), 88 },
+ {"gunzip", 0, 0, OPTION_ALIAS, NULL, 88 },
+ {"ungzip", 0, 0, OPTION_ALIAS, NULL, 88 },
+ {"compress", 'Z', 0, 0,
+ N_("filter the archive through compress"), 88 },
+ {"uncompress", 0, 0, OPTION_ALIAS, NULL, 88 },
+ {"use-compress-program", USE_COMPRESS_PROGRAM_OPTION, N_("PROG"), 0,
+ N_("filter through PROG (must accept -d)"), 88 },
+
+ {NULL, 0, NULL, 0,
+ N_("Local file selection:"), 90 },
+
+ {"add-file", ARGP_KEY_ARG, N_("FILE"), 0,
+ N_("add given FILE to the archive (useful if its name starts with a dash)"), 91},
+ {"directory", 'C', N_("DIR"), 0,
+ N_("change to directory DIR"), 91 },
+ {"files-from", 'T', N_("FILE"), 0,
+ N_("get names to extract or create from FILE"), 91 },
+ {"null", NULL_OPTION, 0, 0,
+ N_("-T reads null-terminated names, disable -C"), 91 },
+ {"unquote", UNQUOTE_OPTION, 0, 0,
+ N_("unquote filenames read with -T (default)"), 91 },
+ {"no-unquote", NO_UNQUOTE_OPTION, 0, 0,
+ N_("do not unquote filenames read with -T"), 91 },
+ {"exclude", EXCLUDE_OPTION, N_("PATTERN"), 0,
+ N_("exclude files, given as a PATTERN"), 91 },
+ {"exclude-from", 'X', N_("FILE"), 0,
+ N_("exclude patterns listed in FILE"), 91 },
+ {"exclude-caches", EXCLUDE_CACHES_OPTION, 0, 0,
+ N_("exclude directories containing a cache tag"), 91 },
+ {"ignore-case", IGNORE_CASE_OPTION, 0, 0,
+ N_("exclusion ignores case"), 91 },
+ {"anchored", ANCHORED_OPTION, 0, 0,
+ N_("exclude patterns match file name start"), 91 },
+ {"no-anchored", NO_ANCHORED_OPTION, 0, 0,
+ N_("exclude patterns match after any `/' (default)"), 91 },
+ {"no-ignore-case", NO_IGNORE_CASE_OPTION, 0, 0,
+ N_("exclusion is case sensitive (default)"), 91 },
+ {"no-wildcards", NO_WILDCARDS_OPTION, 0, 0,
+ N_("exclude patterns are plain strings"), 91 },
+ {"no-wildcards-match-slash", NO_WILDCARDS_MATCH_SLASH_OPTION, 0, 0,
+ N_("exclude pattern wildcards do not match `/'"), 91 },
+ {"no-recursion", NO_RECURSION_OPTION, 0, 0,
+ N_("avoid descending automatically in directories"), 91 },
+ {"one-file-system", ONE_FILE_SYSTEM_OPTION, 0, 0,
+ N_("stay in local file system when creating archive"), 91 },
+ {NULL, 'l', 0, OPTION_HIDDEN, "", 91},
+ {"recursion", RECURSION_OPTION, 0, 0,
+ N_("recurse into directories (default)"), 91 },
+ {"absolute-names", 'P', 0, 0,
+ N_("don't strip leading `/'s from file names"), 91 },
+ {"dereference", 'h', 0, 0,
+ N_("follow symlinks; archive and dump the files they point to"), 91 },
+ {"starting-file", 'K', N_("MEMBER-NAME"), 0,
+ N_("begin at member MEMBER-NAME in the archive"), 91 },
+ {"strip-components", STRIP_COMPONENTS_OPTION, N_("NUMBER"), 0,
+ N_("strip NUMBER leading components from file names"), 91 },
+ {"newer", 'N', N_("DATE-OR-FILE"), 0,
+ N_("only store files newer than DATE-OR-FILE"), 91 },
+ {"newer-mtime", NEWER_MTIME_OPTION, N_("DATE"), 0,
+ N_("compare date and time when data changed only"), 91 },
+ {"after-date", 'N', N_("DATE"), 0,
+ N_("same as -N"), 91 },
+ {"backup", BACKUP_OPTION, N_("CONTROL"), OPTION_ARG_OPTIONAL,
+ N_("backup before removal, choose version CONTROL"), 91 },
+ {"suffix", SUFFIX_OPTION, N_("STRING"), 0,
+ N_("backup before removal, override usual suffix ('~' unless overridden by environment variable SIMPLE_BACKUP_SUFFIX)"), 91 },
+ {"wildcards", WILDCARDS_OPTION, 0, 0,
+ N_("exclude patterns use wildcards (default)"), 91 },
+ {"wildcards-match-slash", WILDCARDS_MATCH_SLASH_OPTION, 0, 0,
+ N_("exclude pattern wildcards match `/' (default)"), 91 },
+
+ {NULL, 0, NULL, 0,
+ N_("Informative output:"), 100 },
+
+ {"verbose", 'v', 0, 0,
+ N_("verbosely list files processed"), 101 },
+ {"checkpoint", CHECKPOINT_OPTION, 0, 0,
+ N_("display progress messages every 10th record"), 101 },
+ {"check-links", CHECK_LINKS_OPTION, 0, 0,
+ N_("print a message if not all links are dumped"), 102 },
+ {"totals", TOTALS_OPTION, 0, 0,
+ N_("print total bytes written while creating archive"), 102 },
+ {"utc", UTC_OPTION, 0, 0,
+ N_("print file modification dates in UTC"), 102 },
+ {"index-file", INDEX_FILE_OPTION, N_("FILE"), 0,
+ N_("send verbose output to FILE"), 102 },
+ {"block-number", 'R', 0, 0,
+ N_("show block number within archive with each message"), 102 },
+ {"interactive", 'w', 0, 0,
+ N_("ask for confirmation for every action"), 102 },
+ {"confirmation", 0, 0, OPTION_ALIAS, NULL, 102 },
+ {"show-defaults", SHOW_DEFAULTS_OPTION, 0, 0,
+ N_("Show tar defaults"), 102 },
+ {"show-omitted-dirs", SHOW_OMITTED_DIRS_OPTION, 0, 0,
+ N_("When listing or extracting, list each directory that does not match search criteria"), 102 },
+ {"show-stored-names", SHOW_STORED_NAMES_OPTION, 0, 0,
+ N_("When creating archive in verbose mode, list member names as stored in the archive"),
+ 102 },
+
+ {NULL, 0, NULL, 0,
+ N_("Compatibility options:"), 110 },
+
+ {NULL, 'o', 0, 0,
+ N_("when creating, same as --old-archive. When extracting, same as --no-same-owner"), 111 },
+
+ {NULL, 0, NULL, 0,
+ N_("Other options:"), 120 },
+
+ {"help", '?', 0, 0, N_("Give this help list"), -1},
+ {"usage", USAGE_OPTION, 0, 0, N_("Give a short usage message"), -1},
+ {"license", LICENSE_OPTION, 0, 0, N_("Print license and exit"), -1},
+ {"version", VERSION_OPTION, 0, 0, N_("Print program version"), -1},
+ /* FIXME -V (--label) conflicts with the default short option for
+ --version */
+ {"HANG", HANG_OPTION, "SECS", OPTION_ARG_OPTIONAL | OPTION_HIDDEN,
+ N_("Hang for SECS seconds (default 3600)"), 0},
+ {0, 0, 0, 0, 0, 0}
+};
+
+struct tar_args {
+ char const *textual_date_option;
+ int exclude_options;
+ bool o_option;
+ int pax_option;
+ char const *backup_suffix_string;
+ char const *version_control_string;
+ int input_files;
+};
+
+static void
+show_default_settings (FILE *stream)
+{
+ fprintf (stream,
+ "--format=%s -f%s -b%d --rmt-command=%s",
+ archive_format_string (DEFAULT_ARCHIVE_FORMAT),
+ DEFAULT_ARCHIVE, DEFAULT_BLOCKING,
+ DEFAULT_RMT_COMMAND);
+#ifdef REMOTE_SHELL
+ fprintf (stream, " --rsh-command=%s", REMOTE_SHELL);
+#endif
+ fprintf (stream, "\n");
+}