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

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