summaryrefslogtreecommitdiffstats
path: root/contrib/slapd-modules/emptyds/slapo-emptyds.5
blob: 75b1059aead9770a50da738ea9d10fb45540d1e2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
.TH SLAPO-EDS 5 "RELEASEDATE" "OpenLDAP LDVERSION"
.\" Copyright 2022 The OpenLDAP Foundation, All Rights Reserved.
.\" Copyright 2018 Tamim Ziai 
.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
.\" $OpenLDAP$
.SH NAME
slapo-emptyds \- Remove Empty values from Directory String attributes
Overlay to slapd
.SH SYNOPSIS
ETCDIR/slapd.conf
.SH DESCRIPTION
Some non-conformant clients will provide empty values for Directory String
attributes with certain operations. This overlay makes empty values acceptable
for the Directory String syntax and will adjust all operations to make sure
these values are never actually stored in the database.
.LP
.nf
.ft tt
	dn: cn=alex,cn=people,dc=example,dc=org
	changeType: add                  changeType: add
	sn: <empty>              -->     sn: blah
	sn: blah

	dn: cn=alex,cn=people,dc=example,dc=org
	changeType: modify               changeType: modify
	add: sn                  -->     add: sn
	sn: <empty>                      sn: blah
	sn: blah

	dn: cn=alex,cn=people,dc=example,dc=org
	changeType: modify               changeType: modify
	delete: sn               -->     delete: sn
	sn: <empty>                      sn: blah
	sn: blah

	dn: cn=alex,cn=people,dc=example,dc=org
	changeType: modify               changeType: modify
	replace: sn              -->     replace: sn
	sn: <empty>

	dn: cn=alex,cn=people,dc=example,dc=org
	changeType: modify               changeType: modify
	replace: sn              -->     replace: sn
	sn: <empty>                      sn: blah
	sn: blah
.ft
.fi
.LP
.SH CONFIGURATION
This overlay has no specific configuration, however in order to ensure that it
does what it needs to do, it should be the last overlay configured so it will
run before the other overlays.
.SH EXAMPLES
.LP
.RS
.nf
overlay emptyds
.RE
.SH FILES
.TP
ETCDIR/slapd.conf
default slapd configuration file
.SH SEE ALSO
.BR slapd.conf (5).
.SH ACKNOWLEDGEMENTS
This module was written in 2014 by Tamim Ziai for DAASI International and
updated in 2022 by Ondřej Kuzník for inclusion in the OpenLDAP project.
.so ../Project