.TH 5CV 10.1.SH NAME5cv, mkppcimage, sqz \- convert kernel executable to boot format.SH SYNOPSIS.B 5cv[.BI -D n] [.BI -H n] [.B -s].I "executable outfile".PP.B mkppcimage[.BI -l " loadaddr"].I "executable outfile".PP.B sqz[.B -w] [.B -t].I executable.SH DESCRIPTIONThese commands convert a kernel executable in Inferno/Plan 9.IR a.out (10.5)format into anotherformat used by a third party's boot loader.Most convert the input.I executableand write the new format to.IR outfile ..PP.IR 5cvconverts an ARM executable into one of several alternative formats.The output format is controlled by the.B -Hoption:.TP 8n.BI -H1AIF for RISCOS..TP.BI -H2Plan 9..TP.BI -H3Boot for NetBSD..TP.BI -H4Headerless, stripped, and padded to 2K in length. Used for the ROM resident serialbootstraploader in a Cirrus EP72xx..TP.BI -H5Headerless, and stripped, for general use..TP.BI -H6EPOC IMG format. Not a complete conversion, currently sufficient for use with someNT based downloaders which autosense the file type by the "EP" signature, and thenignore the contents of the header..PPThe other options are:.TP.BI -sStrip symbol table..TP.BI -D nEnables debug output..PP.I Mkppcimageconverts a PowerPC or ARM.I executableto a boot image format used by.SM PPCBOOTand.SM UBOOT\c\&.The output file has a.SM PPCBOOTimage with one component labelled as an `OS kernel' for the appropriate architecture,containing the.IR a.out (10.6)header, text and initialised data, all uncompressed.Symbols are not included.By default the load address is deduced from the executable's entry point;the.B -loption allows.I loadaddrto be set explicitly, with the number in C syntax (decimal by default).Other attributes are deduced from the executable..PP.I Sqzsqueezes (compresses) the givenARM or PowerPC.I executableusing a method that achieves respectable compression for executables but is much faster to decompress than(say).BR gzip 's.By default, both the program text and initialised data are compressed; the.B -toption causes.I sqzto compress only the program text, leaving the data as-is.By default,.I sqzprints compression statistics on its standard error output;the.B -woption causes it also to write the compressed file on its standard output.Either the bootstrap that loads it must decompress the result, or a small uncompressedstub must also be loaded that decompresses the remainder..SH SOURCE.B /utils/5cv.br.B /utils/mkppcimage.br.B /utils/sqz.SH "SEE ALSO".IR 2l (10.1),.IR 5cv (10.1),.IR ms2 (10.1),.IR a.out (10.5)