dlpsh(1) PILOT-LINK dlpsh(1)
dlpsh - An interactive Desktop Link Protocol (DLP) Shell for your Palm device.
dlpsh [-p|--port <port>] [--version] [-?|--help] [--usage] [-c|--com-
mand STRING] [-i|--interactive]
-c, --command STRING
Execute cmd and exit immediately.
Enter interactive mode
-p, --port lt;port>
Use device file <port> to communicate with the Palm handheld. If this
is not specified, dlpsh will look for the $PILOTPORT environment vari-
able. If the port is missing and $PILOTPORT is not set, dlpsh will
print the usage information.
Display the copyright information, version number, license details and
build details and exit.
Show the help message and exit without connecting.
Display a brief usage message and exit without connecting.
dlpsh allows the user to connect to a Palm handheld and execute arbi-
trary DLP commands.
dlpsh can query many different types of information from your Palm
device, such as username, memory capacity, set the time, as well as
other useful functions.
Once connected, the user may execute most of the built-in DLP commands.
(See BUILT-IN COMMANDS below for more detail on currently supported
The connection to the Pilot is kept alive by sending a PadTickle packet
to the Pilot after a small period of non-activity. (7 seconds by
There are many options available while connected to your Palm handheld
via dlpsh, including the following:
Print the currently set User information, including Username, UserID,
PCid, and ViewerID. You may also set these values from this command as
well. Use ’user --help’ while connected to see details on how to set or
change these values.
Used with -l and -r to provide long and RAM and ROM file lists, similar
to the Unix ’ls’ command. This does not yet allow you to narrow your
listing to a certain range of files. It will simply list them all.
Display how much RAM and ROM is free on your device, again similar to
the Unix ’df’ command. This does not accept arguments at this time.
Set the time on the Palm from the currently-set desktop time. This does
not work on OS version 3.3, due to a bug in PalmOS at that time.
Remove a file and delete it entirely from the Palm device. This is an
irrevokable process, and you cannot "undelete" a file, once it has been
deleted with this command.
Exit the DLP Protocol Shell
While in dlpsh, you can always invoke ’help’ or --help to get further
information on that option.
The program will connect to your Palm handheld and give the user an
interactive prompt (a "shell") for executing commands across the DLP
dlpsh was originally written by Chris Stevens <firstname.lastname@example.org> and
Damien Neil <email@example.com>
This manual page was updated to XML by Neil Williams <linux@code-
Report bugs at: http://bugs.pilot-link.org
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MER-
CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
0.12.0-pre5 Copyright 1996-2005 FSF dlpsh(1)
Man(1) output converted with