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