---
name: "dlpsh"
section: "1"
platform: "linux"
package: "pilot-link"
version: "0.11.8-10"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/dlpsh"
---

# dlpsh(1)

## NAME

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

## SYNOPSIS

**dlpsh** \[**-p** \<port\>\]

## DESCRIPTION

**dlpsh** allows the user to connect to a Palm handheld and execute arbitrary 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 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 \<option\> --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 \<*stevens@rpi.edu*\> and Damien Neil \<*neild@rpi.edu*\>