TARX

Section: User Commands (1)
Updated: 26 July 1990
Index Return to Main Contents
 

NAME

tarx - recover files from damaged tar-format archives  

SYNOPSIS

tarx [ -t ] [ -b blockfactor ] [ -e errlimit ] [ -E eoflimit ] name ...  

DESCRIPTION

Tarx is used to list and recover files from a damaged tar(1) archive. It uses a simplistic pattern-matching approach to identify tar header blocks. It will cheerfully persist despite all sorts of bad things about the archive (such as wrong checksums, read errors, and scraped-off magnetic surface...), up to a maximum of errlimit (default 3) hard errors in a row or eoflimit (default 2) EOFs in a row. Such events are reported but don't terminate operations. The tar archive is read from standard input.

With the -t option, tarx lists the file names it sees in the archive.

Without the -t option, tarx takes file or directory names as arguments and attempts to extract them from the archive. (If no names are given, tarx extracts everything it can find.) Tarx is not willing to create directories, however, so these must be made manually beforehand if they do not already exist. Files are owned by the user, and have his default permissions.

Tarx allocates a read buffer of blockfactor*512 bytes, where the default blockfactor is 400 (to allow for the very large blocks sometimes found on cartridge tapes), and attempts a full-sized read each time. It copes properly with getting less than it expected, although it does insist that the result be a multiple of 512 bytes. When dealing with cranky tape drives or other special situations, or severely short of memory, or working on a 16-bit machine, it may be useful to specify a smaller blockfactor. (Notably, on 16-bit machines 126 is often the maximum that will work.) Specifying a larger blockfactor may be necessary if tape blocks are truly enormous.  

EXAMPLE

``tarx -t </dev/rmt0 >filelist'' lists all files on the tape mounted on /dev/rmt0 and places the results in ``filelist''.

``tarx joe/precious </dev/rmt0'' restores the file ``joe/precious'' from the tape mounted on /dev/rmt0. The directory ``joe'' must already exist.  

SEE ALSO

tar(1)  

HISTORY

Written by Henry Spencer, Univ. of Toronto Zoology, based on older programs by the same author. This software is public domain. Original manual page by Chris Robertson.  

BUGS

Tarx should be smarter about directories and permissions.

Arguably should use the tar header-block checksum, instead of the slightly-arcane pattern matcher, to identify header blocks.

A tar archive containing a file which is itself a tar archive will cause considerable confusion.


 

Index

NAME
SYNOPSIS
DESCRIPTION
EXAMPLE
SEE ALSO
HISTORY
BUGS

This document was created by man2html, using the manual pages.
Time: 11:42:15 GMT, December 28, 2024