|
@@ -0,0 +1,471 @@
|
|
|
|
+/* Common declarations for the tar program.
|
|
|
|
+ Copyright (C) 1988, 92, 93, 94, 96, 97 Free Software Foundation, Inc.
|
|
|
|
+
|
|
|
|
+ This program is free software; you can redistribute it and/or modify it
|
|
|
|
+ under the terms of the GNU General Public License as published by the
|
|
|
|
+ Free Software Foundation; either version 2, or (at your option) any later
|
|
|
|
+ version.
|
|
|
|
+
|
|
|
|
+ This program is distributed in the hope that it will be useful, but
|
|
|
|
+ WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
|
|
|
|
+ Public License for more details.
|
|
|
|
+
|
|
|
|
+ You should have received a copy of the GNU General Public License along
|
|
|
|
+ with this program; if not, write to the Free Software Foundation, Inc.,
|
|
|
|
+ 59 Place - Suite 330, Boston, MA 02111-1307, USA. */
|
|
|
|
+
|
|
|
|
+/* Declare the GNU tar archive format. */
|
|
|
|
+#include "tar.h"
|
|
|
|
+
|
|
|
|
+/* The checksum field is filled with this while the checksum is computed. */
|
|
|
|
+#define CHKBLANKS " " /* 8 blanks, no null */
|
|
|
|
+
|
|
|
|
+/* Some constants from POSIX are given names. */
|
|
|
|
+#define NAME_FIELD_SIZE 100
|
|
|
|
+#define PREFIX_FIELD_SIZE 155
|
|
|
|
+#define UNAME_FIELD_SIZE 32
|
|
|
|
+#define GNAME_FIELD_SIZE 32
|
|
|
|
+
|
|
|
|
+/* POSIX specified symbols currently unused are undefined here. */
|
|
|
|
+#undef TSUID
|
|
|
|
+#undef TSGID
|
|
|
|
+#undef TSVTX
|
|
|
|
+#undef TUREAD
|
|
|
|
+#undef TUWRITE
|
|
|
|
+#undef TUEXEC
|
|
|
|
+#undef TGREAD
|
|
|
|
+#undef TGWRITE
|
|
|
|
+#undef TGEXEC
|
|
|
|
+#undef TOREAD
|
|
|
|
+#undef TOWRITE
|
|
|
|
+#undef TOEXEC
|
|
|
|
+
|
|
|
|
+/* Some various global definitions. */
|
|
|
|
+
|
|
|
|
+/* Name of file to use for interacting with user. */
|
|
|
|
+#if MSDOS
|
|
|
|
+# define TTY_NAME "con"
|
|
|
|
+#else
|
|
|
|
+# define TTY_NAME "/dev/tty"
|
|
|
|
+#endif
|
|
|
|
+
|
|
|
|
+/* GLOBAL is defined to empty in `tar.c' only, and left alone in other `*.c'
|
|
|
|
+ modules. Here, we merely set it to "extern" if it is not already set.
|
|
|
|
+ GNU tar does depend on the system loader to preset all GLOBAL variables to
|
|
|
|
+ neutral (or zero) values, explicit initialisation is usually not done. */
|
|
|
|
+#ifndef GLOBAL
|
|
|
|
+# define GLOBAL extern
|
|
|
|
+#endif
|
|
|
|
+
|
|
|
|
+/* Exit status for GNU tar. Let's try to keep this list as simple as
|
|
|
|
+ possible. -d option strongly invites a status different for unequal
|
|
|
|
+ comparison and other errors. */
|
|
|
|
+GLOBAL int exit_status;
|
|
|
|
+
|
|
|
|
+#define TAREXIT_SUCCESS 0
|
|
|
|
+#define TAREXIT_DIFFERS 1
|
|
|
|
+#define TAREXIT_FAILURE 2
|
|
|
|
+
|
|
|
|
+/* Both WARN and ERROR write a message on stderr and continue processing,
|
|
|
|
+ however ERROR manages so tar will exit unsuccessfully. FATAL_ERROR
|
|
|
|
+ writes a message on stderr and aborts immediately, with another message
|
|
|
|
+ line telling so. USAGE_ERROR works like FATAL_ERROR except that the
|
|
|
|
+ other message line suggests trying --help. All four macros accept a
|
|
|
|
+ single argument of the form ((0, errno, _("FORMAT"), Args...)). `errno'
|
|
|
|
+ is `0' when the error is not being detected by the system. */
|
|
|
|
+
|
|
|
|
+#define WARN(Args) \
|
|
|
|
+ error Args
|
|
|
|
+#define ERROR(Args) \
|
|
|
|
+ (error Args, exit_status = TAREXIT_FAILURE)
|
|
|
|
+#define FATAL_ERROR(Args) \
|
|
|
|
+ (error Args, error (TAREXIT_FAILURE, 0, \
|
|
|
|
+ _("Error is not recoverable: exiting now")), 0)
|
|
|
|
+#define USAGE_ERROR(Args) \
|
|
|
|
+ (error Args, usage (TAREXIT_FAILURE), 0)
|
|
|
|
+
|
|
|
|
+/* Information gleaned from the command line. */
|
|
|
|
+
|
|
|
|
+#include "arith.h"
|
|
|
|
+#include "modechange.h"
|
|
|
|
+
|
|
|
|
+/* Name of this program. */
|
|
|
|
+GLOBAL const char *program_name;
|
|
|
|
+
|
|
|
|
+/* Main command option. */
|
|
|
|
+
|
|
|
|
+enum subcommand
|
|
|
|
+{
|
|
|
|
+ UNKNOWN_SUBCOMMAND, /* none of the following */
|
|
|
|
+ APPEND_SUBCOMMAND, /* -r */
|
|
|
|
+ CAT_SUBCOMMAND, /* -A */
|
|
|
|
+ CREATE_SUBCOMMAND, /* -c */
|
|
|
|
+ DELETE_SUBCOMMAND, /* -D */
|
|
|
|
+ DIFF_SUBCOMMAND, /* -d */
|
|
|
|
+ EXTRACT_SUBCOMMAND, /* -x */
|
|
|
|
+ LIST_SUBCOMMAND, /* -t */
|
|
|
|
+ UPDATE_SUBCOMMAND /* -u */
|
|
|
|
+};
|
|
|
|
+
|
|
|
|
+GLOBAL enum subcommand subcommand_option;
|
|
|
|
+
|
|
|
|
+/* Selected format for output archive. */
|
|
|
|
+GLOBAL enum archive_format archive_format;
|
|
|
|
+
|
|
|
|
+/* Either NL or NUL, as decided by the --null option. */
|
|
|
|
+GLOBAL char filename_terminator;
|
|
|
|
+
|
|
|
|
+/* Size of each record, once in blocks, once in bytes. Those two variables
|
|
|
|
+ are always related, the second being BLOCKSIZE times the first. They do
|
|
|
|
+ not have _option in their name, even if their values is derived from
|
|
|
|
+ option decoding, as these are especially important in tar. */
|
|
|
|
+GLOBAL int blocking_factor;
|
|
|
|
+GLOBAL int record_size;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int absolute_names_option;
|
|
|
|
+
|
|
|
|
+/* This variable tells how to interpret newer_mtime_option, below. If zero,
|
|
|
|
+ files get archived if their mtime is not less than newer_mtime_option.
|
|
|
|
+ If nonzero, files get archived if *either* their ctime or mtime is not less
|
|
|
|
+ than newer_mtime_option. */
|
|
|
|
+GLOBAL int after_date_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int atime_preserve_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int backup_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int block_number_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int checkpoint_option;
|
|
|
|
+
|
|
|
|
+/* Specified name of compression program, or "gzip" as implied by -z. */
|
|
|
|
+GLOBAL const char *use_compress_program_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int dereference_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int exclude_option;
|
|
|
|
+
|
|
|
|
+/* Specified file containing names to work on. */
|
|
|
|
+GLOBAL const char *files_from_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int force_local_option;
|
|
|
|
+
|
|
|
|
+/* Specified value to be put into tar file in place of stat () results, or
|
|
|
|
+ just -1 if such an override should not take place. */
|
|
|
|
+GLOBAL gid_t group_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int ignore_failed_read_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int ignore_zeros_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int incremental_option;
|
|
|
|
+
|
|
|
|
+/* Specified name of script to run at end of each tape change. */
|
|
|
|
+GLOBAL const char *info_script_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int interactive_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int keep_old_files_option;
|
|
|
|
+
|
|
|
|
+/* Specified file name for incremental list. */
|
|
|
|
+GLOBAL const char *listed_incremental_option;
|
|
|
|
+
|
|
|
|
+/* Specified mode change string. */
|
|
|
|
+GLOBAL struct mode_change *mode_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int multi_volume_option;
|
|
|
|
+
|
|
|
|
+/* The same variable hold the time, whether mtime or ctime. Just fake a
|
|
|
|
+ non-existing option, for making the code clearer, elsewhere. */
|
|
|
|
+#define newer_ctime_option newer_mtime_option
|
|
|
|
+
|
|
|
|
+/* Specified threshold date and time. Files having a more recent timestamp
|
|
|
|
+ get archived (also see after_date_option above). If left to zero, it may
|
|
|
|
+ be interpreted as very low threshold, just usable as such. */
|
|
|
|
+GLOBAL time_t newer_mtime_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int no_recurse_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int numeric_owner_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int one_file_system_option;
|
|
|
|
+
|
|
|
|
+/* Specified value to be put into tar file in place of stat () results, or
|
|
|
|
+ just -1 if such an override should not take place. */
|
|
|
|
+GLOBAL uid_t owner_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int recursive_unlink_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int read_full_records_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int remove_files_option;
|
|
|
|
+
|
|
|
|
+/* Specified remote shell command. */
|
|
|
|
+GLOBAL const char *rsh_command_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int same_order_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int same_owner_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int same_permissions_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int show_omitted_dirs_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int sparse_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int starting_file_option;
|
|
|
|
+
|
|
|
|
+/* Specified maximum byte length of each tape volume (multiple of 1024). */
|
|
|
|
+GLOBAL tarlong tape_length_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int to_stdout_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int totals_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int touch_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int unlink_first_option;
|
|
|
|
+
|
|
|
|
+/* Count how many times the option has been set, multiple setting yields
|
|
|
|
+ more verbose behavior. Value 0 means no verbosity, 1 means file name
|
|
|
|
+ only, 2 means file name and all attributes. More than 2 is just like 2. */
|
|
|
|
+GLOBAL int verbose_option;
|
|
|
|
+
|
|
|
|
+/* Boolean value. */
|
|
|
|
+GLOBAL int verify_option;
|
|
|
|
+
|
|
|
|
+/* Specified name of file containing the volume number. */
|
|
|
|
+GLOBAL const char *volno_file_option;
|
|
|
|
+
|
|
|
|
+/* Specified value or pattern. */
|
|
|
|
+GLOBAL const char *volume_label_option;
|
|
|
|
+
|
|
|
|
+/* Other global variables. */
|
|
|
|
+
|
|
|
|
+/* File descriptor for archive file. */
|
|
|
|
+GLOBAL int archive;
|
|
|
|
+
|
|
|
|
+/* Nonzero when outputting to /dev/null. */
|
|
|
|
+GLOBAL int dev_null_output;
|
|
|
|
+
|
|
|
|
+/* Name of file for the current archive entry. */
|
|
|
|
+GLOBAL char *current_file_name;
|
|
|
|
+
|
|
|
|
+/* Name of link for the current archive entry. */
|
|
|
|
+GLOBAL char *current_link_name;
|
|
|
|
+
|
|
|
|
+/* List of tape drive names, number of such tape drives, allocated number,
|
|
|
|
+ and current cursor in list. */
|
|
|
|
+GLOBAL const char **archive_name_array;
|
|
|
|
+GLOBAL int archive_names;
|
|
|
|
+GLOBAL int allocated_archive_names;
|
|
|
|
+GLOBAL const char **archive_name_cursor;
|
|
|
|
+
|
|
|
|
+/* Structure for keeping track of filenames and lists thereof. */
|
|
|
|
+struct name
|
|
|
|
+ {
|
|
|
|
+ struct name *next;
|
|
|
|
+ short length; /* cached strlen(name) */
|
|
|
|
+ char found; /* a matching file has been found */
|
|
|
|
+ char firstch; /* first char is literally matched */
|
|
|
|
+ char regexp; /* this name is a regexp, not literal */
|
|
|
|
+ char *change_dir; /* set with the -C option */
|
|
|
|
+ char *dir_contents; /* for incremental_option */
|
|
|
|
+ char fake; /* dummy entry */
|
|
|
|
+ char name[1];
|
|
|
|
+ };
|
|
|
|
+GLOBAL struct name *namelist; /* points to first name in list */
|
|
|
|
+GLOBAL struct name *namelast; /* points to last name in list */
|
|
|
|
+
|
|
|
|
+/* Pointer to the start of the scratch space. */
|
|
|
|
+struct sp_array
|
|
|
|
+ {
|
|
|
|
+ off_t offset;
|
|
|
|
+ int numbytes;
|
|
|
|
+ };
|
|
|
|
+GLOBAL struct sp_array *sparsearray;
|
|
|
|
+
|
|
|
|
+/* Initial size of the sparsearray. */
|
|
|
|
+GLOBAL int sp_array_size;
|
|
|
|
+
|
|
|
|
+/* Declarations for each module. */
|
|
|
|
+
|
|
|
|
+/* FIXME: compare.c should not directly handle the following variable,
|
|
|
|
+ instead, this should be done in buffer.c only. */
|
|
|
|
+
|
|
|
|
+enum access_mode
|
|
|
|
+{
|
|
|
|
+ ACCESS_READ,
|
|
|
|
+ ACCESS_WRITE,
|
|
|
|
+ ACCESS_UPDATE
|
|
|
|
+};
|
|
|
|
+extern enum access_mode access_mode;
|
|
|
|
+
|
|
|
|
+/* Module buffer.c. */
|
|
|
|
+
|
|
|
|
+extern FILE *stdlis;
|
|
|
|
+extern char *save_name;
|
|
|
|
+extern long save_sizeleft;
|
|
|
|
+extern long save_totsize;
|
|
|
|
+extern int write_archive_to_stdout;
|
|
|
|
+
|
|
|
|
+int available_space_after PARAMS ((union block *));
|
|
|
|
+long current_block_ordinal PARAMS ((void));
|
|
|
|
+void close_archive PARAMS ((void));
|
|
|
|
+void closeout_volume_number PARAMS ((void));
|
|
|
|
+union block *find_next_block PARAMS ((void));
|
|
|
|
+void flush_read PARAMS ((void));
|
|
|
|
+void flush_write PARAMS ((void));
|
|
|
|
+void flush_archive PARAMS ((void));
|
|
|
|
+void init_total_written PARAMS ((void));
|
|
|
|
+void init_volume_number PARAMS ((void));
|
|
|
|
+void open_archive PARAMS ((enum access_mode));
|
|
|
|
+void print_total_written PARAMS ((void));
|
|
|
|
+void reset_eof PARAMS ((void));
|
|
|
|
+void set_next_block_after PARAMS ((union block *));
|
|
|
|
+
|
|
|
|
+/* Module create.c. */
|
|
|
|
+
|
|
|
|
+void create_archive PARAMS ((void));
|
|
|
|
+void dump_file PARAMS ((char *, int, int));
|
|
|
|
+void finish_header PARAMS ((union block *));
|
|
|
|
+void to_oct PARAMS ((long, int, char *));
|
|
|
|
+void write_eot PARAMS ((void));
|
|
|
|
+
|
|
|
|
+/* Module diffarch.c. */
|
|
|
|
+
|
|
|
|
+extern int now_verifying;
|
|
|
|
+
|
|
|
|
+void diff_archive PARAMS ((void));
|
|
|
|
+void diff_init PARAMS ((void));
|
|
|
|
+void verify_volume PARAMS ((void));
|
|
|
|
+
|
|
|
|
+/* Module extract.c. */
|
|
|
|
+
|
|
|
|
+void extr_init PARAMS ((void));
|
|
|
|
+void extract_archive PARAMS ((void));
|
|
|
|
+void apply_delayed_set_stat PARAMS ((void));
|
|
|
|
+
|
|
|
|
+/* Module delete.c. */
|
|
|
|
+
|
|
|
|
+void delete_archive_members PARAMS ((void));
|
|
|
|
+
|
|
|
|
+/* Module incremen.c. */
|
|
|
|
+
|
|
|
|
+void collect_and_sort_names PARAMS ((void));
|
|
|
|
+char *get_directory_contents PARAMS ((char *, int));
|
|
|
|
+void write_dir_file PARAMS ((void));
|
|
|
|
+void gnu_restore PARAMS ((int));
|
|
|
|
+void write_directory_file PARAMS ((void));
|
|
|
|
+
|
|
|
|
+/* Module list.c. */
|
|
|
|
+
|
|
|
|
+enum read_header
|
|
|
|
+{
|
|
|
|
+ HEADER_STILL_UNREAD, /* for when read_header has not been called */
|
|
|
|
+ HEADER_SUCCESS, /* header successfully read and checksummed */
|
|
|
|
+ HEADER_ZERO_BLOCK, /* zero block where header expected */
|
|
|
|
+ HEADER_END_OF_FILE, /* true end of file while header expected */
|
|
|
|
+ HEADER_FAILURE /* ill-formed header, or bad checksum */
|
|
|
|
+};
|
|
|
|
+
|
|
|
|
+extern union block *current_header;
|
|
|
|
+extern struct stat current_stat;
|
|
|
|
+extern enum archive_format current_format;
|
|
|
|
+
|
|
|
|
+void decode_header PARAMS ((union block *, struct stat *,
|
|
|
|
+ enum archive_format *, int));
|
|
|
|
+long from_oct PARAMS ((int, char *));
|
|
|
|
+void list_archive PARAMS ((void));
|
|
|
|
+void print_for_mkdir PARAMS ((char *, int, int));
|
|
|
|
+void print_header PARAMS ((void));
|
|
|
|
+void read_and PARAMS ((void (*do_) ()));
|
|
|
|
+enum read_header read_header PARAMS ((void));
|
|
|
|
+void skip_extended_headers PARAMS ((void));
|
|
|
|
+void skip_file PARAMS ((long));
|
|
|
|
+
|
|
|
|
+/* Module mangle.c. */
|
|
|
|
+
|
|
|
|
+void extract_mangle PARAMS ((void));
|
|
|
|
+
|
|
|
|
+/* Module misc.c. */
|
|
|
|
+
|
|
|
|
+void assign_string PARAMS ((char **, const char *));
|
|
|
|
+char *quote_copy_string PARAMS ((const char *));
|
|
|
|
+int unquote_string PARAMS ((char *));
|
|
|
|
+
|
|
|
|
+char *merge_sort PARAMS ((char *, int, int, int (*) (char *, char *)));
|
|
|
|
+
|
|
|
|
+int is_dot_or_dotdot PARAMS ((const char *));
|
|
|
|
+int remove_any_file PARAMS ((const char *, int));
|
|
|
|
+int maybe_backup_file PARAMS ((const char *, int));
|
|
|
|
+void undo_last_backup PARAMS ((void));
|
|
|
|
+
|
|
|
|
+/* Module names.c. */
|
|
|
|
+
|
|
|
|
+void gid_to_gname PARAMS ((gid_t, char gname[GNAME_FIELD_SIZE]));
|
|
|
|
+int gname_to_gid PARAMS ((char gname[GNAME_FIELD_SIZE], gid_t *));
|
|
|
|
+void uid_to_uname PARAMS ((uid_t, char uname[UNAME_FIELD_SIZE]));
|
|
|
|
+int uname_to_uid PARAMS ((char uname[UNAME_FIELD_SIZE], uid_t *));
|
|
|
|
+
|
|
|
|
+void init_names PARAMS ((void));
|
|
|
|
+void name_add PARAMS ((const char *));
|
|
|
|
+void name_init PARAMS ((int, char *const *));
|
|
|
|
+void name_term PARAMS ((void));
|
|
|
|
+char *name_next PARAMS ((int change_));
|
|
|
|
+void name_close PARAMS ((void));
|
|
|
|
+void name_gather PARAMS ((void));
|
|
|
|
+void addname PARAMS ((const char *));
|
|
|
|
+int name_match PARAMS ((const char *));
|
|
|
|
+void names_notfound PARAMS ((void));
|
|
|
|
+void name_expand PARAMS ((void));
|
|
|
|
+struct name *name_scan PARAMS ((const char *));
|
|
|
|
+char *name_from_list PARAMS ((void));
|
|
|
|
+void blank_name_list PARAMS ((void));
|
|
|
|
+char *new_name PARAMS ((const char *, const char *));
|
|
|
|
+
|
|
|
|
+void add_exclude PARAMS ((char *));
|
|
|
|
+void add_exclude_file PARAMS ((const char *));
|
|
|
|
+int check_exclude PARAMS ((const char *));
|
|
|
|
+
|
|
|
|
+/* Module tar.c. */
|
|
|
|
+
|
|
|
|
+int confirm PARAMS ((const char *, const char *));
|
|
|
|
+void request_stdin PARAMS ((const char *));
|
|
|
|
+
|
|
|
|
+/* Module update.c. */
|
|
|
|
+
|
|
|
|
+extern char *output_start;
|
|
|
|
+
|
|
|
|
+void update_archive PARAMS ((void));
|