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