git.sur5r.net Git - openldap/blob - doc/man/man8/chlog2replog.8

   1 .TH CHLOG2REPLOG 8C "22 September 1998" "OpenLDAP LDVERSION"
   2 .\" $OpenLDAP$
   3 .\" Copyright 1998-2000 The OpenLDAP Foundation All Rights Reserved.
   4 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
   5 .SH NAME
   6 chlog2replog \- convert an X.500 DSA-style changelog to an LDAP-style
   7 replication log
   8 .SH SYNOPSIS
   9 .B SBINDIR/chlog2replog
  10 .B \-r hostname:port [\-r hostname:port ...]
  11 .B \-d dn\-suffix [\-o output\-file] < input\-file
  12 .LP
  13 .SH DESCRIPTION
  14 .LP
  15 chlog2replog is used to convert an X.500\-style changelog to an
  16 LDAP\-style replication log.  It reads its standard input and
  17 writes standard output if no \-o flag is given.  If the \-o flag
  18 is given,
  19 .B chlog2replog
  20 writes its output to the given file, following
  21 the same advisory locking mechanisms respected by the
  22 .B slurpd
  23 program.  This makes it possible to use chlog2replog in a pipeline
  24 to produce input for
  25 .B slurpd.
  26
  27 .SH OPTIONS
  28 .TP
  29 .BI \-r " hostname:port"
  30 This option specifies the hostname and port number to which updates
  31 should be propagated.
  32 .B chlog2replog
  33 will include one "replica: hostname:port" directive in each replication
  34 log entry it writes out for each
  35 .B \-r
  36 option given.  You may supply as many replica hostname:port options as
  37 you wish.
  38 .TP
  39 .BI \-d " dn\-suffix"
  40 This option specifies an additional string to append to converted
  41 DNs (Distinguished Names) converted from the changelog file.  The
  42 DNs in the changelog file will typically be partial DNs which omit
  43 the portion of the directory tree "above" the organizational root.
  44 For example, if your directory tree is rooted at o=University of
  45 Michigan, c=US, you will need to include the argument
  46 "\-d ", o=University of Michigan, c=US".
  47 .TP
  48 .BI \-o " output\-file"
  49 If given, this option specifies an output file to which converted
  50 replication log entries will be written.
  51 .B chlog2replog
  52 obeys the same file locking conventions used by
  53 .B slurpd,
  54 so that it is possible to use
  55 .B chlog2replog
  56 to "feed" changes from an X.500 DSA to
  57 .B slurpd.  See the
  58 .B examples
  59 section, below, for more information.
  60 .SH EXAMPLES
  61 To read the DSA-style changelog file
  62 .BR changlelog
  63 and write on the standard output an LDAP-style replication log,
  64 appending ", o=University of Michigan, c=US" to all entry
  65 DNs, and including a replica: entry for host "ldapserver," port
  66 389, give the command:
  67 .LP
  68 .nf
  69 .ft tt
  70         SBINDIR/chlog2replog -d ", o=University of Michigan, c=US"
  71         -r ldapserver:389 < changelog
  72 .ft
  73 .fi
  74 .LP
  75 To do the same, but routing the output to the file "replog," using
  76 slurpd\-compatible file\-locking,
  77 give this command:
  78 .LP
  79 .nf
  80 .ft tt
  81         SBINDIR/chlog2replog -d ", o=University of Michigan, c=US"
  82         -r ldapserver:389 -o replog < changelog
  83 .ft
  84 .fi
  85 .LP
  86 To continually read new changes from the file "changelog" and write
  87 them to the file "replog",
  88 give this command:
  89 .LP
  90 .nf
  91 .ft tt
  92         tail +0f changelog  | SBINDIR/chlog2replog
  93         -d ", o=University of Michigan, c=US"
  94         -r ldapserver:389 -o replog < changelog
  95 .ft
  96 .fi
  97
  98 .LP
  99 .SH "SEE ALSO"
 100 .BR ldap (3),
 101 .BR ldif (5),
 102 .BR slurpd (8),
 103 .BR slapd (8),
 104 .LP
 105 "The SLAPD and SLURPD Administrator's Guide"
 106 .SH ACKNOWLEDGEMENTS
 107 .B      OpenLDAP
 108 is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
 109 .B      OpenLDAP
 110 is derived from University of Michigan LDAP 3.3 Release.