(tar.info.gz) recurse

Info Catalog (tar.info.gz) after (tar.info.gz) Choosing (tar.info.gz) one
 
 6.9 Descending into Directories
 ===============================
 
 Usually, 'tar' will recursively explore all directories (either those
 given on the command line or through the '--files-from' option) for the
 various files they contain.  However, you may not always want 'tar' to
 act this way.
 
    The '--no-recursion' option inhibits 'tar''s recursive descent into
 specified directories.  If you specify '--no-recursion', you can use the
 'find' ( find (find)Top.) utility for hunting through levels of
 directories to construct a list of file names which you could then pass
 to 'tar'.  'find' allows you to be more selective when choosing which
 files to archive; see  files, for more information on using
 'find' with 'tar'.
 
 '--no-recursion'
      Prevents 'tar' from recursively descending directories.
 
 '--recursion'
      Requires 'tar' to recursively descend directories.  This is the
      default.
 
    When you use '--no-recursion', GNU 'tar' grabs directory entries
 themselves, but does not descend on them recursively.  Many people use
 'find' for locating files they want to back up, and since 'tar'
 _usually_ recursively descends on directories, they have to use the
 '-not -type d' test in their 'find' invocation ( Type
 (find)Type.), as they usually do not want all the files in a directory.
 They then use the '--files-from' option to archive the files located via
 'find'.
 
    The problem when restoring files archived in this manner is that the
 directories themselves are not in the archive; so the
 '--same-permissions' ('--preserve-permissions', '-p') option does not
 affect them--while users might really like it to.  Specifying
 '--no-recursion' is a way to tell 'tar' to grab only the directory
 entries given to it, adding no new files on its own.  To summarize, if
 you use 'find' to create a list of files to be stored in an archive, use
 it as follows:
 
      $ find DIR TESTS | \
        tar -cf ARCHIVE -T - --no-recursion
 
    The '--no-recursion' option also applies when extracting: it causes
 'tar' to extract only the matched directory entries, not the files under
 those directories.
 
    The '--no-recursion' option also affects how globbing patterns are
 interpreted ( controlling pattern-matching).
 
    The '--no-recursion' and '--recursion' options apply to later options
 and operands, and can be overridden by later occurrences of
 '--no-recursion' and '--recursion'.  For example:
 
      $ tar -cf jams.tar --no-recursion grape --recursion grape/concord
 
 creates an archive with one entry for 'grape', and the recursive
 contents of 'grape/concord', but no entries under 'grape' other than
 'grape/concord'.
 
Info Catalog (tar.info.gz) after (tar.info.gz) Choosing (tar.info.gz) one
automatically generated by info2html