PILOT-ADDRESSES(1)PILOT-ADDRESSES(1)NAMEpilot-addresses - read and write address book databases to
and from a Palm Computing Device, Handspring Visor, TRG
Pro, or other Palm Compatible Handheld PDA
SYNOPSISpilot-addresses-p [<port>] [-c category ] [-d category ]
[-r file | -w file ]
(Note that some options are not shown above)
DESCRIPTIONpilot-addresses allows the user to read all entries in the
Palm address book database, write new entries into the
database, and delete a category or delete all entries in
the database. Once the user has executed pilot-addresses
the user must invoke HotSync on the target device.
TARGET DEVICE
The default serial device used to communicate with a Palm
is /dev/pilot. If the environment variable $PILOTPORT is
set, its value will override the default. A serial device
specified on the command-line will be used regardless of
any $PILOTPORT setting.
OPTIONS
Several options exist, including...
-a 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 includes:
category_name - placed in front of each record or
["Work" | "Home" | "Fax" | "Other" | "E-mail" |
"Main" | "Pager" | "Mobile" ] - placed in front of
each phone number field.
Empty fields are not augmented.
-c category
Install records to category category by default.
Normally pilot-addresses uses Unfiled as the
default category. This option is overridden by the
category specified in the record with the -a
option.
-d category
Delete all records in the specified category before
installing new records.
-D Delete all address book records in all categories.
FSF Palm Computing Device Tools 1
PILOT-ADDRESSES(1)PILOT-ADDRESSES(1)
Obviously, be very careful with this one.
-e Escape all special characters with a backslash.
This enables you to read and write entries with
newline characters in a field or note.
-q Causes pilot-addresses to be quiet and not prompt
you to press the HotSync button.
-r file
Reads records from file and install them to the
Palm address book database. (Use the -w file to get
a template file for input records.)
-t delim
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.)
-T Write a header line with field titles as the first
line of the data file.
-w file
Get all address book records from the Palm address
book database and writes them into file
USAGE
The program will connect to a target device and port,
prompt the user to HotSync, 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/irnine -w addrbook.csv
To read the address book records in the file addrbook.csv
and install them on a 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 addr
book.csv
FSF Palm Computing Device Tools 2
PILOT-ADDRESSES(1)PILOT-ADDRESSES(1)SEE ALSOpilot-link(7).
AUTHORpilot-addresses written by _____. This manual page was
originally written by Robert Wittig.
FSF Palm Computing Device Tools 3