.TP
.B sessionlog <sid> <limit>
Specify a session log store for the syncrepl replication provider
-site which contains information on the entries that have been scoped
-out of the content of the replication session identified by {{EX:<sid>}}.
-The number of entries in the session log store is limited
-by {{EX:<limit>}}. Excessive entries are removed from the store
-in the FIFO order. Both {{EX:<sid>}} and {{EX:<limit>}} are
-non-negative integers. {{EX:<sid>}} has no more than three digits.
+server. The session log store contains information on the entries that
+have been scoped out of the provider replication content identified by
+.B <sid>.
+The number of entries in the session log store is limited by
+.B <limit>.
+Excessive entries are removed from the store in the FIFO order.
+Both
+.B <sid>
+and
+.B <limit>
+are non-negative integers.
+.B <sid>
+has no more than three decimal digits.
Refer to the "OpenLDAP Administrator's Guide" for detailed information
on setting up a replicated slapd directory service using the syncrepl
replication engine and the session log store.
.B [\-v]
.B [\-c]
.B [\-u]
+.B [\-p]
+.B [\-r]
+.B [\-w]
.B [\-d level]
.B [\-b suffix]
.B [\-n dbnum]
+.B [\-i rid1,rid2,...]
.B [\-f slapd.conf]
.B [\-l ldif-file]
.B
.B \-u
enable dry-run (don't write to backend) mode.
.TP
+.BI \-p
+If the LDIF input represents a syncrepl consumer replica,
+promote it to the syncrepl provider's content after adding
+the entries.
+.TP
+.BI \-r
+If the LDIF input represents a syncrepl provider replica,
+demote it to the syncrepl consumer replica after adding
+the entries.
+.TP
+.BI \-w
+When used with either
+.B \-p
+or
+.B \-r,
+rebuild the new syncrepl
+information from the contents of the added entries.
+The syncrepl information contained in the LDIF input
+file is ignored.
+.TP
.BI \-d " level"
enable debugging messages as defined by the specified
.IR level .
.B \-b
option.
.TP
+.BI \-i " rid1,rid2,..."
+Specify the replication ids for one or more syncrepl consumer
+replicas contained in the LDIF input. If omitted, 0 is used
+as the replication id.
+.TP
.BI \-f " slapd.conf"
specify an alternative
.BR slapd.conf (5)
.TP
.BI \-l " ldif-file"
Read LDIF from the specified file instead of standard input.
-.TP
-.BI \-p
-If the LDIF input represents a syncrepl consumer replica,
-promote it to the syncrepl provider replica after adding
-the entries.
-.TP
-.BI \-r
-If the LDIF input represents a syncrepl provider replica,
-demote it to the syncrepl consumer replica after adding
-the entries.
-.TP
-.BI \-w
-When used with \-p or \-r, rebuild a new syncrepl
-information from the contents of the added entries.
-The syncrepl information contained in the LDIF input
-file is ignored.
-.TP
-.BI \-i " rid1,rid2,...*"
-Specify the replication ids for one or more syncrepl consumer
-replicas contained in the LDIF input. If omitted, 0 is used
-as the replication id.
.SH LIMITATIONS
Your
.BR slapd (8)
.B SBINDIR/slapcat
.B [\-v]
.B [\-c]
+.B [\-k]
+.B [\-m]
.B [\-d level]
.B [\-b suffix]
.B [\-n dbnum]
.SH OPTIONS
.TP
.B \-v
-enable verbose mode.
+Enable verbose mode.
.TP
.B \-c
-enable continue (ignore errors) mode.
+Enable continue (ignore errors) mode.
+.TP
+.B \-k
+Include
+.B syncConsumerSubentry
+of the syncrepl consumer in the generated LDIF output.
+.TP
+.B \-m
+Include
+.B syncProviderSubentry
+of the syncrepl provider in the generated LDIF output.
.TP
.BI \-d " level"
-enable debugging messages as defined by the specified
+Enable debugging messages as defined by the specified
.IR level .
.TP
.BI \-b " suffix"
option is given.
.TP
.BI \-f " slapd.conf"
-specify an alternative
+Specify an alternative
.BR slapd.conf (5)
file.
.TP
.B [\-n service\-name] [\-s syslog\-level] [\-l syslog\-local\-user]
.B [\-r directory]
.B [\-u user] [\-g group] [\-t]
+.B [\-c cookie]
.B
.SH DESCRIPTION
.LP
or database.
.TP
.BI \-c " cookie"
-This option provides a cookie for a syncrepl replication consumer.
+This option provides a cookie for the syncrepl replication consumer.
The cookie is a comma separated list of name=value pairs.
Currently supported syncrepl cookie fields are
.B csn,
and
.B rid.
.B csn
-is the commit sequence number of the master content at the provider site
-and represents the state of the content to which the replica content
-was synchronized most recently.
+is the commit sequence number received by a previous synchronization
+and represents the state of the consumer replica content which the
+syncrepl engine will synchronize to the current provider content.
.B sid
-is the identity of the session which this replication thread belongs to.
-The replication provider site may maintain a session history store
-for each replication session to reduce synchronization traffic.
+is the identity of the per-scope session log with which the
+provider server can process this syncrepl request to reduce
+synchronization traffic.
.B rid
-identifies a replication thread within a replication consumer site
-and is used to find the replication thread specification of
+identifies a replication thread within the consumer server
+and is used to find the syncrepl specification in
.BR slapd.conf (5)
-having the same
-.B rid
-value as the cookie.
+having the matching replication identifier in its definition.
.SH EXAMPLES
To start
.I slapd
projects / openldap / commitdiff