external/bsd/openldap/man/slapdn.8

   1 .TH SLAPDN 8C "2008/07/16" "OpenLDAP 2.4.11"
   2 .\" Copyright 2004-2008 The OpenLDAP Foundation All Rights Reserved.
   3 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
   4 .SH NAME
   5 slapdn \- Check a list of string-represented LDAP DNs based on schema syntax
   6 .SH SYNOPSIS
   7 .B /usr/sbin/slapdn
   8 .B [\-d level]
   9 .B [\-f slapd.conf]
  10 .B [\-F confdir]
  11 .B [\-N | \-P]
  12 .B [\-o name[=value]]
  13 .B [\-v]
  14 .B DN [...]
  15 .LP
  16 .SH DESCRIPTION
  17 .LP
  18 .B Slapdn
  19 is used to check the conformance of a DN based on the schema
  20 defined in
  21 .BR slapd (8)
  22 and that loaded via
  23 .BR slapd.conf (5).
  24 It opens the
  25 .BR slapd.conf (5)
  26 configuration file, reads in the schema definitions, and then
  27 parses the
  28 .B DN
  29 list given on the command-line.
  30 .LP
  31 .SH OPTIONS
  32 .TP
  33 .BI \-d " level"
  34 enable debugging messages as defined by the specified
  35 .IR level ;
  36 see
  37 .BR slapd (8)
  38 for details.
  39 .TP
  40 .BI \-f " slapd.conf"
  41 specify an alternative
  42 .BR slapd.conf (5)
  43 file.
  44 .TP
  45 .BI \-F " confdir"
  46 specify a config directory.
  47 If both
  48 .B -f
  49 and
  50 .B -F
  51 are specified, the config file will be read and converted to
  52 config directory format and written to the specified directory.
  53 If neither option is specified, an attempt to read the
  54 default config directory will be made before trying to use the default
  55 config file. If a valid config directory exists then the
  56 default config file is ignored.
  57 .TP
  58 .BI \-N
  59 only output a normalized form of the DN, suitable to be used
  60 in a normalization tool; incompatible with
  61 .BR \-P .
  62 .TP
  63 .BI \-o " option[=value]"
  64 Specify an
  65 .BR option
  66 with a(n optional)
  67 .BR value .
  68 Possible generic options/values are:
  69 .LP
  70 .nf
  71               syslog=<subsystems>  (see `\-s' in slapd(8))
  72               syslog-level=<level> (see `\-S' in slapd(8))
  73               syslog-user=<user>   (see `\-l' in slapd(8))
  74
  75 .fi
  76 .TP
  77 .BI \-P
  78 only output a prettified form of the DN, suitable to be used
  79 in a check and beautification tool; incompatible with
  80 .BR \-N .
  81 .TP
  82 .B \-v
  83 enable verbose mode.
  84 .SH EXAMPLES
  85 To check a
  86 .B DN
  87 give the command:
  88 .LP
  89 .nf
  90 .ft tt
  91         /usr/sbin/slapdn -f //etc/openldap/slapd.conf -v DN
  92 .ft
  93 .fi
  94 .SH "SEE ALSO"
  95 .BR ldap (3),
  96 .BR slapd (8)
  97 .BR slaptest (8)
  98 .LP
  99 "OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)
 100 .SH ACKNOWLEDGEMENTS
 101 .\" Shared Project Acknowledgement Text
 102 .B "OpenLDAP Software"
 103 is developed and maintained by The OpenLDAP Project <http://www.openldap.org/>.
 104 .B "OpenLDAP Software"
 105 is derived from University of Michigan LDAP 3.3 Release.