'\" t
|
.\" Title: ldif-diff
|
.\" Author: Mark Craig
|
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
|
.\" Date: October\ \&20,\ \&2011
|
.\" Manual: Tools Reference
|
.\" Source: OpenDJ 2.5.0
|
.\" Language: English
|
.\"
|
.TH "LDIF\-DIFF" "1" "October\ \&20,\ \&2011" "OpenDJ 2.5.0" "Tools Reference"
|
.\" -----------------------------------------------------------------
|
.\" * Define some portability stuff
|
.\" -----------------------------------------------------------------
|
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
.\" http://bugs.debian.org/507673
|
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
.ie \n(.g .ds Aq \(aq
|
.el .ds Aq '
|
.\" -----------------------------------------------------------------
|
.\" * set default formatting
|
.\" -----------------------------------------------------------------
|
.\" disable hyphenation
|
.nh
|
.\" disable justification (adjust text to left margin only)
|
.ad l
|
.\" -----------------------------------------------------------------
|
.\" * MAIN CONTENT STARTS HERE *
|
.\" -----------------------------------------------------------------
|
.SH "NAME"
|
ldif-diff \- compare small LDIF files
|
.SH "SYNOPSIS"
|
.HP \w'\fBldif\-diff\fR\ 'u
|
\fBldif\-diff\fR {options}
|
.SH "DESCRIPTION"
|
.PP
|
This utility can be used to compare two LDIF files and report the differences in LDIF format\&.
|
.SH "OPTIONS"
|
.PP
|
The following options are supported\&.
|
.PP
|
\fB\-a, \-\-ignoreAttrs {file}\fR
|
.RS 4
|
File containing a list of attributes to ignore when computing the difference\&.
|
.RE
|
.PP
|
\fB\-\-checkSchema\fR
|
.RS 4
|
Takes into account the syntax of the attributes as defined in the schema to make the value comparison\&. The provided LDIF files must conform to the server schema\&.
|
.RE
|
.PP
|
\fB\-e, \-\-ignoreEntries {file}\fR
|
.RS 4
|
File containing a list of entries (DN) to ignore when computing the difference\&.
|
.RE
|
.PP
|
\fB\-o, \-\-outputLDIF {file}\fR
|
.RS 4
|
File to which the output should be written\&.
|
.RE
|
.PP
|
\fB\-O, \-\-overwriteExisting\fR
|
.RS 4
|
Any existing output file should be overwritten rather than appending to it\&.
|
.RE
|
.PP
|
\fB\-s, \-\-sourceLDIF {file}\fR
|
.RS 4
|
LDIF file to use as the source data\&.
|
.RE
|
.PP
|
\fB\-S, \-\-singleValueChanges\fR
|
.RS 4
|
Each attribute\-level change should be written as a separate modification per attribute value rather than one modification per entry\&.
|
.RE
|
.PP
|
\fB\-t, \-\-targetLDIF {file}\fR
|
.RS 4
|
LDIF file to use as the target data\&.
|
.RE
|
.PP
|
\fB\-V, \-\-version\fR
|
.RS 4
|
Display version information\&.
|
.RE
|
.PP
|
\fB\-?, \-H, \-\-help\fR
|
.RS 4
|
Display usage information\&.
|
.RE
|
.SH "EXIT CODES"
|
.PP
|
0
|
.RS 4
|
The command completed successfully\&.
|
.RE
|
.PP
|
> 0
|
.RS 4
|
An error occurred\&.
|
.RE
|
.SH "EXAMPLES"
|
.PP
|
The following example demonstrates use of the command with two small LDIF files\&.
|
.sp
|
.if n \{\
|
.RS 4
|
.\}
|
.nf
|
$ cat /path/to/newuser\&.ldif
|
dn: uid=newuser,ou=People,dc=example,dc=com
|
uid: newuser
|
objectClass: person
|
objectClass: organizationalPerson
|
objectClass: inetOrgPerson
|
objectClass: top
|
cn: New User
|
sn: User
|
ou: People
|
mail: newuser@example\&.com
|
userPassword: changeme
|
|
$ cat /path/to/neweruser\&.ldif
|
dn: uid=newuser,ou=People,dc=example,dc=com
|
uid: newuser
|
objectClass: person
|
objectClass: organizationalPerson
|
objectClass: inetOrgPerson
|
objectClass: top
|
cn: New User
|
sn: User
|
ou: People
|
mail: newuser@example\&.com
|
userPassword: secret12
|
description: A new description\&.
|
|
$ ldif\-diff \-s /path/to/newuser\&.ldif \-t /path/to/neweruser\&.ldif
|
dn: uid=newuser,ou=People,dc=example,dc=com
|
changetype: modify
|
add: userPassword
|
userPassword: secret12
|
\-
|
delete: userPassword
|
userPassword: changeme
|
\-
|
add: description
|
description: A new description\&.
|
.fi
|
.if n \{\
|
.RE
|
.\}
|
.SH "AUTHORS"
|
.PP
|
\fBMark Craig\fR
|
.RS 4
|
Author.
|
.RE
|
.PP
|
\fBNemanja Lukić\fR
|
.RS 4
|
Author.
|
.RE
|
.SH "COPYRIGHT"
|
.br
|
Copyright \(co 2011 ForgeRock AS
|
.br
|
.sp
|
.RS 4
|
[IMAGE]
|
.PP
|
This work is licensed under the
|
\m[blue]\fBCreative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License\fR\m[].
|
.RE
|
.PP
|
To view a copy of this license, visit
|
http://creativecommons.org/licenses/by-nc-nd/3.0/
|
or send a letter to Creative Commons, 444 Castro Street, Suite 900, Mountain View, California, 94041, USA.
|
.PP
|
Trademarks are the property of their respective owners.
|
.PP
|
UNLESS OTHERWISE MUTUALLY AGREED BY THE PARTIES IN WRITING, LICENSOR OFFERS THE WORK AS-IS AND MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND CONCERNING THE WORK, EXPRESS, IMPLIED, STATUTORY OR OTHERWISE, INCLUDING, WITHOUT LIMITATION, WARRANTIES OF TITLE, MERCHANTIBILITY, FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, OR THE ABSENCE OF LATENT OR OTHER DEFECTS, ACCURACY, OR THE PRESENCE OF ABSENCE OF ERRORS, WHETHER OR NOT DISCOVERABLE. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO SUCH EXCLUSION MAY NOT APPLY TO YOU.
|
.PP
|
EXCEPT TO THE EXTENT REQUIRED BY APPLICABLE LAW, IN NO EVENT WILL LICENSOR BE LIABLE TO YOU ON ANY LEGAL THEORY FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES ARISING OUT OF THIS LICENSE OR THE USE OF THE WORK, EVEN IF LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
|
.sp
|
