Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

slaptest (8oldap)

Name

slaptest - Check the suitability of the OpenLDAP slapd configuration

Synopsis

/usr/sbin/slaptest [-d debug-level] [-f slapd.conf] [-F confdir] [-ndb-
num] [-o option[=value]] [-Q] [-u] [-v]

Description

SLAPTEST(8oldap)                                              SLAPTEST(8oldap)



NAME
       slaptest - Check the suitability of the OpenLDAP slapd configuration

SYNOPSIS
       /usr/sbin/slaptest [-d debug-level] [-f slapd.conf] [-F confdir] [-ndb-
       num] [-o option[=value]] [-Q] [-u] [-v]

DESCRIPTION
       Slaptest is used to check the conformance of  the  slapd(8)  configura-
       tion.   It opens the slapd.conf(5) configuration file or the slapd-con-
       fig(5) backend, and parses it according to the general and the backend-
       specific rules, checking its sanity.

OPTIONS
       -d debug-level
              enable  debugging  messages  as  defined by the specified debug-
              level; see slapd(8) for details.

       -f slapd.conf
              specify an alternative slapd.conf(5) file.

       -F confdir
              specify a config directory.  If both -f and  -F  are  specified,
              the  config  file will be read and converted to config directory
              format and written  to  the  specified  directory.   If  neither
              option  is  specified, slaptest will attempt to read the default
              config directory before trying to use the default  config  file.
              If  a valid config directory exists then the default config file
              is ignored. If dry-run mode is  also  specified,  no  conversion
              will occur.

       -n dbnum
              Just  open and test the dbnum-th database listed in the configu-
              ration file.  To only test the config database  slapd-config(5),
              use -n 0 as it is always the first database.

       -o option[=value]
              Specify  an  option  with a(n optional) value.  Possible generic
              options/values are:

                     syslog=<subsystems>  (see `-s' in slapd(8))
                     syslog-level=<level> (see `-S' in slapd(8))
                     syslog-user=<user>   (see `-l' in slapd(8))


       -Q     Be extremely quiet: only the exit code indicates success (0)  or
              not (any other value).

       -u     enable  dry-run  mode  (i.e.  don't  fail if databases cannot be
              opened, but config is fine).

       -v     enable verbose mode.

EXAMPLES
       To check a slapd.conf(5) give the command:

            /usr/sbin/slaptest -f //etc/openldap/slapd.conf -v


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-------------------------------+
       |ATTRIBUTE TYPE |       ATTRIBUTE VALUE         |
       +---------------+-------------------------------+
       |Availability   | service/network/ldap/openldap |
       +---------------+-------------------------------+
       |Stability      | Pass-through uncommitted      |
       +---------------+-------------------------------+

SEE ALSO
       ldap(3), slapd(8), slapdn(8)

       "OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)

ACKNOWLEDGEMENTS
       OpenLDAP Software is developed and maintained by The  OpenLDAP  Project
       <http://www.openldap.org/>.  OpenLDAP Software is derived from the Uni-
       versity of Michigan LDAP 3.3 Release.



NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source was downloaded from   ftp://ftp.openldap.org/pub/OpenLDAP/openl-
       dap-release/openldap-2.4.59.tgz.

       Further information about this software can be found on the open source
       community website at http://www.openldap.org/.



OpenLDAP 2.4.59                   2021/06/03                  SLAPTEST(8oldap)