Provided by: pilot-link_0.12.3-4ubuntu1_i386 bug

NAME

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

SECTION

       pilot-link: Tools

SYNOPSIS

        pilot-dlpsh     [-p|--port     <port>]     [-c|--command       STRING]
       [-i|--interactive] [--version]

OPTIONS

   pilot-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, pilot-dlpsh will look for the $PILOTPORT  environment
       variable. If the port is missing and $PILOTPORT is not set, pilot-dlpsh
       will print the usage information.

                               --version

       Display the copyright information, version number, license details  and
       build details and exit without connecting.

DESCRIPTION

        pilot-dlpsh  allows the user to connect to a Palm handheld and execute
       arbitrary DLP commands.

       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.

       Once connected, the user may execute most of the built-in DLP commands.
       (See  BUILT-IN  COMMANDS   below for more detail on currently supported
       options).

       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
       default)

BUILT-IN COMMANDS

       There are many options available while connected to your Palm  handheld
       via pilot-dlpsh, including the following:

        user, u

       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.

        ls

       Used with -l and -r 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.

        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.

        ntp, time, dtp

       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, del

       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, q, exit, bye

       Exit the DLP Protocol Shell

OPTIONS

       Passing  commandline  options to pilot-dlpsh will allow you to interact
       with it in unattended mode, for example: ’pilot-dlpsh -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.

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

        pilot-dlpsh was originally written by Chris Stevens  <stevens@rpi.edu>
       and Damien Neil <neild@rpi.edu>

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

REPORTING BUGS

       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: http://bugs.pilot-link.org and report  your
       bugs and issues there.

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

SEE ALSO

        pilot-link(7)