RubyGems - passenger - Versions diffs - 3.0.4 → 3.0.5 - Mend

passenger 3.0.4 → 3.0.5

Potentially problematic release.

This version of passenger might be problematic. Click here for more details.

Files changed (571) hide show

data/doc/cxxapi/classPassenger_1_1Process-members.html ADDED

@@ -0,0 +1,44 @@
+<!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">
+<head>
+<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
+<title>Passenger: Member List</title>
+<link href="tabs.css" rel="stylesheet" type="text/css"/>
+<link href="doxygen.css" rel="stylesheet" type="text/css"/>
+</head>
+<body>
+<!-- Generated by Doxygen 1.6.2 -->
+<div class="navigation" id="top">
+  <div class="tabs">
+    <ul>
+      <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
+      <li><a href="modules.html"><span>Modules</span></a></li>
+      <li><a href="namespaces.html"><span>Namespaces</span></a></li>
+      <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
+      <li><a href="files.html"><span>Files</span></a></li>
+    </ul>
+  </div>
+  <div class="tabs">
+    <ul>
+      <li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
+      <li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
+      <li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
+    </ul>
+  </div>
+</div>
+<div class="contents">
+<h1>Passenger::Process Member List</h1>This is the complete list of members for <a class="el" href="classPassenger_1_1Process.html">Passenger::Process</a>, including all inherited members.<table>
+  <tr class="memlist"><td><a class="el" href="classPassenger_1_1Process.html#ace9e949fa460ce09228cc08d76fc38e7">getAppRoot</a>() const </td><td><a class="el" href="classPassenger_1_1Process.html">Passenger::Process</a></td><td><code> [inline]</code></td></tr>
+  <tr class="memlist"><td><a class="el" href="classPassenger_1_1Process.html#a002791d7909d4d7a6566eb26ec491552">getConnectPassword</a>() const </td><td><a class="el" href="classPassenger_1_1Process.html">Passenger::Process</a></td><td><code> [inline]</code></td></tr>
+  <tr class="memlist"><td><a class="el" href="classPassenger_1_1Process.html#a308fa4c3bf80e4d3d48a3c833b9e3205">getDetachKey</a>() const </td><td><a class="el" href="classPassenger_1_1Process.html">Passenger::Process</a></td><td><code> [inline]</code></td></tr>
+  <tr class="memlist"><td><a class="el" href="classPassenger_1_1Process.html#a6997775fdfa7c0d9e681102bd044c40b">getGupid</a>() const </td><td><a class="el" href="classPassenger_1_1Process.html">Passenger::Process</a></td><td><code> [inline]</code></td></tr>
+  <tr class="memlist"><td><a class="el" href="classPassenger_1_1Process.html#afc1b82c05e963fee7e58445b152ca784">getPid</a>() const </td><td><a class="el" href="classPassenger_1_1Process.html">Passenger::Process</a></td><td><code> [inline]</code></td></tr>
+  <tr class="memlist"><td><a class="el" href="classPassenger_1_1Process.html#afe06f5be540203452a5e787da15ee5e4">getServerSockets</a>() const </td><td><a class="el" href="classPassenger_1_1Process.html">Passenger::Process</a></td><td><code> [inline]</code></td></tr>
+  <tr class="memlist"><td><a class="el" href="classPassenger_1_1Process.html#a4df3ce126ba64c864c1759d916f25635">newSession</a>(const StandardSession::CloseCallback &amp;closeCallback=StandardSession::CloseCallback(), bool initiateNow=true)</td><td><a class="el" href="classPassenger_1_1Process.html">Passenger::Process</a></td><td><code> [inline]</code></td></tr>
+  <tr class="memlist"><td><a class="el" href="classPassenger_1_1Process.html#a52c89242f2ff9298f302b4e2f75aea8f">Process</a>(const string &amp;appRoot, pid_t pid, int ownerPipe, const SocketInfoMap &amp;serverSockets, const string &amp;detachKey, const string &amp;connectPassword, const string &amp;gupid, const function&lt; void()&gt; &amp;destructionCallback=function&lt; void()&gt;())</td><td><a class="el" href="classPassenger_1_1Process.html">Passenger::Process</a></td><td><code> [inline]</code></td></tr>
+</table></div>
+<hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
+<a href="http://www.doxygen.org/index.html">
+<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
+</body>
+</html>

