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


SECTION

       pilot-link: Tools


SYNOPSIS

       dlpsh   [-p|--port   <port>]   [--version]    [-q|--quiet]
       [-?|--help] [--usage] [-c|--command STRING] [-i|--interac-
       tive]


OPTIONS

   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, dlpsh will look
              for the $PILOTPORT environment variable. If neither
              are  found, dlpsh will print the usage information.

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

       -q, --quiet
              Suppress 'Hit HotSync button' message

   HELP OPTIONS
       -?, --help
              Show the help message and exit without  connecting.

       --usage
              Display a brief usage message and exit without con-
              necting.


DESCRIPTION

       dlpsh allows the user to connect to a  Palm  handheld  and
       execute arbitrary 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
       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
       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 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., 59  Temple  Place,  Suite  330,
       Boston, MA 02111-1307 USA


SEE ALSO

       pilot-link(7)




























Man(1) output converted with man2html