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