WArc * Manage Data Archives

[Main] [Docs] [Installs] [Search] [Team] [Guestbook] [Links]

WArc * Manage Data Archives

WArc is a tool to transform data directories of WHDLoad installs into archives and vice versa. Data archives can be used by WHDLoad using the Virtual Filesystem plugin (VFS). The VFS WHDLoadArchiveFS which can read lha/zip archives is part of the WHDLoad distribution.
WArc has the following features:

can replace a directory with an lha-archive
can replace an lha-archive with a directory
on-the-fly decompression of XPK-packed files when archiving; supports files compressed multiple times and encrypted files
automatically updates the Data ToolType of .info files (icons)
can recursively process whole WHDLoad install collections
can be interrupted by pressing Ctrl-C
gives statistics about processed objects and saved space at the end

WArc can be run from the CLI only.
WArc currently only supports lha-archives. Support for zip-files is not implemented and may be added in a future version.
When creating archives WArc stores only files and no directories. That way empty directories are not included in created archives. If you transform directories into archives and then these back into directories using the UnArc/S option, empty directories are lost. This is usually no problem because WHDLoad option SavePath/K should be used anyway, as archives are not writable via the Virtual Filesystem interface.
In recursive mode WArc will remember all transformed directories/archives in one directory. That way multiple WHDLoad icons sharing the same data directories/archives in their Data option are handled correctly.
Files starting with a '@' character cannot be archived (e.g. game Scrabble). This is because the Amiga LHa tool uses this for some special processing.
For best performance the command 'Delete' should be made Resident. Lha claims to be reentrant but fails in version 2.15.

Installation

copy it to C: or a similar place

Options

`Src,Scan/S,UnArc/S,NoDelete/S,TmpDir/K,Verbose/S`
`Src`	The object to operate on. This can be a directory or a file. If Src is a directory then this directory is archived to a file with the same name and the added extension ".lha". The directory is deleted afterwards. If option Scan/S is active, then the specified directory is recursively scanned for WHDLoad icons. For each found icon all data directories are transformed into archives. If Scan/S and UnArc/S is set, then the specified directory is recursively scanned for WHDLoad icons. For each found icon all archives are transformed back into data directories. If Src is a .info file, then all data directories of this icon/slave are transformed into archives and the icon is updated. If Src is a .lha file, then the file in unarchived into a directory with the same (without the extension). Afterwards the archive is deleted.
`Scan/S`	Enables recursive mode where WArc searches for WHDLoad icons and operates on them.
`UnArc/S`	Instead of creating archives it will unarchive. On success the archive is deleted afterwards.
`NoDelete/S`	When specified the archives/directories are not deleted after successful operation.
`TmpDir/K`	This specifies the temporary directory where WArc stores XPK decompressed files. WArc creates the directory if not already present.
`Verbose/S`	Output more processing information.

Examples

Archive a directory

3.WHDLoad:> warc data
archiving 'data'
scanned 'data': dirs=5 files=82 size=745138 xpkfiles=0 xpksaved=0
Creating new archive 'data.lha':
82 files added, all files OK.

Operation successful.

archive 'data.lha' saved 245127 bytes

Unarchive a single archive

3.WHDLoad:> warc data.lha
unarchiving 'data.lha'
Extracting from archive '/data.lha':
82 files extracted, all files OK.

Operation successful.

Archive via an icon

3.WHDLoad:> warc TestDrive.info
archiving 'data'
scanned 'data': dirs=5 files=82 size=745138 xpkfiles=0 xpksaved=0
Creating new archive 'data.lha':
82 files added, all files OK.

Operation successful.

archive 'data.lha' saved 245127 bytes
icon 'TestDrive.info' updated

Unarchive via an icon

3.WHDLoad:> warc TestDrive.info UnArc
unarchiving 'data.lha'
Extracting from archive '/data.lha':
82 files extracted, all files OK.

Operation successful.

icon 'TestDrive.info' updated

Archive recursively

3.WHDLoad:> warc Z Scan
checking 'Z/Z-Out/Z-Out.info'
archiving 'data'
scanned 'data': dirs=0 files=2 size=901280 xpkfiles=0 xpksaved=0
Creating new archive 'data.lha':
2 files added, all files OK.

