1LDCLT(1) General Commands Manual LDCLT(1)
2
6 ldclt - load test program for LDAP
7
9 ldclt [-qQvV] [-E <max errors>] [-b <base DN>] [-h <host>] [-p <port>]
10 [-t <timeout>] [-D <bind DN>] [-w <passwd>] [-o <SASL option>] [-e
11 <execParams>] [-a <max pending>] [-n <nb threads>] [-i <nb times>] [-N
12 <nb samples>] [-I <err number>] [-T <total>] [-r <low> -R <high>] [-f
13 <filter>] [-s <scope>] [-S <slave>] [-P<master port>] [-W <waitsec>]
14 [-Z <certfile>]
15
17 This tool is a LDAP client targeted to validate the reliability of the
18 product under a wide variety of stress conditions.
19
21 The valid options are:
22 -a Asynchronous mode, with max pending operations.
24 -b Give the base DN to use. Default "dc=example,dc=com".
26 -D Bind DN. See -w
28 -E Max errors allowed. Default 1000.
30 -f Filter for searches.
32 -h Host to connect. Default "localhost".
34 -H Ldap URL to connect to. Example, ldap://localhost:389. This
36 takes precedence over -h and -p.
37 -i Number of times inactivity allowed. Default 3 (30 seconds)
39 -I Ignore errors (cf. -E). Default none.
41 -n Number of threads. Default 10.
43 -N Number of samples (10 seconds each). Default infinite.
45 -o SASL Option.
47 -p Server port. Default 389.
49 -P Master port (to check replication). Default 16000.
51 -q Quiet mode. See option -I.
53 -Q Super quiet mode.
55 -r Range's low value.
57 -R Range's high value.
59 -s Scope. May be base, subtree or one. Default subtree.
61 -S Slave to check.
63 -t LDAP operations timeout. Default 30 seconds.
65 -T Total number of operations per thread. Default infinite.
67 -v Verbose.
69 -V Very verbose.
71 -w Bind passwd. See -D.
73 -W Wait between two operations. Default 0 seconds.
75 -Z certfile. Turn on SSL and use certfile as the certificate DB
77 -e Execution parameters:
79 add ldap_add() entries.
81 append entries to the genldif file.
82 ascii use ascii 7-bits strings.
83 attreplace=name:mask replace attribute of existing entry.
84 attrlist=name:name:name specify list of attribs to retrieve
85 attrsonly=0|1 ldap_search() parameter. Set 0 to read values.
86 bindeach ldap_bind() for each operation.
87 bindonly only bind/unbind, no other operation is performed.
88 close will close() the fd, rather than ldap_unbind().
89 cltcertname=name name of the SSL client certificate
90 commoncounter all threads share the same counter.
91 counteach count each operation not only successful ones.
92 delete ldap_delete() entries.
93 dontsleeponserverdown will loop very fast if server down.
94 emailPerson objectclass=emailPerson (-e add only).
95 esearch exact search.
96 genldif=filename generates a ldif file
97 imagesdir=path specify where are the images.
98 incr incremental values.
99 inetOrgPerson objectclass=inetOrgPerson (-e add only).
100 keydbfile=file filename of the key database
101 keydbpin=password password for accessing the key database
102 noglobalstats don't print periodical global statistics
103 noloop does not loop the incremental numbers.
104 object=filename build object from input file
105 person objectclass=person (-e add only).
106 random random filters, etc...
107 randomattrlist=name:name:name random select attrib in the list
108 randombase random base DN.
109 randombaselow=value low value for random generator.
110 randombasehigh=value high value for random generator.
111 randombinddn random bind DN.
112 randombinddnfromfile=fine retrieve bind DN & passwd from file
113 randombinddnlow=value low value for random generator.
114 randombinddnhigh=value high value for random generator.
115 rdn=attrname:value alternate for -f.
116 referral=on|off|rebind change referral behaviour.
117 scalab01 activates scalab01 scenario.
118 scalab01_cnxduration maximum connection duration.
119 scalab01_maxcnxnb modem pool size.
120 scalab01_wait sleep() between 2 attempts to connect.
121 smoothshutdown main thread waits till the worker threads exit.
122 string create random strings rather than random numbers.
123 v2 ldap v2.
124 withnewparent rename with newparent specified as argument.
125 randomauthid random SASL Authid.
126 randomauthidlow=value low value for random SASL Authid.
127 randomauthidhigh=value high value for random SASL Authid.
128
130 ldclt was written by the 389 Project.
131
133 Report bugs to https://github.com/389ds/389-ds-base/issues/new
134
136 Copyright © 2001 Sun Microsystems, Inc. Used by permission.
137 Copyright © 2018 Red Hat, Inc.
138 This manual page was written by Michele Baldessari
139 <michele@pupazzo.org>, for the Debian project (but may be used by oth‐
140 ers).
141 This is free software. You may redistribute copies of it under the
142 terms of the Directory Server license found in the LICENSE file of this
143 software distribution. This license is essentially the GNU General
144 Public License version 2 with an exception for plug-in distribution.
145 March 31, 2017 LDCLT(1)