RubyGems - fakeldap - Versions diffs - 0.0.0 → 0.0.1 - Mend

fakeldap 0.0.0 → 0.0.1

Files changed (81) hide show

data/vendor/ruby-ldapserver/doc/LDAP/Server/Connection.html ADDED

@@ -0,0 +1,1353 @@
+<!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" xml:lang="en" lang="en">
+  <head>
+    <meta name="Content-Type" content="text/html; charset=utf-8" />
+<title>Class: LDAP::Server::Connection</title>
+<link rel="stylesheet" href="../../css/style.css" type="text/css" media="screen" charset="utf-8" />
+<link rel="stylesheet" href="../../css/common.css" type="text/css" media="screen" charset="utf-8" />
+<script type="text/javascript" charset="utf-8">
+  relpath = '../..';
+  if (relpath != '') relpath += '/';
+</script>
+<script type="text/javascript" charset="utf-8" src="../../js/jquery.js"></script>
+<script type="text/javascript" charset="utf-8" src="../../js/app.js"></script>
+  </head>
+  <body>
+    <script type="text/javascript" charset="utf-8">
+      if (window.top.frames.main) document.body.className = 'frames';
+    </script>
+    <div id="header">
+      <div id="menu">
+    <a href="../../_index.html">Index (C)</a> &raquo;
+    <span class='title'><span class='object_link'><a href="../../LDAP.html" title="LDAP (module)">LDAP</a></span></span> &raquo; <span class='title'><span class='object_link'><a href="../Server.html" title="LDAP::Server (class)">Server</a></span></span>
+     &raquo;
+    <span class="title">Connection</span>
+  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
+</div>
+      <div id="search">
+  <a id="class_list_link" href="#">Class List</a>
+  <a id="method_list_link" href="#">Method List</a>
+  <a id ="file_list_link" href="#">File List</a>
+</div>
+      <div class="clear"></div>
+    </div>
+    <iframe id="search_frame"></iframe>
+    <div id="content"><h1>Class: LDAP::Server::Connection
+</h1>
+<dl class="box">
+    <dt class="r1">Inherits:</dt>
+    <dd class="r1">
+      <span class="inheritName">Object</span>
+        <ul class="fullTree">
+          <li>Object</li>
+            <li class="next">LDAP::Server::Connection</li>
+        </ul>
+        <a href="#" class="inheritanceTree">show all</a>
+      </dd>
+    <dt class="r2 last">Defined in:</dt>
+    <dd class="r2 last">lib/ldap/server/connection.rb</dd>
+</dl>
+<div class="clear"></div>
+<h2>Overview</h2><div class="docstring">
+  <div class="discussion">
+    <p>
+An object which handles an LDAP connection. Note that LDAP allows requests
+and responses to be exchanged asynchronously: e.g. a client can send three
+requests, and the three responses can come back in any order. For that
+reason, we start a new thread for each request, and we need a mutex on the
+io object so that multiple responses don&#8217;t interfere with each other.
+</p>
+  </div>
+</div>
+<div class="tags">
+</div>
+  <h2>Instance Attribute Summary <small>(<a href="#" class="summary_toggle">collapse</a>)</small></h2>
+  <ul class="summary">
+      <li class="public ">
+  <span class="summary_signature">
+      <a href="#binddn-instance_method" title="#binddn (instance method)">- (Object) <strong>binddn</strong> </a>
+  </span>
+    <span class="note title readonly">readonly</span>
+    <span class="summary_desc"><div class='inline'><p>
+Returns the value of attribute binddn.
+</p>
+</div></span>
+</li>
+      <li class="public ">
+  <span class="summary_signature">
+      <a href="#opt-instance_method" title="#opt (instance method)">- (Object) <strong>opt</strong> </a>
+  </span>
+    <span class="note title readonly">readonly</span>
+    <span class="summary_desc"><div class='inline'><p>
+Returns the value of attribute opt.
+</p>
+</div></span>
+</li>
+      <li class="public ">
+  <span class="summary_signature">
+      <a href="#version-instance_method" title="#version (instance method)">- (Object) <strong>version</strong> </a>
+  </span>
+    <span class="note title readonly">readonly</span>
+    <span class="summary_desc"><div class='inline'><p>
+Returns the value of attribute version.
+</p>
+</div></span>
+</li>
+  </ul>
+    <h2>
+      Instance Method Summary
+      <small>(<a href="#" class="summary_toggle">collapse</a>)</small>
+    </h2>
+    <ul class="summary">
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#abandon-instance_method" title="#abandon (instance method)">- (Object) <strong>abandon</strong>(messageID) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'></div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#abandon_all-instance_method" title="#abandon_all (instance method)">- (Object) <strong>abandon_all</strong> </a>
+  </span>
+    <span class="summary_desc"><div class='inline'></div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#ber_read-instance_method" title="#ber_read (instance method)">- (Object) <strong>ber_read</strong>(io) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'><p>
+Read one ASN1 element from the given stream.
+</p>
+</div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#handle_requests-instance_method" title="#handle_requests (instance method)">- (Object) <strong>handle_requests</strong> </a>
+  </span>
+    <span class="summary_desc"><div class='inline'></div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#initialize-instance_method" title="#initialize (instance method)">- (Connection) <strong>initialize</strong>(io, opt = {}) </a>
+  </span>
+    <span class="note title constructor">constructor</span>
+    <span class="summary_desc"><div class='inline'><p>
+A new instance of Connection.
+</p>
+</div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#log-instance_method" title="#log (instance method)">- (Object) <strong>log</strong>(msg) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'></div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#send_notice_of_disconnection-instance_method" title="#send_notice_of_disconnection (instance method)">- (Object) <strong>send_notice_of_disconnection</strong>(resultCode, errorMessage = &quot;&quot;) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'></div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#send_unsolicited_notification-instance_method" title="#send_unsolicited_notification (instance method)">- (Object) <strong>send_unsolicited_notification</strong>(resultCode, opt = {}) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'></div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#startssl-instance_method" title="#startssl (instance method)">- (Object) <strong>startssl</strong> </a>
+  </span>
+    <span class="summary_desc"><div class='inline'><p>
+:yields:.
+</p>
+</div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#write-instance_method" title="#write (instance method)">- (Object) <strong>write</strong>(data) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'></div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#writelock-instance_method" title="#writelock (instance method)">- (Object) <strong>writelock</strong> </a>
+  </span>
+    <span class="summary_desc"><div class='inline'></div></span>
+</li>
+    </ul>
+<div id="constructor_details" class="method_details_list">
+  <h2>Constructor Details</h2>
+    <div class="method_details first">
+  <p class="signature first" id="initialize-instance_method">
+    - (<tt><span class='object_link'><a href="" title="LDAP::Server::Connection (class)">Connection</a></span></tt>) <strong>initialize</strong>(io, opt = {})
+</p><div class="docstring">
+  <div class="discussion">
+    <p>
+A new instance of Connection
+</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ldap/server/connection.rb', line 18</span>
+<span class='kw'>def</span> <span class='id initialize'>initialize</span><span class='lparen'>(</span><span class='id io'>io</span><span class='comma'>,</span> <span class='id opt'>opt</span><span class='op'>=</span><span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
+  <span class='ivar'>@io</span> <span class='op'>=</span> <span class='id io'>io</span>
+  <span class='ivar'>@opt</span> <span class='op'>=</span> <span class='id opt'>opt</span>
+  <span class='ivar'>@mutex</span> <span class='op'>=</span> <span class='const'>Mutex</span><span class='period'>.</span><span class='id new'>new</span>
+  <span class='ivar'>@active_reqs</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>   <span class='comment'># map message ID to thread object
+</span>  <span class='ivar'>@binddn</span> <span class='op'>=</span> <span class='kw'>nil</span>
+  <span class='ivar'>@version</span> <span class='op'>=</span> <span class='int'>3</span>
+  <span class='ivar'>@logger</span> <span class='op'>=</span> <span class='ivar'>@opt</span><span class='lbracket'>[</span><span class='symbol'>:logger</span><span class='rbracket'>]</span> <span class='op'>||</span> <span class='gvar'>$stderr</span>
+  <span class='ivar'>@ssl</span> <span class='op'>=</span> <span class='kw'>false</span>
+  <span class='id startssl'>startssl</span> <span class='kw'>if</span> <span class='ivar'>@opt</span><span class='lbracket'>[</span><span class='symbol'>:ssl_on_connect</span><span class='rbracket'>]</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+</div>
+  <div id="instance_attr_details" class="attr_details">
+    <h2>Instance Attribute Details</h2>
+      <span id=""></span>
+      <span id="binddn-instance_method"></span>
+      <div class="method_details first">
+  <p class="signature first" id="binddn-instance_method">
+    - (<tt>Object</tt>) <strong>binddn</strong>  <span class="extras">(readonly)</span>
+</p><div class="docstring">
+  <div class="discussion">
+    <p>
+Returns the value of attribute binddn
+</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+16
+17
+18</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ldap/server/connection.rb', line 16</span>
+<span class='kw'>def</span> <span class='id binddn'>binddn</span>
+  <span class='ivar'>@binddn</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <span id=""></span>
+      <span id="opt-instance_method"></span>
+      <div class="method_details ">
+  <p class="signature " id="opt-instance_method">
+    - (<tt>Object</tt>) <strong>opt</strong>  <span class="extras">(readonly)</span>
+</p><div class="docstring">
+  <div class="discussion">
+    <p>
+Returns the value of attribute opt
+</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+16
+17
+18</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ldap/server/connection.rb', line 16</span>
+<span class='kw'>def</span> <span class='id opt'>opt</span>
+  <span class='ivar'>@opt</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <span id=""></span>
+      <span id="version-instance_method"></span>
+      <div class="method_details ">
+  <p class="signature " id="version-instance_method">
+    - (<tt>Object</tt>) <strong>version</strong>  <span class="extras">(readonly)</span>
+</p><div class="docstring">
+  <div class="discussion">
+    <p>
+Returns the value of attribute version
+</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+16
+17
+18</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ldap/server/connection.rb', line 16</span>
+<span class='kw'>def</span> <span class='id version'>version</span>
+  <span class='ivar'>@version</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+  </div>
+  <div id="instance_method_details" class="method_details_list">
+    <h2>Instance Method Details</h2>
+      <div class="method_details first">
+  <p class="signature first" id="abandon-instance_method">
+    - (<tt>Object</tt>) <strong>abandon</strong>(messageID)
+</p><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+227
+228
+229
+230
+231
+232</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ldap/server/connection.rb', line 227</span>
+<span class='kw'>def</span> <span class='id abandon'>abandon</span><span class='lparen'>(</span><span class='id messageID'>messageID</span><span class='rparen'>)</span>
+  <span class='ivar'>@mutex</span><span class='period'>.</span><span class='id synchronize'>synchronize</span> <span class='kw'>do</span>
+    <span class='id thread'>thread</span> <span class='op'>=</span> <span class='ivar'>@active_reqs</span><span class='period'>.</span><span class='id delete'>delete</span><span class='lparen'>(</span><span class='id messageID'>messageID</span><span class='rparen'>)</span>
+    <span class='id thread'>thread</span><span class='period'>.</span><span class='id raise'>raise</span> <span class='const'>LDAP</span><span class='op'>::</span><span class='const'>Abandon</span> <span class='kw'>if</span> <span class='id thread'>thread</span> <span class='kw'>and</span> <span class='id thread'>thread</span><span class='period'>.</span><span class='id alive?'>alive?</span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <p class="signature " id="abandon_all-instance_method">
+    - (<tt>Object</tt>) <strong>abandon_all</strong>
+</p><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+234
+235
+236
+237
+238
+239
+240
+241
+242</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ldap/server/connection.rb', line 234</span>
+<span class='kw'>def</span> <span class='id abandon_all'>abandon_all</span>
+  <span class='kw'>return</span> <span class='kw'>if</span> <span class='ivar'>@active_reqs</span><span class='period'>.</span><span class='id size'>size</span> <span class='op'>==</span> <span class='int'>0</span>
+  <span class='ivar'>@mutex</span><span class='period'>.</span><span class='id synchronize'>synchronize</span> <span class='kw'>do</span>
+    <span class='ivar'>@active_reqs</span><span class='period'>.</span><span class='id each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id id'>id</span><span class='comma'>,</span> <span class='id thread'>thread</span><span class='op'>|</span>
+      <span class='id thread'>thread</span><span class='period'>.</span><span class='id raise'>raise</span> <span class='const'>LDAP</span><span class='op'>::</span><span class='const'>Abandon</span> <span class='kw'>if</span> <span class='id thread'>thread</span><span class='period'>.</span><span class='id alive?'>alive?</span>
+    <span class='kw'>end</span>
+    <span class='ivar'>@active_reqs</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <p class="signature " id="ber_read-instance_method">
+    - (<tt>Object</tt>) <strong>ber_read</strong>(io)
+</p><div class="docstring">
+  <div class="discussion">
+    <p>
+Read one ASN1 element from the given stream. Return String containing the
+raw element.
+</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+49
+50
+51
+52
+53
+54
+55
+56
+57
+58
+59
+60
+61
+62
+63
+64
+65
+66
+67
+68
+69
+70
+71
+72
+73
+74
+75
+76
+77
+78
+79
+80
+81
+82
+83
+84
+85</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ldap/server/connection.rb', line 49</span>
+<span class='kw'>def</span> <span class='id ber_read'>ber_read</span><span class='lparen'>(</span><span class='id io'>io</span><span class='rparen'>)</span>
+  <span class='id blk'>blk</span> <span class='op'>=</span> <span class='id io'>io</span><span class='period'>.</span><span class='id read'>read</span><span class='lparen'>(</span><span class='int'>2</span><span class='rparen'>)</span>		<span class='comment'># minimum: short tag, short length
+</span>  <span class='id throw'>throw</span><span class='lparen'>(</span><span class='symbol'>:close</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id blk'>blk</span><span class='period'>.</span><span class='id nil?'>nil?</span>
+  <span class='id codepoints'>codepoints</span> <span class='op'>=</span> <span class='id blk'>blk</span><span class='period'>.</span><span class='id respond_to?'>respond_to?</span><span class='lparen'>(</span><span class='symbol'>:codepoints</span><span class='rparen'>)</span> <span class='op'>?</span> <span class='id blk'>blk</span><span class='period'>.</span><span class='id codepoints'>codepoints</span><span class='period'>.</span><span class='id to_a'>to_a</span> <span class='op'>:</span> <span class='id blk'>blk</span>
+  <span class='id tag'>tag</span> <span class='op'>=</span> <span class='id codepoints'>codepoints</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span> <span class='op'>&amp;</span> <span class='int'>0x1f</span>
+  <span class='id len'>len</span> <span class='op'>=</span> <span class='id codepoints'>codepoints</span><span class='lbracket'>[</span><span class='int'>1</span><span class='rbracket'>]</span>
+  <span class='kw'>if</span> <span class='id tag'>tag</span> <span class='op'>==</span> <span class='int'>0x1f</span>		<span class='comment'># long form
+</span>    <span class='id tag'>tag</span> <span class='op'>=</span> <span class='int'>0</span>
+    <span class='kw'>while</span> <span class='kw'>true</span>
+      <span class='id ch'>ch</span> <span class='op'>=</span> <span class='id io'>io</span><span class='period'>.</span><span class='id getc'>getc</span>
+      <span class='id blk'>blk</span> <span class='op'>&lt;&lt;</span> <span class='id ch'>ch</span>
+      <span class='id tag'>tag</span> <span class='op'>=</span> <span class='lparen'>(</span><span class='id tag'>tag</span> <span class='op'>&lt;&lt;</span> <span class='int'>7</span><span class='rparen'>)</span> <span class='op'>|</span> <span class='lparen'>(</span><span class='id ch'>ch</span> <span class='op'>&amp;</span> <span class='int'>0x7f</span><span class='rparen'>)</span>
+      <span class='kw'>break</span> <span class='kw'>if</span> <span class='lparen'>(</span><span class='id ch'>ch</span> <span class='op'>&amp;</span> <span class='int'>0x80</span><span class='rparen'>)</span> <span class='op'>==</span> <span class='int'>0</span>
+    <span class='kw'>end</span>
+    <span class='id len'>len</span> <span class='op'>=</span> <span class='id io'>io</span><span class='period'>.</span><span class='id getc'>getc</span>
+    <span class='id blk'>blk</span> <span class='op'>&lt;&lt;</span> <span class='id len'>len</span>
+  <span class='kw'>end</span>
+  <span class='kw'>if</span> <span class='lparen'>(</span><span class='id len'>len</span> <span class='op'>&amp;</span> <span class='int'>0x80</span><span class='rparen'>)</span> <span class='op'>!=</span> <span class='int'>0</span>	<span class='comment'># long form
+</span>    <span class='id len'>len</span> <span class='op'>=</span> <span class='id len'>len</span> <span class='op'>&amp;</span> <span class='int'>0x7f</span>
+    <span class='id raise'>raise</span> <span class='const'>LDAP</span><span class='op'>::</span><span class='const'>ResultError</span><span class='op'>::</span><span class='const'>ProtocolError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Indefinite length encoding not supported</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>if</span> <span class='id len'>len</span> <span class='op'>==</span> <span class='int'>0</span>
+    <span class='id offset'>offset</span> <span class='op'>=</span> <span class='id blk'>blk</span><span class='period'>.</span><span class='id length'>length</span>
+    <span class='id blk'>blk</span> <span class='op'>&lt;&lt;</span> <span class='id io'>io</span><span class='period'>.</span><span class='id read'>read</span><span class='lparen'>(</span><span class='id len'>len</span><span class='rparen'>)</span>
+    <span class='comment'># is there a more efficient way of doing this?
+</span>    <span class='id len'>len</span> <span class='op'>=</span> <span class='int'>0</span>
+    <span class='id blk'>blk</span><span class='lbracket'>[</span><span class='id offset'>offset</span><span class='op'>..</span><span class='op'>-</span><span class='int'>1</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id each_byte'>each_byte</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id b'>b</span><span class='op'>|</span> <span class='id len'>len</span> <span class='op'>=</span> <span class='lparen'>(</span><span class='id len'>len</span> <span class='op'>&lt;&lt;</span> <span class='int'>8</span><span class='rparen'>)</span> <span class='op'>|</span> <span class='id b'>b</span> <span class='rbrace'>}</span>
+  <span class='kw'>end</span>
+  <span class='id offset'>offset</span> <span class='op'>=</span> <span class='id blk'>blk</span><span class='period'>.</span><span class='id length'>length</span>
+  <span class='id blk'>blk</span> <span class='op'>&lt;&lt;</span> <span class='id io'>io</span><span class='period'>.</span><span class='id read'>read</span><span class='lparen'>(</span><span class='id len'>len</span><span class='rparen'>)</span>
+  <span class='kw'>return</span> <span class='id blk'>blk</span>
+  <span class='comment'># or if we wanted to keep the partial decoding we've done:
+</span>  <span class='comment'># return blk, [blk[0] &gt;&gt; 6, tag], offset
+</span><span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <p class="signature " id="handle_requests-instance_method">
+    - (<tt>Object</tt>) <strong>handle_requests</strong>
+</p><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+87
+88
+89
+90
+91
+92
+93
+94
+95
+96
+97
+98
+99
+100
+101
+102
+103
+104
+105
+106
+107
+108
+109
+110
+111
+112
+113
+114
+115
+116
+117
+118
+119
+120
+121
+122
+123
+124
+125
+126
+127
+128
+129
+130
+131
+132
+133
+134
+135
+136
+137
+138
+139
+140
+141
+142
+143
+144
+145
+146
+147
+148
+149
+150
+151
+152
+153
+154
+155
+156
+157
+158
+159
+160
+161
+162
+163
+164
+165
+166
+167
+168
+169
+170
+171
+172
+173
+174
+175
+176
+177
+178
+179
+180
+181
+182
+183
+184
+185
+186
+187
+188
+189
+190
+191
+192
+193
+194
+195
+196
+197
+198
+199
+200
+201
+202
+203
+204
+205
+206
+207
+208
+209
+210
+211</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ldap/server/connection.rb', line 87</span>
+<span class='kw'>def</span> <span class='id handle_requests'>handle_requests</span>
+  <span class='id operationClass'>operationClass</span> <span class='op'>=</span> <span class='ivar'>@opt</span><span class='lbracket'>[</span><span class='symbol'>:operation_class</span><span class='rbracket'>]</span>
+  <span class='id ocArgs'>ocArgs</span> <span class='op'>=</span> <span class='ivar'>@opt</span><span class='lbracket'>[</span><span class='symbol'>:operation_args</span><span class='rbracket'>]</span> <span class='op'>||</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
+  <span class='id catch'>catch</span><span class='lparen'>(</span><span class='symbol'>:close</span><span class='rparen'>)</span> <span class='kw'>do</span>
+    <span class='kw'>while</span> <span class='kw'>true</span>
+      <span class='kw'>begin</span>
+        <span class='id blk'>blk</span> <span class='op'>=</span> <span class='id ber_read'>ber_read</span><span class='lparen'>(</span><span class='ivar'>@io</span><span class='rparen'>)</span>
+        <span class='id asn1'>asn1</span> <span class='op'>=</span> <span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>ASN1</span><span class='op'>::</span><span class='id decode'>decode</span><span class='lparen'>(</span><span class='id blk'>blk</span><span class='rparen'>)</span>
+        <span class='comment'># Debugging:
+</span>        <span class='comment'># puts &quot;Request: #{blk.unpack(&quot;H*&quot;)}\n#{asn1.inspect}&quot; if $debug
+</span>
+        <span class='id raise'>raise</span> <span class='const'>LDAP</span><span class='op'>::</span><span class='const'>ResultError</span><span class='op'>::</span><span class='const'>ProtocolError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>LDAPMessage must be SEQUENCE</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id asn1'>asn1</span><span class='period'>.</span><span class='id is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>ASN1</span><span class='op'>::</span><span class='const'>Sequence</span><span class='rparen'>)</span>
+        <span class='id raise'>raise</span> <span class='const'>LDAP</span><span class='op'>::</span><span class='const'>ResultError</span><span class='op'>::</span><span class='const'>ProtocolError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Bad Message ID</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id asn1'>asn1</span><span class='period'>.</span><span class='id value'>value</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>ASN1</span><span class='op'>::</span><span class='const'>Integer</span><span class='rparen'>)</span>
+        <span class='id messageId'>messageId</span> <span class='op'>=</span> <span class='id asn1'>asn1</span><span class='period'>.</span><span class='id value'>value</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id value'>value</span>
+        <span class='id protocolOp'>protocolOp</span> <span class='op'>=</span> <span class='id asn1'>asn1</span><span class='period'>.</span><span class='id value'>value</span><span class='lbracket'>[</span><span class='int'>1</span><span class='rbracket'>]</span>
+        <span class='id raise'>raise</span> <span class='const'>LDAP</span><span class='op'>::</span><span class='const'>ResultError</span><span class='op'>::</span><span class='const'>ProtocolError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Bad protocolOp</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id protocolOp'>protocolOp</span><span class='period'>.</span><span class='id is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>ASN1</span><span class='op'>::</span><span class='const'>ASN1Data</span><span class='rparen'>)</span>
+        <span class='id raise'>raise</span> <span class='const'>LDAP</span><span class='op'>::</span><span class='const'>ResultError</span><span class='op'>::</span><span class='const'>ProtocolError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Bad protocolOp tag class</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id protocolOp'>protocolOp</span><span class='period'>.</span><span class='id tag_class'>tag_class</span> <span class='op'>==</span> <span class='symbol'>:APPLICATION</span>
+        <span class='comment'># controls are not properly implemented
+</span>        <span class='id c'>c</span> <span class='op'>=</span> <span class='id asn1'>asn1</span><span class='period'>.</span><span class='id value'>value</span><span class='lbracket'>[</span><span class='int'>2</span><span class='rbracket'>]</span>
+        <span class='kw'>if</span> <span class='id c'>c</span><span class='period'>.</span><span class='id is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>ASN1</span><span class='op'>::</span><span class='const'>ASN1Data</span><span class='rparen'>)</span> <span class='kw'>and</span> <span class='id c'>c</span><span class='period'>.</span><span class='id tag_class'>tag_class</span> <span class='op'>==</span> <span class='symbol'>:APPLICATION</span> <span class='kw'>and</span> <span class='id c'>c</span><span class='period'>.</span><span class='id tag'>tag</span> <span class='op'>==</span> <span class='int'>0</span>
+          <span class='id controls'>controls</span> <span class='op'>=</span> <span class='id c'>c</span><span class='period'>.</span><span class='id value'>value</span>
+        <span class='kw'>end</span>
+        <span class='kw'>case</span> <span class='id protocolOp'>protocolOp</span><span class='period'>.</span><span class='id tag'>tag</span>
+        <span class='kw'>when</span> <span class='int'>0</span> <span class='comment'># BindRequest
+</span>          <span class='id abandon_all'>abandon_all</span>
+          <span class='ivar'>@binddn</span><span class='comma'>,</span> <span class='ivar'>@version</span> <span class='op'>=</span> <span class='id operationClass'>operationClass</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='kw'>self</span><span class='comma'>,</span><span class='id messageId'>messageId</span><span class='comma'>,</span><span class='op'>*</span><span class='id ocArgs'>ocArgs</span><span class='rparen'>)</span><span class='period'>.</span>
+                              <span class='id do_bind'>do_bind</span><span class='lparen'>(</span><span class='id protocolOp'>protocolOp</span><span class='comma'>,</span> <span class='id controls'>controls</span><span class='rparen'>)</span>
+        <span class='kw'>when</span> <span class='int'>2</span> <span class='comment'># UnbindRequest
+</span>          <span class='id throw'>throw</span><span class='lparen'>(</span><span class='symbol'>:close</span><span class='rparen'>)</span>
+        <span class='kw'>when</span> <span class='int'>3</span> <span class='comment'># SearchRequest
+</span>          <span class='comment'># Note: RFC 2251 4.4.4.1 says behaviour is undefined if
+</span>          <span class='comment'># client sends an overlapping request with same message ID,
+</span>          <span class='comment'># so we don't have to worry about the case where there is
+</span>          <span class='comment'># already a thread with this id in @active_reqs.
+</span>          <span class='comment'># However, to avoid a race we copy messageId/
+</span>          <span class='comment'># protocolOp/controls into thread-local variables, because
+</span>          <span class='comment'># they will change when the next request comes in.
+</span>          <span class='comment'>#
+</span>          <span class='comment'># There is a theoretical race condition here: a client could
+</span>          <span class='comment'># send an abandon request before Thread.current is assigned to
+</span>          <span class='comment'># @active_reqs[thrm]. It's not a problem, because abandon isn't
+</span>          <span class='comment'># guaranteed to work anyway. Doing it this way ensures that
+</span>          <span class='comment'># @active_reqs does not leak memory on a long-lived connection.
+</span>
+          <span class='const'>Thread</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='id messageId'>messageId</span><span class='comma'>,</span><span class='id protocolOp'>protocolOp</span><span class='comma'>,</span><span class='id controls'>controls</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id thrm'>thrm</span><span class='comma'>,</span><span class='id thrp'>thrp</span><span class='comma'>,</span><span class='id thrc'>thrc</span><span class='op'>|</span>
+            <span class='kw'>begin</span>
+              <span class='ivar'>@active_reqs</span><span class='lbracket'>[</span><span class='id thrm'>thrm</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='const'>Thread</span><span class='period'>.</span><span class='id current'>current</span>
+              <span class='id operationClass'>operationClass</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='kw'>self</span><span class='comma'>,</span><span class='id thrm'>thrm</span><span class='comma'>,</span><span class='op'>*</span><span class='id ocArgs'>ocArgs</span><span class='rparen'>)</span><span class='period'>.</span><span class='id do_search'>do_search</span><span class='lparen'>(</span><span class='id thrp'>thrp</span><span class='comma'>,</span> <span class='id thrc'>thrc</span><span class='rparen'>)</span>
+            <span class='kw'>ensure</span>
+              <span class='ivar'>@active_reqs</span><span class='period'>.</span><span class='id delete'>delete</span><span class='lparen'>(</span><span class='id thrm'>thrm</span><span class='rparen'>)</span>
+            <span class='kw'>end</span>
+          <span class='kw'>end</span>
+        <span class='kw'>when</span> <span class='int'>6</span> <span class='comment'># ModifyRequest
+</span>          <span class='const'>Thread</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='id messageId'>messageId</span><span class='comma'>,</span><span class='id protocolOp'>protocolOp</span><span class='comma'>,</span><span class='id controls'>controls</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id thrm'>thrm</span><span class='comma'>,</span><span class='id thrp'>thrp</span><span class='comma'>,</span><span class='id thrc'>thrc</span><span class='op'>|</span>
+            <span class='kw'>begin</span>
+              <span class='ivar'>@active_reqs</span><span class='lbracket'>[</span><span class='id thrm'>thrm</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='const'>Thread</span><span class='period'>.</span><span class='id current'>current</span>
+              <span class='id operationClass'>operationClass</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='kw'>self</span><span class='comma'>,</span><span class='id thrm'>thrm</span><span class='comma'>,</span><span class='op'>*</span><span class='id ocArgs'>ocArgs</span><span class='rparen'>)</span><span class='period'>.</span><span class='id do_modify'>do_modify</span><span class='lparen'>(</span><span class='id thrp'>thrp</span><span class='comma'>,</span> <span class='id thrc'>thrc</span><span class='rparen'>)</span>
+            <span class='kw'>ensure</span>
+              <span class='ivar'>@active_reqs</span><span class='period'>.</span><span class='id delete'>delete</span><span class='lparen'>(</span><span class='id thrm'>thrm</span><span class='rparen'>)</span>
+            <span class='kw'>end</span>
+          <span class='kw'>end</span>
+        <span class='kw'>when</span> <span class='int'>8</span> <span class='comment'># AddRequest
+</span>          <span class='const'>Thread</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='id messageId'>messageId</span><span class='comma'>,</span><span class='id protocolOp'>protocolOp</span><span class='comma'>,</span><span class='id controls'>controls</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id thrm'>thrm</span><span class='comma'>,</span><span class='id thrp'>thrp</span><span class='comma'>,</span><span class='id thrc'>thrc</span><span class='op'>|</span>
+            <span class='kw'>begin</span>
+              <span class='ivar'>@active_reqs</span><span class='lbracket'>[</span><span class='id thrm'>thrm</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='const'>Thread</span><span class='period'>.</span><span class='id current'>current</span>
+              <span class='id operationClass'>operationClass</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='kw'>self</span><span class='comma'>,</span><span class='id thrm'>thrm</span><span class='comma'>,</span><span class='op'>*</span><span class='id ocArgs'>ocArgs</span><span class='rparen'>)</span><span class='period'>.</span><span class='id do_add'>do_add</span><span class='lparen'>(</span><span class='id thrp'>thrp</span><span class='comma'>,</span> <span class='id thrc'>thrc</span><span class='rparen'>)</span>
+            <span class='kw'>ensure</span>
+              <span class='ivar'>@active_reqs</span><span class='period'>.</span><span class='id delete'>delete</span><span class='lparen'>(</span><span class='id thrm'>thrm</span><span class='rparen'>)</span>
+            <span class='kw'>end</span>
+          <span class='kw'>end</span>
+        <span class='kw'>when</span> <span class='int'>10</span> <span class='comment'># DelRequest
+</span>          <span class='const'>Thread</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='id messageId'>messageId</span><span class='comma'>,</span><span class='id protocolOp'>protocolOp</span><span class='comma'>,</span><span class='id controls'>controls</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id thrm'>thrm</span><span class='comma'>,</span><span class='id thrp'>thrp</span><span class='comma'>,</span><span class='id thrc'>thrc</span><span class='op'>|</span>
+            <span class='kw'>begin</span>
+              <span class='ivar'>@active_reqs</span><span class='lbracket'>[</span><span class='id thrm'>thrm</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='const'>Thread</span><span class='period'>.</span><span class='id current'>current</span>
+              <span class='id operationClass'>operationClass</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='kw'>self</span><span class='comma'>,</span><span class='id thrm'>thrm</span><span class='comma'>,</span><span class='op'>*</span><span class='id ocArgs'>ocArgs</span><span class='rparen'>)</span><span class='period'>.</span><span class='id do_del'>do_del</span><span class='lparen'>(</span><span class='id thrp'>thrp</span><span class='comma'>,</span> <span class='id thrc'>thrc</span><span class='rparen'>)</span>
+            <span class='kw'>ensure</span>
+              <span class='ivar'>@active_reqs</span><span class='period'>.</span><span class='id delete'>delete</span><span class='lparen'>(</span><span class='id thrm'>thrm</span><span class='rparen'>)</span>
+            <span class='kw'>end</span>
+          <span class='kw'>end</span>
+        <span class='kw'>when</span> <span class='int'>12</span> <span class='comment'># ModifyDNRequest
+</span>          <span class='const'>Thread</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='id messageId'>messageId</span><span class='comma'>,</span><span class='id protocolOp'>protocolOp</span><span class='comma'>,</span><span class='id controls'>controls</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id thrm'>thrm</span><span class='comma'>,</span><span class='id thrp'>thrp</span><span class='comma'>,</span><span class='id thrc'>thrc</span><span class='op'>|</span>
+            <span class='kw'>begin</span>
+              <span class='ivar'>@active_reqs</span><span class='lbracket'>[</span><span class='id thrm'>thrm</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='const'>Thread</span><span class='period'>.</span><span class='id current'>current</span>
+              <span class='id operationClass'>operationClass</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='kw'>self</span><span class='comma'>,</span><span class='id thrm'>thrm</span><span class='comma'>,</span><span class='op'>*</span><span class='id ocArgs'>ocArgs</span><span class='rparen'>)</span><span class='period'>.</span><span class='id do_modifydn'>do_modifydn</span><span class='lparen'>(</span><span class='id thrp'>thrp</span><span class='comma'>,</span> <span class='id thrc'>thrc</span><span class='rparen'>)</span>
+            <span class='kw'>ensure</span>
+              <span class='ivar'>@active_reqs</span><span class='period'>.</span><span class='id delete'>delete</span><span class='lparen'>(</span><span class='id thrm'>thrm</span><span class='rparen'>)</span>
+            <span class='kw'>end</span>
+          <span class='kw'>end</span>
+        <span class='kw'>when</span> <span class='int'>14</span> <span class='comment'># CompareRequest
+</span>          <span class='const'>Thread</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='id messageId'>messageId</span><span class='comma'>,</span><span class='id protocolOp'>protocolOp</span><span class='comma'>,</span><span class='id controls'>controls</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id thrm'>thrm</span><span class='comma'>,</span><span class='id thrp'>thrp</span><span class='comma'>,</span><span class='id thrc'>thrc</span><span class='op'>|</span>
+            <span class='kw'>begin</span>
+              <span class='ivar'>@active_reqs</span><span class='lbracket'>[</span><span class='id thrm'>thrm</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='const'>Thread</span><span class='period'>.</span><span class='id current'>current</span>
+              <span class='id operationClass'>operationClass</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='kw'>self</span><span class='comma'>,</span><span class='id thrm'>thrm</span><span class='comma'>,</span><span class='op'>*</span><span class='id ocArgs'>ocArgs</span><span class='rparen'>)</span><span class='period'>.</span><span class='id do_compare'>do_compare</span><span class='lparen'>(</span><span class='id thrp'>thrp</span><span class='comma'>,</span> <span class='id thrc'>thrc</span><span class='rparen'>)</span>
+            <span class='kw'>ensure</span>
+              <span class='ivar'>@active_reqs</span><span class='period'>.</span><span class='id delete'>delete</span><span class='lparen'>(</span><span class='id thrm'>thrm</span><span class='rparen'>)</span>
+            <span class='kw'>end</span>
+          <span class='kw'>end</span>
+        <span class='kw'>when</span> <span class='int'>16</span> <span class='comment'># AbandonRequest
+</span>          <span class='id abandon'>abandon</span><span class='lparen'>(</span><span class='id protocolOp'>protocolOp</span><span class='period'>.</span><span class='id value'>value</span><span class='rparen'>)</span>
+        <span class='kw'>else</span>
+          <span class='id raise'>raise</span> <span class='const'>LDAP</span><span class='op'>::</span><span class='const'>ResultError</span><span class='op'>::</span><span class='const'>ProtocolError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Unrecognised protocolOp tag </span><span class='embexpr_beg'>#{</span><span class='id protocolOp'>protocolOp</span><span class='period'>.</span><span class='id tag'>tag</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span>
+        <span class='kw'>end</span>
+      <span class='kw'>rescue</span> <span class='const'>LDAP</span><span class='op'>::</span><span class='const'>ResultError</span><span class='op'>::</span><span class='const'>ProtocolError</span><span class='comma'>,</span> <span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>ASN1</span><span class='op'>::</span><span class='const'>ASN1Error</span> <span class='op'>=&gt;</span> <span class='id e'>e</span>
+        <span class='id send_notice_of_disconnection'>send_notice_of_disconnection</span><span class='lparen'>(</span><span class='const'>LDAP</span><span class='op'>::</span><span class='const'>ResultError</span><span class='op'>::</span><span class='const'>ProtocolError</span><span class='period'>.</span><span class='id new'>new</span><span class='period'>.</span><span class='id to_i'>to_i</span><span class='comma'>,</span> <span class='id e'>e</span><span class='period'>.</span><span class='id message'>message</span><span class='rparen'>)</span>
+        <span class='id throw'>throw</span><span class='lparen'>(</span><span class='symbol'>:close</span><span class='rparen'>)</span>
+      <span class='comment'># all other exceptions propagate up and are caught by tcpserver
+</span>      <span class='kw'>end</span>
+    <span class='kw'>end</span>
+  <span class='kw'>end</span>
+  <span class='id abandon_all'>abandon_all</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <p class="signature " id="log-instance_method">
+    - (<tt>Object</tt>) <strong>log</strong>(msg)
+</p><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+31
+32
+33</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ldap/server/connection.rb', line 31</span>
+<span class='kw'>def</span> <span class='id log'>log</span><span class='lparen'>(</span><span class='id msg'>msg</span><span class='rparen'>)</span>
+  <span class='ivar'>@logger</span> <span class='op'>&lt;&lt;</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>[</span><span class='embexpr_beg'>#{</span><span class='ivar'>@io</span><span class='period'>.</span><span class='id peeraddr'>peeraddr</span><span class='lbracket'>[</span><span class='int'>3</span><span class='rbracket'>]</span><span class='rbrace'>}</span><span class='tstring_content'>]: </span><span class='embexpr_beg'>#{</span><span class='id msg'>msg</span><span class='rbrace'>}</span><span class='tstring_content'>\n</span><span class='tstring_end'>&quot;</span></span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <p class="signature " id="send_notice_of_disconnection-instance_method">
+    - (<tt>Object</tt>) <strong>send_notice_of_disconnection</strong>(resultCode, errorMessage = &quot;&quot;)
+</p><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+268
+269
+270
+271
+272
+273</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ldap/server/connection.rb', line 268</span>
+<span class='kw'>def</span> <span class='id send_notice_of_disconnection'>send_notice_of_disconnection</span><span class='lparen'>(</span><span class='id resultCode'>resultCode</span><span class='comma'>,</span> <span class='id errorMessage'>errorMessage</span><span class='op'>=</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
+  <span class='id send_unsolicited_notification'>send_unsolicited_notification</span><span class='lparen'>(</span><span class='id resultCode'>resultCode</span><span class='comma'>,</span>
+    <span class='symbol'>:errorMessage</span><span class='op'>=&gt;</span><span class='id errorMessage'>errorMessage</span><span class='comma'>,</span>
+    <span class='symbol'>:responseName</span><span class='op'>=&gt;</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>1.3.6.1.4.1.1466.20036</span><span class='tstring_end'>&quot;</span></span>
+  <span class='rparen'>)</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <p class="signature " id="send_unsolicited_notification-instance_method">
+    - (<tt>Object</tt>) <strong>send_unsolicited_notification</strong>(resultCode, opt = {})
+</p><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+244
+245
+246
+247
+248
+249
+250
+251
+252
+253
+254
+255
+256
+257
+258
+259
+260
+261
+262
+263
+264
+265
+266</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ldap/server/connection.rb', line 244</span>
+<span class='kw'>def</span> <span class='id send_unsolicited_notification'>send_unsolicited_notification</span><span class='lparen'>(</span><span class='id resultCode'>resultCode</span><span class='comma'>,</span> <span class='id opt'>opt</span><span class='op'>=</span><span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
+  <span class='id protocolOp'>protocolOp</span> <span class='op'>=</span> <span class='lbracket'>[</span>
+    <span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>ASN1</span><span class='op'>::</span><span class='const'>Enumerated</span><span class='lparen'>(</span><span class='id resultCode'>resultCode</span><span class='rparen'>)</span><span class='comma'>,</span>
+    <span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>ASN1</span><span class='op'>::</span><span class='const'>OctetString</span><span class='lparen'>(</span><span class='id opt'>opt</span><span class='lbracket'>[</span><span class='symbol'>:matchedDN</span><span class='rbracket'>]</span> <span class='op'>||</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='comma'>,</span>
+    <span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>ASN1</span><span class='op'>::</span><span class='const'>OctetString</span><span class='lparen'>(</span><span class='id opt'>opt</span><span class='lbracket'>[</span><span class='symbol'>:errorMessage</span><span class='rbracket'>]</span> <span class='op'>||</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='comma'>,</span>
+  <span class='rbracket'>]</span>
+  <span class='kw'>if</span> <span class='id opt'>opt</span><span class='lbracket'>[</span><span class='symbol'>:referral</span><span class='rbracket'>]</span>
+    <span class='id rs'>rs</span> <span class='op'>=</span> <span class='id opt'>opt</span><span class='lbracket'>[</span><span class='symbol'>:referral</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id collect'>collect</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id r'>r</span><span class='op'>|</span> <span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>ASN1</span><span class='op'>::</span><span class='const'>OctetString</span><span class='lparen'>(</span><span class='id r'>r</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
+    <span class='id protocolOp'>protocolOp</span> <span class='op'>&lt;&lt;</span> <span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>ASN1</span><span class='op'>::</span><span class='const'>Sequence</span><span class='lparen'>(</span><span class='id rs'>rs</span><span class='comma'>,</span> <span class='int'>3</span><span class='comma'>,</span> <span class='symbol'>:IMPLICIT</span><span class='comma'>,</span> <span class='symbol'>:APPLICATION</span><span class='rparen'>)</span>
+  <span class='kw'>end</span>
+  <span class='kw'>if</span> <span class='id opt'>opt</span><span class='lbracket'>[</span><span class='symbol'>:responseName</span><span class='rbracket'>]</span>
+    <span class='id protocolOp'>protocolOp</span> <span class='op'>&lt;&lt;</span> <span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>ASN1</span><span class='op'>::</span><span class='const'>OctetString</span><span class='lparen'>(</span><span class='id opt'>opt</span><span class='lbracket'>[</span><span class='symbol'>:responseName</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='int'>10</span><span class='comma'>,</span> <span class='symbol'>:IMPLICIT</span><span class='comma'>,</span> <span class='symbol'>:APPLICATION</span><span class='rparen'>)</span>
+  <span class='kw'>end</span>
+  <span class='kw'>if</span> <span class='id opt'>opt</span><span class='lbracket'>[</span><span class='symbol'>:response</span><span class='rbracket'>]</span>
+    <span class='id protocolOp'>protocolOp</span> <span class='op'>&lt;&lt;</span> <span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>ASN1</span><span class='op'>::</span><span class='const'>OctetString</span><span class='lparen'>(</span><span class='id opt'>opt</span><span class='lbracket'>[</span><span class='symbol'>:response</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='int'>11</span><span class='comma'>,</span> <span class='symbol'>:IMPLICIT</span><span class='comma'>,</span> <span class='symbol'>:APPLICATION</span><span class='rparen'>)</span>
+  <span class='kw'>end</span>
+  <span class='id message'>message</span> <span class='op'>=</span> <span class='lbracket'>[</span>
+    <span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>ASN1</span><span class='op'>::</span><span class='const'>Integer</span><span class='lparen'>(</span><span class='int'>0</span><span class='rparen'>)</span><span class='comma'>,</span>
+    <span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>ASN1</span><span class='op'>::</span><span class='const'>Sequence</span><span class='lparen'>(</span><span class='id protocolOp'>protocolOp</span><span class='comma'>,</span> <span class='int'>24</span><span class='comma'>,</span> <span class='symbol'>:IMPLICIT</span><span class='comma'>,</span> <span class='symbol'>:APPLICATION</span><span class='rparen'>)</span><span class='comma'>,</span>
+  <span class='rbracket'>]</span>
+  <span class='id message'>message</span> <span class='op'>&lt;&lt;</span> <span class='id opt'>opt</span><span class='lbracket'>[</span><span class='symbol'>:controls</span><span class='rbracket'>]</span> <span class='kw'>if</span> <span class='id opt'>opt</span><span class='lbracket'>[</span><span class='symbol'>:controls</span><span class='rbracket'>]</span>
+  <span class='id write'>write</span><span class='lparen'>(</span><span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>ASN1</span><span class='op'>::</span><span class='const'>Sequence</span><span class='lparen'>(</span><span class='id message'>message</span><span class='rparen'>)</span><span class='period'>.</span><span class='id to_der'>to_der</span><span class='rparen'>)</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <p class="signature " id="startssl-instance_method">
+    - (<tt>Object</tt>) <strong>startssl</strong>
+</p><div class="docstring">
+  <div class="discussion">
+    <p>
+:yields:
+</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+35
+36
+37
+38
+39
+40
+41
+42
+43
+44</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ldap/server/connection.rb', line 35</span>
+<span class='kw'>def</span> <span class='id startssl'>startssl</span> <span class='comment'># :yields:
+</span>  <span class='ivar'>@mutex</span><span class='period'>.</span><span class='id synchronize'>synchronize</span> <span class='kw'>do</span>
+    <span class='id raise'>raise</span> <span class='const'>LDAP</span><span class='op'>::</span><span class='const'>ResultError</span><span class='op'>::</span><span class='const'>OperationsError</span> <span class='kw'>if</span> <span class='ivar'>@ssl</span> <span class='kw'>or</span> <span class='ivar'>@active_reqs</span><span class='period'>.</span><span class='id size'>size</span> <span class='op'>&gt;</span> <span class='int'>0</span>
+    <span class='kw'>yield</span> <span class='kw'>if</span> <span class='id block_given?'>block_given?</span>
+    <span class='ivar'>@io</span> <span class='op'>=</span> <span class='const'>OpenSSL</span><span class='op'>::</span><span class='const'>SSL</span><span class='op'>::</span><span class='const'>SSLSocket</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='ivar'>@io</span><span class='comma'>,</span> <span class='ivar'>@opt</span><span class='lbracket'>[</span><span class='symbol'>:ssl_ctx</span><span class='rbracket'>]</span><span class='rparen'>)</span>
+    <span class='ivar'>@io</span><span class='period'>.</span><span class='id sync_close'>sync_close</span> <span class='op'>=</span> <span class='kw'>true</span>
+    <span class='ivar'>@io</span><span class='period'>.</span><span class='id accept'>accept</span>
+    <span class='ivar'>@ssl</span> <span class='op'>=</span> <span class='kw'>true</span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <p class="signature " id="write-instance_method">
+    - (<tt>Object</tt>) <strong>write</strong>(data)
+</p><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+213
+214
+215
+216
+217
+218</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ldap/server/connection.rb', line 213</span>
+<span class='kw'>def</span> <span class='id write'>write</span><span class='lparen'>(</span><span class='id data'>data</span><span class='rparen'>)</span>
+  <span class='ivar'>@mutex</span><span class='period'>.</span><span class='id synchronize'>synchronize</span> <span class='kw'>do</span>
+    <span class='ivar'>@io</span><span class='period'>.</span><span class='id write'>write</span><span class='lparen'>(</span><span class='id data'>data</span><span class='rparen'>)</span>
+    <span class='ivar'>@io</span><span class='period'>.</span><span class='id flush'>flush</span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <p class="signature " id="writelock-instance_method">
+    - (<tt>Object</tt>) <strong>writelock</strong>
+</p><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+220
+221
+222
+223
+224
+225</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ldap/server/connection.rb', line 220</span>
+<span class='kw'>def</span> <span class='id writelock'>writelock</span>
+  <span class='ivar'>@mutex</span><span class='period'>.</span><span class='id synchronize'>synchronize</span> <span class='kw'>do</span>
+    <span class='kw'>yield</span> <span class='ivar'>@io</span>
+    <span class='ivar'>@io</span><span class='period'>.</span><span class='id flush'>flush</span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+  </div>
+</div>
+    <div id="footer">
+  Generated on Mon Sep 13 13:27:18 2010 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.6.0 (ruby-1.9.2).
+</div>
+  </body>
+</html>