1pilot-getrom(1) PILOT-LINK pilot-getrom(1)
2
3
4
6 pilot-getrom - Retrieves the ROM image from your Palm device for use in
7 debugging.
8
10 pilot-link: Tools
11
12
14 pilot-getrom [-p|--port <port>] [--version] [-?|--help] [--usage]
15 [-q|--quiet] [-t|--token token] [-s|--sysinfo] [--ram] [--rom] [file‐
16 name]
17
18
20 pilot-getrom is used to fetch the ROM from your Palm handheld for use
21 in debugging Palm applications through the use of POSE, the Palm OS
22 Emulator application.
23
24
25 Note, because pilot-getrom uses the low-level RPC protocol to fetch the
26 ROM image, and the new OS5 devices do not use this protocol, you cur‐
27 rently cannot fetch an OS5 ROM image using this utility. This will be
28 updated in a future release to handle fetching OS5 ROM images, using
29 the debugger protocol.
30
31
33 pilot-getrom options
34 -t,
35 --token token
36
37
38 A ROM token to read (i.e. snum)
39
40 -s, --sysinfo
41
42
43 Print SysInfo
44
45 --ram
46
47
48 Read RAM
49
50 --rom
51
52
53 Read ROM
54
55 <filename>
56
57
58 Write the ROM image to the file named by <filename>. If this is omit‐
59 ted, the filename will be written out as the rom version name as fol‐
60 lows: ' pilot-$VERSION.rom ', where an OS 3.5 image would be written
61 as the filename of 'pilot-3.5.0.rom'.
62
63
64 Conduit Options
65 -p, --port
66 <port>
67
68
69 Use device file <port> to communicate with the Palm handheld. If this
70 is not specified, pilot-getrom will look for the $PILOTPORT environment
71 variable. If neither are found or supplied, pilot-getrom will print
72 the usage information.
73
74 -q,
75 --quiet
76
77
78 Suppress 'Hit HotSync button' message
79
80 -v, --version
81
82
83 Display version of pilot-getrom and exit without connecting.
84
85
86 Help Options
87 -h, --help
88
89
90 Display the help synopsis for pilot-getrom and exit without connecting.
91
92 --usage
93
94
95 Display a brief usage message and exit without connecting.
96
97
99 Connect to a target Palm handheld and fetch the ROM for use in debug‐
100 ging Palm applications through the use of POSE, the Palm OS Emulator
101 or with the CoPilot application (deprecated).
102
103
105 Warning: Please completely back up your Palm before using this pro‐
106 gram! The developers of pilot-link are not responsible for any data
107 loss that may occur from the use of this application.
108
109
110 Use of this program MAY place you in violation of your license agree‐
111 ment with Palmsource, Inc. or other OEM partners. Please read your Palm
112 documentation (specifically the "Software License Agreement") before
113 running this program.
114
115
117 pilot-getrom was originally written by Kenneth Albanowski.
118
119
120 This manual page was converted to XML by Neil Williams <linux@code‐
121 help.co.uk>
122
123
125 Known Bugs
126 pilot-getrom does not work with OS5 devices as yet, due to changes in
127 the architecture and design of the Palm HotSync protocol and file type
128 changes from m68k to ARM. Other than that, pilot-getrom has no known
129 bugs at this time.
130
131
132 Reporting Bugs
133 We have an online bug tracker. Using this is the only way to ensure
134 that your bugs are recorded and that we can track them until they are
135 resolved or closed. Reporting bugs via email, while easy, is not very
136 useful in terms of accountability. Please point your browser to
137 http://bugs.pilot-link.org: http://bugs.pilot-link.org and report your
138 bugs and issues there.
139
140
142 This program is free software; you can redistribute it and/or modify it
143 under the terms of the GNU General Public License as published by the
144 Free Software Foundation; either version 2 of the License, or (at your
145 option) any later version.
146
147
148 This program is distributed in the hope that it will be useful, but
149 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
150 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
151 Public License for more details.
152
153
154 You should have received a copy of the GNU General Public License along
155 with this program; if not, write to the Free Software Foundation, Inc.,
156 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
157
158
160 pilot-getram (1), pilot-link(7).
161
162
163
164
1650.12.4 Copyright 1996-2007 FSF pilot-getrom(1)