附录 A. 目录服务器提供的测试脚本

-a max_pending_ops

使用定义的最大待处理操作数，以异步模式运行该工具。

-b base_dn

提供用于运行 LDAP 操作测试的基础 DN。如果未指定，则默认值为 dc=example,dc=com。

-D bind_dn

提供 ldclt 工具的绑定 DN，以用于连接到服务器。

-E max_errors

设置工具退出前在测试 LDAP 操作中允许进行的最大错误数。默认值为 1000。

-e execution_params

指定用于测试的操作和其他测试环境参数的类型。可能的值在 表 A.2 “执行参数” 中列出。此选项可以接受以逗号分隔的列表中的多个值。

-f filter

提供用于搜索测试的 LDAP 搜索过滤器。

-h

指定要针对运行测试的 Directory 服务器的主机名或 IP 地址。如果未指定主机，ldclt 将使用本地主机。

-I error_code

告知 ldclt 忽略与特定响应代码匹配的任何错误。例如，-I 89 告知服务器忽略错误代码 89。

-i inactivity_times

设置在退出前工具可以不活跃的间隔。默认情况下，此设置是 3，它转换为 30 秒（每个操作间隔为 10 秒）。

-N number_of_samples

设置要运行的迭代数量，这意味着要运行的 10 秒测试周期数量。默认情况下，这是无限的，工具仅在手动停止时退出。

-n number_of_threads

设置为操作同时运行的线程数量。默认值为 10。

-o SASL_option

告知工具使用 SASL 连接到服务器，并提供 SASL 机制。格式为 is -o saslOption=value。saslOption 可以有六个值之一：

* mech, SASL 身份验证机制

* authid，绑定到服务器的用户(Kerberos 主体)

* authzid，一个代理授权（服务器忽略忽略，因为不支持代理授权）

* secProp, 安全属性

* realm，Kerberos 域

* 标记

预期的值取决于支持的机制。该 -o 可以多次使用，为机制传递所有所需的 SASL 信息。例如：

[literal,subs="+ quotes,verbatim"] …​. -o "mech=DIGEST-MD5" -o "authzid=test_user" -o "authid=test_user" …​.

-P supplier_port

提供用于连接用于复制测试的供应商服务器的端口。默认值如果没有提供，则为 16000。

-p port

提供正在测试的 Directory Server 实例的服务器端口号。

-Q

以"super"静默模式运行该工具。这会忽略 ldclt 运行的操作中遇到的任何错误。

-q

以静默模式运行工具。

-r number

设置范围的高数字。

-r number

设置范围的低数量。

-S consumer_name

提供要连接以运行复制测试的使用者服务器的主机名。

-s scope

提供搜索范围。与 ldapsearch 一样，这些值可以是 subtree、one 或 base。

-T ops_per_thread

设置每个线程允许的最大操作数。

-T timeout

为 LDAP 操作设置超时周期。默认值为 30 秒。

-V

以非常详细的方式运行该工具。

-v

以详细模式运行工具。

-W wait_time

设置 ldclt 工具的时间（以秒为单位），以便在一个操作完成后等待下一个操作。默认值为 0，这意味着没有等待时间。

-w password

提供要使用的密码以及 -D 身份，以绑定到目录服务器进行测试。

-Z /path/to/cert.db

为测试连接启用 TLS，并指向文件以用作证书数据库。

abandon

为异步搜索请求启动带头操作程序。

add

向目录添加条目(ldapadd)。

附加

将条目附加到使用 genldif 选项生成的 LDIF 文件的末尾。

ASCII

生成 ASCII 7 位字符串。

attreplace=name:mask

运行 修改操作，以替换现有条目中的属性(名称)。

attrlist=name:name:name

指定要在搜索操作中返回的属性列表。

attrsonly=#

与搜索操作一起使用，以设置是否读取属性值。可能的值有 0 （读取值）或 1 （不读取值）。

bindeach

告知 ldclt 工具与其尝试的每个操作绑定。

bindonly

告知 ldclt 工具仅运行 bind/unbind 操作。没有执行其他操作。

关闭

告知工具关闭连接，而不是执行 unbind 操作。

cltcertname=name

提供用于 TLS 连接的 TLS 客户端证书名称。

commoncounter

使 ldclt 工具打开的所有线程以共享相同的计数器。

counteach

告知工具计算每个操作，而不仅仅是成功。

delete

启动删除操作。

deref

为搜索操作添加解引用控制(esearch)。添加后，这告知 ldclt 将 secretary 属性添加到新条目中，以允许解引用搜索。

dontsleeponserverdown

如果服务器停机，会导致工具非常快。

emailPerson

这会将 emailPerson 对象类添加到生成的条目中。这只适用于 add 操作(-e add)。

esearch

执行精确搜索。

genldif=filename

生成用于操作的 LDIF 文件。

imagesdir=path

提供用于测试的镜像的位置。

incr

启用增量值。

inetOrgPerson

这会将 inetOrgPerson 对象类添加到生成的条目中。这只适用于 add 操作(-e add)。

keydbfile=file

包含用于 TLS 连接的密钥数据库的路径和文件名。

keydbpin=password

包含用于访问密钥数据库的令牌密码。

noglobalstats

告知工具 不 打印定期全局统计信息。

noloop

不对增量数字进行循环。

object=filename

从输入文件构建条目对象。

个人

这会将 person 对象类添加到生成的条目中。这只适用于 add 操作(-e add)。

random

告知 ldclt 实用程序使用所有随机元素，如随机过滤和随机基础 DNS。

randomattrlist=name:name:name

告知 ldclt 实用程序从给定的列表中选择随机属性。

randombase

告知 ldclt 实用程序从目录中选择一个随机基础 DN。

randombaselow=value

为随机生成器设置低值。

randombasehigh=value

为随机生成器设置高值。

randombinddn

告知 ldclt 实用程序使用随机绑定 DN。

randombinddnfromfile=file

告知 ldclt 实用程序使用从文件中选择的随机绑定 DN。文件中的每个条目都必须具有适当的 DN 密码对。

randombinddnlow=value

为随机生成器设置低值。

randombinddnhigh=value

为随机生成器设置高值。

rdn=attrname:value

提供用作搜索过滤器的 RDN。这被使用，而不是 a -f 过滤器。

referral=value

设置操作的引用行为。有三个选项： on (allow referrals), off (disallow referrals)或 rebind (attempt to connect)。

smoothshutdown

告知 ldclt 工具不会关闭其主线程，直到 worker 线程退出为止。

字符串

告知 ldclt 实用程序创建随机字符串，而不是随机数字。

v2

告知 ldclt 实用程序使用 LDAPv2 测试操作。

withnewparent

执行 modRDN 操作，使用 newparent set 作为参数重命名条目。

randomauthid

使用随机 SASL 身份验证 ID。

randomauthidlow=value

为随机 SASL 身份验证 ID 设置低值。

randomauthidhigh=value

为随机 SASL 身份验证 ID 设置高值。

0

成功（无错误）。

1

操作遇到严重严重错误。

2

使用 工具传递的参数中出现错误。

3

工具达到最大 LDAP 错误数。

4

该工具无法绑定到目录服务器实例。

5

工具无法加载通过 TLS 进行连接的 TLS 库。

6

存在一个多线程(mutex)错误。

7

存在一个初始化问题。

8

工具达到资源限值，如内存分配错误。

99

脚本遇到未知错误。