Operation successful.

archive 'data.lha' saved 177596 bytes
icon 'Z-Out.info' updated
checking 'Z/Z-Out/Z-Out.info'
checking 'Z/ZakMcKracken/ZakMcKracken DE.info'
archiving 'data-de'
scanned 'data-de': dirs=1 files=73 size=1586361 xpkfiles=0 xpksaved=0
Creating new archive 'data-de.lha':
73 files added, all files OK.

Operation successful.

archive 'data-de.lha' saved 627406 bytes
icon 'ZakMcKracken DE.info' updated
checking 'Z/ZakMcKracken/ZakMcKracken DE.info'
checking 'Z/ZakMcKracken/ZakMcKracken IT.info'
archiving 'data-it'
scanned 'data-it': dirs=1 files=70 size=1561780 xpkfiles=0 xpksaved=0
Creating new archive 'data-it.lha':
70 files added, all files OK.

Operation successful.

archive 'data-it.lha' saved 608160 bytes
icon 'ZakMcKracken IT.info' updated
checking 'Z/ZakMcKracken/ZakMcKracken IT.info'
checking 'Z/ZakMcKracken/ZakMcKracken DE.info'
checking 'Z/ZakMcKracken/ZakMcKracken FR.info'
archiving 'data-fr'
scanned 'data-fr': dirs=1 files=63 size=1516584 xpkfiles=0 xpksaved=0
Creating new archive 'data-fr.lha':
63 files added, all files OK.

Operation successful.

archive 'data-fr.lha' saved 566723 bytes
icon 'ZakMcKracken FR.info' updated
checking 'Z/ZakMcKracken/ZakMcKracken FR.info'
checking 'Z/ZakMcKracken/ZakMcKracken IT.info'
checking 'Z/ZakMcKracken/ZakMcKracken DE.info'
checking 'Z/ZakMcKracken/ZakMcKracken EN.info'
archiving 'data-en'
scanned 'data-en': dirs=1 files=73 size=1582233 xpkfiles=0 xpksaved=0
Creating new archive 'data-en.lha':
73 files added, all files OK.

Operation successful.

archive 'data-en.lha' saved 625333 bytes
icon 'ZakMcKracken EN.info' updated

...


checking 'Z/Zool2/Zool2 AGA.info'
checking 'Z/Zool2/Zool2 OCS.info'
checking 'Z/Zoom!/Zoom!.info'
checking 'Z/Zyconix/Zyconix Crystal.info'
archiving 'data-crystal'
scanned 'data-crystal': dirs=0 files=2 size=902140 xpkfiles=0 xpksaved=0
Creating new archive 'data-crystal.lha':
2 files added, all files OK.

Operation successful.

archive 'data-crystal.lha' saved 192252 bytes
icon 'Zyconix Crystal.info' updated
checking 'Z/Zyconix/Zyconix Crystal.info'
checking 'Z/Zyconix/Zyconix.info'
archiving 'data'
scanned 'data': dirs=0 files=2 size=902140 xpkfiles=0 xpksaved=0
Creating new archive 'data.lha':
2 files added, all files OK.

Operation successful.

archive 'data.lha' saved 196197 bytes
icon 'Zyconix.info' updated
checking 'Z/Zyconix/Zyconix.info'
checking 'Z/Zyconix/Zyconix Crystal.info'
checking 'Z/Zynaps/Zynaps.info'
archiving 'data'
scanned 'data': dirs=0 files=65 size=441335 xpkfiles=0 xpksaved=0
Creating new archive 'data.lha':
65 files added, all files OK.

Operation successful.

archive 'data.lha' saved 149064 bytes
icon 'Zynaps.info' updated
checking 'Z/Zynaps/Zynaps.info'
summary: whdicons=71 whdnodata=5 updicon=25 dirs=33 files=982 xpkfiles=0 archived=25 unarchived=0
archived 25940330 bytes files into 16291805 bytes archives, saved 9648525

[Main] [Docs] [Installs] [Search] [Team] [Guestbook] [Links]