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.