           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)