
                                    Star Zip



  This program was designed to zip and unzip disk  images  using  the  ZipCode
algorithm. It can create and extract both diskpacked  and  filepacked  ZipCode
archives. Sixpacked archives and GCR-coded  disk  images  are  not  supported.
Star Zip is an external utility of The Star Commander but is also  distributed
separately.



  1. Usage

  STARZIP [-]A <diskname> [-|/C|D|Ixxyy|S|Y] [<zipname>]
  STARZIP [-]F <diskname> [-|/C|D|Y] [<zipname>]
  STARZIP [-]L <zipname>
  STARZIP [-]T <zipname>
  STARZIP [-]X <zipname> [-|/4|7|8|C|D|X[D|P|S]|Y] [<diskname>]

  Commands:

  - A: Zips disk images into diskpacked ZipCode archives. (Add)

  - F: Zips disk images into filepacked ZipCode archives. (Filepack)

  - L: Lists the contents of filepacked ZipCode archives. (List)

  - T: Tests the integrity of diskpacked ZipCode archives. (Test)

  - X: Unzips both types of ZipCode archives into disk images. (eXtract)

  <diskname>:

  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).  If  you
leave this parameter blank when unzipping, the name of the disk image will  be
determined by stripping the first two  characters  off  of  the  name  of  the
ZipCode archive. You can use wildcards to add multiple disk images and you can
use long filenames, too.

  <zipname>:

  Type the path, the base name and the extension of the ZipCode  archive  here
(the default extension for ZipCode archives is empty).  Leave  this  parameter
blank and the base names of the archives will be the  names  of  the  original
disk images. However, the  names  of  diskpacked  ZipCode  archives  have  the
structure "<number-of-part>!<basename>.<extension>" and for filepacked ZipCode
archives it is  "<letter-code-of-part>!<basename>.<extension>".  You  can  use
wildcards to list, test or extract multiple archives  and  you  can  use  long
filenames, too.

  Options:

  - 4: Extracts filepacked data into 1541 disk images (default).

  - 7: Extracts filepacked data into 1571 disk images.

  - 8: Extracts filepacked data into 1581 disk images.

  - C: Asks for your confirmation about extracting each file.

  - D: Deletes successfully processed source files.

  - Ixxyy: The second two bytes of  the  first  diskpacked  archive  hold  the
    sector header ID of the original disk. Since there is no sector header  in
    disk images, this field cannot be filled automatically. Its default  value
    is the cosmetical ID in the BAM of the  source  disk  image  but  you  can
    override it by entering two hexadecimal values as  the  argument  of  this
    option.

  - L: Displays Commodore filenames with the lowercase/uppercase character set
    (default).

  - S: Stores original sector data uncompressed, good if you want  to  further
    compress the output with an archiver.

  - 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.



  2. Error messages

  - Unknown command
    The command is unknown.

  - Invalid option
    The option is unknown or the syntax of its argument is wrong.

  - FILENAME.EXT not found
    The file does not exist.

  - No archives found
    There are no ZipCode archives that could be listed or tested.

  - Cannot create FILENAME.EXT
    The file could not be created for some reason.

  - "filename" exists...
    It is not recommended to put two  files  with  the  same  name  into  disk
    images. You can skip, rename the file or  extract  it  with  its  original
    name.

  - 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.

  - ZIPNAME.EXT is too big
    The ZipCode archive is bigger than the maximum possible size.

  - Invalid track number...
    An illegal track number was encountered in the ZipCode archive.

  - Invalid sector number...
    An illegal sector number was encountered in the ZipCode archive.

  - Duplicate sector number...
    The current sector was already encountered in the ZipCode archive.

  - Unexpected end of file...
    The ZipCode archive has ended although more data is needed to complete the
    unzipping process.



  3. Copyright and legal issues

  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.



  4. The author

  If you're interested in some similarly useful utilities then contact  me  at
the E-mail address sta@c64.org or visit my homepage at http://sta.c64.org.

  Joe Forster/STA
  11th January, 2010