data/doc/cxxapi/classPassenger_1_1Process.html ADDED

@@ -0,0 +1,290 @@
+<!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">
+<head>
+<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
+<title>Passenger: Passenger::Process Class Reference</title>
+<link href="tabs.css" rel="stylesheet" type="text/css"/>
+<link href="doxygen.css" rel="stylesheet" type="text/css"/>
+</head>
+<body>
+<!-- Generated by Doxygen 1.6.2 -->
+<div class="navigation" id="top">
+  <div class="tabs">
+    <ul>
+      <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
+      <li><a href="modules.html"><span>Modules</span></a></li>
+      <li><a href="namespaces.html"><span>Namespaces</span></a></li>
+      <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
+      <li><a href="files.html"><span>Files</span></a></li>
+    </ul>
+  </div>
+  <div class="tabs">
+    <ul>
+      <li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
+      <li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
+      <li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
+    </ul>
+  </div>
+  <div class="navpath"><a class="el" href="namespacePassenger.html">Passenger</a>::<a class="el" href="classPassenger_1_1Process.html">Process</a>
+  </div>
+</div>
+<div class="contents">
+<h1>Passenger::Process Class Reference<br/>
+<small>
+[<a class="el" href="group__Support.html">Apache-independent support classes and function</a>]</small>
+</h1><!-- doxytag: class="Passenger::Process" -->
+<p>Represents a single application process, as spawned by <a class="el" href="classPassenger_1_1SpawnManager.html" title="An AbstractSpawnManager implementation.">SpawnManager</a> or by ApplicationPool::Interface::get().
+<a href="#_details">More...</a></p>
+<p><code>#include &lt;<a class="el" href="Process_8h_source.html">Process.h</a>&gt;</code></p>
+<p><a href="classPassenger_1_1Process-members.html">List of all members.</a></p>
+<table border="0" cellpadding="0" cellspacing="0">
+<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1Process.html#a52c89242f2ff9298f302b4e2f75aea8f">Process</a> (const string &amp;appRoot, pid_t pid, int ownerPipe, const SocketInfoMap &amp;serverSockets, const string &amp;detachKey, const string &amp;connectPassword, const string &amp;gupid, const function&lt; void()&gt; &amp;destructionCallback=function&lt; void()&gt;())</td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Construct a new <a class="el" href="classPassenger_1_1Process.html" title="Represents a single application process, as spawned by SpawnManager or by ApplicationPool::Interface...">Process</a> object.  <a href="#a52c89242f2ff9298f302b4e2f75aea8f"></a><br/></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">string&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1Process.html#ace9e949fa460ce09228cc08d76fc38e7">getAppRoot</a> () const </td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the application root for this application process.  <a href="#ace9e949fa460ce09228cc08d76fc38e7"></a><br/></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="afc1b82c05e963fee7e58445b152ca784"></a><!-- doxytag: member="Passenger::Process::getPid" ref="afc1b82c05e963fee7e58445b152ca784" args="() const " -->
+pid_t&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1Process.html#afc1b82c05e963fee7e58445b152ca784">getPid</a> () const </td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the process ID of this application process. <br/></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a308fa4c3bf80e4d3d48a3c833b9e3205"></a><!-- doxytag: member="Passenger::Process::getDetachKey" ref="a308fa4c3bf80e4d3d48a3c833b9e3205" args="() const " -->
+string&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1Process.html#a308fa4c3bf80e4d3d48a3c833b9e3205">getDetachKey</a> () const </td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns this process's detach key. <br/></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">string&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1Process.html#a002791d7909d4d7a6566eb26ec491552">getConnectPassword</a> () const </td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns this process's connect password.  <a href="#a002791d7909d4d7a6566eb26ec491552"></a><br/></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">string&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1Process.html#a6997775fdfa7c0d9e681102bd044c40b">getGupid</a> () const </td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns this process's gupid.  <a href="#a6997775fdfa7c0d9e681102bd044c40b"></a><br/></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="afe06f5be540203452a5e787da15ee5e4"></a><!-- doxytag: member="Passenger::Process::getServerSockets" ref="afe06f5be540203452a5e787da15ee5e4" args="() const " -->
+const SocketInfoMap *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1Process.html#afe06f5be540203452a5e787da15ee5e4">getServerSockets</a> () const </td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns a map containing all server sockets that this process listens on. <br/></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">SessionPtr&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1Process.html#a4df3ce126ba64c864c1759d916f25635">newSession</a> (const StandardSession::CloseCallback &amp;closeCallback=StandardSession::CloseCallback(), bool initiateNow=true)</td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Request a new session from this application process by connecting to its main server socket.  <a href="#a4df3ce126ba64c864c1759d916f25635"></a><br/></td></tr>
+</table>
+<hr/><a name="_details"></a><h2>Detailed Description</h2>
+<p>Represents a single application process, as spawned by <a class="el" href="classPassenger_1_1SpawnManager.html" title="An AbstractSpawnManager implementation.">SpawnManager</a> or by ApplicationPool::Interface::get(). </p>
+<hr/><h2>Constructor &amp; Destructor Documentation</h2>
+<a class="anchor" id="a52c89242f2ff9298f302b4e2f75aea8f"></a><!-- doxytag: member="Passenger::Process::Process" ref="a52c89242f2ff9298f302b4e2f75aea8f" args="(const string &amp;appRoot, pid_t pid, int ownerPipe, const SocketInfoMap &amp;serverSockets, const string &amp;detachKey, const string &amp;connectPassword, const string &amp;gupid, const function&lt; void()&gt; &amp;destructionCallback=function&lt; void()&gt;())" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">Passenger::Process::Process </td>
+          <td>(</td>
+          <td class="paramtype">const string &amp;&nbsp;</td>
+          <td class="paramname"> <em>appRoot</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">pid_t&nbsp;</td>
+          <td class="paramname"> <em>pid</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">int&nbsp;</td>
+          <td class="paramname"> <em>ownerPipe</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const SocketInfoMap &amp;&nbsp;</td>
+          <td class="paramname"> <em>serverSockets</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const string &amp;&nbsp;</td>
+          <td class="paramname"> <em>detachKey</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const string &amp;&nbsp;</td>
+          <td class="paramname"> <em>connectPassword</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const string &amp;&nbsp;</td>
+          <td class="paramname"> <em>gupid</em>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">const function&lt; void()&gt; &amp;&nbsp;</td>
+          <td class="paramname"> <em>destructionCallback</em> = <code>function&lt;void&nbsp;()&gt;()</code></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td><code> [inline]</code></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+<p>Construct a new <a class="el" href="classPassenger_1_1Process.html" title="Represents a single application process, as spawned by SpawnManager or by ApplicationPool::Interface...">Process</a> object. </p>
+<dl><dt><b>Parameters:</b></dt><dd>
+  <table border="0" cellspacing="2" cellpadding="0">
+    <tr><td valign="top"></td><td valign="top"><em>appRoot</em>&nbsp;</td><td>The application root of an application. This must be a valid directory, but the path does not have to be absolute. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>pid</em>&nbsp;</td><td>The process ID of this application process. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>ownerPipe</em>&nbsp;</td><td>The owner pipe of this application process. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>serverSockets</em>&nbsp;</td><td>All the server sockets that this process listens on. There must a server socket with the name 'main'. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>detachKey</em>&nbsp;</td><td>A detach key. Used by the ApplicationPool algorithm. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>connectPassword</em>&nbsp;</td><td>The password to use when connecting to this process. Must be valid ASCII. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>gupid</em>&nbsp;</td><td>A string which uniquely identifies this process. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>destructionCallback</em>&nbsp;</td><td>A callback to be called when this <a class="el" href="classPassenger_1_1Process.html" title="Represents a single application process, as spawned by SpawnManager or by ApplicationPool::Interface...">Process</a> is destroyed. </td></tr>
+  </table>
+  </dd>
+</dl>
+<dl><dt><b>Exceptions:</b></dt><dd>
+  <table border="0" cellspacing="2" cellpadding="0">
+    <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1ArgumentException.html" title="Indicates that a specified argument is incorrect or violates a requirement.">ArgumentException</a></em>&nbsp;</td><td>If serverSockets has no socket named 'main'. </td></tr>
+  </table>
+  </dd>
+</dl>
+</div>
+</div>
+<hr/><h2>Member Function Documentation</h2>
+<a class="anchor" id="ace9e949fa460ce09228cc08d76fc38e7"></a><!-- doxytag: member="Passenger::Process::getAppRoot" ref="ace9e949fa460ce09228cc08d76fc38e7" args="() const " -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">string Passenger::Process::getAppRoot </td>
+          <td>(</td>
+          <td class="paramname"></td>
+          <td>&nbsp;)&nbsp;</td>
+          <td> const<code> [inline]</code></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+<p>Returns the application root for this application process. </p>
+<p>See the constructor for information about the application root. </p>
+</div>
+</div>
+<a class="anchor" id="a002791d7909d4d7a6566eb26ec491552"></a><!-- doxytag: member="Passenger::Process::getConnectPassword" ref="a002791d7909d4d7a6566eb26ec491552" args="() const " -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">string Passenger::Process::getConnectPassword </td>
+          <td>(</td>
+          <td class="paramname"></td>
+          <td>&nbsp;)&nbsp;</td>
+          <td> const<code> [inline]</code></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+<p>Returns this process's connect password. </p>
+<p>This password is guaranteed to be valid ASCII. </p>
+</div>
+</div>
+<a class="anchor" id="a6997775fdfa7c0d9e681102bd044c40b"></a><!-- doxytag: member="Passenger::Process::getGupid" ref="a6997775fdfa7c0d9e681102bd044c40b" args="() const " -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">string Passenger::Process::getGupid </td>
+          <td>(</td>
+          <td class="paramname"></td>
+          <td>&nbsp;)&nbsp;</td>
+          <td> const<code> [inline]</code></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+<p>Returns this process's gupid. </p>
+<p>This is like a PID, but does not rotate and is even unique over multiple servers. </p>
+</div>
+</div>
+<a class="anchor" id="a4df3ce126ba64c864c1759d916f25635"></a><!-- doxytag: member="Passenger::Process::newSession" ref="a4df3ce126ba64c864c1759d916f25635" args="(const StandardSession::CloseCallback &amp;closeCallback=StandardSession::CloseCallback(), bool initiateNow=true)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">SessionPtr Passenger::Process::newSession </td>
+          <td>(</td>
+          <td class="paramtype">const StandardSession::CloseCallback &amp;&nbsp;</td>
+          <td class="paramname"> <em>closeCallback</em> = <code>StandardSession::CloseCallback()</code>, </td>
+        </tr>
+        <tr>
+          <td class="paramkey"></td>
+          <td></td>
+          <td class="paramtype">bool&nbsp;</td>
+          <td class="paramname"> <em>initiateNow</em> = <code>true</code></td><td>&nbsp;</td>
+        </tr>
+        <tr>
+          <td></td>
+          <td>)</td>
+          <td></td><td></td><td><code> [inline]</code></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+<p>Request a new session from this application process by connecting to its main server socket. </p>
+<p>This session represents the life time of a single request/response pair, and can be used to send the request data to the application process, as well as receiving the response data.</p>
+<p>The use of connect() is demonstrated in the following example. </p>
+<div class="fragment"><pre class="fragment">   <span class="comment">// Request a new session from the process.</span>
+   SessionPtr session = process-&gt;newSession(...);
+   <span class="comment">// Send the request headers and request body data.</span>
+   session-&gt;sendHeaders(...);
+   session-&gt;sendBodyBlock(...);
+   <span class="comment">// Done sending data, so we close the writer channel.</span>
+   session-&gt;shutdownWriter();
+   <span class="comment">// Now read the HTTP response.</span>
+   <span class="keywordtype">string</span> responseData = readAllDataFromSocket(session-&gt;getReader());
+   <span class="comment">// Done reading data, so we close the reader channel.</span>
+   session-&gt;shutdownReader();
+   <span class="comment">// This session has now finished, so we close the session by resetting</span>
+   <span class="comment">// the smart pointer to NULL (thereby destroying the Session object).</span>
+   session.reset();
+   <span class="comment">// We can connect to a Process multiple times. Just make sure</span>
+   <span class="comment">// the previous session is closed.</span>
+   session = process-&gt;newSession(...);
+</pre></div><p>You <b>must</b> close a session when you no longer need it. If you call connect() without having properly closed a previous session, you might cause a deadlock because the application process may be waiting for you to close the previous session.</p>
+<dl><dt><b>Parameters:</b></dt><dd>
+  <table border="0" cellspacing="2" cellpadding="0">
+    <tr><td valign="top"></td><td valign="top"><em>closeCallback</em>&nbsp;</td><td>A function which will be called when the session has been closed. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>initiateNow</em>&nbsp;</td><td>Whether the session should be initiated immediately. If set to false then you must call <code>initiate()</code> on the session before it's usable. </td></tr>
+  </table>
+  </dd>
+</dl>
+<dl class="return"><dt><b>Returns:</b></dt><dd>A smart pointer to a <a class="el" href="classPassenger_1_1Session.html" title="Represents a single request/response pair of an application process.">Session</a> object, which represents the created session. </dd></dl>
+<dl class="post"><dt><b>Postcondition:</b></dt><dd>result-&gt;initiated() == initiateNow </dd></dl>
+<dl><dt><b>Exceptions:</b></dt><dd>
+  <table border="0" cellspacing="2" cellpadding="0">
+    <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1SystemException.html" title="Represents an error returned by a system call or a standard library call.">SystemException</a></em>&nbsp;</td><td>Something went wrong during session initiation. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em><a class="el" href="classPassenger_1_1IOException.html" title="Represents an error that occured during an I/O operation.">IOException</a></em>&nbsp;</td><td>Something went wrong during session initiation. </td></tr>
+    <tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em>&nbsp;</td><td></td></tr>
+  </table>
+  </dd>
+</dl>
+</div>
+</div>
+<hr/>The documentation for this class was generated from the following file:<ul>
+<li><a class="el" href="Process_8h_source.html">Process.h</a></li>
+</ul>
+</div>
+<hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
+<a href="http://www.doxygen.org/index.html">
+<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
+</body>
+</html>

data/doc/cxxapi/classPassenger_1_1RandomGenerator-members.html ADDED

@@ -0,0 +1,37 @@
+<!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">
+<head>
+<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
+<title>Passenger: Member List</title>
+<link href="tabs.css" rel="stylesheet" type="text/css"/>
+<link href="doxygen.css" rel="stylesheet" type="text/css"/>
+</head>
+<body>
+<!-- Generated by Doxygen 1.6.2 -->
+<div class="navigation" id="top">
+  <div class="tabs">
+    <ul>
+      <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
+      <li><a href="modules.html"><span>Modules</span></a></li>
+      <li><a href="namespaces.html"><span>Namespaces</span></a></li>
+      <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
+      <li><a href="files.html"><span>Files</span></a></li>
+    </ul>
+  </div>
+  <div class="tabs">
+    <ul>
+      <li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
+      <li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
+      <li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
+    </ul>
+  </div>
+</div>
+<div class="contents">
+<h1>Passenger::RandomGenerator Member List</h1>This is the complete list of members for <a class="el" href="classPassenger_1_1RandomGenerator.html">Passenger::RandomGenerator</a>, including all inherited members.<table>
+  <tr class="memlist"><td><a class="el" href="classPassenger_1_1RandomGenerator.html#ad9d9a489f6dbfabafb35da326f5ed967">generateAsciiString</a>(unsigned int size)</td><td><a class="el" href="classPassenger_1_1RandomGenerator.html">Passenger::RandomGenerator</a></td><td><code> [inline]</code></td></tr>
+</table></div>
+<hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
+<a href="http://www.doxygen.org/index.html">
+<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
+</body>
+</html>

data/doc/cxxapi/classPassenger_1_1RandomGenerator.html ADDED

@@ -0,0 +1,79 @@
+<!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">
+<head>
+<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
+<title>Passenger: Passenger::RandomGenerator Class Reference</title>
+<link href="tabs.css" rel="stylesheet" type="text/css"/>
+<link href="doxygen.css" rel="stylesheet" type="text/css"/>
+</head>
+<body>
+<!-- Generated by Doxygen 1.6.2 -->
+<div class="navigation" id="top">
+  <div class="tabs">
+    <ul>
+      <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
+      <li><a href="modules.html"><span>Modules</span></a></li>
+      <li><a href="namespaces.html"><span>Namespaces</span></a></li>
+      <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
+      <li><a href="files.html"><span>Files</span></a></li>
+    </ul>
+  </div>
+  <div class="tabs">
+    <ul>
+      <li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
+      <li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
+      <li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
+    </ul>
+  </div>
+  <div class="navpath"><a class="el" href="namespacePassenger.html">Passenger</a>::<a class="el" href="classPassenger_1_1RandomGenerator.html">RandomGenerator</a>
+  </div>
+</div>
+<div class="contents">
+<h1>Passenger::RandomGenerator Class Reference</h1><!-- doxytag: class="Passenger::RandomGenerator" -->
+<p>A random data generator.
+<a href="#_details">More...</a></p>
+<p><code>#include &lt;<a class="el" href="RandomGenerator_8h_source.html">RandomGenerator.h</a>&gt;</code></p>
+<p><a href="classPassenger_1_1RandomGenerator-members.html">List of all members.</a></p>
+<table border="0" cellpadding="0" cellspacing="0">
+<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">string&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1RandomGenerator.html#ad9d9a489f6dbfabafb35da326f5ed967">generateAsciiString</a> (unsigned int size)</td></tr>
+<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Generates a random string of <em>size</em> bytes which is also valid ASCII.  <a href="#ad9d9a489f6dbfabafb35da326f5ed967"></a><br/></td></tr>
+</table>
+<hr/><a name="_details"></a><h2>Detailed Description</h2>
+<p>A random data generator. </p>
+<p>Data is generated using /dev/urandom, and is cryptographically secure. Unlike rand() and friends, <a class="el" href="classPassenger_1_1RandomGenerator.html" title="A random data generator.">RandomGenerator</a> does not require seeding.</p>
+<p>The reason why <a class="el" href="classPassenger_1_1RandomGenerator.html" title="A random data generator.">RandomGenerator</a> isn't a singleton is because opening /dev/urandom is *very* slow on Mac OS X and OpenBSD. Each object of this class caches the /dev/urandom file handle.</p>
+<p>This class is thread-safe as long as there are no concurrent calls to reopen() or close(). </p>
+<hr/><h2>Member Function Documentation</h2>
+<a class="anchor" id="ad9d9a489f6dbfabafb35da326f5ed967"></a><!-- doxytag: member="Passenger::RandomGenerator::generateAsciiString" ref="ad9d9a489f6dbfabafb35da326f5ed967" args="(unsigned int size)" -->
+<div class="memitem">
+<div class="memproto">
+      <table class="memname">
+        <tr>
+          <td class="memname">string Passenger::RandomGenerator::generateAsciiString </td>
+          <td>(</td>
+          <td class="paramtype">unsigned int&nbsp;</td>
+          <td class="paramname"> <em>size</em></td>
+          <td>&nbsp;)&nbsp;</td>
+          <td><code> [inline]</code></td>
+        </tr>
+      </table>
+</div>
+<div class="memdoc">
+<p>Generates a random string of <em>size</em> bytes which is also valid ASCII. </p>
+<p>The result consists only of the characters A-Z, a-z and 0-9, and therefore the total number of possibilities given a size of N is 62**N. However not every character has an equal chance of being chosen: a-i have 5/256 chance of being chosen, while other characters have 4/256 chance of being chosen. Therefore, to match the entropy of a random binary string of size N, one should choose a <em>size</em> which yields slightly more possibilities than 2**N. </p>
+</div>
+</div>
+<hr/>The documentation for this class was generated from the following file:<ul>
+<li><a class="el" href="RandomGenerator_8h_source.html">RandomGenerator.h</a></li>
+</ul>
+</div>
+<hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
+<a href="http://www.doxygen.org/index.html">
+<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
+</body>
+</html>