NAME¶
pilot-addresses - Read and write address book databases to and from a Palm
handheld.
SECTION¶
pilot-link: Userland conduits
LOCATION¶
./src
SYNOPSIS¶
pilot-addresses [
-p|
--port <
port>]
[
--version] [
-?|
--help] [
--usage]
[
-q|
--quiet] [
--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,
Handera,
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 additional information. The
augmented information is placed before and separated from the field with a
semi-colon, (;).
Augmented information can include any of the following 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.
-c,
--category=
category
Install records to category
category by default. Normally
pilot-addresses uses the
Unfiled category by default. This
option is overridden by the category specified in the record with the
-a
option.
-d,
--delete-category
Delete all records in the specified category
category 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.
Help Options¶
-h,
--help
Display the help synopsis for
pilot-addresses and exit without
connecting.
--usage
Display a brief usage message and exit without connecting.
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 addrbook.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 category
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 originally written by Robert Wittig <bob.wittig@gt.org> and
later updated by David A. Desrosiers <hacker@gnu-designs.com> and Neil
Williams <linux@codehelp.co.uk>.
REPORTING BUGS¶
We have an online bug tracker. Using this is the only way to ensure that your
bugs are recorded and that we can track them until they are resolved or
closed. Reporting bugs via email, while easy, is not very useful in terms of
accountability. Please point your browser to
http://bugs.pilot-link.org:
http://bugs.pilot-link.org and report your bugs and issues there.
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.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied 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., 51 Franklin
St, Fifth Floor, Boston, MA 02110-1301, USA.
SEE ALSO¶
pilot-link(7)