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