www.fifi.org
    Documentation
        Manpages
        GNU Info
        Debian document tree
        Whole document tree
    Trigance web page
    Public services
    User info
    Mailing lists
    Secure server
    Multilingual usage

Manpages

Manpage of pilot-addresses

pilot-addresses

Section: User Commands (1)
Updated: Palm Computing Device Tools
Index
Return to Main Contents

NAME

pilot-addresses - read and write address book databases to and from a Palm handheld device, such as those made from Palm, Handspring, Handera, TRGPro, Sony or other Palm Compatible Handheld PDA device

SYNOPSIS

pilot-addresses -p <port> [-c category ] [-d category ] [-r file | -w file ]

(Note that some options are not shown above)

DESCRIPTION

pilot-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.

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...

-p --port <port>,

Use device file port to communicate with the Palm handheld device. If this is not specified, will look for the $PILOTPORT environment variable. If both are not found, will fall back to /dev/pilot.

-h --help,

Display help synopsis for pilot-addresses

-v --version,

Display version of pilot-addresses

-a

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 includes:

category_name - placed in front of each record or

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. 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 addrbook.csv:

: pilot-addresses -w addrbook.csv

: 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 category Special after first deleting all current records in the Special category on the palm:

: pilot-addresses -c Special -d Special -r addrbook.csv

KNOWN BUGS

pilot-addresses has no known bugs.

REPORTING BUGS

Report bugs at http://bugs.pilot-link.org/

AUTHOR

pilot-addresses originally written by Kenneth Albanowski, manual page was written by Robert Wittig <bob.wittig@gt.org>.

This document was created by man2html, using the manual pages.
Time: 17:02:27 GMT, April 19, 2024