69 lines
4.0 KiB
HTML
69 lines
4.0 KiB
HTML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="dc.language" scheme="rfc1766" content="en-us" />
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<meta name="dc.date" scheme="iso8601" content="2005-09-06" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow"/>
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<title>Directory Server (LDAP) - Controls and extended operations</title>
|
|
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
|
|
<link rel="stylesheet" type="text/css" href="ic.css" />
|
|
</head>
|
|
<body>
|
|
<a id="Top_Of_Page" name="Top_Of_Page"></a><!-- Java sync-link -->
|
|
<script language = "Javascript" src = "../rzahg/synch.js" type="text/javascript"></script>
|
|
|
|
|
|
<a name="rzahycontrols"></a>
|
|
<h2 id="rzahycontrols">Controls and extended operations</h2>
|
|
<p><span class="bold">Controls</span></p>
|
|
<p>Controls provide additional information to the server to control how it
|
|
interprets a given request. For example, a <tt class="xph">delete subtree</tt> control
|
|
can be specified on a LDAP delete request, indicating that the server should
|
|
delete the entry and all its subordinate entries, rather than deleting just
|
|
the entry specified. A control consists of three parts:</p>
|
|
<ul>
|
|
<li>The control type, which is an OID identifying the control.</li>
|
|
<li>A criticality indicator, which specifies how the server should behave
|
|
if it does not support the control. This is a Boolean value. FALSE indicates
|
|
the control is not critical, and the server should ignore it if it doesn't
|
|
support it. TRUE indicates the control is critical and the entire request
|
|
should be failed (with an unsupported critical extension error) if the server
|
|
cannot honor the control.</li>
|
|
<li>An optional control value, which contains other information specific to
|
|
the control. The content of the control value is specified using ASN.1 notation.
|
|
The value itself is the BER encoding of the control data.</li></ul>
|
|
<p><span class="bold">Extended operations</span></p>
|
|
<p>Extended operations are used to start additional operations beyond the
|
|
core LDAP operations. For example, extended operations have been defined
|
|
to group a set of operations into a single transaction. An extended operation
|
|
consists of:</p>
|
|
<ul>
|
|
<li>The request name, an OID which identifies the specific operation.</li>
|
|
<li>An optional request value, which contains other information specific to
|
|
the operation. The content of the request value is specified using ASN.1
|
|
notation. The value itself is the BER encoding of the request data.</li></ul>
|
|
<p>Extended operations typically have an extended response. The response
|
|
consists of:</p>
|
|
<ul>
|
|
<li>The components of the standard LDAP result (error code, matched DN, and
|
|
error message)</li>
|
|
<li>The response name, an OID which identifies the type of response</li>
|
|
<li>An optional value, which contains other information specific to the response.
|
|
The content of the response value is specified using ASN.1 notation. The
|
|
value itself is the BER encoding of the response data.</li></ul>
|
|
<p>For a complete list of controls and extended operations as well as their
|
|
respective object identifiers (OIDs) and descriptions, see <a href="rzahyoids.htm#rzahyoids">Object identifiers (OIDs)</a>.</p>
|
|
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
|
|
</body>
|
|
</html>
|