This program was designed to create Commodore LHA archives out of disk images and to extract them into disk images. It uses LHA for DOS (© by Haruyasu Yoshizaki, 1988-1992) for compression and decompression, remember to put it into your path. Star LHA is an external utility of The Star Commander but is also distributed separately.
CREDIT: Included in this program is the C64/C128 LHA Extractor (© by Chris Smeets, 1990).
WARNING: Star LHA needs LHA for DOS 2.14 or newer to be able to create or extract LHA archives!
STARLHA [-]A <diskname> [-|/C|D|S|Y] [<lhaname>] STARLHA [-]L <lhaname> STARLHA [-]S[+|-] <lhaname> STARLHA [-]X <lhaname> [-|/4|7|8|C|D|X[D|P|S]|Y] [<diskname>]
A: Puts files into LHA archives. (Add)
L: Lists the contents of LHA archives. (List)
S: Adds SFX header to LHA archives or strips it off of SFX archives. (SFX)
X: Extracts the contents of LHA archives. (eXtract)
Type the path and the name of the disk images here (the extension is always ".d64" for 1541, ".d71" for 1571 and ".d81" for 1581 disk images). Leave this parameter blank to extract the archives into disk images with the same name. You can use wildcards to add multiple disk images and you can use long filenames, too.
Type the path, the name and the extension of the archives here (the default extension of LHA archives is ".lzh", for LHA SFX archives it is ".sfx"). You may leave it blank and the names of the archives will be those of the original disk images. You can use wildcards to list or extract multiple archives and you can use long filenames, too.
+: When used with the S command, prepends the self-extract header to LHA archives (default).
-: When used with the S command, strips the self-extract header off of SFX archives.
4: Extracts data into 1541 disk images (default).
7: Extracts data into 1571 disk images.
8: Extracts data into 1581 disk images.
C: Asks for your confirmation about extracting each file.
D: Deletes successfully processed source files.
L: Displays Commodore filenames with the lowercase/uppercase character set (default).
S: When compressing, the program creates self-extracting archives.
U: Displays Commodore filenames with the uppercase/graphics character set.
X: Extracts data into 40-track 1541 disk images. You can choose the offset of the additional BAM entries by adding "S" (Speed DOS, default), "D" (Dolphin DOS) or "P" (Prologic DOS) to this option.
Y: Assumes "Yes" to all queries, good for running from batch files.
When decompressing an LHA archive, the program checks if the first file in the archive has the name "title". If it does then this file contains a comment which is displayed before decompression. However, the display routine can only handle the control codes $0D (carriage return), $0E and $8E (changing to lowercase/uppercase and uppercase/graphics character set). All other control codes are omitted.
The command is unknown.
The option is unknown or the syntax of its argument is wrong.
FILENAME.EXT not found
The file does not exist.
Cannot create FILENAME.EXT
The file could not be created for some reason.
Cannot add "filename" correctly
The file could not be fully added into the archive. It is possible that the disk is full or the source disk image is corrupted.
Cannot compress temporary archive correctly
There is something wrong with compressing the temporary archive. Check if LHA for DOS is in your path.
It is not recommended to put two files with the same name into disk images. You can skip, rename the current file or extract it with its original name.
Cannot extract "filename" correctly
The file could not be fully extracted from the archive. It is possible that the disk is full or the archive is corrupted, e.g. some bytes are missing from its end.
Cannot decompress LHANAME.LZH correctly
There is something wrong with decompressing the LHA archive. Make sure that LHA for DOS is in your path.
DISKNAME.D64 is not a valid disk image
The disk image is corrupted.
DISKNAME.D64 has an invalid BAM
The BAM of the disk image is corrupted. Try validating the disk image.
Directory is full in DISKNAME.D64
The directory of the disk image is full. You can store a maximum of 144 files in a 1541 or 1571 disk image and 296 files in a 1581 disk image.
DISKNAME.D64 is full
The disk image is full. You can store a maximum of 664 blocks in a 1541, 749 blocks in an extended 1541, 1328 blocks in a 1571 and 3160 blocks in a 1581 disk image.
LHANAME.LZH is not a valid LHA archive
The LHA archive is corrupted.
LHANAME.LZH has in invalid entry
The current entry of the LHA archive is corrupted.
This program is freeware. You may use it as long as you wish and you may give it to any individual, provided that it's in the original, unmodified archive. It is highly recommended that you download distribution packages from the homepage or other official distribution sites. If you get a package from somewhere else then make sure that the package has the author's authentic verification stamped on it.
The source of this program is distributed under a license that is similar to the GNU Public License but is more restrictive, for the protection of the users and the author. You may distribute only those modified versions or derived softwares that satisfy all restrictions in the license. When you distribute this program, modified versions of it or softwares derived from it, you may not ask for money above the normal fee of the distribution media itself. Furthermore, you may not publish this program or its source on floppy disks, CD-ROM's, FTP sites, WWW pages or any other distribution media, include it in a software compilation or bundle it with other software or hardware without prior permission of the author.
Note that public distribution of the beta releases of this program is prohibited. The only place where you can find them is the homepage.
This program is provided "as is", without a warranty of any kind. You are using it at your own risk. The author is not liable for any damage or data loss caused by the software.
If you're interested in some similarly useful utilities then contact me at the E-mail address sta.ANTI@SPAM.c64.org or visit my homepage at http://sta.c64.org.
11th January, 2010
(This page best viewed with any browser)