.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "pilot-dlpsh" 1 "Copyright 1996-2007 FSF" "0.12.5" "PILOT-LINK"
.SH NAME
pilot-dlpsh \- An interactive Desktop Link Protocol (DLP) Shell for your Palm device.
.SH "SECTION"

.PP
pilot\-link: Tools

.SH "SYNOPSIS"

.PP
 \fIpilot\-dlpsh\fR [\fB\-p\fR|\fB\-\-port\fR <\fBport\fR>] [\fB\-c\fR|\fB\-\-command\fR  \fBSTRING\fR] [\fB\-i\fR|\fB\-\-interactive\fR] [\fB\-\-version\fR]

.SH "OPTIONS"

.SS "pilot-dlpsh options"

                        \fB\-c\fR,
                        \fB\-\-command STRING\fR
                    
.PP
Execute \fBcmd\fR and exit immediately\&.

                        \fB\-i\fR, \fB\-\-interactive\fR
                    
.PP
Enter interactive mode

.SS "Conduit Options"

                        \fB\-p\fR, 
                        \fB\-\-port\fR <
                        \fBport\fR>
                    
.PP
Use device file <\fIport\fR> to communicate with the Palm handheld\&. If this is not specified, \fIpilot\-dlpsh\fR will look for the \fI$PILOTPORT\fR environment variable\&. If the port is missing and \fI$PILOTPORT\fR is not set, \fIpilot\-dlpsh\fR will print the usage information\&.

                        \fB\-\-version\fR
                    
.PP
Display the copyright information, version number, license details and build details and exit without connecting\&.

.SH "DESCRIPTION"

.PP
 \fIpilot\-dlpsh\fR allows the user to connect to a Palm handheld and execute arbitrary DLP commands\&.

.PP
pilot\-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\&.

.PP
Once connected, the user may execute most of the built\-in \fIDLP\fR commands\&. (See \fIBUILT\-IN COMMANDS \fR below for more detail on currently supported options)\&.

.PP
The connection to the Pilot is kept alive by sending a \fIPadTickle\fR packet to the Pilot after a small period of non\-activity\&. (7 seconds by default)

.SH "BUILT-IN COMMANDS"

.PP
There are many options available while connected to your Palm handheld via \fIpilot\-dlpsh\fR, including the following:

.PP
 \fBuser, u\fR 

.PP
Print the currently set User information, including Username, UserID, PCid, and ViewerID\&. You may also set these values from this command as well\&. To set these values, simply pass the value to the option, such as 'user John Q\&. Public' for example\&.

.PP
 \fBls\fR 

.PP
Used with \fB\-l\fR and \fB\-r\fR to provide long and RAM and ROM file lists, similar to (but slightly different from) 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\&.

.PP
 \fBdf\fR 

.PP
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\&.

.PP
 \fBntp, time, dtp\fR 

.PP
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\&.

.PP
 \fBrm, del\fR 

.PP
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\&.

.PP
 \fBquit, q, exit, bye\fR 

.PP
Exit the DLP Protocol Shell

.SH "OPTIONS"

.PP
Passing commandline options to \fBpilot\-dlpsh\fR will allow you to interact with it in unattended mode, for example: '\fBpilot\-dlpsh\fR \-p usb: \-c user' will connect and display the user information, just as if you had connected interactively and typed 'user' at the DLP shell prompt\&.

.SH "USAGE"

.PP
The program will connect to your Palm handheld and give the user an interactive prompt (a "shell") for executing commands across the DLP \fIHotSync\fR protocol\&.

.SH "AUTHOR"

.PP
 \fBpilot\-dlpsh\fR was originally written by Chris Stevens <stevens@rpi\&.edu> and Damien Neil <neild@rpi\&.edu> 

.PP
This manual page was updated to XML by Neil Williams <linux@codehelp\&.co\&.uk> 

.SH "REPORTING BUGS"

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

.SH "COPYRIGHT"

.PP
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\&.

.PP
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\&.

.PP
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\&., 51 Franklin St, Fifth Floor, Boston, MA 02110\-1301, USA\&.

.SH "SEE ALSO"

.PP
 \fIpilot\-link\fR(7)