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