Skip to content

Commit c87c512

Browse files
committed
Fix typos in dynamic lists design page
1 parent b28ad56 commit c87c512

2 files changed

Lines changed: 14 additions & 6 deletions

File tree

docs/389ds/design/design.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ If you are adding a new design document, use the [template](design-template.html
4242
- [Session Tracking Control client - replication](session-identifier-clients.html)
4343
- [MemberOf Plugin Specific Group Scoping](memberof-specific-group-scoping-design.html)
4444
- [Entry cache pinned entries - limit large groups eviction](entrycache-pinned.html)
45-
- [Dynamic Lists plugin](dynamic-lists.design.html)
45+
- [Dynamic Lists plugin](dynamic-lists-design.html)
4646

4747
## 389 Directory Server 3.0
4848

docs/389ds/design/dynamic-lists-design.md

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Dynamic lists are designed to perform an internal search to build up an entries
1313
Design
1414
------
1515

16-
This feature is implemented as a preoperation entry plugin. When returning the result to the client, if entry matches the dynamic list parameters (it has the objectclass and URL attribute), it will perform an internal search using the LDAP URI to find the content to populate the resulting entry with:
16+
This feature is implemented as a preoperation entry plugin. When returning the result to the client, if the entry matches the dynamic list parameters (it has the objectclass and URL attribute), it will perform an internal search using the LDAP URI to find the content to populate the resulting entry with:
1717

1818
```
1919
#0 dynamic_lists_pre_entry (pb=0x50800051c020) at ldap/servers/plugins/dynamic_lists/dynamic_lists.c:162
@@ -50,7 +50,7 @@ As previously mentioned you can override what attribute/content is added to the
5050

5151
ldap:///ou=people,dc=example,dc=com?mail?one?(&(objectclass=posixAccount)(uid=*))
5252

53-
Here we set **mail** as the requested attribute. The plugin will take the "mail" attribute and value and add it the resulting entry. Note, the attribute specified in the plugin configuration (dynamicListAttribute) is now bypassed and will **not** be written to the dynamic entry. See the Example section to see how this looks.
53+
Here we set **mail** as the requested attribute. The plugin will take the "mail" attribute and value and add it the resulting entry. Note, the attribute specified in the plugin configuration (*dynamicListAttribute*) is now bypassed and will **not** be written to the dynamic entry. See the Example section to see how this looks.
5454

5555
Major configuration options and enablement
5656
------------------------------------------
@@ -82,6 +82,9 @@ Examples
8282
Here are some different configurations and how it will impact the search
8383

8484
### Example 1 - Standard configuration
85+
86+
Plugin configuration
87+
8588
```
8689
dynamicListObjectclass: groupOfUrls
8790
dynamicListUrlAttr: memberUrl
@@ -102,7 +105,8 @@ The search
102105
```
103106
$ ldapsearch -xLLL -H ldap://localhost:389 -D "cn=directory manager" -w PASSWORD -b "dc=example,dc=com" cn=my_dynamic_group
104107
dn: cn=my_dynamic_group,ou=groups,dc=example,dc=com
105-
...
108+
objectclass: top
109+
objectclass: groupOfUrls
106110
memberUrl: ldap:///ou=people,dc=example,dc=com??sub?(uid=*)
107111
member: uid=mreynolds,ou=people,dc=example,dc=com
108112
member: uid=tbordaz,ou=people,dc=example,dc=com
@@ -115,13 +119,15 @@ No matter what attribute is configured it is always populated with the DN of the
115119

116120
### Example 2 - Request a special attribute "employeeNumber"
117121

122+
Plugin configuration (same as the last example)
123+
118124
```
119125
dynamicListObjectclass: groupOfUrls
120126
dynamicListUrlAttr: memberUrl
121127
dynamicListAttr: member
122128
```
123129

124-
Dynamic entry that uses an attribute "employeeNumber" in the URL which triggers **dynamicListAttr** to be ignored. While the LDAP standard allows for multiple attributes to be requested in an LDAP Url the plugin only looks at the first requested attribute. All other requested attributes are ignored.
130+
A dynamic entry that uses an attribute "employeeNumber" in the URL causes **dynamicListAttr** to be ignored. While the LDAP standard allows for multiple attributes to be requested in an LDAP Url the plugin only looks at the first requested attribute. All other requested attributes are ignored.
125131

126132
```
127133
cn=dynamic_employee_group,ou=groups,dc=example,dc=com
@@ -135,7 +141,8 @@ The search
135141
```
136142
$ ldapsearch -xLLL -H ldap://localhost:389 -D "cn=directory manager" -w PASSWORD -b "dc=example,dc=com" cn=dynamic_employee_group
137143
dn: cn=dynamic_employee_group,ou=groups,dc=example,dc=com
138-
...
144+
objectclass: top
145+
objectclass: groupOfUrls
139146
memberUrl: ldap:///ou=people,dc=example,dc=com?employeeNumber?sub?(&(objectclass=posixAccount)(uid=*))
140147
employeeNumber: 1001
141148
employeeNumber: 628
@@ -147,6 +154,7 @@ Origin
147154
-------------
148155

149156
[1] <https://github.com/389ds/389-ds-base/issues/1793>
157+
<br>
150158
[2] <https://github.com/389ds/389-ds-base/issues/82>
151159

152160
Author

0 commit comments

Comments
 (0)