pi-getromtoken  -  Reads  a ROM token from a Palm Handheld
       device.


SECTION

       pilot-link: Tools


SYNOPSIS

       pi-getromtoken [-p|--port <port>] [--version] [-q|--quiet]
       [-?|--help]  [--usage]  [-t|--token  token] [-s|--sysinfo]
       [--ram] [--rom] [filename]


DESCRIPTION

       Tokens you may currently extract are:
              adcc: Entropy for internal A->D convertor  calibra-
              tion
              irda: Present only on memory card w/IrDA support
              snum:  Device serial number (from Memory Card Flash
              ID)

       pi-getromtoken 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-GETROMTOKEN 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
              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.

       -q, --quiet
              Suppress 'Hit HotSync button' message

       -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 this program!
       The developers of pilot-link are not responsible  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 written by Owen Stenseth.

       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
       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-getram(1), pilot-link(7).


































Man(1) output converted with man2html