NAME
PilotManager - Unix-based manager for PalmOS devices
SYNOPSIS
PilotManager [ -rcdir dir ] [ -sync | -syncwith conduit... | -install
file... | -daemon ]
pilot-manager [ -rcdir dir ] [ -sync | -syncwith conduit... | -install
file... | -daemon ]
DESCRIPTION
PilotManager allows you to synchronize databases with your PalmOS-based
devices, such as PalmPilot(tm), Visor(tm), etc. Comes with several
basic conduits, and more can easily be plugged in.
OPTIONS
-sync Attempt to synchronize immediately, without user interaction.
-syncwith conduit...
Attempts to synchronize using the specified conduit(s), rather
than the "active" conduits.
-install file...
Uses the Installer conduit to install the file(s) specified on
the command line (should be .prc or .pdb files).
-daemon
Causes PilotManager to run in the background, waiting for
HotSync events.
-rcdir dir
Specify the directory to use for configuration files and storage
(defaults to $HOME/.pilotmgr/).
SETUP
When you first run PilotManager you will need to configure it and
select the conduits you wish to use. At a minimum, you should select
the Backup and Installer conduits. At the main menu, choose File, then
Properties. A new window will appear where you can configure the
HotSync device (if necessary), set some other options, and select and
configure your conduits. To activate an inactive conduit, select it
with the mouse, then click on "<< Move" to move it to the Active
Conduits list.
You can configure an active conduit by selecting it and then pressing
the button labelled "Configure". Press "Dismiss" when finished.
SYNCHRONIZING
Once you have configured PilotManager to your liking, return to the
main window, insert your PalmOS device in its cradle, and press the
HotSync button. This is the round button with red and blue arrows,
just above the words "Synchronization Status". PilotManager will ask
you to press the HotSync button on your cradle. When you do so, all of
the conduits will run, and diagnostic messages will appear in the large
scrolling text area in the middle of the main PilotManager window.
When you see "Synchronization Complete", you are done.
CONDUITS
PilotManager comes with several conduits, which act on data in the Palm
device and on local files. Most of the conduits will use a
subdirectory under $HOME/.pilotmgr with the same name as the conduit.
More conduits are available from various sources, and instructions on
writing your own conduits can be found in the on-line help.
Backup Lets you archive your applications and databases on your
workstation, painlessly. It is mildly intelligent about not
backing up databases if they haven’t changed (but only mildly).
Can be configured to keep a certain number of older backups.
The most recent backup can be found in
$HOME/.pilotmgr/Backup/LatestArchive.
Installer
This conduit is used to install new applications and databases
on your Palm device.
SyncTime
Sets the Palm device time and date to match that of your
workstation at regular intervals (daily, weekly, monthly).
SyncMemo
Synchronizes text files on your workstation with memos on your
Palm device. These files are kept in $HOME/SyncMemo, in
subdirectories named after the memo categories. New
updates/files in these directories get copied to the Palm
device, and new updates/memos in the Palm device get copied to
the filesystem.
SyncPlan
Synchronizes your Palm device’s datebook with the Plan calendar
program (see plan(1)). You must have the plan application
installed and running on your workstation for this conduit to be
useful.
SyncAB Imports and exports your address book data. Uses CSV format,
and has partial support for vCards. (Originally designed to
work with Solaris 7 address manager.)
SyncFood
Synchronize your restaurant database. The Palm app and the Unix
app (a perl script) for this conduit can be found in the
/usr/share/doc/pilot-manager/contrib/alan-harder directory.
SendMail
A still-experimental conduit to send email from your Palm
device.
FILES
/usr/share/perl5/PilotMgr/*
System-wide conduits may be found here.
/usr/share/perl5/PilotMgr/doc/*
Online documentation.
$HOME/.pilotmgr
Personal conduits may be installed here. Also, conduits may
create their own subdirectories here.
SEE ALSO
The online help in PilotManager and the official web page at
http://www.moshpit.org/pilotmgr/
AUTHOR
PilotManager was written by Bharat Mediratta, and is currently
maintained by Alan Harder.
This manual page was written by Chris Waters <xtifr@debian.org>
expressly for Debian GNU/Linux (The innocent authors of PilotManager
should not be blamed for errors in this manual. This is a first draft
manual, all comments, suggestions and criticisms welcomed.)
COPYRIGHT
PilotManager is copyright (c) 1997 by Sun Microsystems, Inc.
May 2001