pilot-dlpsh(1)

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

NAME

6       pilot-dlpsh - An interactive Desktop Link Protocol (DLP) Shell for your
7       Palm device.
8

SECTION

10       pilot-link: Tools
11
12

SYNOPSIS

14        pilot-dlpsh [-p|--port <port>] [-c|--command   STRING]  [-i|--interac‐
15       tive] [--version]
16
17

OPTIONS

19   pilot-dlpsh options
20                               -c,
21                               --command STRING
22
23
24       Execute cmd and exit immediately.
25
26                               -i, --interactive
27
28
29       Enter interactive mode
30
31
32   Conduit Options
33                               -p,
34                               --port <
35                               port>
36
37
38       Use  device  file <port> to communicate with the Palm handheld. If this
39       is not specified, pilot-dlpsh will look for the $PILOTPORT  environment
40       variable. If the port is missing and $PILOTPORT is not set, pilot-dlpsh
41       will print the usage information.
42
43                               --version
44
45
46       Display the copyright information, version number, license details  and
47       build details and exit without connecting.
48
49

DESCRIPTION

51        pilot-dlpsh  allows the user to connect to a Palm handheld and execute
52       arbitrary DLP commands.
53
54
55       pilot-dlpsh can query many different types  of  information  from  your
56       Palm  device,  such as username, memory capacity, set the time, as well
57       as other useful functions.
58
59
60       Once connected, the user may execute most of the built-in DLP commands.
61       (See  BUILT-IN  COMMANDS   below for more detail on currently supported
62       options).
63
64
65       The connection to the Pilot is kept alive by sending a PadTickle packet
66       to  the  Pilot  after  a  small  period  of non-activity. (7 seconds by
67       default)
68
69

BUILT-IN COMMANDS

71       There are many options available while connected to your Palm  handheld
72       via pilot-dlpsh, including the following:
73
74
75        user, u
76
77
78       Print  the  currently set User information, including Username, UserID,
79       PCid, and ViewerID. You may also set these values from this command  as
80       well. To set these values, simply pass the value to the option, such as
81       'user John Q. Public' for example.
82
83
84        ls
85
86
87       Used with -l and -r to provide long and RAM and ROM file lists, similar
88       to  (but  slightly different from) the Unix 'ls' command. This does not
89       yet allow you to narrow your listing to a certain range  of  files.  It
90       will simply list them all.
91
92
93        df
94
95
96       Display  how  much RAM and ROM is free on your device, again similar to
97       the Unix 'df' command. This does not accept arguments at this time.
98
99
100        ntp, time, dtp
101
102
103       Set the time on the Palm from the currently-set desktop time. This does
104       not work on OS version 3.3, due to a bug in PalmOS at that time.
105
106
107        rm, del
108
109
110       Remove  a  file and delete it entirely from the Palm device. This is an
111       irrevokable process, and you cannot "undelete" a file, once it has been
112       deleted with this command.
113
114
115        quit, q, exit, bye
116
117
118       Exit the DLP Protocol Shell
119
120

OPTIONS

122       Passing  commandline  options to pilot-dlpsh will allow you to interact
123       with it in unattended mode, for example: 'pilot-dlpsh -p usb: -c  user'
124       will  connect and display the user information, just as if you had con‐
125       nected interactively and typed 'user' at the DLP shell prompt.
126
127

USAGE

129       The program will connect to your Palm handheld and  give  the  user  an
130       interactive  prompt  (a  "shell") for executing commands across the DLP
131       HotSync protocol.
132
133

AUTHOR

135        pilot-dlpsh was originally written by Chris Stevens  <stevens@rpi.edu>
136       and Damien Neil <neild@rpi.edu>
137
138
139       This  manual  page  was  updated  to  XML by Neil Williams <linux@code‐
140       help.co.uk>
141
142

REPORTING BUGS

144       We have an online bug tracker. Using this is the  only  way  to  ensure
145       that  your  bugs are recorded and that we can track them until they are
146       resolved or closed. Reporting bugs via email, while easy, is  not  very
147       useful  in  terms  of  accountability.  Please  point  your  browser to
148       http://bugs.pilot-link.org: http://bugs.pilot-link.org and report  your
149       bugs and issues there.
150
151

COPYRIGHT

153       This program is free software; you can redistribute it and/or modify it
154       under the terms of the GNU General Public License as published  by  the
155       Free  Software Foundation; either version 2 of the License, or (at your
156       option) any later version.
157
158
159       This program is distributed in the hope that it  will  be  useful,  but
160       WITHOUT  ANY  WARRANTY;  without  even  the  implied  warranty  of MER‐
161       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the  GNU  General
162       Public License for more details.
163
164
165       You should have received a copy of the GNU General Public License along
166       with this program; if not, write to the Free Software Foundation, Inc.,
167       51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
168
169