slave 0.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (27) hide show
  1. data/README +42 -0
  2. data/VERSION +1 -0
  3. data/doc/classes/Slave.html +541 -0
  4. data/doc/classes/Slave/Heartbeat.html +342 -0
  5. data/doc/created.rid +1 -0
  6. data/doc/dot/f_0.dot +14 -0
  7. data/doc/dot/f_0.jpg +0 -0
  8. data/doc/dot/f_1.dot +14 -0
  9. data/doc/dot/f_1.jpg +0 -0
  10. data/doc/dot/f_2.dot +29 -0
  11. data/doc/dot/f_2.jpg +0 -0
  12. data/doc/files/README.html +169 -0
  13. data/doc/files/VERSION.html +107 -0
  14. data/doc/files/lib/slave_rb.html +119 -0
  15. data/doc/fr_class_index.html +28 -0
  16. data/doc/fr_file_index.html +29 -0
  17. data/doc/fr_method_index.html +39 -0
  18. data/doc/index.html +24 -0
  19. data/doc/rdoc-style.css +172 -0
  20. data/gemspec.rb +23 -0
  21. data/install.rb +201 -0
  22. data/lib/slave-0.0.0.rb +292 -0
  23. data/lib/slave.rb +292 -0
  24. data/rdoc.cmd +1 -0
  25. data/sample/a.rb +102 -0
  26. data/slave-0.0.0.gem +0 -0
  27. metadata +72 -0
