dlpsh(1)			   Conduits			     dlpsh(1)



NAME
       dlpsh  is  a command "shell" for executing DLP (Desktop Link Protocol)
       commands to a Palm handheld.



SYNOPSIS
       dlpsh [-p ]



DESCRIPTION
       dlpsh allows the user to connect to a Palm handheld and execute	arbi-
       trary  DLP  commands. 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 sim-
	      ilar  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.



BUGS
       KNOWN BUGS


	      dlpsh has no known bugs at this time.


       REPORTING BUGS


	      Report bugs at http://bugs.pilot-link.org/

AUTHOR
       dlpsh  was  originally  written by Chris Stevens  and
       Damien Neil 



(c) FSF 1996-2003	     pilot-link - 0.11.8		     dlpsh(1)

UNIX/Linux commands referenced on this page:

1. more
2. as
3. ls
4. file
5. df
6. free
7. accept
8. at
9. time
10. rm