---
name: "ds-replcheck"
section: "1"
platform: "linux"
package: "389-ds-base"
version: "3.3.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/ds-replcheck"
---

# ds-replcheck(1)

## NAME

ds-replcheck

## SYNOPSIS

**ds-replcheck** \[-h\] \[-v\] {online,offline,state} ...

## DESCRIPTION

Replication Comparison Tool (v2.0). This script can be used to compare two\
 replicas to see if they are in sync.

## OPTIONS

### **Sub-commands**

- **ds-replcheck** *online*

  Compare two online replicas for differences

- **ds-replcheck** *offline*

  Compare two replication LDIF files for differences (LDIF file generated by 'db2ldif -r')

- **ds-replcheck** *state*

  Get the general state of replication between two replicas

## OPTIONS 'ds-replcheck state'

usage: ds-replcheck online \[-h\] -m URL -r URL -b SUFFIX -D BINDDN\
                            \[-w BINDPW\] \[-W\] \[-y PASS\_FILE\] \[-Z CERTDIR\]

- **-m** *URL*, **--supplier-url** *URL*

  The LDAP URL for the Supplier server

- **-r** *URL*, **--replica-url** *URL*

  The LDAP URL for the Replica server

- **-b** *SUFFIX*, **--suffix** *SUFFIX*

  Replicated suffix

- **-D** *BINDDN*, **--bind-dn** *BINDDN*

  The Bind DN

- **-w** *BINDPW*, **--bind-pw** *BINDPW*

  The Bind password

- **-W**, **--prompt**

  Prompt for the bind DN password

- **-y** *PASS\_FILE*, **--pass-file** *PASS\_FILE*

  A text file containing the clear text password for the bind dn

- **-Z** *CERTDIR*, **--cert-dir** *CERTDIR*

  The certificate database directory for secure connections

## OPTIONS 'ds-replcheck online'

usage: ds-replcheck online \[-h\] -m URL -r URL --rid RID -b SUFFIX -D BINDDN\
                            \[-w BINDPW\] \[-W\] \[-y PASS\_FILE\] \[-l LAG\] \[-c\]\
                            \[-Z CERTDIR\] \[-i IGNORE\] \[-p PAGESIZE\] \[-o FILE\]

- **-m** *URL*, **--supplier-url** *MRL*

  The LDAP URL for the Supplier server

- **-r** *URL*, **--replica-url** *URL*

  The LDAP URL for the Replica server

- **-b** *SUFFIX*, **--suffix** *SUFFIX*

  Replicated suffix

- **-D** *BINDDN*, **--bind-dn** *BINDDN*

  The Bind DN

- **-w** *BINDPW*, **--bind-pw** *BINDPW*

  The Bind password

- **-W**, **--prompt**

  Prompt for the bind DN password

- **-y** *PASS\_FILE*, **--pass-file** *PASS\_FILE*

  A text file containing the clear text password for the bind dn

- **-l** *LAG*, **--lag-time** *LAG*

  The amount of time to ignore inconsistencies (default 300 seconds)

- **-c**, **--conflicts**

  Display verbose conflict entry information

- **-Z** *CERTDIR*, **--cert-dir** *CERTDIR*

  The certificate database directory for secure connections

- **-i** *IGNORE*, **--ignore** *IGNORE*

  Comma separated list of attributes to ignore

- **-p** *PAGESIZE*, **--page-size** *PAGESIZE*

  The paged-search result grouping size (default 500 entries)

- **-o** *FILE*, **--out-file** *FILE*

  The output file

## OPTIONS 'ds-replcheck offline'

usage: ds-replcheck offline \[-h\] -m LDIF\_FILE -r LDIF\_FILE --rid RID -b SUFFIX \[-c\]\
                             \[-i IGNORE\] \[-o FILE\]

- **-m** *LDIF\_FILE*, **--supplier-ldif** *LDIF\_FILE*

  Supplier LDIF file

- **-r** *LDIF\_FILE*, **--replica-ldif** *LDIF\_FILE*

  Replica LDIF file

- **--rid** *RID*

  The Replica Identifier (rid) for the "Supplier" server

- **-b** *SUFFIX*, **--suffix** *SUFFIX*

  Replicated suffix

- **-c**, **--conflicts**

  Display verbose conflict entry information

- **-i** *IGNORE*, **--ignore** *IGNORE*

  Comma separated list of attributes to ignore

- **-o** *FILE*, **--out-file** *FILE*

  The output file

- **-v**, **--verbose**

  Verbose output

## AUTHOR

ds-replcheck was written by the 389 Project.

## REPORTING BUGS

Report bugs to https://github.com/389ds/389-ds-base/issues/new

## COPYRIGHT

Copyright © 2022 Red Hat, Inc.