SYNOPSIS

       Bin2S19 -f <file> -w

       Bin2S19 -f <file> [-r|-s] [-x] [-c <length>] [-b <address>]

DESCRIPTION

       Bin2S19  converts  binary  files to Motorola S19 format and vice versa.
       It can process raw binaries as well as binaries created by dasm.

OPTIONS

       -b <base_address>
              offset address where the binary file has to  be  placed  in  the
              Motorola ROM.

       -f <file_string>
              input  file  name. When converting from S19 format to binary the
              extension "s19" has to be ommitted.  The  output  file  will  be
              named "<name>-0x<baseaddress>.bin".

       -s, --s19
              will create s19 format output from binary.

       -r, --ras
              process binaries created by dasm with format "random access seg-
              ments".

       -w, --raw
              make binary output from S19 file.

       -c <record_number>
              specifies the S19 record lenght  (number  of  bytes  to  process
              until linefeed in S19 format will occur).

       -x, --hexout
              make  raw  hex  dump.  Ommits  the  S19 format record header and
              trailer for each line.

       -n <addr_number>
              number of address bytes {2,3,4} to create  16-,  24-  or  32-bit
              addresses.

       -j <jump_number>
              address  to  run  program. This address will be placed in the S9
              section (last section)

       -i, --ignore
              If given on the command line the checksum from  buggy  s19  file
              will be ignored.

       -z <size_number>
              Vector  feature: If given on the command line record length will
              be reduced to 2 when the current adress is higher than (baseaddr

       -V     Print version and  copyright  information,  then  exit.  To  get
              detailed version and copyright information about used modules do
              a

               strings Bin2S19 | grep copyright: [ENTER]

FILES

       ~/.Bin2S19rc

       ~/etc/Bin2S19.conf

       ~/share/Bin2S19/Bin2S19rc

       /opt/etc/Bin2S19.conf

       /opt/share/Bin2S19/Bin2S19rc

       Bin2S19 looks at these locations to find its defaults.  If  a  file  is
       found  further  searching  is aborted. All values can be overwritten by
       its corresponding commandline options.

ENVIRONMENT

       The HOME variable is used.

SEE ALSO

       dasm(1)

BUGS

       no bugs discovered

AUTHOR

       Thomas Pantzer <Thomas@Pantzer.net>, 2002



                               October 28, 2002                     Bin2S19(1)