dlpsh - An interactive Desktop Link Protocol (DLP) Shell
for your Palm device.
SECTION
pilot-link: Tools
SYNOPSIS
dlpsh [-p|--port <port>] [--version] [-q|--quiet]
[-?|--help] [--usage] [-c|--command STRING] [-i|--interac-
tive]
OPTIONS
DLPSH OPTIONS
-c, --command STRING
Execute cmd and exit immediately.
-i, --interactive
Enter interactive mode.
CONDUIT OPTIONS
-p, --port <port>
Use device file <port> to communicate with the Palm
handheld. If this is not specified, dlpsh will look
for the $PILOTPORT environment variable. If neither
are found, dlpsh will print the usage information.
--version
Display the copyright information,version number,
licence details and build details and exit without
connecting.
-q, --quiet
Suppress 'Hit HotSync button' message
HELP OPTIONS
-?, --help
Show the help message and exit without connecting.
--usage
Display a brief usage message and exit without con-
necting.
DESCRIPTION
dlpsh allows the user to connect to a Palm handheld and
execute arbitrary 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
PadTickle packet to the Pilot after a small period of
non-activity. (7 seconds by default)
BUILT-IN COMMANDS
There are many options available while connected to your
Palm handheld via dlpsh, including the following.
user
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.
ls
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.
df
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.
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.
rm
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.
quit
Exit the DLP Protocol Shell
OPTIONS
While in dlpsh, you can always invoke 'help' or --help to
get further information on that option.
USAGE
The program will connect to your Palm handheld and give
the user an interactive prompt (a "shell") for executing
commands across the DLP HotSync protocol.
AUTHOR
dlpsh was originally written by Chris Stevens
stevens@rpi.edu and Damien Neil neild@rpi.edu
help.co.uk
REPORTING BUGS
Report bugs at: http://bugs.pilot-link.org
COPYRIGHT
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 MERCHANTABILITY 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
SEE ALSO
pilot-link(7)
Man(1) output converted with
man2html