Updated TODO
[barry.git] / man / upldif.1
blob07a7966844b9c7c34a0b52d9003ba428c7bb1406
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 "May 29, 2008"
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][-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.
30 .SH OPTIONS
31 .TP
32 .B \-p pin
33 Specify the PIN of the device to talk to.  Only needed if there are
34 multiple Blackberries plugged into your system at once.
35 .TP
36 .B \-u
37 Actually do the upload.  If not specified, upldif only dumps the parsed
38 LDIF data to stdout for verification.
40 Note! If this option is specified, all existing contacts on your
41 Blackberry will be deleted and replaced with the LDIF contacts.
42 .TP
43 .B \-v
44 Dump verbose protocol data during operation.
45 .TP
46 .B \-h, \-\-help
47 Show summary of options.
50 .SH RETURN STATUS
51 In the event of a fatal error, the message will be written to stderr,
52 with an error code of 1.
55 .SH AUTHOR
56 .nh
57 .B upldif 
58 is part of the Barry project.
59 This manual page was written by Chris Frey.
60 .SH SEE ALSO
61 .PP
62 http://www.netdirect.ca/software/packages/barry/index.php