]> git.sur5r.net Git - openldap/blob - doc/man/man8/slapdn.8
f297e5dcc7346031b048cc7a0be3b5da0475338e
[openldap] / doc / man / man8 / slapdn.8
1 .TH SLAPDN 8C "RELEASEDATE" "OpenLDAP LDVERSION"
2 .\" Copyright 2004-2006 The OpenLDAP Foundation All Rights Reserved.
3 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
4 .SH NAME
5 slapdn \- Check a list of string-represented DNs based on schema syntax.
6 .SH SYNOPSIS
7 .B SBINDIR/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 .TP
37 .BI \-f " slapd.conf"
38 specify an alternative
39 .BR slapd.conf (5)
40 file.
41 .TP
42 .BI \-F " confdir"
43 specify a config directory.
44 If both
45 .B -f
46 and
47 .B -F
48 are specified, the config file will be read and converted to
49 config directory format and written to the specified directory.
50 If neither option is specified, an attempt to read the
51 default config directory will be made before trying to use the default
52 config file. If a valid config directory exists then the
53 default config file is ignored.
54 .TP
55 .BI \-N
56 only output a normalized form of the DN, suitable to be used
57 in a normalization tool; incompatible with
58 .BR \-P .
59 .TP
60 .BI \-o " option[=value]"
61 Specify an
62 .BR option
63 with a(n optional)
64 .BR value .
65 Possible generic options/values are:
66 .LP
67 .nf
68               syslog=<subsystems>  (see `\-s' in slapd(8))
69               syslog-level=<level> (see `\-S' in slapd(8))
70               syslog-user=<user>   (see `\-l' in slapd(8))
71
72 .fi
73 .TP
74 .BI \-P
75 only output a prettified form of the DN, suitable to be used
76 in a check and beautification tool; incompatible with
77 .BR \-N .
78 .TP
79 .B \-v
80 enable verbose mode.
81 .SH EXAMPLES
82 To check a
83 .B DN
84 give the command:
85 .LP
86 .nf
87 .ft tt
88         SBINDIR/slapdn -f /ETCDIR/slapd.conf -v DN
89 .ft
90 .fi
91 .SH "SEE ALSO"
92 .BR ldap (3),
93 .BR slapd (8)
94 .BR slaptest (8)
95 .LP
96 "OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)
97 .SH ACKNOWLEDGEMENTS
98 .B OpenLDAP
99 is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
100 .B OpenLDAP
101 is derived from University of Michigan LDAP 3.3 Release.