Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   14563 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

pilot-getromtoken(1)		  PILOT-LINK		  pilot-getromtoken(1)

NAME
       pilot-getromtoken - Reads a ROM token from a Palm Handheld device.

SECTION
       pilot-link: Tools

SYNOPSIS
	pilot-getromtoken [-p|--port <port>] [--version] [-?|--help] [--usage]
       [-q|--quiet] [-t|--token	 token] [-s|--sysinfo] [--ram] [--rom]	[file‐
       name]

DESCRIPTION
       Tokens you may currently extract are:

       adcc: Entropy for internal A->D convertor calibration

       irda: Present only on memory card w/IrDA support

       snum: Device serial number (from Memory Card Flash ID)

	pilot-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 pilot-getrom uses the low-level RPC protocol to fetch the
       ROM image, and the new OS5 devices do not use this protocol,  you  cur‐
       rently  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
   pilot-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 <filename>. If this is omit‐
       ted, the filename will be written out as the rom version name  as  fol‐
       lows:  'pilot-$VERSION.rom'  ,where an OS 3.5 image would be written as
       the filename of 'pilot-3.5.0.rom'.

   Conduit Options
			       -p, --port
			       <port>

       Use device file <port> to communicate with the Palm handheld.  If  this
       is not specified, pilot-getrom will look for the $PILOTPORT environment
       variable. If neither are found or supplied,  pilot-getrom   will	 print
       the usage information.

			       -q,
			       --quiet

       Suppress 'Hit HotSync button' message

			       -v, --version

       Display version of pilot-getrom and exit without connecting.

   Help Options
			       -h, --help

       Display the help synopsis for pilot-getrom and exit without connecting.

			       --usage

       Display a brief usage message and exit without connecting.

USAGE
       Connect	to  a target Palm handheld and fetch the ROM for use in debug‐
       ging 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 devel‐
       opers 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 agree‐
       ment with Palmsource, Inc. or other OEM partners. Please read your Palm
       documentation  (specifically  the  "Software License Agreement") before
       running this program.

AUTHOR
	pilot-getrom was originally written by Owen Stenseth.

       This manual page was written by Neil Williams <linux@codehelp.co.uk>

BUGS
   Known Bugs
	pilot-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, pilot-getrom	has  no	 known
       bugs at this time.

   Reporting Bugs
       We  have	 an  online  bug tracker. Using this is the only way to ensure
       that your bugs are recorded and that we can track them until  they  are
       resolved	 or  closed. Reporting bugs via email, while easy, is not very
       useful in  terms	 of  accountability.  Please  point  your  browser  to
       http://bugs.pilot-link.org:  http://bugs.pilot-link.org and report your
       bugs and issues there.

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  MER‐
       CHANTABILITY  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.,
       51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.

SEE ALSO
	pilot-getram(1), pilot-link(7).

0.12.5			    Copyright 1996-2007 FSF	  pilot-getromtoken(1)

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome