#

Manual Reference Pages - dlpsh (1)

### NAME

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

### CONTENTS

> Section
> Synopsis
> Options
> Description
> Options
> Usage
> Author
> Copyright

### SECTION

> pilot-link: Tools

### SYNOPSIS

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

### 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 connecting.

### 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 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 written by Neil Williams linux@codehelp.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)

pilot-link 0.12.0-pre4 | dlpsh (1) | Copyright 1996-2005 FSF

Generated by manServer 1.07 from e:\usr\local\palm\man\man1\dlpsh.1 using man macros.