From c172a20c49bf73882f1a125b5bde41034a217328 Mon Sep 17 00:00:00 2001 From: Pierangelo Masarati Date: Tue, 19 Jul 2005 00:42:32 +0000 Subject: [PATCH] document new timeout feature; improve existing stuff --- doc/man/man5/slapd-meta.5 | 55 ++++++++++++++++++++++++++++----------- 1 file changed, 40 insertions(+), 15 deletions(-) diff --git a/doc/man/man5/slapd-meta.5 b/doc/man/man5/slapd-meta.5 index e686aaf9a7..9c61bb15d1 100644 --- a/doc/man/man5/slapd-meta.5 +++ b/doc/man/man5/slapd-meta.5 @@ -105,6 +105,22 @@ before any target specification, it applies to all targets (by default, .BR never ); the global value can be overridden by redefinitions inside each target specification. + +.TP +.B onerr {CONTINUE|stop} +This directive allows to select the behavior in case an error is returned +by one target during a search. +The default, \fBcontinue\fP, consists in continuing the operation, +trying to return as much data as possible. +If this statement is set to \fBstop\fP, the search is terminated as soon +as an error is returned by one target, and the error is immediately +propagated to the client. + +.TP +.B rebind-as-user {NO|yes} +If this option is given, the client's bind credentials are remembered +for rebinds when chasing referrals. + .SH TARGET SPECIFICATION Target specification starts with a "uri" directive: @@ -165,16 +181,13 @@ Password used with the acl-authcDN above. -.TP -.B rebind-as-user {NO|yes} -If this option is given, the client's bind credentials are remembered -for rebinds when chasing referrals. - .TP .B chase-referrals {YES|no} enable/disable automatic referral chasing, which is delegated to the underlying libldap, with rebinding eventually performed if the \fBrebind-as-user\fP directive is used. The default is to chase referrals. +If set before any target specification, it affects all targets, unless +overridden by any per-target directive. .TP .B tls {[try-]start|[try-]propagate} @@ -184,6 +197,8 @@ only works if the URI directive protocol scheme is not \fBldaps://\fP. connection did. The \fBtry-\fP prefix instructs the proxy to continue operations if start TLS failed; its use is highly deprecated. +If set before any target specification, it affects all targets, unless +overridden by any per-target directive. .TP .B t-f-support {NO|yes|discover} @@ -192,16 +207,26 @@ enable if the remote server supports absolute filters If set to .BR discover , support is detected by reading the remote server's root DSE. - -.TP -.B onerr {CONTINUE|stop} -This directive allows to select the behavior in case an error is returned -by one target during a search. -The default, \fBcontinue\fP, consists in continuing the operation, -trying to return as much data as possible. -If this statement is set to \fBstop\fP, the search is terminated as soon -as an error is returned by one target, and the error is immediately -propagated to the client. +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 +.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. .TP .B pseudorootdn "" -- 2.39.5