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

Purpose: To extract data from multiple file archives.
XADUNFILEM is the master shell tool to extract data from multiple or split file archives.

FROM specifies the split file archives, given in their correct order, that should be processed. Do not give multiple names of single archives! However, you may use patterns. If you have single archives you must use xadUnFile instead.

DEST=<destination> or DESTDIR=<destination> 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:). XADUNFILEM 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 FILE=<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. You cannot pass multiple strings as with xadUnFile, so to specify multiple names, you must use patterns like (xxx|yyy|zzz), where xxx, yyy and zzz are three file names. NOTE: Unless you use the 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 NC or NOCOMMENT option prevents setting archived file comments or displaying comment lines with INFO or LIST options.

The NP or NOPROT option prevents setting file protection bits.

The ND or NODATE option prevents setting date information.

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.

XADUNFILEM can also be used to extract files from disk images. If you specify DISKIMAGE, the input file is handled as disk image (ADF file) and not as file archive. If it is an valid Amiga filesytem disk, files can be extracted from it. Specifying DISKARCHIVE is like DISKIMAGE, but input data is a disk archive, which is de-archived before extracting files. If the disk archive has multiple entries, you may use ENTRY option to specify the wanted entry.

Example 1:

   3.OS4:> XADUNFILEM archive.lha DEST RAM: FILE (#?.txt|#?.doc|Contents)

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

Example 2:

   3.OS4:> XADUNFILEM archive.lha archive.l[0-9]? LIST

displays information about split lha archive.

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.