maint: changed save.sh to accept empty string argument to skip pkg file rename
[barry/progweb.git] / man / upldif.1
blob32cae0cdf25f4c295041613971f735e83fb941b8
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 "November 24, 2009"
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.
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 \-P password
37 Simplistic method to specify device password.
38 .TP
39 .B \-u
40 Actually do the upload.  If not specified, upldif only dumps the parsed
41 LDIF data to stdout for verification.
43 Note! If this option is specified, all existing contacts on your
44 Blackberry will be deleted and replaced with the LDIF contacts.
45 .TP
46 .B \-v
47 Dump verbose protocol data during operation.
48 .TP
49 .B \-h, \-\-help
50 Show summary of options.
53 .SH RETURN STATUS
54 In the event of a fatal error, the message will be written to stderr,
55 with an error code of 1.
58 .SH AUTHOR
59 .nh
60 .B upldif
61 is part of the Barry project.
62 This manual page was written by Chris Frey.
63 .SH SEE ALSO
64 .PP
65 http://www.netdirect.ca/software/packages/barry