Home Page The Club Computers News Links Glossary EYAWTK
Before Amiga Background ICS OCS ECS AGA ??? AmigaOne
U-Boot SLB Linux Amiga OS Dual Boot Motherboards Peripherals Other
Initialisation Installation OS4 Updates About OS4 File Systems Networking Printing Other
Introduction File System Workbench Preferences Commands Error Msgs Miscellaneous

AmigaOS 4.0 - About OS4 - Commands

XADUNTAR Workbench
Purpose: To extract data from TAR archives.
Format: XADUNTAR <archive> [<destination>] [PASSWORD=<password>] [{<filename> | <pattern>}] [NAMESIZE=<size>] [FFS | OFS | SFS] [INFO | LIST] [QUIET] [AM | ASKMAKEDIR] [OW | OVERWRITE] [SP | SHOWPROT] [VERBOSE] [DARC | DISKARCHIVE] [ENTRY=<entry>] [DIMG | DISKIMAGE] [NA | NOABS] [NC=NOCOMMENT] [ND | NODATE] [NE | NOEXTERN] [NKP | NOKILLPART] [NP | NOPROT] [NT | NOTREE]
XADUNTAR is a Shell tool to extract data from Tar archives and compressed Tar archives. This includes .tar.bz, .tar.bz2, .tar.gz, .tar.Z, .tar and others.

FROM specifies the file archive that should be processed.

DESTDIR specifies the destination directory. If it does not exist, and ASKMAKEDIR has not been specified, the directory is created automatically. There are some dangerous archives using absolute path names (e.g. starting with LIBS: or RAM:). XADUNTAR un-archives these files to their absolute position (except when NOTREE or NOABS is specified).

The PASSWORD=<password> option can be used to supply a password for unarchiving of encrypted archives.

The <filename> option enables you to select filename(s) (including patterns), to be extracted. When this option is not used, all files are extracted. With FILE=<filename> only matching files are extracted. NOTE: Unless you use NOTREE option, the patterns check includes checks for directory structure as well.

The NAMESIZE=<size> option enables to specify the maximum size of a filename. This is useful as some archives from Unix/Linux machines have longer filenames than the Amiga filesystem allows. Whenever a name is longer than the namesize value, you will be asked to enter a shorter name. Names of directories are truncated without requests. When the FFS or OFS options are specified, these replace <size> with a standard FFS length of 30 characters. When the SFS option is specified, it replaces <size> with the standard SFS length of 100 characters.

The NOEXTERN option prohibits the use of external clients for recognition purposes.

The INFO or LIST options print information about the archive and does not do any unarchiving. The SP or SHOWPROT option also displays protection information. The VERBOSE option shows additional information texts, which exist for some archivers.

The OW or OVERWRITE option forces the program to overwrite an already existing destination file. Normally you are asked about that.

The NT or NOTREE option skips all directory names and writes the files directly to the destination directory.

The AM or ASKMAKEDIR option forces the program to ask you, if a missing directory should be created.

The NP or NOPROT option prevents setting file protection bits.

The NA or NOABS option prevents creation of absolute path names.

The NKP or NOKILLPART option inhibits the deletion of partial or corrupt output files.

The QUIET option turns off the progress report, and also disables questions to skip, rename or overwrite files.

Example 1:

   3.OS4:> XADUNTAR archive.tar RAM:

unarchives the tar archive to RAM:.

Example 2:

   3.OS4:> XADUNTAR archive.tar.gz RAM: #?.txt #?.doc Contents

unarchives all .txt and .doc file and the file "Contents" of lha archive to RAM:.

Example 3:

   3.OS4:> XADUNTAR archive.tar.bz LIST

displays information about archive.tar.bz file.

Return to Commands Selection

Disclaimer: Amiga Auckland have prepared the above information for the use of its members based on our experiences and as such is subject to revision at any time. Amiga Auckland cannot guarantee any of the information and cannot be held accountable for any issues that may result from using it.

Copyright 2006 Amiga Auckland Inc. All rights reserved.
Revised: February 9, 2006.