./archivers/gtar-info, Info format documentation for the GNU tape archiver

[ CVSweb ] [ Homepage ] [ RSS ] [ Required by ] [ Add to tracker ]

Branch: CURRENT, Version: 1.28, Package name: gtar-info-1.28, Maintainer: pkgsrc-users

GNU tar, is a full-featured tar command that can access remote
and local magnetic tapes, tar files (ustar, POSIX, and V7), and
even compressed or gzipped versions of these.

This package provides info pages for the GNU tape archiver.

Master sites: (Expand)

SHA1: 668ea52014ef7e70afc4ff7324410ee32f2970ef
RMD160: a2edf2a854fa9a7bc7383638038a7465ae8bba51
Filesize: 2630.849 KB

Version history: (Expand)

CVS history: (Expand)

   2014-10-09 15:45:06 by Thomas Klausner | Files touched by this commit (456)
Log message:
Remove SVR4_PKGNAME, per discussion on tech-pkg.
   2014-08-21 08:21:37 by Thomas Klausner | Files touched by this commit (1)
Log message:
Remove unused file.
   2014-08-17 18:28:18 by Thomas Klausner | Files touched by this commit (8) | Package updated
Log message:
Update gtar to 1.28. Add a Makefile.common and use it.
Use official man page, now that there is one.

version 1.28, 2014-07-28

* New checkpoint action: totals

The --checkpoint-action=totals option instructs tar to output the
total number of bytes transferred at each checkpoint.

* Extended checkpoint format specification.

New conversion specifiers are implemented.  Some of them take
optional arguments, supplied in curly braces between the percent
sign and the specifier letter.

  %d        -  Number of seconds since tar started.
  %{r,w,d}T -  I/O totals; optional arguments supply prefixes
               to be used before number of bytes read, written and
	       deleted, correspondingly.
  %{FMT}t   -  Current local time using FMT as strftime(3) format.
               If {FMT} is omitted, use %c.
  %{N}*     -  Pad output with spaces to the Nth column, or to the
               current screen width, if {N} is not given.
  %c        -  A shortcut for "%{%Y-%m-%d %H:%M:%S}t: %ds, \ 

* New option --one-top-level

The option --one-top-level tells tar to extract all files into a
subdirectory named by the base name of the archive (minus standard
compression suffixes recognizable by --auto-compress).  When used with
an argument, as in --one-top-level=DIR, the files are extracted into the
supplied DIRectory.  This ensures that no archive members are
extracted outside of the specified directory, even if the archive is
crafted so as to put them elsewhere.

* New option --sort

The --sort=ORDER option instructs tar to sort directory entries
according to ORDER.  It takes effect when creating archives.
Available ORDERs are: none (the default), name and inode.  The
latter may be absent, if the underlying system does not provide
the necessary information.

Using --sort=name ensures the member ordering in the created archive
is uniform and reproducible.  Using --sort=inode reduces the number
of disk seeks made when creating the archive and thus can considerably
speed up archivation.

* New exclusion options

  --exclude-ignore=FILE   Before dumping a directory check if it
                          contains FILE, and if so read exclude
                          patterns for this directory from FILE.
                          Same as above, but the exclusion patterns
                          read from FILE remain in effect for any
			  subdirectory, recursively.
  --exclude-vcs-ignores   Read exclude tags from VCS ignore files,
                          where such files exist.  Supported VCS's
                          are: CVS, Git, Bazaar, Mercurial.

* Tar refuses to read input from and write output to a tty device.

* Manpages

This release includes official tar(1) and rmt(8) manpages.
Distribution maintainers are kindly asked to use these instead of the
home-made pages they have been providing so far.
   2014-02-24 09:16:56 by Adam Ciarcinski | Files touched by this commit (6)
Log message:
Changes 1.27.1:
* Bug fixes
* Fix unquoting of file names obtained via the -T option.
* Fix GNU long link header timestamp (backward compatibility).
* Fix extracting sparse members from star archives.
   2012-09-11 21:47:04 by Aleksej Saushev | Files touched by this commit (95)
Log message:
"user-destdir" is default these days
   2012-01-06 12:49:31 by OBATA Akio | Files touched by this commit (1) | Package updated
