pilot-getram(1)

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

NAME

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

SECTION

10       pilot-link: Tools
11
12

SYNOPSIS

14        pilot-getram [-p|--port <port>] [--version]  [-q|--quiet]  [-?|--help]
15       [--usage] [-t|--token  token] [-s|--sysinfo] [--ram] [--rom] [filename]
16
17

DESCRIPTION

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

OPTIONS

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

USAGE

102       Connect to a target Palm handheld and fetch the RAM from the device.
103
104

AUTHOR

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

REPORTING BUGS

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

COPYRIGHT

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