ruby-lsapi 5.8 → 5.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 25bb6c397ec50194cb0b748361b0e84623148ca88803ebd9d5a25ac2d445d367
-  data.tar.gz: 5469a7a000fb7cf30cade06b6e3d5d261bd622719ddfaddc5350e94227edcdf2
+  metadata.gz: f10920844cbc990bc8c86333ae9c906ac69fcf6de5dea66dd2c5aefc5c54dfbb
+  data.tar.gz: 16f8bb6da43c797709294552a7a2c90b159933eecc5481db4af2e69c26a08175
 SHA512:
-  metadata.gz: beea3f11b03496201e142ff6047e55372bf1a819e165a702d2bcd1b25848621681963065ba5b70110d78537b1f0cc94b40cad6615657ab1652c49eda4ae261a3
-  data.tar.gz: afdb209facd04c02ae70a44c0e152073e914adf238955ff243c7d34d753507b56ad18a977d50ad68951016cabbd979fee8065a4b77385542ed8a0e1e12cc012a
+  metadata.gz: 66004fe6644e356b6992e877aaa3d5a6964d271066f50ee9603365b100d5ecb467a69dec5c215e80afb7ca239cb3de21d83a34ffacf21f05addabce381a98a2b
+  data.tar.gz: f1561515cd625f60689a8a55582e430f88e6686b80502d00c44299b7afaa12591bcaa44fbd4e795e71f8893bbb599e4c93740fadd73c761f2feb4ffff5693a7c

data/README

@@ -15,7 +15,8 @@ USAGE
 General CGI scripts
 ^^^^^^^^^^^^^^^^^^^
 The most efficient way to use LSAPI interface is to modify your CGI scripts. 
-You need to add the following code to your CGI scripts:
+For a single-process application (LSAPI_CHILDREN <= 1), add the following
+code to your CGI scripts:
 
   require 'lsapi'
   
@@ -26,6 +27,15 @@ You need to add the following code to your CGI scripts:
 
   end
 
+For self-managed prefork applications, use one of the bundled runners.  They
+load the Ruby application before accepting connections, then use Ruby's fork
+method together with LSAPI.postfork_child and LSAPI.postfork_parent.  This
+preserves copy-on-write sharing without bypassing Ruby's fork hooks.
+
+Ruby LSAPI refuses to start with an effective UID of 0.  The web server must
+select the final application UID before starting Ruby; the runner never starts
+as root and does not perform an in-process UID transition.
+
 There is no need to change the way that how CGI environment variables 
 are being accessed in your scripts.
 
@@ -162,4 +172,3 @@ Copyright
 
 Copyright (C) 2006 Lite Speed Technologies Inc.
 
-

data/examples/lsapi_with_cgi.rb

@@ -3,12 +3,27 @@
 require 'lsapi'
 require 'cgi'
 
-
-while LSAPI.accept != nil
+def handle_request
     cgi = CGI.new
     name = cgi['name']
     puts cgi.header
     puts "Hello #{name}! <br> " if name
     puts "You are from #{cgi.remote_addr}<br>"
+end
 
+if LSAPI.respond_to?("accept_new_connection")
+    while LSAPI.accept_new_connection != nil
+        begin
+            fork do
+                LSAPI.postfork_child
+                handle_request while LSAPI.accept != nil
+            end
+            LSAPI.postfork_parent
+        rescue SystemCallError => e
+            LSAPI.postfork_failed
+            warn "ruby-lsapi: fork failed: #{e.message}"
+        end
+    end
+else
+    handle_request while LSAPI.accept != nil
 end

data/examples/testlsapi.rb

@@ -4,8 +4,25 @@ require 'lsapi'
 
 $count = 0;
 
-while LSAPI.accept != nil
+def handle_request
 	print "HTTP/1.0 200 OK\r\nContent-type: text/html\r\n\r\nHello World! \##{$count}<br>\r\n"
 	ENV.each_pair {|key, value| print "#{key} is #{value}<br>\r\n" }
 	$count = $count + 1
 end
+
+if LSAPI.respond_to?("accept_new_connection")
+    while LSAPI.accept_new_connection != nil
+        begin
+            fork do
+                LSAPI.postfork_child
+                handle_request while LSAPI.accept != nil
+            end
+            LSAPI.postfork_parent
+        rescue SystemCallError => e
+            LSAPI.postfork_failed
+            warn "ruby-lsapi: fork failed: #{e.message}"
+        end
+    end
+else
+    handle_request while LSAPI.accept != nil
+end