dlpsh

dlpsh(1)                          PILOT-LINK                          dlpsh(1)



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

SECTION

       pilot-link: Tools

SYNOPSIS

        dlpsh [-p|--port <port>] [--version] [-?|--help] [--usage]  [-c|--com-
       mand  STRING] [-i|--interactive]

OPTIONS

   dlpsh options
        -c, --command STRING


       Execute cmd and exit immediately.


        -i, --interactive


       Enter interactive mode


   Conduit Options
        -p, --port lt;port>


       Use  device  file <port> to communicate with the Palm handheld. If this
       is not specified, dlpsh will look for the $PILOTPORT environment  vari-
       able.  If  the  port  is  missing and $PILOTPORT is not set, dlpsh will
       print the usage information.


        --version


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


   Help options
        -?, --help


       Show the help message and exit without connecting.


        --usage


       Display a brief usage message and exit without connecting.

DESCRIPTION

        dlpsh  allows the user to connect to a Palm handheld and execute arbi-
       trary 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 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 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>


       This manual page was updated  to  XML  by  Neil  Williams  <linux@code-
       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 MER-
       CHANTABILITY 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)




0.12.0-pre5                 Copyright 1996-2005 FSF                   dlpsh(1)