Next: Excluding Some Files, Previous: Selecting Archive Members, Up: Choosing Files and Names for tar
[Contents][Index]
Instead of giving the names of files or archive members on the command
line, you can put the names into a file, and then use the
--files-from=file-of-names (-T
file-of-names) option to tar
. Give the name of the
file which contains the list of files to include as the argument to
--files-from. In the list, the file names should be separated by
newlines. You will frequently use this option when you have generated
the list of files to archive with the find
utility.
Get names to extract or create from file file-name.
If you give a single dash as a file name for --files-from, (i.e.,
you specify either --files-from=-
or -T -
), then the file
names are read from standard input.
Unless you are running tar
with --create, you cannot use
both --files-from=-
and --file=-
(-f -
) in the same
command.
Any number of -T options can be given in the command line.
The following example shows how to use find
to generate a list of
files smaller than 400K in length and put that list into a file
called small-files. You can then use the -T option to
tar
to specify the files from that file, small-files, to
create the archive little.tgz. (The -z option to
tar
compresses the archive with gzip
; see Creating and Reading Compressed Archives for
more information.)
$ find . -size -400 -print > small-files $ tar -c -v -z -T small-files -f little.tgz
By default, each line read from the file list is first stripped off
any leading and trailing whitespace. If the resulting string begins
with ‘-’ character, it is considered a tar
option and is
processed accordingly15. Only a
subset of GNU tar
options is allowed for use in file lists. For
a list of such options, Position-Sensitive Options.
For example, the common use of this feature is to change to another directory by specifying -C option:
$ cat list -C/etc passwd hosts -C/lib libc.a $ tar -c -f foo.tar --files-from list
In this example, tar
will first switch to /etc
directory and add files passwd and hosts to the
archive. Then it will change to /lib directory and will archive
the file libc.a. Thus, the resulting archive foo.tar will
contain:
$ tar tf foo.tar passwd hosts libc.a
Note, that any options used in the file list remain in effect for the rest of the command line. For example, using the same list file as above, the following command
$ tar -c -f foo.tar --files-from list libcurses.a
will look for file libcurses.a in the directory /lib, because it was used with the last -C option (see Position-Sensitive Options).
If such option handling is undesirable, use the --verbatim-files-from option. When this option is in effect, each line read from the file list is treated as a file name. Notice, that this means, in particular, that no whitespace trimming is performed.
The --verbatim-files-from affects all -T options that follow it in the command line. The default behavior can be restored using --no-verbatim-files-from option.
To disable option handling for a single file name, use the
--add-file option, e.g.: --add-file=--my-file
.
You can use any GNU tar
command line options in the file list file,
including --files-from option itself. This allows for
including contents of a file list into another file list file.
Note however, that options that control file list processing, such as
--verbatim-files-from or --null won’t affect the
file they appear in. They will affect next --files-from
option, if there is any.
Versions of GNU tar
up to 1.15.1
recognized only -C option in file lists, and only if the
option and its argument occupied two consecutive lines.
Next: Excluding Some Files, Previous: Selecting Archive Members, Up: Choosing Files and Names for tar
[Contents][Index]