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   8420 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

pi-getrom(1)			   Conduits			  pi-getrom(1)

NAME
       pi-getrom  -  Retrieves	the ROM image from your Palm device for use in
       debugging.

SYNOPSIS
       pi-getrom [-p <port>] [filename]

DESCRIPTION
       pi-getrom is used to fetch the ROM from your Palm handheld for  use  in
       debugging Palm applications through the use of POSE, the Palm OS Emula‐
       tor 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 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
       -p, --port <port>
	      Use device file <port> to communicate with the Palm handheld. If
	      this  is not specified, will look for the $PILOTPORT environment
	      variable.	 If both are not found or  supplied,  install-expenses
	      will fall back to /dev/pilot.

       -h, --help
	      Display the help synopsis for pi-getrom.

       -v, --version
	      Display version of pi-getrom.

       <filename>
	      Write  the ROM image to the file named by <filename>. 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'.

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 before using 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	agree‐
       ment with Palmsource, Inc. or other OEM partners. Please read your Palm
       documentation (specifically the "Software  License  Agreement")	before
       running this program.

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

	      Report bugs at http://bugs.pilot-link.org/

AUTHOR
       pi-getrom was originally written by Kenneth Albanowski.

SEE ALSO
       pi-getram(1)

(c) FSF 1996-2003	      pilot-link - 0.11.8		  pi-getrom(1)

Vote for polarhome