pilot-getrom(1)

1pilot-getrom(1)                   PILOT-LINK                   pilot-getrom(1)
2
3
4

NAME

6       pilot-getrom - Retrieves the ROM image from your Palm device for use in
7       debugging.
8

SECTION

10       pilot-link: Tools
11
12

SYNOPSIS

14        pilot-getrom  [-p|--port  <port>]  [--version]  [-?|--help]  [--usage]
15       [-q|--quiet]  [-t|--token  token] [-s|--sysinfo] [--ram] [--rom] [file‐
16       name]
17
18

DESCRIPTION

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

OPTIONS

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

USAGE

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

LICENSING

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

AUTHOR

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

BUGS

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

COPYRIGHT

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