man/upldif.1

   1 .\"                                      Hey, EMACS: -*- nroff -*-
   2 .\" First parameter, NAME, should be all caps
   3 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
   4 .\" other parameters are allowed: see man(7), man(1)
   5 .TH UPLDIF 1 "February 19, 2013"
   6 .\" Please adjust this date whenever revising the manpage.
   7 .\"
   8 .\" Some roff macros, for reference:
   9 .\" .nh        disable hyphenation
  10 .\" .hy        enable hyphenation
  11 .\" .ad l      left justify
  12 .\" .ad b      justify to both left and right margins
  13 .\" .nf        disable filling
  14 .\" .fi        enable filling
  15 .\" .br        insert line break
  16 .\" .sp <n>    insert n+1 empty lines
  17 .\" for manpage-specific macros, see man(7)
  18 .SH NAME
  19 .B upldif
  20 \- Barry Project's LDIF contact uploader
  21 .SH SYNOPSIS
  22 .B upldif
  23 [\-p pin][\-P password][\-u][\-h][\-v]
  24 .SH DESCRIPTION
  25 .PP
  26 .B upldif
  27 reads a list of contacts in LDAP LDIF format from stdin, and
  28 overwrites the Blackberry's Address Book database with those
  29 contents.  In other words, upldif is for
  30 .B writing
  31 to your Blackberry.  If you want to
  32 .B read
  33 data from your Blackberry into various formats, you want some other
  34 tool, such as btool or bio.
  35 .SH OPTIONS
  36 .TP
  37 .B \-p pin
  38 Specify the PIN of the device to talk to.  Only needed if there are
  39 multiple Blackberries plugged into your system at once.
  40 .TP
  41 .B \-P password
  42 Simplistic method to specify device password.
  43 .TP
  44 .B \-u
  45 Actually do the upload.  If not specified, upldif only dumps the
  46 LDIF data that it parsed from stdin, back to stdout for verification.
  47
  48 Note! If this option is specified, all existing contacts on your
  49 Blackberry will be deleted and replaced with the LDIF contacts.
  50 .TP
  51 .B \-v
  52 Dump verbose protocol data during operation.
  53 .TP
  54 .B \-h, \-\-help
  55 Show summary of options.
  56
  57
  58 .SH RETURN STATUS
  59 In the event of a fatal error, the message will be written to stderr,
  60 with an error code of 1.
  61
  62
  63 .SH EXAMPLES
  64 .TP
  65 1) Have Barry parse your default ldap contacts as best it can, and send
  66 the output to stdout.
  67 .IP
  68 ldapsearch \-x | upldif
  69
  70
  71 .SH AUTHOR
  72 .nh
  73 .B upldif
  74 is part of the Barry project.
  75 This manual page was written by Chris Frey.
  76 .SH SEE ALSO
  77 .PP
  78 http://netdirect.ca/barry
  79