GNUTAR(1) Schilys USER COMMANDS GNUTAR(1)
NAME
gnutar - emulates the GNU version(1,3,5) of the tar archiver
SYNOPSIS
gnutar command [ options ] file1 ... filen
DESCRIPTION
This manual page documents the GNU version(1,3,5) of tar, an archiving program
designed to store and extract files from an archive file(1,n) known as a
tarfile. A tarfile may be made on a tape drive, however, it is also
common to write(1,2) a tarfile to a normal file. The first argument to gnu-
tar must be one of the options: Acdrtux, followed by any optional func-
tions. The final arguments to gnutar are the names of the files or
directories which should be archived. The use of a directory name
always implies that the subdirectories below should be included in(1,8) the
archive.
COMMAND
One of the following commands must be used:
-A, --catenate, --concatenate
append tar files to an archive
-c, --create
create a new archive
-d, --diff, --compare
find differences between archive and file(1,n) system
--delete
delete from the archive (not for use on mag tapes!)
-r, --append
append files to the end of an archive
-t, --list
list the contents of an archive
-u, --update
only append files that are newer than copy in(1,8) archive
-x, --extract, --get
extract files from an archive
OPTIONS
--atime-preserve
don't change access(2,5) times on dumped files
-b, --block-size N
block size of Nx512 bytes (default N=20)
-B, --read-full-blocks
reblock as we read(2,n,1 builtins) (for reading 4.2BSD pipes)
-C, --directory DIR
change to directory DIR
--checkpoint
print directory names while reading the archive
-f, --file [HOSTNAME:]F
use archive file(1,n) or device F (default /dev/rmt0)
--force-local
archive file(1,n) is local even if(3,n) has a colon
-F, --info-script F, --new-volume-script F
run script at end of each tape (implies -M)
-G, --incremental
create/list/extract old GNU-format incremental backup
-g, --listed-incremental F
create/list/extract new GNU-format incremental backup
-h, --dereference
don't dump symlinks; dump the files they point to
-i, --ignore-zeros
ignore blocks of zeros in(1,8) archive (normally mean EOF)
-j, --bzip
filter(1,3x,3x curs_util) the archive through bzip2.
--ignore-failed-read
don't exit(3,n,1 builtins) with non-zero status on unreadable files
-k, --keep-old-files
keep existing files; don't overwrite them from archive
-K, --starting-file F
begin at file(1,n) F in(1,8) the archive
-l, --one-file-system
stay in(1,8) local file(1,n) system when creating an archive
-L, --tape-length N
change tapes after writing N*1024 bytes
-m, --modification-time
don't extract file(1,n) modified time(1,2,n)
-M, --multi-volume
create/list/extract multi-volume archive
-N, --after-date DATE, --newer DATE
only store files newer than DATE
-o, --old-archive, --portability
write(1,2) a V7 format archive, rather than ANSI format
-O, --to-stdout
extract files to standard output
-p, --same-permissions, --preserve-permissions
extract all protection information
-P, --absolute-paths
don't strip leading `/'s from file(1,n) names
--preserve
like -p -s.
-R, --record-number
show record number within archive with each message
--remove-files
remove files after adding them to the archive
-s, --same-order, --preserve-order
list of names to extract is sorted to match archive
--same-owner
create extracted files with the same ownership
-S, --sparse
handle sparse files efficiently
-T, --files-from= F
get names to extract or create from file(1,n) F
--null
-T reads null-terminated names, disable -C
--totals
print total bytes written with --create
-v, --verbose
verbosely list files processed
-V, --label NAME
create archive with volume name NAME
--version
print gnutar program version(1,3,5) number
-w, --interactive, --confirmation
ask for confirmation for every action
-W, --verify
attempt to verify(1,8) the archive after writing it
--exclude FILE
exclude file(1,n) FILE
-X, --exclude-from FILE
exclude files listed in(1,8) FILE
-Z, --compress, --uncompress
filter(1,3x,3x curs_util) the archive through compress
-z, --gzip, --ungzip
filter(1,3x,3x curs_util) the archive through gzip
--use-compress-program PROG
filter(1,3x,3x curs_util) the archive through PROG (which must accept(2,8) -d)
EXTENDED OPTIONS
The extended options are options taken from star(1,4).
--help Prints a summary of the most important options for gnutar(1) and
exits.
--xhelp
Prints a summary of the less(1,3) important options for gnutar(1) and
exits.
--version
Prints the gnutar version(1,3,5) number string(3,n) and exists.
--debug
print additional debug messages
xdebug=#
xd=# set(7,n,1 builtins) extended debug level
-/ don't strip leading '/'s from file(1,n) names
-.. don't skip filenames that contain '..' in(1,8) non-interactive
extract
--secure-links
don't extract links that start with '/' or contain '..'
--acl handle access(2,5) control lists
--xfflags
handle extended file(1,n) flags
bs=# set(7,n,1 builtins) (output) block size to #
fs=# set(7,n,1 builtins) fifo size to #
--no-fsync
do not call fsync() for each extracted file(1,n) (may be dangerous)
--time print timing info(1,5,n)
--no-statistics
do not print statistics
--fifostats
print fifo statistics
--no-fifo
don't use a fifo to optimize data flow from/to tape
--numeric
don't use user/group name from tape
The options above are not defined by GNU tar.
For a complete documentation of the star(1,4) based optione check star(1,4)(1).
EXAMPLES
ENVIRONMENT
FILES
SEE ALSO
spax(1), suntar(1), scpio(1), tar(1), cpio(1), pax(1), rcp(1), mt(1),
rmt(1), match(1), dd(1), sdd(1), rsh(1), ssh(1), star(1,4)(1), star(1,4)(4/5),
rcmd(3), fssnap(1m)
DIAGNOSTICS
NOTES
This gnutar implementation is based on the star(1,4) implementation and does
not implement all features of the original GNU tar program.
BUGS
AUTHOR
Joerg Schilling
Seestr. 110
D-13353 Berlin
Germany
Mail bugs and suggestions to:
schilling@fokus.fraunhofer.de or js@cs.tu-berlin.de or
joerg@schily.isdn.cs.tu-berlin.de
Joerg Schilling 04/09/26 GNUTAR(1)