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