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)