1pilot-getram(1) PILOT-LINK pilot-getram(1)
2
3
4
6 pilot-getram - Retrieves the RAM image from your Palm device for use in
7 debugging.
8
10 pilot-link: Tools
11
12
14 pilot-getram [-p|--port <port>] [--version] [-q|--quiet] [-?|--help]
15 [--usage] [-t|--token token] [-s|--sysinfo] [--ram] [--rom] [filename]
16
17
19 pilot-getram is used to fetch the current RAM image from your Palm
20 handheld for use in debugging.
21
22
23 pilot-getromtoken, pilot-getrom and pilot-getram are inter-related.
24 All relevant code is implemented in pilot-getrom, and you can do
25 pilot-getromtoken --ram filename to get the RAM dump if you like.
26
27
28 Note, because pilot-getrom uses the low-level RPC protocol to fetch the
29 ROM image, and the new OS5 devices do not use this protocol, you cur‐
30 rently cannot fetch an OS5 ROM image using this utility. This will be
31 updated in a future release to handle fetching OS5 ROM images, using
32 the debugger protocol.
33
34
36 pilot-getram options
37 -t,
38 --token token
39
40
41 A ROM token to read (i.e. snum)
42
43 -s, --sysinfo
44
45
46 Print SysInfo
47
48 --ram
49
50
51 Read RAM
52
53 --rom
54
55
56 Read ROM
57
58 <filename>
59
60
61 Write the RAM image to the file named by <filename>. If this is omit‐
62 ted, the filename will be written out as the RAM version name as fol‐
63 lows: ' pilot-$VERSION.ram ', where an OS 3.5 image would be written
64 as the filename of 'pilot-3.5.0.ram'.
65
66
67 Conduit Options
68 -p, --port
69 <port>
70
71
72 Use device file <port> to communicate with the Palm handheld. If this
73 is not specified, pilot-getram will look for the $PILOTPORT environment
74 variable. If neither are found or supplied, pilot-getram will print
75 the usage information.
76
77 -q,
78 --quiet
79
80
81 Suppress 'Hit HotSync button' message
82
83 -v, --version
84
85
86 Display version of pilot-getram and exit without connecting.
87
88
89 Help Options
90 -h, --help
91
92
93 Display the help synopsis for pilot-getram and exit without connecting.
94
95 --usage
96
97
98 Display a brief usage message and exit without connecting.
99
100
102 Connect to a target Palm handheld and fetch the RAM from the device.
103
104
106 pilot-getram was originally written by Kenneth Albanowski.
107
108
109 This manual page was converted to XML by Neil Williams <linux@code‐
110 help.co.uk>
111
112
114 We have an online bug tracker. Using this is the only way to ensure
115 that your bugs are recorded and that we can track them until they are
116 resolved or closed. Reporting bugs via email, while easy, is not very
117 useful in terms of accountability. Please point your browser to
118 http://bugs.pilot-link.org: http://bugs.pilot-link.org and report your
119 bugs and issues there.
120
121
123 This program is free software; you can redistribute it and/or modify it
124 under the terms of the GNU General Public License as published by the
125 Free Software Foundation; either version 2 of the License, or (at your
126 option) any later version.
127
128
129 This program is distributed in the hope that it will be useful, but
130 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
131 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
132 Public License for more details.
133
134
135 You should have received a copy of the GNU General Public License along
136 with this program; if not, write to the Free Software Foundation, Inc.,
137 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
138
139
141 pilot-getrom (1), pilot-link(7).
142
143
144
145
1460.12.5 Copyright 1996-2007 FSF pilot-getram(1)