data/doc/classes/Slave/Heartbeat.html ADDED
@@ -0,0 +1,342 @@
1
+ <?xml version="1.0" encoding="iso-8859-1"?>
2
+ <!DOCTYPE html
3
+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
+ "DTD/xhtml1-transitional.dtd">
5
+
6
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7
+ <head>
8
+ <title>Class: Slave::Heartbeat</title>
9
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
+ <meta http-equiv="Content-Script-Type" content="text/javascript" />
11
+ <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
12
+ <script type="text/javascript">
13
+ // <![CDATA[
14
+
15
+ function popupCode( url ) {
16
+ window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
17
+ }
18
+
19
+ function toggleCode( id ) {
20
+ if ( document.getElementById )
21
+ elem = document.getElementById( id );
22
+ else if ( document.all )
23
+ elem = eval( "document.all." + id );
24
+ else
25
+ return false;
26
+
27
+ elemStyle = elem.style;
28
+
29
+ if ( elemStyle.display != "block" ) {
30
+ elemStyle.display = "block"
31
+ } else {
32
+ elemStyle.display = "none"
33
+ }
34
+
35
+ return true;
36
+ }
37
+
38
+ // Make codeblocks hidden by default
39
+ document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
40
+
41
+ // ]]>
42
+ </script>
43
+
44
+ </head>
45
+ <body>
46
+
47
+
48
+
49
+ <div id="classHeader">
50
+ <h1>Slave::Heartbeat <sup class="type-note">(Class)</sup></h1>
51
+ <table class="header-table">
52
+ <tr class="top-aligned-row">
53
+ <td><strong>In:</strong></td>
54
+ <td>
55
+ <a href="../../files/lib/slave_rb.html">
56
+ lib/slave.rb
57
+ </a>
58
+ <br />
59
+ </td>
60
+ </tr>
61
+
62
+ <tr class="top-aligned-row">
63
+ <td><strong>Parent:</strong></td>
64
+ <td>
65
+ Object
66
+ </td>
67
+ </tr>
68
+ </table>
69
+ </div>
70
+ <!-- banner header -->
71
+
72
+ <div id="bodyContent">
73
+
74
+
75
+ <div id="contextContent">
76
+ <div id="diagram">
77
+ <map name="map">
78
+ <area shape="RECT" coords="28,88,99,40" href="../Slave.html" alt="Slave">
79
+ </map>
80
+ <img src="../../dot/f_2.jpg" usemap="#map" border=0 alt="TopLevel">
81
+ </div>
82
+
83
+ <div id="description">
84
+ <p>
85
+ the <a href="Heartbeat.html">Heartbeat</a> class is essentially wrapper
86
+ over an IPC channel that sends a ping on the channel indicating process
87
+ health. if either end of the channel is detached the ping will fail and an
88
+ error will be raised. in this was it is ensured that <a
89
+ href="../Slave.html">Slave</a> object cannot continue to live without their
90
+ parent being alive.
91
+ </p>
92
+
93
+ </div>
94
+
95
+
96
+ <div id="method-list">
97
+ <h2 class="section-bar">Methods</h2>
98
+
99
+ <div class="name-list">
100
+ <a href="#M000011">child_start</a>&nbsp;&nbsp;
101
+ <a href="#M000008">new</a>&nbsp;&nbsp;
102
+ <a href="#M000010">parent_start</a>&nbsp;&nbsp;
103
+ <a href="#M000009">start</a>&nbsp;&nbsp;
104
+ <a href="#M000012">stop</a>&nbsp;&nbsp;
105
+ <a href="#M000013">trace</a>&nbsp;&nbsp;
106
+ </div>
107
+ </div>
108
+
109
+
110
+
111
+
112
+
113
+
114
+ </div>
115
+
116
+
117
+
118
+ <!-- if includes -->
119
+
120
+
121
+ <!-- if method_list -->
122
+ <div id="methods">
123
+ <h2 class="section-bar">Public Class methods</h2>
124
+
125
+ <div id="method-M000008" class="method-detail">
126
+ <a name="M000008"></a>
127
+
128
+ <div class="method-heading">
129
+ <a href="#M000008" class="method-signature">
130
+ <span class="method-name">new</span><span class="method-args">pulse_rate = 4.2, debug = false</span>
131
+ </a>
132
+ </div>
133
+
134
+ <div class="method-description">
135
+ <p><a class="source-toggle" href="#"
136
+ onclick="toggleCode('M000008-source');return false;">[Source]</a></p>
137
+ <div class="method-source-code" id="M000008-source">
138
+ <pre>
139
+ <span class="ruby-comment cmt"># File lib/slave.rb, line 206</span>
140
+ 206: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span> <span class="ruby-identifier">pulse_rate</span> = <span class="ruby-value">4.2</span>, <span class="ruby-identifier">debug</span> = <span class="ruby-keyword kw">false</span>
141
+ 207: <span class="ruby-comment cmt">#--{{{</span>
142
+ 208: <span class="ruby-ivar">@pulse_rate</span> = <span class="ruby-constant">Float</span> <span class="ruby-identifier">pulse_rate</span>
143
+ 209: <span class="ruby-ivar">@debug</span> = <span class="ruby-identifier">debug</span>
144
+ 210: <span class="ruby-ivar">@r</span>, <span class="ruby-ivar">@w</span> = <span class="ruby-constant">IO</span><span class="ruby-operator">::</span><span class="ruby-identifier">pipe</span>
145
+ 211: <span class="ruby-ivar">@pid</span> = <span class="ruby-constant">Process</span><span class="ruby-operator">::</span><span class="ruby-identifier">pid</span>
146
+ 212: <span class="ruby-ivar">@ppid</span> = <span class="ruby-constant">Process</span><span class="ruby-operator">::</span><span class="ruby-identifier">ppid</span>
147
+ 213: <span class="ruby-ivar">@cid</span> = <span class="ruby-keyword kw">nil</span>
148
+ 214: <span class="ruby-ivar">@thread</span> = <span class="ruby-keyword kw">nil</span>
149
+ 215: <span class="ruby-ivar">@ppid</span> = <span class="ruby-keyword kw">nil</span>
150
+ 216: <span class="ruby-ivar">@whoami</span> = <span class="ruby-keyword kw">nil</span>
151
+ 217: <span class="ruby-ivar">@beating</span> = <span class="ruby-keyword kw">nil</span>
152
+ 218: <span class="ruby-ivar">@pipe</span> = <span class="ruby-keyword kw">nil</span>
153
+ 219: <span class="ruby-comment cmt">#--}}}</span>
154
+ 220: <span class="ruby-keyword kw">end</span>
155
+ </pre>
156
+ </div>
157
+ </div>
158
+ </div>
159
+
160
+ <h2 class="section-bar">Public Instance methods</h2>
161
+
162
+ <div id="method-M000011" class="method-detail">
163
+ <a name="M000011"></a>
164
+
165
+ <div class="method-heading">
166
+ <a href="#M000011" class="method-signature">
167
+ <span class="method-name">child_start</span><span class="method-args">()</span>
168
+ </a>
169
+ </div>
170
+
171
+ <div class="method-description">
172
+ <p><a class="source-toggle" href="#"
173
+ onclick="toggleCode('M000011-source');return false;">[Source]</a></p>
174
+ <div class="method-source-code" id="M000011-source">
175
+ <pre>
176
+ <span class="ruby-comment cmt"># File lib/slave.rb, line 254</span>
177
+ 254: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">child_start</span>
178
+ 255: <span class="ruby-comment cmt">#--{{{</span>
179
+ 256: <span class="ruby-ivar">@whoami</span> = <span class="ruby-value str">'child'</span>
180
+ 257: <span class="ruby-ivar">@pid</span> = <span class="ruby-constant">Process</span><span class="ruby-operator">::</span><span class="ruby-identifier">pid</span>
181
+ 258: <span class="ruby-ivar">@ppid</span> = <span class="ruby-constant">Process</span><span class="ruby-operator">::</span><span class="ruby-identifier">ppid</span>
182
+ 259: <span class="ruby-ivar">@thread</span> =
183
+ 260: <span class="ruby-constant">Thread</span><span class="ruby-operator">::</span><span class="ruby-identifier">new</span>(<span class="ruby-constant">Thread</span><span class="ruby-operator">::</span><span class="ruby-identifier">current</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">cur</span><span class="ruby-operator">|</span>
184
+ 261: <span class="ruby-keyword kw">begin</span>
185
+ 262: <span class="ruby-identifier">loop</span> <span class="ruby-keyword kw">do</span>
186
+ 263: <span class="ruby-identifier">trace</span>{ <span class="ruby-node">&quot;&lt;#{ @whoami }&gt; &lt;#{ @pid }&gt; puts &lt;#{ @pid }&gt;&quot;</span> }
187
+ 264: <span class="ruby-ivar">@pipe</span>.<span class="ruby-identifier">puts</span> <span class="ruby-ivar">@pid</span>
188
+ 265: <span class="ruby-constant">Process</span><span class="ruby-operator">::</span><span class="ruby-identifier">kill</span> <span class="ruby-value">0</span>, <span class="ruby-ivar">@ppid</span>
189
+ 266: <span class="ruby-identifier">sleep</span> <span class="ruby-ivar">@pulse_rate</span>
190
+ 267: <span class="ruby-keyword kw">end</span>
191
+ 268: <span class="ruby-keyword kw">rescue</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
192
+ 269: <span class="ruby-identifier">cur</span>.<span class="ruby-identifier">raise</span> <span class="ruby-identifier">e</span>
193
+ 270: <span class="ruby-keyword kw">ensure</span>
194
+ 271: <span class="ruby-ivar">@pipe</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
195
+ 272: <span class="ruby-keyword kw">end</span>
196
+ 273: <span class="ruby-keyword kw">end</span>
197
+ 274: <span class="ruby-comment cmt">#--}}}</span>
198
+ 275: <span class="ruby-keyword kw">end</span>
199
+ </pre>
200
+ </div>
201
+ </div>
202
+ </div>
203
+
204
+ <div id="method-M000010" class="method-detail">
205
+ <a name="M000010"></a>
206
+
207
+ <div class="method-heading">
208
+ <a href="#M000010" class="method-signature">
209
+ <span class="method-name">parent_start</span><span class="method-args">()</span>
210
+ </a>
211
+ </div>
212
+
213
+ <div class="method-description">
214
+ <p><a class="source-toggle" href="#"
215
+ onclick="toggleCode('M000010-source');return false;">[Source]</a></p>
216
+ <div class="method-source-code" id="M000010-source">
217
+ <pre>
218
+ <span class="ruby-comment cmt"># File lib/slave.rb, line 235</span>
219
+ 235: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">parent_start</span>
220
+ 236: <span class="ruby-comment cmt">#--{{{</span>
221
+ 237: <span class="ruby-ivar">@whoami</span> = <span class="ruby-value str">'parent'</span>
222
+ 238: <span class="ruby-ivar">@thread</span> =
223
+ 239: <span class="ruby-constant">Thread</span><span class="ruby-operator">::</span><span class="ruby-identifier">new</span>(<span class="ruby-constant">Thread</span><span class="ruby-operator">::</span><span class="ruby-identifier">current</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">cur</span><span class="ruby-operator">|</span>
224
+ 240: <span class="ruby-keyword kw">begin</span>
225
+ 241: <span class="ruby-identifier">loop</span> <span class="ruby-keyword kw">do</span>
226
+ 242: <span class="ruby-identifier">buf</span> = <span class="ruby-ivar">@pipe</span>.<span class="ruby-identifier">gets</span>
227
+ 243: <span class="ruby-identifier">trace</span>{ <span class="ruby-node">&quot;&lt;#{ @whoami }&gt; &lt;#{ @pid }&gt; gets &lt;#{ buf.inspect }&gt;&quot;</span> }
228
+ 244: <span class="ruby-ivar">@cid</span> = <span class="ruby-constant">Integer</span> <span class="ruby-identifier">buf</span>.<span class="ruby-identifier">strip</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@cid</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">buf</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">%/^\s*\d+\s*$/</span>
229
+ 245: <span class="ruby-keyword kw">end</span>
230
+ 246: <span class="ruby-keyword kw">rescue</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
231
+ 247: <span class="ruby-identifier">cur</span>.<span class="ruby-identifier">raise</span> <span class="ruby-identifier">e</span>
232
+ 248: <span class="ruby-keyword kw">ensure</span>
233
+ 249: <span class="ruby-ivar">@pipe</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
234
+ 250: <span class="ruby-keyword kw">end</span>
235
+ 251: <span class="ruby-keyword kw">end</span>
236
+ 252: <span class="ruby-comment cmt">#--}}}</span>
237
+ 253: <span class="ruby-keyword kw">end</span>
238
+ </pre>
239
+ </div>
240
+ </div>
241
+ </div>
242
+
243
+ <div id="method-M000009" class="method-detail">
244
+ <a name="M000009"></a>
245
+
246
+ <div class="method-heading">
247
+ <a href="#M000009" class="method-signature">
248
+ <span class="method-name">start</span><span class="method-args">()</span>
249
+ </a>
250
+ </div>
251
+
252
+ <div class="method-description">
253
+ <p><a class="source-toggle" href="#"
254
+ onclick="toggleCode('M000009-source');return false;">[Source]</a></p>
255
+ <div class="method-source-code" id="M000009-source">
256
+ <pre>
257
+ <span class="ruby-comment cmt"># File lib/slave.rb, line 221</span>
258
+ 221: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">start</span>
259
+ 222: <span class="ruby-comment cmt">#--{{{</span>
260
+ 223: <span class="ruby-keyword kw">if</span> <span class="ruby-constant">Process</span><span class="ruby-operator">::</span><span class="ruby-identifier">pid</span> <span class="ruby-operator">==</span> <span class="ruby-ivar">@pid</span>
261
+ 224: <span class="ruby-ivar">@w</span>.<span class="ruby-identifier">close</span>
262
+ 225: <span class="ruby-ivar">@pipe</span> = <span class="ruby-ivar">@r</span>
263
+ 226: <span class="ruby-identifier">parent_start</span>
264
+ 227: <span class="ruby-keyword kw">else</span>
265
+ 228: <span class="ruby-ivar">@r</span>.<span class="ruby-identifier">close</span>
266
+ 229: <span class="ruby-ivar">@pipe</span> = <span class="ruby-ivar">@w</span>
267
+ 230: <span class="ruby-identifier">child_start</span>
268
+ 231: <span class="ruby-keyword kw">end</span>
269
+ 232: <span class="ruby-ivar">@beating</span> = <span class="ruby-keyword kw">true</span>
270
+ 233: <span class="ruby-comment cmt">#--}}}</span>
271
+ 234: <span class="ruby-keyword kw">end</span>
272
+ </pre>
273
+ </div>
274
+ </div>
275
+ </div>
276
+
277
+ <div id="method-M000012" class="method-detail">
278
+ <a name="M000012"></a>
279
+
280
+ <div class="method-heading">
281
+ <a href="#M000012" class="method-signature">
282
+ <span class="method-name">stop</span><span class="method-args">()</span>
283
+ </a>
284
+ </div>
285
+
286
+ <div class="method-description">
287
+ <p><a class="source-toggle" href="#"
288
+ onclick="toggleCode('M000012-source');return false;">[Source]</a></p>
289
+ <div class="method-source-code" id="M000012-source">
290
+ <pre>
291
+ <span class="ruby-comment cmt"># File lib/slave.rb, line 276</span>
292
+ 276: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stop</span>
293
+ 277: <span class="ruby-comment cmt">#--{{{</span>
294
+ 278: <span class="ruby-identifier">raise</span> <span class="ruby-value str">&quot;not beating&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@beating</span>
295
+ 279: <span class="ruby-ivar">@thread</span>.<span class="ruby-identifier">kill</span>
296
+ 280: <span class="ruby-ivar">@pipe</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
297
+ 281: <span class="ruby-ivar">@beating</span> = <span class="ruby-keyword kw">false</span>
298
+ 282: <span class="ruby-comment cmt">#--}}}</span>
299
+ 283: <span class="ruby-keyword kw">end</span>
300
+ </pre>
301
+ </div>
302
+ </div>
303
+ </div>
304
+
305
+ <div id="method-M000013" class="method-detail">
306
+ <a name="M000013"></a>
307
+
308
+ <div class="method-heading">
309
+ <a href="#M000013" class="method-signature">
310
+ <span class="method-name">trace</span><span class="method-args">() {|| ...}</span>
311
+ </a>
312
+ </div>
313
+
314
+ <div class="method-description">
315
+ <p><a class="source-toggle" href="#"
316
+ onclick="toggleCode('M000013-source');return false;">[Source]</a></p>
317
+ <div class="method-source-code" id="M000013-source">
318
+ <pre>
319
+ <span class="ruby-comment cmt"># File lib/slave.rb, line 284</span>
320
+ 284: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">trace</span>
321
+ 285: <span class="ruby-comment cmt">#--{{{</span>
322
+ 286: <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">puts</span>(<span class="ruby-keyword kw">yield</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@debug</span> <span class="ruby-keyword kw">and</span> <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">tty?</span>
323
+ 287: <span class="ruby-comment cmt">#--}}}</span>
324
+ 288: <span class="ruby-keyword kw">end</span>
325
+ </pre>
326
+ </div>
327
+ </div>
328
+ </div>
329
+
330
+
331
+ </div>
332
+
333
+
334
+ </div>
335
+
336
+
337
+ <div id="validator-badges">
338
+ <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
339
+ </div>
340
+
341
+ </body>
342
+ </html>
data/doc/created.rid ADDED
@@ -0,0 +1 @@
1
+ Fri Nov 12 12:27:08 MST 2004
data/doc/dot/f_0.dot ADDED
@@ -0,0 +1,14 @@
1
+ digraph TopLevel {
2
+ compound = true
3
+ bgcolor = lightcyan1
4
+ fontname = Arial
5
+ fontsize = 8
6
+ label = "README"
7
+ node [
8
+ fontname = Arial,
9
+ fontsize = 8,
10
+ color = black
11
+ ]
12
+
13
+ }
14
+
data/doc/dot/f_0.jpg ADDED
Binary file
data/doc/dot/f_1.dot ADDED
@@ -0,0 +1,14 @@
1
+ digraph TopLevel {
2
+ compound = true
3
+ bgcolor = lightcyan1
4
+ fontname = Arial
5
+ fontsize = 8
6
+ label = "VERSION"
7
+ node [
8
+ fontname = Arial,
9
+ fontsize = 8,
10
+ color = black
11
+ ]
12
+
13
+ }
14
+
data/doc/dot/f_1.jpg ADDED
Binary file
data/doc/dot/f_2.dot ADDED
@@ -0,0 +1,29 @@
1
+ digraph TopLevel {
2
+ compound = true
3
+ bgcolor = lightcyan1
4
+ fontname = Arial
5
+ fontsize = 8
6
+ label = "lib/slave.rb"
7
+ node [
8
+ fontname = Arial,
9
+ fontsize = 8,
10
+ color = black
11
+ ]
12
+
13
+ subgraph cluster_1 {
14
+ fontname = Arial
15
+ color = red
16
+ label = "lib/slave.rb"
17
+ Slave [
18
+ fontcolor = black,
19
+ URL = "classes/Slave.html",
20
+ shape = ellipse,
21
+ color = palegoldenrod,
22
+ style = filled,
23
+ label = "Slave"
24
+ ]
25
+
26
+ }
27
+
28
+ }
29
+
data/doc/dot/f_2.jpg ADDED
Binary file
data/doc/files/README.html ADDED
@@ -0,0 +1,169 @@
1
+ <?xml version="1.0" encoding="iso-8859-1"?>
2
+ <!DOCTYPE html
3
+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
+ "DTD/xhtml1-transitional.dtd">
5
+
6
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7
+ <head>
8
+ <title>File: README</title>
9
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
+ <meta http-equiv="Content-Script-Type" content="text/javascript" />
11
+ <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
12
+ <script type="text/javascript">
13
+ // <![CDATA[
14
+
15
+ function popupCode( url ) {
16
+ window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
17
+ }
18
+
19
+ function toggleCode( id ) {
20
+ if ( document.getElementById )
21
+ elem = document.getElementById( id );
22
+ else if ( document.all )
23
+ elem = eval( "document.all." + id );
24
+ else
25
+ return false;
26
+
27
+ elemStyle = elem.style;
28
+
29
+ if ( elemStyle.display != "block" ) {
30
+ elemStyle.display = "block"
31
+ } else {
32
+ elemStyle.display = "none"
33
+ }
34
+
35
+ return true;
36
+ }
37
+
38
+ // Make codeblocks hidden by default
39
+ document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
40
+
41
+ // ]]>
42
+ </script>
43
+
44
+ </head>
45
+ <body>
46
+
47
+
48
+
49
+ <div id="fileHeader">
50
+ <h1>README</h1>
51
+ <table class="header-table">
52
+ <tr class="top-aligned-row">
53
+ <td><strong>Path:</strong></td>
54
+ <td>README
55
+ </td>
56
+ </tr>
57
+ <tr class="top-aligned-row">
58
+ <td><strong>Last Update:</strong></td>
59
+ <td>Fri Nov 12 12:27:06 MST 2004</td>
60
+ </tr>
61
+ </table>
62
+ </div>
63
+ <!-- banner header -->
64
+
65
+ <div id="bodyContent">
66
+
67
+
68
+ <div id="contextContent">
69
+ <div id="diagram">
70
+ <map name="map">
71
+ </map>
72
+ <img src="../dot/f_0.jpg" usemap="#map" border=0 alt="TopLevel">
73
+ </div>
74
+
75
+ <div id="description">
76
+ <p>
77
+ the <a href="../classes/Slave.html">Slave</a> class forks a process and
78
+ starts a drb server in the child using any object as the server. the
79
+ process is detached so it is not required (nor possible) to wait on the
80
+ child pid. a Heartbeat is set up between the parent and child processes so
81
+ that the child will exit of the parent exits for any reason - preventing
82
+ orphaned slaves from running indefinitely. the purpose of Slaves is to be
83
+ able to easily set up a collection of objects communicating via drb
84
+ protocols instead of having to use IPC.
85
+ </p>
86
+ <p>
87
+ typical usage:
88
+ </p>
89
+ <pre>
90
+ obj = AnyClass::new
91
+
92
+ slave = Slave::new obj
93
+
94
+ p slave.object # handle on drb object
95
+ p slave.uri # uri of the drb object
96
+ p slave.socket # unix domain socket path for drb object
97
+ p slave.psname # title shown in ps/top
98
+ </pre>
99
+ <p>
100
+ other usage:
101
+ </p>
102
+ <p>
103
+ set the pulse_rate used for the Heartbeat
104
+ </p>
105
+ <pre>
106
+ slave = Slave::new MyClass::new, 'pulse_rate' =&gt; 10
107
+ </pre>
108
+ <p>
109
+ same
110
+ </p>
111
+ <pre>
112
+ Slave::pulse_rate = 10
113
+ slave = Slave::new MyClass::new
114
+ </pre>
115
+ <p>
116
+ same
117
+ </p>
118
+ <pre>
119
+ ENV['SLAVE_PULSE_RATE'] = 10
120
+ slave = Slave::new MyClass::new
121
+ </pre>
122
+ <p>
123
+ slaves may be configured via the environment, the <a
124
+ href="../classes/Slave.html">Slave</a> class, or via the ctor for object
125
+ itself. attributes which may be configured include
126
+ </p>
127
+ <ul>
128
+ <li>socket_creation_attempts
129
+
130
+ </li>
131
+ <li>pulse_rate
132
+
133
+ </li>
134
+ <li>psname
135
+
136
+ </li>
137
+ <li>debug
138
+
139
+ </li>
140
+ </ul>
141
+
142
+ </div>
143
+
144
+
145
+
146
+
147
+
148
+
149
+
150
+
151
+ </div>
152
+
153
+
154
+
155
+ <!-- if includes -->
156
+
157
+
158
+ <!-- if method_list -->
159
+
160
+
161
+ </div>
162
+
163
+
164
+ <div id="validator-badges">
165
+ <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
166
+ </div>
167
+
168
+ </body>
169
+ </html>