From 5ef5652125ce84c107b34ea233fc99e614893119 Mon Sep 17 00:00:00 2001 From: Pierangelo Masarati Date: Fri, 26 Jan 2007 02:05:49 +0000 Subject: [PATCH] document timeout support in searches --- doc/man/man5/slapd-ldap.5 | 6 ++++-- doc/man/man5/slapd-meta.5 | 43 +++++++++++++++++++++++++-------------- 2 files changed, 32 insertions(+), 17 deletions(-) diff --git a/doc/man/man5/slapd-ldap.5 b/doc/man/man5/slapd-ldap.5 index 8a66b2e0ef..847ea6d657 100644 --- a/doc/man/man5/slapd-ldap.5 +++ b/doc/man/man5/slapd-ldap.5 @@ -446,13 +446,15 @@ support is detected by reading the remote server's root DSE. This directive allows to set per-operation timeouts. Operations can be -\fB ::= bind, add, delete, modrdn, modify, compare\fP +\fB ::= bind, add, delete, modrdn, modify, compare, search\fP -The \fBsearch\fP operation is already controlled either +The overall duration of the \fBsearch\fP operation is controlled either by the \fBtimelimit\fP parameter or by server-side enforced time limits (see \fBtimelimit\fP and \fBlimits\fP in .BR slapd.conf (5) for details). +This \fBtimeout\fP parameter controls how long the target can be +irresponsive before the operation is aborted. Timeout is meaningless for the remaining operations, \fBunbind\fP and \fBabandon\fP, which do not imply any response, while it is not yet implemented in currently supported \fBextended\fP diff --git a/doc/man/man5/slapd-meta.5 b/doc/man/man5/slapd-meta.5 index 7330046d43..46e9fb5c14 100644 --- a/doc/man/man5/slapd-meta.5 +++ b/doc/man/man5/slapd-meta.5 @@ -371,22 +371,35 @@ If set before any target specification, it affects all targets, unless overridden by any per-target directive. .TP -.B timeout [{add|delete|modify|modrdn}=] [...] -This directive allows to set per-database, per-target and per-operation -timeouts. -If no operation is specified, it affects all. -Currently, only write operations are addressed, because searches -can already be limited by means of the -.B limits -directive (see +.B timeout [=] [...] +This directive allows to set per-operation timeouts. +Operations can be + +\fB ::= bind, add, delete, modrdn, modify, compare, search\fP + +The overall duration of the \fBsearch\fP operation is controlled either +by the \fBtimelimit\fP parameter or by server-side enforced +time limits (see \fBtimelimit\fP and \fBlimits\fP in .BR slapd.conf (5) -for details), and other operations are not supposed to incur into the -need for timeouts. -Note: if the timelimit is exceeded, the operation is abandoned; -the protocol does not provide any means to rollback the operation, -so the client will not know if the operation eventually succeeded or not. -If set before any target specification, it affects all targets, unless -overridden by any per-target directive. +for details). +This \fBtimeout\fP parameter controls how long the target can be +irresponsive before the operation is aborted. +Timeout is meaningless for the remaining operations, +\fBunbind\fP and \fBabandon\fP, which do not imply any response, +while it is not yet implemented in currently supported \fBextended\fP +operations. +If no operation is specified, the timeout \fBval\fP affects all +supported operations. +If specified before any target definition, it affects all targets +unless overridden by per-target directives. + +Note: if the timelimit is exceeded, the operation is cancelled +(according to the \fBcancel\fP directive); +the protocol does not provide any means to rollback operations, +so the client will not be notified about the result of the operation, +which may eventually succeeded or not. +In case the timeout is exceeded during a bind operation, the connection +is destroyed, according to RFC4511. .TP .B tls {[try-]start|[try-]propagate} -- 2.39.5