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)

0.12.5                                       Copyright 1996-2007 FSF                              pilot-dlpsh(1)