.TH PALMLD 1
.SH NAME
palmld \- backup and restore Palm files
.SH SYNOPSIS
.B palmld
[
.B \-p
serial-device ] [
.B \-e
file ]
[ [
.B \-busr
] directory ] [
.B \-lPSv
] [
.B \-fd
dbname...
] [
.B \-im
file...
]
.SH DESCRIPTION
.I Palmld
copies files between Plan 9 and Palm hand-held PDAs.
(Palm calls files ``databases'',
though some of them are programs.)
It can install files in the standard
.B \&.prc
and
.B \&.pdb
formats into a Palm,
retrieve files from a Palm,
list the files contained in a Palm,
and backup or restore all of the files at once.
After starting
.IR palmld ,
the user must invoke HotSync on the target Palm.
.PP
The default serial device used to communicate with a Palm is
.BR /dev/eia0 .
If the environment variable
.B PALMPORT
is set, its value will override the default.
A serial device named on the command line will be used regardless of any
.B PALMPORT
setting.
.PP
The options are:
.TP 3
.B b
Backs up the Palm into
.I directory
(which will be created if it does not already exist).
.TP
.B d
Delete the named file(s).
Obviously, be careful with this one.
.TP
.B e
Reads a list of files from
.I file
and prevents
.BR backup ,
.BR sync ,
or
.B update
from operating on the listed file(s).
.TP
.B f
Fetch each named file out of the Palm into the current directory.
.TP
.B h
Displays a reminder list of
.IR palmld 's
usage.
.TP
.B i
Install each named
.I file
into the Palm.
.TP
.B l
List the files in the Palm.
.TP
.B m
Adds the records in each named
.I file
into the corresponding Palm file.
.TP
.B P
Purge any deleted data that hasn't been cleaned up by a sync
(this is a safe operation, and will prevent your Palm from accumulating
crud if you delete records but aren't syncing with the PIM.
The only information you can lose is archived but un-synced records.)
.TP
.B r
Installs all files contained in a directory into the Palm.
(Use this to restore your Palm after a hard reset has cleared its memory.)
.TP
.B s
Backs up the Palm into the
named directory (which will be created if it does not already exist).
Any Palm files which have not been modified or created since the versions
stored in the named directory will not be backed up.
Any Palm files which have been deleted will have their corresponding
backup file removed.
.TP
.B S
Print statistics when done about data transfer performance.
.TP
.B u
Backs up the Palm into the
named directory (which will be created if it does not already exist).
Any Palm files which have not been modified or created since the versions
stored in the named directory will not be backed up.
.TP
.B v
Displays the version of
.I pilot-link
from which this program was derived.
.SH EXAMPLES
Backup a Palm.
.RS
.EX
palmld \-b $HOME/palm
.EE
.RE
.\" .LP
Restore that backup via a non-standard serial port.
.RS
.EX
palmld -p /dev/eia1 \-r $HOME/palm
.EE
.RE
.SH SEE ALSO
.IR pilot-link (7)
.SH BUGS
.I Palmld
doesn't know Palm VII
.B \&.pqa
(wireless application)
files.
It can install them,
but when it backs them up,
a few bits in the file header (first 78 bytes) are wrong,
so the backed-up copy can't be reinstalled.
So keep copies of any
.B \&.pqa
files you install in a Palm.
.PP
Doesn't implement tickling of the serial line to keep the
other side from timing out.
Shouldn't be a big problem since we keep the line as busy as we can.
.SH HISTORY
.I Palmld
is derived from
.IR pilot\-xfer ,
written by Kenneth Albanowski.
This manual page was written by (Kenneth Albanowski?) and David H. Silber.
