pilot-addresses - Read and write address book databases to
and from a Palm handheld.
SECTION
pilot-link: Userland Conduits
SYNOPSIS
pilot-addresses [-p|--port <port>] [--version]
[-q|--quiet] [-?|--help] [--usage] [--delete-all]
[-t|--delimiter INT] [-d|--delete-category category ]
[-c|--category category] [-a|--augment] [-r|--read file]
[-w|--write file ] [-C|--human-readable]
DESCRIPTION
pilot-addresses allows the user to read all entries from a
Palm handheld such as those made by Palm, Handspring, Han-
dera, TRGPro, Sony or other Palm handheld in the Palm
Address Book application, write new entries into the
database, and delete a category or delete all entries in
the database.
COMMANDS
Provide exactly one of --read or --write.
-r, --read=<file>
Reads records from <file> and install them to the
Palm Address Book application. (Use the -w <file>
option to get a sample "template file" for input
records to see how the fields are laid out).
-w, --write=file
Reads all address book records from the Palm
Address Book application and writes them into file
OPTIONS
PILOT-ADDRESSES OPTIONS
-a, --augment
Augments fields in address book records with addi-
tional information. The augmented information is
placed before and separated from the field with a
semi-colon, (;).
Augmented information can include any of the fol-
lowing below.
category # Placed in front of each record or..
Placed in front of each phone number field:
["Work"|"Home"|"Fax"|"Other"|"E-mail"|"Main"|"Pager"|"Mobile"]
Empty fields are not augmented.
Install records to category category by default.
Normally pilot-addresses uses the Unfiled category
by default. This option is overridden by the cate-
gory specified in the record with the -a option.
-d, --delete-category
Delete all records in the specified category cate-
gory before installing new records.
Note that the long name of this option has changed
since 0.11.8
-D, --delete-all
Delete all address book records in all categories.
Obviously, be very careful with this one.
Note that the long name of this option has changed
since 0.11.8
-t, --delimiter INT
Include category in each record, use the delimiter
specified to separate all fields of a record.
Delimiters are specified as follows: 3=tab, 2=;,
1=,. This overrides the default delimiter of comma
between fields and semi-colon between a field's
augmented information. (Please note that this may
generate confusing results when used with the -a
option.)
Note that the long name of this option has changed
since 0.11.8
-T, --titles
Obsolete. This option has been removed since 0.11.8
-C|--human-readable
Write generic human-readable output instead of CSV.
CONDUIT OPTIONS
-p, --port <port>
Use device file <port> to communicate with the Palm
handheld. If this is not specified, pilot-addresses
will look for the $PILOTPORT environment variable.
If neither are found or supplied, pilot-addresses
will print the usage information.
-q, --quiet
Suppress 'Hit HotSync button' message
-v, --version
Display version of pilot-addresses and exit without
connecting.
-h, --help
Display the help synopsis for pilot-addresses and
exit without connecting.
--usage
Display a brief usage message and exit without con-
necting.
USAGE
The program will connect to the Palm handheld, and perform
the requested read or write operation specified by the
user.
EXAMPLES
To write all address records in a Palm to the file addr-
book.csv:
pilot-addresses -w addrbook.csv
or
pilot-addresses -p /dev/pilot -w addrbook.csv
To read the address book records in the file addrbook.csv
and install them onto the Palm:
pilot-addresses -r addrbook.csv
To read the address book records in the file addrbook.csv
and place them into the Palm address book database cate-
gory Special after first deleting all current records in
the Special category on the palm:
pilot-addresses -c Special -d Special -r addrbook.csv
AUTHOR
pilot-addresses originally written by Kenneth Albanowski,
this manual page was written by Robert Wittig bob.wit-
tig@gt.org and later updated by David A. Desrosiers
hacker@gnu-designs.com and Neil Williams linux@code-
help.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.
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
addresses(1) pilot-link(7)
Man(1) output converted with
man2html