pi-getrom  - Retrieves the ROM image from your Palm device
       for use in debugging.


SECTION

       pilot-link: Tools


SYNOPSIS

       pi-getrom  [-p|--port  <port>]  [--version]   [-q|--quiet]
       [-?|--help]  [--usage]  [-t|--token  token] [-s|--sysinfo]
       [--ram] [--rom] [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

   PI-GETROM OPTIONS
       -t, --token token
              A ROM token to read (i.e. snum)

       -s, --sysinfo
              Print SysInfo

       --ram
              Read RAM

       --rom
              Read ROM

       <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'.

   CONDUIT OPTIONS
       -p, --port <port>
              Use device file <port> to communicate with the Palm
              handheld. If this is not specified, pi-getrom  will
              look  for  the  $PILOTPORT environment variable. If
              neither are found or supplied, pi-getrom will print
              the usage information.


       -v, --version
              Display  version of pi-getrom and exit without con-
              necting.

   HELP OPTIONS
       -h, --help
              Display the help synopsis for  pi-getrom  and  exit
              without connecting.

       --usage
              Display a brief usage message and exit without con-
              necting.


USAGE

       Connect to a target Palm handheld and fetch  the  ROM  for
       use  in  debugging  Palm  applications  through the use of
       POSE, the Palm OS Emulator or with the CoPilot application
       (deprecated).


LICENSING

       Warning:  Please completely back up your Palm before using
       this program! The developers of pilot-link are not respon-
       sible  for  any  data  loss that may occur from the use of
       this application.

       Use of this program MAY place you  in  violation  of  your
       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.


AUTHOR

       pi-getrom was originally written by Kenneth Albanowski.

       This manual page was written by Neil Williams  linux@code-
       help.co.uk


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/.


COPYRIGHT

       This program is free software;  you  can  redistribute  it
       and/or modify it under the terms of the GNU General Public
       License as published  by  the  Free  Software  Foundation;

       This program is distributed in the hope that  it  will  be
       useful, but WITHOUT ANY WARRANTY; without even the implied
       warranty of MERCHANTABILITY or FITNESS  FOR  A  PARTICULAR
       PURPOSE.  See  the  GNU  General  Public  License for more
       details.

       You should have received a copy of the GNU General  Public
       License along with this program; if not, write to the Free
       Software Foundation, Inc., 59  Temple  Place,  Suite  330,
       Boston, MA 02111-1307 USA


SEE ALSO

       pi-getram (1), pilot-link(7).







































Man(1) output converted with man2html