passenger 2.0.3 → 2.0.4
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of passenger might be problematic. Click here for more details.
- data/Rakefile +8 -5
- data/bin/passenger-install-apache2-module +6 -1
- data/doc/ApplicationPool algorithm.txt +23 -5
- data/doc/Architectural overview.html +778 -0
- data/doc/Security of user switching support.html +1 -1
- data/doc/Users guide.html +113 -31
- data/doc/Users guide.txt +104 -10
- data/doc/cxxapi/ApplicationPoolServer_8h-source.html +683 -0
- data/doc/cxxapi/ApplicationPool_8h-source.html +224 -0
- data/doc/cxxapi/Application_8h-source.html +448 -0
- data/doc/cxxapi/Bucket_8h-source.html +61 -0
- data/doc/cxxapi/Configuration_8h-source.html +195 -0
- data/doc/cxxapi/DummySpawnManager_8h-source.html +126 -0
- data/doc/cxxapi/Exceptions_8h-source.html +244 -0
- data/doc/cxxapi/Hooks_8h-source.html +63 -0
- data/doc/cxxapi/Logging_8h-source.html +136 -0
- data/doc/cxxapi/MessageChannel_8h-source.html +524 -0
- data/doc/cxxapi/SpawnManager_8h-source.html +593 -0
- data/doc/cxxapi/StandardApplicationPool_8h-source.html +732 -0
- data/doc/cxxapi/System_8h-source.html +251 -0
- data/doc/cxxapi/Utils_8h-source.html +283 -0
- data/doc/cxxapi/annotated.html +59 -0
- data/doc/cxxapi/classClient-members.html +35 -0
- data/doc/cxxapi/classClient.html +117 -0
- data/doc/cxxapi/classDirectoryMapper-members.html +38 -0
- data/doc/cxxapi/classDirectoryMapper.html +203 -0
- data/doc/cxxapi/classHooks-members.html +33 -0
- data/doc/cxxapi/classHooks.html +43 -0
- data/doc/cxxapi/classPassenger_1_1Application-members.html +38 -0
- data/doc/cxxapi/classPassenger_1_1Application.html +229 -0
- data/doc/cxxapi/classPassenger_1_1ApplicationPool-members.html +41 -0
- data/doc/cxxapi/classPassenger_1_1ApplicationPool.html +359 -0
- data/doc/cxxapi/classPassenger_1_1ApplicationPoolServer-members.html +36 -0
- data/doc/cxxapi/classPassenger_1_1ApplicationPoolServer.html +225 -0
- data/doc/cxxapi/classPassenger_1_1ApplicationPool__inherit__graph.map +1 -0
- data/doc/cxxapi/classPassenger_1_1ApplicationPool__inherit__graph.md5 +1 -0
- data/doc/cxxapi/classPassenger_1_1ApplicationPool__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1Application_1_1Session-members.html +43 -0
- data/doc/cxxapi/classPassenger_1_1Application_1_1Session.html +329 -0
- data/doc/cxxapi/classPassenger_1_1BusyException-members.html +33 -0
- data/doc/cxxapi/classPassenger_1_1BusyException.html +47 -0
- data/doc/cxxapi/classPassenger_1_1ConfigurationException-members.html +33 -0
- data/doc/cxxapi/classPassenger_1_1ConfigurationException.html +44 -0
- data/doc/cxxapi/classPassenger_1_1DummySpawnManager-members.html +33 -0
- data/doc/cxxapi/classPassenger_1_1DummySpawnManager.html +51 -0
- data/doc/cxxapi/classPassenger_1_1FileNotFoundException-members.html +33 -0
- data/doc/cxxapi/classPassenger_1_1FileNotFoundException.html +51 -0
- data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.map +1 -0
- data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.md5 +1 -0
- data/doc/cxxapi/classPassenger_1_1FileNotFoundException__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1FileSystemException-members.html +38 -0
- data/doc/cxxapi/classPassenger_1_1FileSystemException.html +61 -0
- data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.map +1 -0
- data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.md5 +1 -0
- data/doc/cxxapi/classPassenger_1_1FileSystemException__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1IOException-members.html +33 -0
- data/doc/cxxapi/classPassenger_1_1IOException.html +54 -0
- data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.map +1 -0
- data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.md5 +1 -0
- data/doc/cxxapi/classPassenger_1_1IOException__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1MessageChannel-members.html +47 -0
- data/doc/cxxapi/classPassenger_1_1MessageChannel.html +591 -0
- data/doc/cxxapi/classPassenger_1_1SpawnException-members.html +35 -0
- data/doc/cxxapi/classPassenger_1_1SpawnException.html +77 -0
- data/doc/cxxapi/classPassenger_1_1SpawnManager-members.html +37 -0
- data/doc/cxxapi/classPassenger_1_1SpawnManager.html +255 -0
- data/doc/cxxapi/classPassenger_1_1StandardApplicationPool-members.html +43 -0
- data/doc/cxxapi/classPassenger_1_1StandardApplicationPool.html +400 -0
- data/doc/cxxapi/classPassenger_1_1StandardApplicationPool__inherit__graph.map +1 -0
- data/doc/cxxapi/classPassenger_1_1StandardApplicationPool__inherit__graph.md5 +1 -0
- data/doc/cxxapi/classPassenger_1_1StandardApplicationPool__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1SystemException-members.html +37 -0
- data/doc/cxxapi/classPassenger_1_1SystemException.html +154 -0
- data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.map +1 -0
- data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.md5 +1 -0
- data/doc/cxxapi/classPassenger_1_1SystemException__inherit__graph.png +0 -0
- data/doc/cxxapi/classPassenger_1_1TempFile-members.html +36 -0
- data/doc/cxxapi/classPassenger_1_1TempFile.html +128 -0
- data/doc/cxxapi/classPassenger_1_1Thread-members.html +35 -0
- data/doc/cxxapi/classPassenger_1_1Thread.html +100 -0
- data/doc/cxxapi/classboost_1_1this__thread_1_1disable__syscall__interruption-members.html +33 -0
- data/doc/cxxapi/classboost_1_1this__thread_1_1disable__syscall__interruption.html +46 -0
- data/doc/cxxapi/classboost_1_1this__thread_1_1enable__syscall__interruption-members.html +33 -0
- data/doc/cxxapi/classboost_1_1this__thread_1_1enable__syscall__interruption.html +44 -0
- data/doc/cxxapi/classboost_1_1this__thread_1_1restore__syscall__interruption-members.html +33 -0
- data/doc/cxxapi/classboost_1_1this__thread_1_1restore__syscall__interruption.html +44 -0
- data/doc/cxxapi/definitions_8h-source.html +28 -0
- data/doc/cxxapi/doxygen.css +433 -0
- data/doc/cxxapi/doxygen.png +0 -0
- data/doc/cxxapi/files.html +42 -0
- data/doc/cxxapi/ftv2blank.png +0 -0
- data/doc/cxxapi/ftv2doc.png +0 -0
- data/doc/cxxapi/ftv2folderclosed.png +0 -0
- data/doc/cxxapi/ftv2folderopen.png +0 -0
- data/doc/cxxapi/ftv2lastnode.png +0 -0
- data/doc/cxxapi/ftv2link.png +0 -0
- data/doc/cxxapi/ftv2mlastnode.png +0 -0
- data/doc/cxxapi/ftv2mnode.png +0 -0
- data/doc/cxxapi/ftv2node.png +0 -0
- data/doc/cxxapi/ftv2plastnode.png +0 -0
- data/doc/cxxapi/ftv2pnode.png +0 -0
- data/doc/cxxapi/ftv2vertline.png +0 -0
- data/doc/cxxapi/functions.html +215 -0
- data/doc/cxxapi/functions_func.html +210 -0
- data/doc/cxxapi/functions_type.html +46 -0
- data/doc/cxxapi/functions_vars.html +48 -0
- data/doc/cxxapi/graph_legend.dot +22 -0
- data/doc/cxxapi/graph_legend.html +87 -0
- data/doc/cxxapi/graph_legend.png +0 -0
- data/doc/cxxapi/group__Configuration.html +236 -0
- data/doc/cxxapi/group__Configuration.png +0 -0
- data/doc/cxxapi/group__Core.html +51 -0
- data/doc/cxxapi/group__Core.png +0 -0
- data/doc/cxxapi/group__Exceptions.html +43 -0
- data/doc/cxxapi/group__Hooks.html +46 -0
- data/doc/cxxapi/group__Hooks.png +0 -0
- data/doc/cxxapi/group__Support.html +406 -0
- data/doc/cxxapi/hierarchy.html +67 -0
- data/doc/cxxapi/index.html +11 -0
- data/doc/cxxapi/inherit__graph__0.map +1 -0
- data/doc/cxxapi/inherit__graph__0.md5 +1 -0
- data/doc/cxxapi/inherit__graph__0.png +0 -0
- data/doc/cxxapi/inherit__graph__1.map +1 -0
- data/doc/cxxapi/inherit__graph__1.md5 +1 -0
- data/doc/cxxapi/inherit__graph__1.png +0 -0
- data/doc/cxxapi/inherit__graph__10.map +1 -0
- data/doc/cxxapi/inherit__graph__10.md5 +1 -0
- data/doc/cxxapi/inherit__graph__10.png +0 -0
- data/doc/cxxapi/inherit__graph__11.map +1 -0
- data/doc/cxxapi/inherit__graph__11.md5 +1 -0
- data/doc/cxxapi/inherit__graph__11.png +0 -0
- data/doc/cxxapi/inherit__graph__12.map +1 -0
- data/doc/cxxapi/inherit__graph__12.md5 +1 -0
- data/doc/cxxapi/inherit__graph__12.png +0 -0
- data/doc/cxxapi/inherit__graph__13.map +1 -0
- data/doc/cxxapi/inherit__graph__13.md5 +1 -0
- data/doc/cxxapi/inherit__graph__13.png +0 -0
- data/doc/cxxapi/inherit__graph__14.map +2 -0
- data/doc/cxxapi/inherit__graph__14.md5 +1 -0
- data/doc/cxxapi/inherit__graph__14.png +0 -0
- data/doc/cxxapi/inherit__graph__15.map +1 -0
- data/doc/cxxapi/inherit__graph__15.md5 +1 -0
- data/doc/cxxapi/inherit__graph__15.png +0 -0
- data/doc/cxxapi/inherit__graph__16.map +1 -0
- data/doc/cxxapi/inherit__graph__16.md5 +1 -0
- data/doc/cxxapi/inherit__graph__16.png +0 -0
- data/doc/cxxapi/inherit__graph__17.map +1 -0
- data/doc/cxxapi/inherit__graph__17.md5 +1 -0
- data/doc/cxxapi/inherit__graph__17.png +0 -0
- data/doc/cxxapi/inherit__graph__18.map +1 -0
- data/doc/cxxapi/inherit__graph__18.md5 +1 -0
- data/doc/cxxapi/inherit__graph__18.png +0 -0
- data/doc/cxxapi/inherit__graph__19.map +2 -0
- data/doc/cxxapi/inherit__graph__19.md5 +1 -0
- data/doc/cxxapi/inherit__graph__19.png +0 -0
- data/doc/cxxapi/inherit__graph__2.map +1 -0
- data/doc/cxxapi/inherit__graph__2.md5 +1 -0
- data/doc/cxxapi/inherit__graph__2.png +0 -0
- data/doc/cxxapi/inherit__graph__20.map +1 -0
- data/doc/cxxapi/inherit__graph__20.md5 +1 -0
- data/doc/cxxapi/inherit__graph__20.png +0 -0
- data/doc/cxxapi/inherit__graph__21.map +1 -0
- data/doc/cxxapi/inherit__graph__21.md5 +1 -0
- data/doc/cxxapi/inherit__graph__21.png +0 -0
- data/doc/cxxapi/inherit__graph__3.map +1 -0
- data/doc/cxxapi/inherit__graph__3.md5 +1 -0
- data/doc/cxxapi/inherit__graph__3.png +0 -0
- data/doc/cxxapi/inherit__graph__4.map +1 -0
- data/doc/cxxapi/inherit__graph__4.md5 +1 -0
- data/doc/cxxapi/inherit__graph__4.png +0 -0
- data/doc/cxxapi/inherit__graph__5.map +1 -0
- data/doc/cxxapi/inherit__graph__5.md5 +1 -0
- data/doc/cxxapi/inherit__graph__5.png +0 -0
- data/doc/cxxapi/inherit__graph__6.map +1 -0
- data/doc/cxxapi/inherit__graph__6.md5 +1 -0
- data/doc/cxxapi/inherit__graph__6.png +0 -0
- data/doc/cxxapi/inherit__graph__7.map +1 -0
- data/doc/cxxapi/inherit__graph__7.md5 +1 -0
- data/doc/cxxapi/inherit__graph__7.png +0 -0
- data/doc/cxxapi/inherit__graph__8.map +1 -0
- data/doc/cxxapi/inherit__graph__8.md5 +1 -0
- data/doc/cxxapi/inherit__graph__8.png +0 -0
- data/doc/cxxapi/inherit__graph__9.map +2 -0
- data/doc/cxxapi/inherit__graph__9.md5 +1 -0
- data/doc/cxxapi/inherit__graph__9.png +0 -0
- data/doc/cxxapi/inherits.html +102 -0
- data/doc/cxxapi/main.html +27 -0
- data/doc/cxxapi/modules.html +34 -0
- data/doc/cxxapi/namespacePassenger.html +208 -0
- data/doc/cxxapi/namespacePassenger_1_1InterruptableCalls.html +43 -0
- data/doc/cxxapi/namespacemembers.html +70 -0
- data/doc/cxxapi/namespacemembers_func.html +66 -0
- data/doc/cxxapi/namespacemembers_type.html +46 -0
- data/doc/cxxapi/namespaces.html +35 -0
- data/doc/cxxapi/structPassenger_1_1AnythingToString-members.html +33 -0
- data/doc/cxxapi/structPassenger_1_1AnythingToString.html +49 -0
- data/doc/cxxapi/structPassenger_1_1AnythingToString_3_01vector_3_01string_01_4_01_4-members.html +33 -0
- data/doc/cxxapi/structPassenger_1_1AnythingToString_3_01vector_3_01string_01_4_01_4.html +49 -0
- data/doc/cxxapi/tab_b.gif +0 -0
- data/doc/cxxapi/tab_l.gif +0 -0
- data/doc/cxxapi/tab_r.gif +0 -0
- data/doc/cxxapi/tabs.css +102 -0
- data/doc/cxxapi/tree.html +167 -0
- data/doc/rdoc/classes/ConditionVariable.html +160 -0
- data/doc/rdoc/classes/Exception.html +120 -0
- data/doc/rdoc/classes/GC.html +113 -0
- data/doc/rdoc/classes/IO.html +150 -0
- data/doc/rdoc/classes/Passenger.html +136 -0
- data/doc/rdoc/classes/Passenger/AbstractRequestHandler.html +402 -0
- data/doc/rdoc/classes/Passenger/AbstractServer.html +649 -0
- data/doc/rdoc/classes/Passenger/AbstractServer/ServerAlreadyStarted.html +97 -0
- data/doc/rdoc/classes/Passenger/AbstractServer/ServerError.html +96 -0
- data/doc/rdoc/classes/Passenger/AbstractServer/ServerNotStarted.html +97 -0
- data/doc/rdoc/classes/Passenger/AbstractServer/UnknownMessage.html +96 -0
- data/doc/rdoc/classes/Passenger/AppInitError.html +137 -0
- data/doc/rdoc/classes/Passenger/Application.html +298 -0
- data/doc/rdoc/classes/Passenger/ConsoleTextTemplate.html +172 -0
- data/doc/rdoc/classes/Passenger/FrameworkInitError.html +143 -0
- data/doc/rdoc/classes/Passenger/HTMLTemplate.html +175 -0
- data/doc/rdoc/classes/Passenger/InitializationError.html +141 -0
- data/doc/rdoc/classes/Passenger/MessageChannel.html +488 -0
- data/doc/rdoc/classes/Passenger/NativeSupport.html +320 -0
- data/doc/rdoc/classes/Passenger/SpawnManager.html +375 -0
- data/doc/rdoc/classes/Passenger/UnknownError.html +125 -0
- data/doc/rdoc/classes/Passenger/Utils.html +578 -0
- data/doc/rdoc/classes/Passenger/VersionNotFound.html +140 -0
- data/doc/rdoc/classes/PlatformInfo.html +302 -0
- data/doc/rdoc/classes/RakeExtensions.html +197 -0
- data/doc/rdoc/created.rid +1 -0
- data/doc/rdoc/files/DEVELOPERS_TXT.html +230 -0
- data/doc/rdoc/files/README.html +150 -0
- data/doc/rdoc/files/ext/passenger/native_support_c.html +92 -0
- data/doc/rdoc/files/lib/passenger/abstract_request_handler_rb.html +126 -0
- data/doc/rdoc/files/lib/passenger/abstract_server_rb.html +127 -0
- data/doc/rdoc/files/lib/passenger/application_rb.html +123 -0
- data/doc/rdoc/files/lib/passenger/console_text_template_rb.html +122 -0
- data/doc/rdoc/files/lib/passenger/constants_rb.html +114 -0
- data/doc/rdoc/files/lib/passenger/dependencies_rb.html +130 -0
- data/doc/rdoc/files/lib/passenger/exceptions_rb.html +118 -0
- data/doc/rdoc/files/lib/passenger/html_template_rb.html +122 -0
- data/doc/rdoc/files/lib/passenger/message_channel_rb.html +118 -0
- data/doc/rdoc/files/lib/passenger/platform_info_rb.html +122 -0
- data/doc/rdoc/files/lib/passenger/simple_benchmarking_rb.html +118 -0
- data/doc/rdoc/files/lib/passenger/spawn_manager_rb.html +139 -0
- data/doc/rdoc/files/lib/passenger/utils_rb.html +130 -0
- data/doc/rdoc/files/lib/rake/extensions_rb.html +122 -0
- data/doc/rdoc/fr_class_index.html +71 -0
- data/doc/rdoc/fr_file_index.html +63 -0
- data/doc/rdoc/fr_method_index.html +120 -0
- data/doc/rdoc/index.html +26 -0
- data/doc/rdoc/rdoc-style.css +187 -0
- data/ext/apache2/ApplicationPool.h +12 -0
- data/ext/apache2/ApplicationPoolServer.h +6 -0
- data/ext/apache2/ApplicationPoolServerExecutable.cpp +6 -0
- data/ext/apache2/Bucket.cpp +63 -69
- data/ext/apache2/Bucket.h +2 -0
- data/ext/apache2/Configuration.cpp +24 -0
- data/ext/apache2/Configuration.h +16 -1
- data/ext/apache2/Hooks.cpp +5 -3
- data/ext/apache2/StandardApplicationPool.h +30 -11
- data/lib/passenger/abstract_request_handler.rb +3 -0
- data/lib/passenger/abstract_server.rb +3 -3
- data/lib/passenger/application.rb +4 -2
- data/lib/passenger/dependencies.rb +10 -1
- data/lib/passenger/platform_info.rb +40 -1
- data/lib/passenger/rack/request_handler.rb +4 -2
- data/lib/passenger/railz/application_spawner.rb +7 -1
- data/lib/passenger/utils.rb +6 -8
- data/lib/rake/gempackagetask.rb +0 -6
- data/lib/rake/rdoctask.rb +84 -23
- data/test/ApplicationPoolTest.cpp +36 -0
- data/test/ruby/rails/minimal_spawner_spec.rb +8 -0
- data/test/ruby/utils_spec.rb +33 -0
- data/test/stub/rails_apps/foobar/config/environments/production.rb +0 -1
- metadata +262 -5
|
@@ -0,0 +1 @@
|
|
|
1
|
+
ba8e6dc8de249ca208329f4593a2d62b
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
2
|
+
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
|
|
3
|
+
<title>Passenger: Member List</title>
|
|
4
|
+
<link href="doxygen.css" rel="stylesheet" type="text/css">
|
|
5
|
+
<link href="tabs.css" rel="stylesheet" type="text/css">
|
|
6
|
+
</head><body>
|
|
7
|
+
<!-- Generated by Doxygen 1.5.5 -->
|
|
8
|
+
<div class="navigation" id="top">
|
|
9
|
+
<div class="tabs">
|
|
10
|
+
<ul>
|
|
11
|
+
<li><a href="main.html"><span>Main Page</span></a></li>
|
|
12
|
+
<li><a href="modules.html"><span>Modules</span></a></li>
|
|
13
|
+
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
|
|
14
|
+
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
|
|
15
|
+
<li><a href="files.html"><span>Files</span></a></li>
|
|
16
|
+
</ul>
|
|
17
|
+
</div>
|
|
18
|
+
<div class="tabs">
|
|
19
|
+
<ul>
|
|
20
|
+
<li><a href="annotated.html"><span>Class List</span></a></li>
|
|
21
|
+
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
|
|
22
|
+
<li><a href="functions.html"><span>Class Members</span></a></li>
|
|
23
|
+
</ul>
|
|
24
|
+
</div>
|
|
25
|
+
</div>
|
|
26
|
+
<div class="contents">
|
|
27
|
+
<h1>Passenger::IOException Member List</h1>This is the complete list of members for <a class="el" href="classPassenger_1_1IOException.html">Passenger::IOException</a>, including all inherited members.<p><table>
|
|
28
|
+
</table></div>
|
|
29
|
+
<hr size="1"><address style="text-align: right;"><small>Generated on Mon Dec 1 14:27:23 2008 for Passenger by
|
|
30
|
+
<a href="http://www.doxygen.org/index.html">
|
|
31
|
+
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.5 </small></address>
|
|
32
|
+
</body>
|
|
33
|
+
</html>
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
2
|
+
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
|
|
3
|
+
<title>Passenger: Passenger::IOException Class Reference</title>
|
|
4
|
+
<link href="doxygen.css" rel="stylesheet" type="text/css">
|
|
5
|
+
<link href="tabs.css" rel="stylesheet" type="text/css">
|
|
6
|
+
</head><body>
|
|
7
|
+
<!-- Generated by Doxygen 1.5.5 -->
|
|
8
|
+
<div class="navigation" id="top">
|
|
9
|
+
<div class="tabs">
|
|
10
|
+
<ul>
|
|
11
|
+
<li><a href="main.html"><span>Main Page</span></a></li>
|
|
12
|
+
<li><a href="modules.html"><span>Modules</span></a></li>
|
|
13
|
+
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
|
|
14
|
+
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
|
|
15
|
+
<li><a href="files.html"><span>Files</span></a></li>
|
|
16
|
+
</ul>
|
|
17
|
+
</div>
|
|
18
|
+
<div class="tabs">
|
|
19
|
+
<ul>
|
|
20
|
+
<li><a href="annotated.html"><span>Class List</span></a></li>
|
|
21
|
+
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
|
|
22
|
+
<li><a href="functions.html"><span>Class Members</span></a></li>
|
|
23
|
+
</ul>
|
|
24
|
+
</div>
|
|
25
|
+
<div class="navpath"><a class="el" href="namespacePassenger.html">Passenger</a>::<a class="el" href="classPassenger_1_1IOException.html">IOException</a>
|
|
26
|
+
</div>
|
|
27
|
+
</div>
|
|
28
|
+
<div class="contents">
|
|
29
|
+
<h1>Passenger::IOException Class Reference<br>
|
|
30
|
+
<small>
|
|
31
|
+
[<a class="el" href="group__Exceptions.html">Exceptions</a>]</small>
|
|
32
|
+
</h1><!-- doxytag: class="Passenger::IOException" --><code>#include <<a class="el" href="Exceptions_8h-source.html">Exceptions.h</a>></code>
|
|
33
|
+
<p>
|
|
34
|
+
<div class="dynheader">
|
|
35
|
+
Inheritance diagram for Passenger::IOException:</div>
|
|
36
|
+
<div class="dynsection">
|
|
37
|
+
<p><center><img src="classPassenger_1_1IOException__inherit__graph.png" border="0" usemap="#Passenger_1_1IOException__inherit__map" alt="Inheritance graph"></center>
|
|
38
|
+
<map name="Passenger_1_1IOException__inherit__map">
|
|
39
|
+
<area shape="rect" href="classPassenger_1_1FileNotFoundException.html" title="Thrown when a certain file cannot be found." alt="" coords="5,81,232,105"></map>
|
|
40
|
+
<center><font size="2">[<a target="top" href="graph_legend.html">legend</a>]</font></center></div>
|
|
41
|
+
|
|
42
|
+
<p>
|
|
43
|
+
<a href="classPassenger_1_1IOException-members.html">List of all members.</a><hr><a name="_details"></a><h2>Detailed Description</h2>
|
|
44
|
+
Represents an error that occured during an I/O operation. <table border="0" cellpadding="0" cellspacing="0">
|
|
45
|
+
<tr><td></td></tr>
|
|
46
|
+
</table>
|
|
47
|
+
<hr>The documentation for this class was generated from the following file:<ul>
|
|
48
|
+
<li><a class="el" href="Exceptions_8h-source.html">Exceptions.h</a></ul>
|
|
49
|
+
</div>
|
|
50
|
+
<hr size="1"><address style="text-align: right;"><small>Generated on Mon Dec 1 14:27:23 2008 for Passenger by
|
|
51
|
+
<a href="http://www.doxygen.org/index.html">
|
|
52
|
+
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.5 </small></address>
|
|
53
|
+
</body>
|
|
54
|
+
</html>
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
<area shape="rect" href="$classPassenger_1_1FileNotFoundException.html" title="Thrown when a certain file cannot be found." alt="" coords="5,81,232,105">
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
b1a5dedd9c73d2a67a19daed5e845bf0
|
|
Binary file
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
2
|
+
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
|
|
3
|
+
<title>Passenger: Member List</title>
|
|
4
|
+
<link href="doxygen.css" rel="stylesheet" type="text/css">
|
|
5
|
+
<link href="tabs.css" rel="stylesheet" type="text/css">
|
|
6
|
+
</head><body>
|
|
7
|
+
<!-- Generated by Doxygen 1.5.5 -->
|
|
8
|
+
<div class="navigation" id="top">
|
|
9
|
+
<div class="tabs">
|
|
10
|
+
<ul>
|
|
11
|
+
<li><a href="main.html"><span>Main Page</span></a></li>
|
|
12
|
+
<li><a href="modules.html"><span>Modules</span></a></li>
|
|
13
|
+
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
|
|
14
|
+
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
|
|
15
|
+
<li><a href="files.html"><span>Files</span></a></li>
|
|
16
|
+
</ul>
|
|
17
|
+
</div>
|
|
18
|
+
<div class="tabs">
|
|
19
|
+
<ul>
|
|
20
|
+
<li><a href="annotated.html"><span>Class List</span></a></li>
|
|
21
|
+
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
|
|
22
|
+
<li><a href="functions.html"><span>Class Members</span></a></li>
|
|
23
|
+
</ul>
|
|
24
|
+
</div>
|
|
25
|
+
</div>
|
|
26
|
+
<div class="contents">
|
|
27
|
+
<h1>Passenger::MessageChannel Member List</h1>This is the complete list of members for <a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a>, including all inherited members.<p><table>
|
|
28
|
+
<tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#06309e208fc5e10642a2e9bbe0f351eb">close</a>()</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
|
|
29
|
+
<tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#73e7c9a8e421d29558838176aff02ca4">MessageChannel</a>()</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
|
|
30
|
+
<tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#486b6e74c4d0973eefbcfde65f898ca7">MessageChannel</a>(int fd)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
|
|
31
|
+
<tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#129659b60d1a663337873d2af944431e">read</a>(vector< string > &args)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
|
|
32
|
+
<tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#1561b7e4a0f4d39ea431f456e5655488">readFileDescriptor</a>()</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
|
|
33
|
+
<tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#cd1d1bd1cc787784c8b54f5471fff479">readRaw</a>(void *buf, unsigned int size)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
|
|
34
|
+
<tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#4ce6a0e751b5e3563bee583c231569bc">readScalar</a>(string &output)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
|
|
35
|
+
<tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#9ad7a978cf8409e01ab2f0a2b6be5a0a">write</a>(const list< string > &args)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
|
|
36
|
+
<tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#12cce3364023eacbe4fe09006cf3d38d">write</a>(const char *name,...)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
|
|
37
|
+
<tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#73e3f3cda384c085a2af0e820ccd3e98">writeFileDescriptor</a>(int fileDescriptor)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
|
|
38
|
+
<tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#069314e4c7e1fe8c8ab36e16d2cc5fef">writeRaw</a>(const char *data, unsigned int size)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
|
|
39
|
+
<tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#cfa38f4f0e22ec16350b8cc159e8e364">writeRaw</a>(const string &data)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
|
|
40
|
+
<tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#44e01a783c48abadeea0d915b9893bfb">writeScalar</a>(const string &str)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
|
|
41
|
+
<tr class="memlist"><td><a class="el" href="classPassenger_1_1MessageChannel.html#80977020ef895f3ea790c5d28a333dda">writeScalar</a>(const char *data, unsigned int size)</td><td><a class="el" href="classPassenger_1_1MessageChannel.html">Passenger::MessageChannel</a></td><td><code> [inline]</code></td></tr>
|
|
42
|
+
</table></div>
|
|
43
|
+
<hr size="1"><address style="text-align: right;"><small>Generated on Mon Dec 1 14:27:23 2008 for Passenger by
|
|
44
|
+
<a href="http://www.doxygen.org/index.html">
|
|
45
|
+
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.5 </small></address>
|
|
46
|
+
</body>
|
|
47
|
+
</html>
|
|
@@ -0,0 +1,591 @@
|
|
|
1
|
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
2
|
+
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
|
|
3
|
+
<title>Passenger: Passenger::MessageChannel Class Reference</title>
|
|
4
|
+
<link href="doxygen.css" rel="stylesheet" type="text/css">
|
|
5
|
+
<link href="tabs.css" rel="stylesheet" type="text/css">
|
|
6
|
+
</head><body>
|
|
7
|
+
<!-- Generated by Doxygen 1.5.5 -->
|
|
8
|
+
<div class="navigation" id="top">
|
|
9
|
+
<div class="tabs">
|
|
10
|
+
<ul>
|
|
11
|
+
<li><a href="main.html"><span>Main Page</span></a></li>
|
|
12
|
+
<li><a href="modules.html"><span>Modules</span></a></li>
|
|
13
|
+
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
|
|
14
|
+
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
|
|
15
|
+
<li><a href="files.html"><span>Files</span></a></li>
|
|
16
|
+
</ul>
|
|
17
|
+
</div>
|
|
18
|
+
<div class="tabs">
|
|
19
|
+
<ul>
|
|
20
|
+
<li><a href="annotated.html"><span>Class List</span></a></li>
|
|
21
|
+
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
|
|
22
|
+
<li><a href="functions.html"><span>Class Members</span></a></li>
|
|
23
|
+
</ul>
|
|
24
|
+
</div>
|
|
25
|
+
<div class="navpath"><a class="el" href="namespacePassenger.html">Passenger</a>::<a class="el" href="classPassenger_1_1MessageChannel.html">MessageChannel</a>
|
|
26
|
+
</div>
|
|
27
|
+
</div>
|
|
28
|
+
<div class="contents">
|
|
29
|
+
<h1>Passenger::MessageChannel Class Reference<br>
|
|
30
|
+
<small>
|
|
31
|
+
[<a class="el" href="group__Support.html">Apache-independent support classes and function</a>]</small>
|
|
32
|
+
</h1><!-- doxytag: class="Passenger::MessageChannel" --><code>#include <<a class="el" href="MessageChannel_8h-source.html">MessageChannel.h</a>></code>
|
|
33
|
+
<p>
|
|
34
|
+
|
|
35
|
+
<p>
|
|
36
|
+
<a href="classPassenger_1_1MessageChannel-members.html">List of all members.</a><hr><a name="_details"></a><h2>Detailed Description</h2>
|
|
37
|
+
Convenience class for I/O operations on file descriptors.
|
|
38
|
+
<p>
|
|
39
|
+
This class provides convenience methods for:<ul>
|
|
40
|
+
<li>sending and receiving raw data over a file descriptor.</li><li>sending and receiving messages over a file descriptor.</li><li>file descriptor passing over a Unix socket. All of these methods use exceptions for error reporting.</li></ul>
|
|
41
|
+
<p>
|
|
42
|
+
There are two kinds of messages:<ul>
|
|
43
|
+
<li>Array messages. These are just a list of strings, and the message itself has a specific length. The contained strings may not contain NUL characters (<code>'\0'</code>). Note that an array message must have at least one element.</li><li>Scalar messages. These are byte strings which may contain arbitrary binary data. Scalar messages also have a specific length. The protocol is designed to be low overhead, easy to implement and easy to parse.</li></ul>
|
|
44
|
+
<p>
|
|
45
|
+
<a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> is to be wrapped around a file descriptor. For example: <div class="fragment"><pre class="fragment"> <span class="keywordtype">int</span> p[2];
|
|
46
|
+
pipe(p);
|
|
47
|
+
<a class="code" href="classPassenger_1_1MessageChannel.html#73e7c9a8e421d29558838176aff02ca4" title="Construct a new MessageChannel with no underlying file descriptor.">MessageChannel</a> channel1(p[0]);
|
|
48
|
+
<a class="code" href="classPassenger_1_1MessageChannel.html#73e7c9a8e421d29558838176aff02ca4" title="Construct a new MessageChannel with no underlying file descriptor.">MessageChannel</a> channel2(p[1]);
|
|
49
|
+
|
|
50
|
+
<span class="comment">// Send an array message.</span>
|
|
51
|
+
channel2.write(<span class="stringliteral">"hello"</span>, <span class="stringliteral">"world !!"</span>, NULL);
|
|
52
|
+
list<string> args;
|
|
53
|
+
channel1.read(args); <span class="comment">// args now contains { "hello", "world !!" }</span>
|
|
54
|
+
|
|
55
|
+
<span class="comment">// Send a scalar message.</span>
|
|
56
|
+
channel2.writeScalar(<span class="stringliteral">"some long string which can contain arbitrary binary data"</span>);
|
|
57
|
+
<span class="keywordtype">string</span> str;
|
|
58
|
+
channel1.readScalar(str);
|
|
59
|
+
</pre></div><p>
|
|
60
|
+
The life time of a <a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> is independent from that of the wrapped file descriptor. If a <a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> object is destroyed, the file descriptor is not automatically closed. Call <a class="el" href="classPassenger_1_1MessageChannel.html#06309e208fc5e10642a2e9bbe0f351eb" title="Close the underlying file descriptor.">close()</a> if you want to close the file descriptor.<p>
|
|
61
|
+
<dl class="note" compact><dt><b>Note:</b></dt><dd>I/O operations are not buffered. <p>
|
|
62
|
+
Be careful with mixing the sending/receiving of array messages, scalar messages and file descriptors. If you send a collection of any of these in a specific order, then the receiving side must receive them in the exact some order. So suppose you first send a message, then a file descriptor, then a scalar, then the receiving side must first receive a message, then a file descriptor, then a scalar. If the receiving side does things in the wrong order then bad things will happen. <p>
|
|
63
|
+
<a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> is not thread-safe, but is reentrant. </dd></dl>
|
|
64
|
+
<table border="0" cellpadding="0" cellspacing="0">
|
|
65
|
+
<tr><td></td></tr>
|
|
66
|
+
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
|
|
67
|
+
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#73e7c9a8e421d29558838176aff02ca4">MessageChannel</a> ()</td></tr>
|
|
68
|
+
|
|
69
|
+
<tr><td class="mdescLeft"> </td><td class="mdescRight">Construct a new <a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> with no underlying file descriptor. <a href="#73e7c9a8e421d29558838176aff02ca4"></a><br></td></tr>
|
|
70
|
+
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="486b6e74c4d0973eefbcfde65f898ca7"></a><!-- doxytag: member="Passenger::MessageChannel::MessageChannel" ref="486b6e74c4d0973eefbcfde65f898ca7" args="(int fd)" -->
|
|
71
|
+
</td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#486b6e74c4d0973eefbcfde65f898ca7">MessageChannel</a> (int fd)</td></tr>
|
|
72
|
+
|
|
73
|
+
<tr><td class="mdescLeft"> </td><td class="mdescRight">Construct a new <a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> with the given file descriptor. <br></td></tr>
|
|
74
|
+
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#06309e208fc5e10642a2e9bbe0f351eb">close</a> ()</td></tr>
|
|
75
|
+
|
|
76
|
+
<tr><td class="mdescLeft"> </td><td class="mdescRight">Close the underlying file descriptor. <a href="#06309e208fc5e10642a2e9bbe0f351eb"></a><br></td></tr>
|
|
77
|
+
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#9ad7a978cf8409e01ab2f0a2b6be5a0a">write</a> (const list< string > &args)</td></tr>
|
|
78
|
+
|
|
79
|
+
<tr><td class="mdescLeft"> </td><td class="mdescRight">Send an array message, which consists of the given elements, over the underlying file descriptor. <a href="#9ad7a978cf8409e01ab2f0a2b6be5a0a"></a><br></td></tr>
|
|
80
|
+
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#12cce3364023eacbe4fe09006cf3d38d">write</a> (const char *name,...)</td></tr>
|
|
81
|
+
|
|
82
|
+
<tr><td class="mdescLeft"> </td><td class="mdescRight">Send an array message, which consists of the given strings, over the underlying file descriptor. <a href="#12cce3364023eacbe4fe09006cf3d38d"></a><br></td></tr>
|
|
83
|
+
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#44e01a783c48abadeea0d915b9893bfb">writeScalar</a> (const string &str)</td></tr>
|
|
84
|
+
|
|
85
|
+
<tr><td class="mdescLeft"> </td><td class="mdescRight">Send a scalar message over the underlying file descriptor. <a href="#44e01a783c48abadeea0d915b9893bfb"></a><br></td></tr>
|
|
86
|
+
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#80977020ef895f3ea790c5d28a333dda">writeScalar</a> (const char *data, unsigned int size)</td></tr>
|
|
87
|
+
|
|
88
|
+
<tr><td class="mdescLeft"> </td><td class="mdescRight">Send a scalar message over the underlying file descriptor. <a href="#80977020ef895f3ea790c5d28a333dda"></a><br></td></tr>
|
|
89
|
+
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#069314e4c7e1fe8c8ab36e16d2cc5fef">writeRaw</a> (const char *data, unsigned int size)</td></tr>
|
|
90
|
+
|
|
91
|
+
<tr><td class="mdescLeft"> </td><td class="mdescRight">Send a block of data over the underlying file descriptor. <a href="#069314e4c7e1fe8c8ab36e16d2cc5fef"></a><br></td></tr>
|
|
92
|
+
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#cfa38f4f0e22ec16350b8cc159e8e364">writeRaw</a> (const string &data)</td></tr>
|
|
93
|
+
|
|
94
|
+
<tr><td class="mdescLeft"> </td><td class="mdescRight">Send a block of data over the underlying file descriptor. <a href="#cfa38f4f0e22ec16350b8cc159e8e364"></a><br></td></tr>
|
|
95
|
+
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#73e3f3cda384c085a2af0e820ccd3e98">writeFileDescriptor</a> (int fileDescriptor)</td></tr>
|
|
96
|
+
|
|
97
|
+
<tr><td class="mdescLeft"> </td><td class="mdescRight">Pass a file descriptor. <a href="#73e3f3cda384c085a2af0e820ccd3e98"></a><br></td></tr>
|
|
98
|
+
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#129659b60d1a663337873d2af944431e">read</a> (vector< string > &args)</td></tr>
|
|
99
|
+
|
|
100
|
+
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read an array message from the underlying file descriptor. <a href="#129659b60d1a663337873d2af944431e"></a><br></td></tr>
|
|
101
|
+
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#4ce6a0e751b5e3563bee583c231569bc">readScalar</a> (string &output)</td></tr>
|
|
102
|
+
|
|
103
|
+
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read a scalar message from the underlying file descriptor. <a href="#4ce6a0e751b5e3563bee583c231569bc"></a><br></td></tr>
|
|
104
|
+
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#cd1d1bd1cc787784c8b54f5471fff479">readRaw</a> (void *buf, unsigned int size)</td></tr>
|
|
105
|
+
|
|
106
|
+
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read exactly <code>size</code> bytes of data from the underlying file descriptor, and put the result in <code>buf</code>. <a href="#cd1d1bd1cc787784c8b54f5471fff479"></a><br></td></tr>
|
|
107
|
+
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classPassenger_1_1MessageChannel.html#1561b7e4a0f4d39ea431f456e5655488">readFileDescriptor</a> ()</td></tr>
|
|
108
|
+
|
|
109
|
+
<tr><td class="mdescLeft"> </td><td class="mdescRight">Receive a file descriptor, which had been passed over the underlying file descriptor. <a href="#1561b7e4a0f4d39ea431f456e5655488"></a><br></td></tr>
|
|
110
|
+
</table>
|
|
111
|
+
<hr><h2>Constructor & Destructor Documentation</h2>
|
|
112
|
+
<a class="anchor" name="73e7c9a8e421d29558838176aff02ca4"></a><!-- doxytag: member="Passenger::MessageChannel::MessageChannel" ref="73e7c9a8e421d29558838176aff02ca4" args="()" -->
|
|
113
|
+
<div class="memitem">
|
|
114
|
+
<div class="memproto">
|
|
115
|
+
<table class="memname">
|
|
116
|
+
<tr>
|
|
117
|
+
<td class="memname">Passenger::MessageChannel::MessageChannel </td>
|
|
118
|
+
<td>(</td>
|
|
119
|
+
<td class="paramname"> </td>
|
|
120
|
+
<td> ) </td>
|
|
121
|
+
<td width="100%"><code> [inline]</code></td>
|
|
122
|
+
</tr>
|
|
123
|
+
</table>
|
|
124
|
+
</div>
|
|
125
|
+
<div class="memdoc">
|
|
126
|
+
|
|
127
|
+
<p>
|
|
128
|
+
Construct a new <a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> with no underlying file descriptor.
|
|
129
|
+
<p>
|
|
130
|
+
Thus the resulting <a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> object will not be usable. This constructor exists to allow one to declare an "empty" <a class="el" href="classPassenger_1_1MessageChannel.html" title="Convenience class for I/O operations on file descriptors.">MessageChannel</a> variable which is to be initialized later.
|
|
131
|
+
</div>
|
|
132
|
+
</div><p>
|
|
133
|
+
<hr><h2>Member Function Documentation</h2>
|
|
134
|
+
<a class="anchor" name="06309e208fc5e10642a2e9bbe0f351eb"></a><!-- doxytag: member="Passenger::MessageChannel::close" ref="06309e208fc5e10642a2e9bbe0f351eb" args="()" -->
|
|
135
|
+
<div class="memitem">
|
|
136
|
+
<div class="memproto">
|
|
137
|
+
<table class="memname">
|
|
138
|
+
<tr>
|
|
139
|
+
<td class="memname">void Passenger::MessageChannel::close </td>
|
|
140
|
+
<td>(</td>
|
|
141
|
+
<td class="paramname"> </td>
|
|
142
|
+
<td> ) </td>
|
|
143
|
+
<td width="100%"><code> [inline]</code></td>
|
|
144
|
+
</tr>
|
|
145
|
+
</table>
|
|
146
|
+
</div>
|
|
147
|
+
<div class="memdoc">
|
|
148
|
+
|
|
149
|
+
<p>
|
|
150
|
+
Close the underlying file descriptor.
|
|
151
|
+
<p>
|
|
152
|
+
If this method is called multiple times, the file descriptor will only be closed the first time.<p>
|
|
153
|
+
<dl compact><dt><b>Exceptions:</b></dt><dd>
|
|
154
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
155
|
+
<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> </td><td></td></tr>
|
|
156
|
+
<tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em> </td><td></td></tr>
|
|
157
|
+
</table>
|
|
158
|
+
</dl>
|
|
159
|
+
|
|
160
|
+
</div>
|
|
161
|
+
</div><p>
|
|
162
|
+
<a class="anchor" name="9ad7a978cf8409e01ab2f0a2b6be5a0a"></a><!-- doxytag: member="Passenger::MessageChannel::write" ref="9ad7a978cf8409e01ab2f0a2b6be5a0a" args="(const list< string > &args)" -->
|
|
163
|
+
<div class="memitem">
|
|
164
|
+
<div class="memproto">
|
|
165
|
+
<table class="memname">
|
|
166
|
+
<tr>
|
|
167
|
+
<td class="memname">void Passenger::MessageChannel::write </td>
|
|
168
|
+
<td>(</td>
|
|
169
|
+
<td class="paramtype">const list< string > & </td>
|
|
170
|
+
<td class="paramname"> <em>args</em> </td>
|
|
171
|
+
<td> ) </td>
|
|
172
|
+
<td width="100%"><code> [inline]</code></td>
|
|
173
|
+
</tr>
|
|
174
|
+
</table>
|
|
175
|
+
</div>
|
|
176
|
+
<div class="memdoc">
|
|
177
|
+
|
|
178
|
+
<p>
|
|
179
|
+
Send an array message, which consists of the given elements, over the underlying file descriptor.
|
|
180
|
+
<p>
|
|
181
|
+
<dl compact><dt><b>Parameters:</b></dt><dd>
|
|
182
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
183
|
+
<tr><td valign="top"></td><td valign="top"><em>args</em> </td><td>The message elements. </td></tr>
|
|
184
|
+
</table>
|
|
185
|
+
</dl>
|
|
186
|
+
<dl compact><dt><b>Exceptions:</b></dt><dd>
|
|
187
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
188
|
+
<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> </td><td>An error occured while writing the data to the file descriptor. </td></tr>
|
|
189
|
+
<tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em> </td><td></td></tr>
|
|
190
|
+
</table>
|
|
191
|
+
</dl>
|
|
192
|
+
<dl class="pre" compact><dt><b>Precondition:</b></dt><dd>None of the message elements may contain a NUL character (<code>'\0'</code>). </dd></dl>
|
|
193
|
+
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#129659b60d1a663337873d2af944431e" title="Read an array message from the underlying file descriptor.">read()</a>, <a class="el" href="classPassenger_1_1MessageChannel.html#9ad7a978cf8409e01ab2f0a2b6be5a0a" title="Send an array message, which consists of the given elements, over the underlying...">write</a>(const char *, ...) </dd></dl>
|
|
194
|
+
|
|
195
|
+
</div>
|
|
196
|
+
</div><p>
|
|
197
|
+
<a class="anchor" name="12cce3364023eacbe4fe09006cf3d38d"></a><!-- doxytag: member="Passenger::MessageChannel::write" ref="12cce3364023eacbe4fe09006cf3d38d" args="(const char *name,...)" -->
|
|
198
|
+
<div class="memitem">
|
|
199
|
+
<div class="memproto">
|
|
200
|
+
<table class="memname">
|
|
201
|
+
<tr>
|
|
202
|
+
<td class="memname">void Passenger::MessageChannel::write </td>
|
|
203
|
+
<td>(</td>
|
|
204
|
+
<td class="paramtype">const char * </td>
|
|
205
|
+
<td class="paramname"> <em>name</em>, </td>
|
|
206
|
+
</tr>
|
|
207
|
+
<tr>
|
|
208
|
+
<td class="paramkey"></td>
|
|
209
|
+
<td></td>
|
|
210
|
+
<td class="paramtype"> </td>
|
|
211
|
+
<td class="paramname"> <em>...</em></td><td> </td>
|
|
212
|
+
</tr>
|
|
213
|
+
<tr>
|
|
214
|
+
<td></td>
|
|
215
|
+
<td>)</td>
|
|
216
|
+
<td></td><td></td><td width="100%"><code> [inline]</code></td>
|
|
217
|
+
</tr>
|
|
218
|
+
</table>
|
|
219
|
+
</div>
|
|
220
|
+
<div class="memdoc">
|
|
221
|
+
|
|
222
|
+
<p>
|
|
223
|
+
Send an array message, which consists of the given strings, over the underlying file descriptor.
|
|
224
|
+
<p>
|
|
225
|
+
<dl compact><dt><b>Parameters:</b></dt><dd>
|
|
226
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
227
|
+
<tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The first element of the message to send. </td></tr>
|
|
228
|
+
<tr><td valign="top"></td><td valign="top"><em>...</em> </td><td>Other elements of the message. These *must* be strings, i.e. of type char*. It is also required to terminate this list with a NULL. </td></tr>
|
|
229
|
+
</table>
|
|
230
|
+
</dl>
|
|
231
|
+
<dl compact><dt><b>Exceptions:</b></dt><dd>
|
|
232
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
233
|
+
<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> </td><td>An error occured while writing the data to the file descriptor. </td></tr>
|
|
234
|
+
<tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em> </td><td></td></tr>
|
|
235
|
+
</table>
|
|
236
|
+
</dl>
|
|
237
|
+
<dl class="pre" compact><dt><b>Precondition:</b></dt><dd>None of the message elements may contain a NUL character (<code>'\0'</code>). </dd></dl>
|
|
238
|
+
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#129659b60d1a663337873d2af944431e" title="Read an array message from the underlying file descriptor.">read()</a>, <a class="el" href="classPassenger_1_1MessageChannel.html#9ad7a978cf8409e01ab2f0a2b6be5a0a" title="Send an array message, which consists of the given elements, over the underlying...">write(const list<string> &)</a> </dd></dl>
|
|
239
|
+
|
|
240
|
+
</div>
|
|
241
|
+
</div><p>
|
|
242
|
+
<a class="anchor" name="44e01a783c48abadeea0d915b9893bfb"></a><!-- doxytag: member="Passenger::MessageChannel::writeScalar" ref="44e01a783c48abadeea0d915b9893bfb" args="(const string &str)" -->
|
|
243
|
+
<div class="memitem">
|
|
244
|
+
<div class="memproto">
|
|
245
|
+
<table class="memname">
|
|
246
|
+
<tr>
|
|
247
|
+
<td class="memname">void Passenger::MessageChannel::writeScalar </td>
|
|
248
|
+
<td>(</td>
|
|
249
|
+
<td class="paramtype">const string & </td>
|
|
250
|
+
<td class="paramname"> <em>str</em> </td>
|
|
251
|
+
<td> ) </td>
|
|
252
|
+
<td width="100%"><code> [inline]</code></td>
|
|
253
|
+
</tr>
|
|
254
|
+
</table>
|
|
255
|
+
</div>
|
|
256
|
+
<div class="memdoc">
|
|
257
|
+
|
|
258
|
+
<p>
|
|
259
|
+
Send a scalar message over the underlying file descriptor.
|
|
260
|
+
<p>
|
|
261
|
+
<dl compact><dt><b>Parameters:</b></dt><dd>
|
|
262
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
263
|
+
<tr><td valign="top"></td><td valign="top"><em>str</em> </td><td>The scalar message's content. </td></tr>
|
|
264
|
+
</table>
|
|
265
|
+
</dl>
|
|
266
|
+
<dl compact><dt><b>Exceptions:</b></dt><dd>
|
|
267
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
268
|
+
<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> </td><td>An error occured while writing the data to the file descriptor. </td></tr>
|
|
269
|
+
<tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em> </td><td></td></tr>
|
|
270
|
+
</table>
|
|
271
|
+
</dl>
|
|
272
|
+
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#4ce6a0e751b5e3563bee583c231569bc" title="Read a scalar message from the underlying file descriptor.">readScalar()</a>, <a class="el" href="classPassenger_1_1MessageChannel.html#80977020ef895f3ea790c5d28a333dda" title="Send a scalar message over the underlying file descriptor.">writeScalar(const char *, unsigned int)</a> </dd></dl>
|
|
273
|
+
|
|
274
|
+
</div>
|
|
275
|
+
</div><p>
|
|
276
|
+
<a class="anchor" name="80977020ef895f3ea790c5d28a333dda"></a><!-- doxytag: member="Passenger::MessageChannel::writeScalar" ref="80977020ef895f3ea790c5d28a333dda" args="(const char *data, unsigned int size)" -->
|
|
277
|
+
<div class="memitem">
|
|
278
|
+
<div class="memproto">
|
|
279
|
+
<table class="memname">
|
|
280
|
+
<tr>
|
|
281
|
+
<td class="memname">void Passenger::MessageChannel::writeScalar </td>
|
|
282
|
+
<td>(</td>
|
|
283
|
+
<td class="paramtype">const char * </td>
|
|
284
|
+
<td class="paramname"> <em>data</em>, </td>
|
|
285
|
+
</tr>
|
|
286
|
+
<tr>
|
|
287
|
+
<td class="paramkey"></td>
|
|
288
|
+
<td></td>
|
|
289
|
+
<td class="paramtype">unsigned int </td>
|
|
290
|
+
<td class="paramname"> <em>size</em></td><td> </td>
|
|
291
|
+
</tr>
|
|
292
|
+
<tr>
|
|
293
|
+
<td></td>
|
|
294
|
+
<td>)</td>
|
|
295
|
+
<td></td><td></td><td width="100%"><code> [inline]</code></td>
|
|
296
|
+
</tr>
|
|
297
|
+
</table>
|
|
298
|
+
</div>
|
|
299
|
+
<div class="memdoc">
|
|
300
|
+
|
|
301
|
+
<p>
|
|
302
|
+
Send a scalar message over the underlying file descriptor.
|
|
303
|
+
<p>
|
|
304
|
+
<dl compact><dt><b>Parameters:</b></dt><dd>
|
|
305
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
306
|
+
<tr><td valign="top"></td><td valign="top"><em>data</em> </td><td>The scalar message's content. </td></tr>
|
|
307
|
+
<tr><td valign="top"></td><td valign="top"><em>size</em> </td><td>The number of bytes in <code>data</code>. </td></tr>
|
|
308
|
+
</table>
|
|
309
|
+
</dl>
|
|
310
|
+
<dl class="pre" compact><dt><b>Precondition:</b></dt><dd><code>data != NULL</code> </dd></dl>
|
|
311
|
+
<dl compact><dt><b>Exceptions:</b></dt><dd>
|
|
312
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
313
|
+
<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> </td><td>An error occured while writing the data to the file descriptor. </td></tr>
|
|
314
|
+
<tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em> </td><td></td></tr>
|
|
315
|
+
</table>
|
|
316
|
+
</dl>
|
|
317
|
+
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#4ce6a0e751b5e3563bee583c231569bc" title="Read a scalar message from the underlying file descriptor.">readScalar()</a>, <a class="el" href="classPassenger_1_1MessageChannel.html#44e01a783c48abadeea0d915b9893bfb" title="Send a scalar message over the underlying file descriptor.">writeScalar(const string &)</a> </dd></dl>
|
|
318
|
+
|
|
319
|
+
</div>
|
|
320
|
+
</div><p>
|
|
321
|
+
<a class="anchor" name="069314e4c7e1fe8c8ab36e16d2cc5fef"></a><!-- doxytag: member="Passenger::MessageChannel::writeRaw" ref="069314e4c7e1fe8c8ab36e16d2cc5fef" args="(const char *data, unsigned int size)" -->
|
|
322
|
+
<div class="memitem">
|
|
323
|
+
<div class="memproto">
|
|
324
|
+
<table class="memname">
|
|
325
|
+
<tr>
|
|
326
|
+
<td class="memname">void Passenger::MessageChannel::writeRaw </td>
|
|
327
|
+
<td>(</td>
|
|
328
|
+
<td class="paramtype">const char * </td>
|
|
329
|
+
<td class="paramname"> <em>data</em>, </td>
|
|
330
|
+
</tr>
|
|
331
|
+
<tr>
|
|
332
|
+
<td class="paramkey"></td>
|
|
333
|
+
<td></td>
|
|
334
|
+
<td class="paramtype">unsigned int </td>
|
|
335
|
+
<td class="paramname"> <em>size</em></td><td> </td>
|
|
336
|
+
</tr>
|
|
337
|
+
<tr>
|
|
338
|
+
<td></td>
|
|
339
|
+
<td>)</td>
|
|
340
|
+
<td></td><td></td><td width="100%"><code> [inline]</code></td>
|
|
341
|
+
</tr>
|
|
342
|
+
</table>
|
|
343
|
+
</div>
|
|
344
|
+
<div class="memdoc">
|
|
345
|
+
|
|
346
|
+
<p>
|
|
347
|
+
Send a block of data over the underlying file descriptor.
|
|
348
|
+
<p>
|
|
349
|
+
This method blocks until everything is sent.<p>
|
|
350
|
+
<dl compact><dt><b>Parameters:</b></dt><dd>
|
|
351
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
352
|
+
<tr><td valign="top"></td><td valign="top"><em>data</em> </td><td>The data to send. </td></tr>
|
|
353
|
+
<tr><td valign="top"></td><td valign="top"><em>size</em> </td><td>The number of bytes in <code>data</code>. </td></tr>
|
|
354
|
+
</table>
|
|
355
|
+
</dl>
|
|
356
|
+
<dl class="pre" compact><dt><b>Precondition:</b></dt><dd><code>data != NULL</code> </dd></dl>
|
|
357
|
+
<dl compact><dt><b>Exceptions:</b></dt><dd>
|
|
358
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
359
|
+
<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> </td><td>An error occured while writing the data to the file descriptor. </td></tr>
|
|
360
|
+
<tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em> </td><td></td></tr>
|
|
361
|
+
</table>
|
|
362
|
+
</dl>
|
|
363
|
+
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#cd1d1bd1cc787784c8b54f5471fff479" title="Read exactly size bytes of data from the underlying file descriptor, and put the...">readRaw()</a> </dd></dl>
|
|
364
|
+
|
|
365
|
+
</div>
|
|
366
|
+
</div><p>
|
|
367
|
+
<a class="anchor" name="cfa38f4f0e22ec16350b8cc159e8e364"></a><!-- doxytag: member="Passenger::MessageChannel::writeRaw" ref="cfa38f4f0e22ec16350b8cc159e8e364" args="(const string &data)" -->
|
|
368
|
+
<div class="memitem">
|
|
369
|
+
<div class="memproto">
|
|
370
|
+
<table class="memname">
|
|
371
|
+
<tr>
|
|
372
|
+
<td class="memname">void Passenger::MessageChannel::writeRaw </td>
|
|
373
|
+
<td>(</td>
|
|
374
|
+
<td class="paramtype">const string & </td>
|
|
375
|
+
<td class="paramname"> <em>data</em> </td>
|
|
376
|
+
<td> ) </td>
|
|
377
|
+
<td width="100%"><code> [inline]</code></td>
|
|
378
|
+
</tr>
|
|
379
|
+
</table>
|
|
380
|
+
</div>
|
|
381
|
+
<div class="memdoc">
|
|
382
|
+
|
|
383
|
+
<p>
|
|
384
|
+
Send a block of data over the underlying file descriptor.
|
|
385
|
+
<p>
|
|
386
|
+
This method blocks until everything is sent.<p>
|
|
387
|
+
<dl compact><dt><b>Parameters:</b></dt><dd>
|
|
388
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
389
|
+
<tr><td valign="top"></td><td valign="top"><em>data</em> </td><td>The data to send. </td></tr>
|
|
390
|
+
</table>
|
|
391
|
+
</dl>
|
|
392
|
+
<dl class="pre" compact><dt><b>Precondition:</b></dt><dd><code>data != NULL</code> </dd></dl>
|
|
393
|
+
<dl compact><dt><b>Exceptions:</b></dt><dd>
|
|
394
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
395
|
+
<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> </td><td>An error occured while writing the data to the file descriptor. </td></tr>
|
|
396
|
+
<tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em> </td><td></td></tr>
|
|
397
|
+
</table>
|
|
398
|
+
</dl>
|
|
399
|
+
|
|
400
|
+
</div>
|
|
401
|
+
</div><p>
|
|
402
|
+
<a class="anchor" name="73e3f3cda384c085a2af0e820ccd3e98"></a><!-- doxytag: member="Passenger::MessageChannel::writeFileDescriptor" ref="73e3f3cda384c085a2af0e820ccd3e98" args="(int fileDescriptor)" -->
|
|
403
|
+
<div class="memitem">
|
|
404
|
+
<div class="memproto">
|
|
405
|
+
<table class="memname">
|
|
406
|
+
<tr>
|
|
407
|
+
<td class="memname">void Passenger::MessageChannel::writeFileDescriptor </td>
|
|
408
|
+
<td>(</td>
|
|
409
|
+
<td class="paramtype">int </td>
|
|
410
|
+
<td class="paramname"> <em>fileDescriptor</em> </td>
|
|
411
|
+
<td> ) </td>
|
|
412
|
+
<td width="100%"><code> [inline]</code></td>
|
|
413
|
+
</tr>
|
|
414
|
+
</table>
|
|
415
|
+
</div>
|
|
416
|
+
<div class="memdoc">
|
|
417
|
+
|
|
418
|
+
<p>
|
|
419
|
+
Pass a file descriptor.
|
|
420
|
+
<p>
|
|
421
|
+
This only works if the underlying file descriptor is a Unix socket.<p>
|
|
422
|
+
<dl compact><dt><b>Parameters:</b></dt><dd>
|
|
423
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
424
|
+
<tr><td valign="top"></td><td valign="top"><em>fileDescriptor</em> </td><td>The file descriptor to pass. </td></tr>
|
|
425
|
+
</table>
|
|
426
|
+
</dl>
|
|
427
|
+
<dl compact><dt><b>Exceptions:</b></dt><dd>
|
|
428
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
429
|
+
<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> </td><td>Something went wrong during file descriptor passing. </td></tr>
|
|
430
|
+
<tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em> </td><td></td></tr>
|
|
431
|
+
</table>
|
|
432
|
+
</dl>
|
|
433
|
+
<dl class="pre" compact><dt><b>Precondition:</b></dt><dd><code>fileDescriptor >= 0</code> </dd></dl>
|
|
434
|
+
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#1561b7e4a0f4d39ea431f456e5655488" title="Receive a file descriptor, which had been passed over the underlying file descriptor...">readFileDescriptor()</a> </dd></dl>
|
|
435
|
+
|
|
436
|
+
</div>
|
|
437
|
+
</div><p>
|
|
438
|
+
<a class="anchor" name="129659b60d1a663337873d2af944431e"></a><!-- doxytag: member="Passenger::MessageChannel::read" ref="129659b60d1a663337873d2af944431e" args="(vector< string > &args)" -->
|
|
439
|
+
<div class="memitem">
|
|
440
|
+
<div class="memproto">
|
|
441
|
+
<table class="memname">
|
|
442
|
+
<tr>
|
|
443
|
+
<td class="memname">bool Passenger::MessageChannel::read </td>
|
|
444
|
+
<td>(</td>
|
|
445
|
+
<td class="paramtype">vector< string > & </td>
|
|
446
|
+
<td class="paramname"> <em>args</em> </td>
|
|
447
|
+
<td> ) </td>
|
|
448
|
+
<td width="100%"><code> [inline]</code></td>
|
|
449
|
+
</tr>
|
|
450
|
+
</table>
|
|
451
|
+
</div>
|
|
452
|
+
<div class="memdoc">
|
|
453
|
+
|
|
454
|
+
<p>
|
|
455
|
+
Read an array message from the underlying file descriptor.
|
|
456
|
+
<p>
|
|
457
|
+
<dl compact><dt><b>Parameters:</b></dt><dd>
|
|
458
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
459
|
+
<tr><td valign="top"></td><td valign="top"><em>args</em> </td><td>The message will be put in this variable. </td></tr>
|
|
460
|
+
</table>
|
|
461
|
+
</dl>
|
|
462
|
+
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Whether end-of-file has been reached. If so, then the contents of <code>args</code> will be undefined. </dd></dl>
|
|
463
|
+
<dl compact><dt><b>Exceptions:</b></dt><dd>
|
|
464
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
465
|
+
<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> </td><td>If an error occured while receiving the message. </td></tr>
|
|
466
|
+
<tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em> </td><td></td></tr>
|
|
467
|
+
</table>
|
|
468
|
+
</dl>
|
|
469
|
+
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#9ad7a978cf8409e01ab2f0a2b6be5a0a" title="Send an array message, which consists of the given elements, over the underlying...">write()</a> </dd></dl>
|
|
470
|
+
|
|
471
|
+
</div>
|
|
472
|
+
</div><p>
|
|
473
|
+
<a class="anchor" name="4ce6a0e751b5e3563bee583c231569bc"></a><!-- doxytag: member="Passenger::MessageChannel::readScalar" ref="4ce6a0e751b5e3563bee583c231569bc" args="(string &output)" -->
|
|
474
|
+
<div class="memitem">
|
|
475
|
+
<div class="memproto">
|
|
476
|
+
<table class="memname">
|
|
477
|
+
<tr>
|
|
478
|
+
<td class="memname">bool Passenger::MessageChannel::readScalar </td>
|
|
479
|
+
<td>(</td>
|
|
480
|
+
<td class="paramtype">string & </td>
|
|
481
|
+
<td class="paramname"> <em>output</em> </td>
|
|
482
|
+
<td> ) </td>
|
|
483
|
+
<td width="100%"><code> [inline]</code></td>
|
|
484
|
+
</tr>
|
|
485
|
+
</table>
|
|
486
|
+
</div>
|
|
487
|
+
<div class="memdoc">
|
|
488
|
+
|
|
489
|
+
<p>
|
|
490
|
+
Read a scalar message from the underlying file descriptor.
|
|
491
|
+
<p>
|
|
492
|
+
<dl compact><dt><b>Parameters:</b></dt><dd>
|
|
493
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
494
|
+
<tr><td valign="top"></td><td valign="top"><em>output</em> </td><td>The message will be put in here. </td></tr>
|
|
495
|
+
</table>
|
|
496
|
+
</dl>
|
|
497
|
+
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Whether end-of-file was reached during reading. </dd></dl>
|
|
498
|
+
<dl compact><dt><b>Exceptions:</b></dt><dd>
|
|
499
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
500
|
+
<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> </td><td>An error occured while writing the data to the file descriptor. </td></tr>
|
|
501
|
+
<tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em> </td><td></td></tr>
|
|
502
|
+
</table>
|
|
503
|
+
</dl>
|
|
504
|
+
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#44e01a783c48abadeea0d915b9893bfb" title="Send a scalar message over the underlying file descriptor.">writeScalar()</a> </dd></dl>
|
|
505
|
+
|
|
506
|
+
</div>
|
|
507
|
+
</div><p>
|
|
508
|
+
<a class="anchor" name="cd1d1bd1cc787784c8b54f5471fff479"></a><!-- doxytag: member="Passenger::MessageChannel::readRaw" ref="cd1d1bd1cc787784c8b54f5471fff479" args="(void *buf, unsigned int size)" -->
|
|
509
|
+
<div class="memitem">
|
|
510
|
+
<div class="memproto">
|
|
511
|
+
<table class="memname">
|
|
512
|
+
<tr>
|
|
513
|
+
<td class="memname">bool Passenger::MessageChannel::readRaw </td>
|
|
514
|
+
<td>(</td>
|
|
515
|
+
<td class="paramtype">void * </td>
|
|
516
|
+
<td class="paramname"> <em>buf</em>, </td>
|
|
517
|
+
</tr>
|
|
518
|
+
<tr>
|
|
519
|
+
<td class="paramkey"></td>
|
|
520
|
+
<td></td>
|
|
521
|
+
<td class="paramtype">unsigned int </td>
|
|
522
|
+
<td class="paramname"> <em>size</em></td><td> </td>
|
|
523
|
+
</tr>
|
|
524
|
+
<tr>
|
|
525
|
+
<td></td>
|
|
526
|
+
<td>)</td>
|
|
527
|
+
<td></td><td></td><td width="100%"><code> [inline]</code></td>
|
|
528
|
+
</tr>
|
|
529
|
+
</table>
|
|
530
|
+
</div>
|
|
531
|
+
<div class="memdoc">
|
|
532
|
+
|
|
533
|
+
<p>
|
|
534
|
+
Read exactly <code>size</code> bytes of data from the underlying file descriptor, and put the result in <code>buf</code>.
|
|
535
|
+
<p>
|
|
536
|
+
If end-of-file has been reached, or if end-of-file was encountered before <code>size</code> bytes have been read, then <code>false</code> will be returned. Otherwise (i.e. if the read was successful), <code>true</code> will be returned.<p>
|
|
537
|
+
<dl compact><dt><b>Parameters:</b></dt><dd>
|
|
538
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
539
|
+
<tr><td valign="top"></td><td valign="top"><em>buf</em> </td><td>The buffer to place the read data in. This buffer must be at least <code>size</code> bytes long. </td></tr>
|
|
540
|
+
<tr><td valign="top"></td><td valign="top"><em>size</em> </td><td>The number of bytes to read. </td></tr>
|
|
541
|
+
</table>
|
|
542
|
+
</dl>
|
|
543
|
+
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Whether reading was successful or whether EOF was reached. </dd></dl>
|
|
544
|
+
<dl class="pre" compact><dt><b>Precondition:</b></dt><dd>buf != NULL </dd></dl>
|
|
545
|
+
<dl compact><dt><b>Exceptions:</b></dt><dd>
|
|
546
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
547
|
+
<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> </td><td>Something went wrong during reading. </td></tr>
|
|
548
|
+
<tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em> </td><td></td></tr>
|
|
549
|
+
</table>
|
|
550
|
+
</dl>
|
|
551
|
+
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classPassenger_1_1MessageChannel.html#069314e4c7e1fe8c8ab36e16d2cc5fef" title="Send a block of data over the underlying file descriptor.">writeRaw()</a> </dd></dl>
|
|
552
|
+
|
|
553
|
+
</div>
|
|
554
|
+
</div><p>
|
|
555
|
+
<a class="anchor" name="1561b7e4a0f4d39ea431f456e5655488"></a><!-- doxytag: member="Passenger::MessageChannel::readFileDescriptor" ref="1561b7e4a0f4d39ea431f456e5655488" args="()" -->
|
|
556
|
+
<div class="memitem">
|
|
557
|
+
<div class="memproto">
|
|
558
|
+
<table class="memname">
|
|
559
|
+
<tr>
|
|
560
|
+
<td class="memname">int Passenger::MessageChannel::readFileDescriptor </td>
|
|
561
|
+
<td>(</td>
|
|
562
|
+
<td class="paramname"> </td>
|
|
563
|
+
<td> ) </td>
|
|
564
|
+
<td width="100%"><code> [inline]</code></td>
|
|
565
|
+
</tr>
|
|
566
|
+
</table>
|
|
567
|
+
</div>
|
|
568
|
+
<div class="memdoc">
|
|
569
|
+
|
|
570
|
+
<p>
|
|
571
|
+
Receive a file descriptor, which had been passed over the underlying file descriptor.
|
|
572
|
+
<p>
|
|
573
|
+
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The passed file descriptor. </dd></dl>
|
|
574
|
+
<dl compact><dt><b>Exceptions:</b></dt><dd>
|
|
575
|
+
<table border="0" cellspacing="2" cellpadding="0">
|
|
576
|
+
<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> </td><td>If something went wrong during the receiving of a file descriptor. Perhaps the underlying file descriptor isn't a Unix socket. </td></tr>
|
|
577
|
+
<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> </td><td>Whatever was received doesn't seem to be a file descriptor. </td></tr>
|
|
578
|
+
<tr><td valign="top"></td><td valign="top"><em>boost::thread_interrupted</em> </td><td></td></tr>
|
|
579
|
+
</table>
|
|
580
|
+
</dl>
|
|
581
|
+
|
|
582
|
+
</div>
|
|
583
|
+
</div><p>
|
|
584
|
+
<hr>The documentation for this class was generated from the following file:<ul>
|
|
585
|
+
<li><a class="el" href="MessageChannel_8h-source.html">MessageChannel.h</a></ul>
|
|
586
|
+
</div>
|
|
587
|
+
<hr size="1"><address style="text-align: right;"><small>Generated on Mon Dec 1 14:27:23 2008 for Passenger by
|
|
588
|
+
<a href="http://www.doxygen.org/index.html">
|
|
589
|
+
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.5 </small></address>
|
|
590
|
+
</body>
|
|
591
|
+
</html>
|