pi-getram - Retrieves the RAM image from your Palm device
for use in debugging.
SECTION
pilot-link: Tools
SYNOPSIS
pi-getram [-p|--port <port>] [--version] [-q|--quiet]
[-?|--help] [--usage] [-t|--token token] [-s|--sysinfo]
[--ram] [--rom] [filename]
DESCRIPTION
pi-getram is used to fetch the current RAM image from your
Palm handheld for use in debugging.
pi-getromtoken, pi-getrom and pi-getram are inter-related.
All relevant code is implemented in pi-getrom, and you can
do pi-getromtoken--ram filename to get the RAM dump if you
like.
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-GETRAM 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 RAM image to the file named by <file-
name>. If this is omitted, the filename will be
written out as the RAM version name as follows:
'pilot-$VERSION.ram', where an OS 3.5 image would
be written as the filename of 'pilot-3.5.0.ram'.
CONDUIT OPTIONS
-p, --port <port>
Use device file <port> to communicate with the Palm
handheld. If this is not specified, pi-getram will
the usage information.
-q, --quiet
Suppress 'Hit HotSync button' message
-v, --version
Display version of pi-getram and exit without con-
necting.
HELP OPTIONS
-h, --help
Display the help synopsis for pi-getram 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 RAM from
the device.
AUTHOR
pi-getram was originally written by Kenneth Albanowski.
This manual page was written by Neil Williams linux@code-
help.co.uk
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;
either version 2 of the License, or (at your option) any
later version.
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-getrom (1), pilot-link(7).
Man(1) output converted with
man2html