pi-getrom

SYNOPSIS

       pi-getrom [-p <port>] [filename]

DESCRIPTION

       pi-getrom is used to fetch the ROM from your Palm handheld
       for  use in debugging Palm applications through the use of
       POSE, the Palm OS Emulator application.

       Note, because pi-getrom uses the low-level RPC protocol to
       fetch  the  ROM  image, and the new OS5 devices do not use
       this protocol, you currently cannot fetch an OS5 ROM image
       using  this  utility.  This  will  be  updated in a future
       release to handle  fetching  OS5  ROM  images,  using  the
       debugger protocol.

OPTIONS

       -p, --port <port>
              Use device file <port> to communicate with the Palm
              handheld. If this is not specified, will  look  for
              the  $PILOTPORT  environment variable.  If both are
              not found or supplied, install-expenses  will  fall
              back to /dev/pilot.

       -h, --help
              Display the help synopsis for pi-getrom.

       -v, --version
              Display version of pi-getrom.

       <filename>
              Write  the  ROM  image  to the file named by <file­
              name>. If this is omitted,  the  filename  will  be
              written  out  as  the  rom version name as follows:
              'pilot-$VERSION.rom', where an OS 3.5  image  would
              be written as the filename of 'pilot-3.5.0.rom'.

USAGE

       license agreement with Palmsource, Inc. or other OEM part­
       ners.  Please  read  your Palm documentation (specifically
       the "Software License Agreement") before running this pro­
       gram.

BUGS

       KNOWN BUGS

              pi-getrom  does  not  work with OS5 devices as yet,
              due to changes in the architecture  and  design  of
              the  Palm  HotSync  protocol  and file type changes
              from m68k to ARM. Other than that, pi-getrom has no
              known bugs at this time.

       REPORTING BUGS

              Report bugs at http://bugs.pilot-link.org/

AUTHOR

       pi-getrom was originally written by Kenneth Albanowski.

SEE ALSO

       pi-getram(1)

(c) FSF 1996-2003      pilot-link - 0.11.8           pi-getrom(1)