NAME

vcomp - Lempel-Ziv compress an image file


SYNOPSIS

vcomp [-auto | -32 | -hydrogen] <inputfile> <outputfile>


ARGUMENTS

-auto
create a self-decompressing image. This has a normal header, so can be loaded by ROMs which do not contain the decompressing code (or over the network). The header contains the text, data and bss sizes of the original file so the loader can initialise the bss correctly. Its entrypoint field points to a small decompression routine which is appended to the image.

-32
compress a 32-bit image

-hydrogen
produce a self-decompressing image for a hydrogen system

inputfile
image file to be compressed

outputfile
name of compressed file


DESCRIPTION

The vcomp utility uses the Lempel-Ziv algorithm to produce a compressed image file. By default, it produces a compressed version of the header, text and data, prefixed by two words containing magic number ``LZ00'' and the original file size. It can also produce self-decompressing images.