Log message:
Let to install all info file fragments.

   2011-05-11 09:49:59 by Adam Ciarcinski | Files touched by this commit (11)
Log message:
Changes 1.26:
* Fix the --verify option, which broke in version 1.24.
* Fix storing long sparse file names in PAX archives.
* Fix correctness of --atime-preserve=replace.
* Work around POSIX incompatibilities on FreeBSD, NetBSD and Tru64.
* Fix bug with --one-file-system --listed-incremental.
   2010-12-12 14:10:40 by Thomas Klausner | Files touched by this commit (10) | Package updated
Log message:
Update gtar to 1.25.

version 1.25 - Sergey Poznyakoff, 2010-11-07

* Fix extraction of empty directories with the -C option in effect.
* Fix extraction of device nodes.
* Make sure name matching occurs before eventual name transformation.

Tar 1.24 changed the ordering of name matching and name transformation
so that the former saw already transformed file names.  This made it
impossible to match file names in certain cases.  It is fixed now.

* Fix the behavior of tar -x --overwrite on hosts lacking O_NOFOLLOW.

* Improve the testsuite.

* Alternative decompression programs.

If extraction from a compressed archive fails because the corresponding
compression program is not installed and the following two conditions
are met, tar retries extraction using an alternative decompressor:

 1. Another compression program supported by tar is able to handle this
 compression format.
 2. The compression program was not explicitly requested in the command
 line by the use of such options as -z, -j, etc.

For example, if `compress' is not available, tar will try `gzip'.

version 1.24 - Sergey Poznyakoff, 2010-10-24

* The --full-time option.

New command line option `--full-time' instructs tar to output file
time stamps to the full resolution.

* Bugfixes.

** More reliable directory traversal when creating archives

Tar now checks for inconsistencies caused when a file system is
modified while tar is creating an archive.  In the new approach, tar
maintains a cache of file descriptors to directories, so it uses more
file descriptors than before, but it adjusts to system limits on
the number of file descriptors.  Tar also takes more care when
a file system is modified while tar is extracting from an archive.

The new checks are implemented via the openat and related calls
standardized by POSIX.1-2008.  On an older system where these calls do
not exist or do not return useful results, tar emulates the calls at
some cost in efficiency and reliability.

** Symbolic link attributes

When extracting symbolic links, tar now restores attributes such as
last-modified time and link permissions, if the operating system
supports this.  For example, recent versions of the Linux kernel
support setting times on symlinks, and some BSD kernels also support
symlink permissions.

** --dereference consistency

The --dereference (-h) option now applies to files that are copied
into or out of archives, independently of other options.  For example,
if F is a symbolic link and archive.tar contains a regular-file member
also named F, "tar --overwrite -x -f archive.tar F" now overwrites F
itself, rather than the file that F points to.  (To overwrite the file
that F points to, add the --dereference (-h) option.)  Formerly,
--dereference was intended to apply only when using the -c option, but
the implementation was not consistent.

Also, the --dereference option no longer affects accesses to other
files, such as archives and time stamp files.  Symbolic links to these
files are always followed.  Previously, the links were usually but not
always followed.

** Spurious error diagnostics on broken pipe.

When receiving SIGPIPE, tar would exit with error status and
"write error" diagnostics. In particular, this occurred if
invoked as in the example below:

   tar tf archive.tar | head -n 1

** --remove-files

`Tar --remove-files' failed to remove a directory which contained
symlinks to another files within that directory.

** --test-label behavior

In case of a mismatch, `tar --test-label LABEL' exits with code 1,
not 2 as it did in previous versions.

The `--verbose' option used with `--test-label' provides additional

Several volume labels may be specified in a command line, e.g.:

   tar --test-label -f archive 'My volume' 'New volume' 'Test volume'

In this case, tar exits with code 0 if any one of the arguments
matches the actual volume label.

** --label used with --update

The `--label' option can be used with `--update' to prevent accidental
update of an archive:

  tar -rf archive --label 'My volume' .

This did not work in previous versions, in spite of what the docs said.

** --record-size and --tape-length (-L) options

Usual size suffixes are allowed for these options.  For example,
-L10k stands for a 10 kilobyte tape length.

** Fix dead loop on extracting existing symlinks with the -k option.