5CV(10.1) 5CV(10.1)
NAME
5cv, mkppcimage, sqz - convert kernel executable to boot
format
SYNOPSIS
5cv [ -Dn ] [ -Hn ] [ -s ] executable outfile
mkppcimage [ -l loadaddr ] executable outfile
sqz [ -w ] [ -t ] executable
DESCRIPTION
These commands convert a kernel executable in Inferno/Plan 9
a.out(10.5) format into another format used by a third
party's boot loader. Most convert the input executable and
write the new format to outfile.
5cv converts an ARM executable into one of several alterna-
tive formats. The output format is controlled by the -H
option:
-H1 AIF for RISCOS.
-H2 Plan 9.
-H3 Boot for NetBSD.
-H4 Headerless, stripped, and padded to 2K in length.
Used for the ROM resident serial bootstrap loader in
a Cirrus EP72xx.
-H5 Headerless, and stripped, for general use.
-H6 EPOC IMG format. Not a complete conversion, cur-
rently sufficient for use with some NT based down-
loaders which autosense the file type by the "EP"
signature, and then ignore the contents of the
header.
The other options are:
-s Strip symbol table.
-Dn Enables debug output.
Mkppcimage converts a PowerPC or ARM executable to a boot
image format used by PPCBOOT and UBOOT. The output file has
a PPCBOOT image with one component labelled as an `OS ker-
nel' for the appropriate architecture, containing the
a.out(10.6) header, text and initialised data, all
Page 1 Plan 9 (printed 12/12/25)
5CV(10.1) 5CV(10.1)
uncompressed. Symbols are not included. By default the
load address is deduced from the executable's entry point;
the -l option allows loadaddr to be set explicitly, with the
number in C syntax (decimal by default). Other attributes
are deduced from the executable.
Sqz squeezes (compresses) the given ARM or PowerPC
executable using a method that achieves respectable compres-
sion for executables but is much faster to decompress than
(say) gzip's. By default, both the program text and ini-
tialised data are compressed; the -t option causes sqz to
compress only the program text, leaving the data as-is. By
default, sqz prints compression statistics on its standard
error output; the -w option causes it also to write the com-
pressed file on its standard output. Either the bootstrap
that loads it must decompress the result, or a small uncom-
pressed stub must also be loaded that decompresses the
remainder.
SOURCE
/utils/5cv
/utils/mkppcimage
/utils/sqz
SEE ALSO
2l(10.1), 5cv(10.1), ms2(10.1), a.out(10.5)
Page 2 Plan 9 (printed 12/12/25)