[PHP-DOC] cvs: phpdoc /en/functions pcntl.xml From: Jason Greene (jason <email protected>)
Date: 09/30/01

jason Sun Sep 30 04:34:46 2001 EDT

  Modified files:
    /phpdoc/en/functions pcntl.xml
  Log:
  Added not about not supporting Windows
  Removed SIG_ constants from signal list
  Modified pcntl_signal example to be more verbose
  
  
Index: phpdoc/en/functions/pcntl.xml
diff -u phpdoc/en/functions/pcntl.xml:1.4 phpdoc/en/functions/pcntl.xml:1.5
--- phpdoc/en/functions/pcntl.xml:1.4 Fri Sep 28 17:40:05 2001
+++ phpdoc/en/functions/pcntl.xml Sun Sep 30 04:34:46 2001
@@ -1,5 +1,5 @@
 <?xml encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
  <reference id="ref.pcntl">
   <title>Process Control Functions</title>
   <titleabbrev>PCNTL</titleabbrev>
@@ -27,6 +27,12 @@
     configuration option when compiling PHP to enable Process Control
     support.
    </para>
+ <note>
+ <para>
+ Currently, this module will not function on non-Unix platforms
+ (Windows).
+ </para>
+ </note>
    <para>
     The following list of signals are supported by the Process Control
     functions. Please see your systems signal(7) man page for details
@@ -36,17 +42,12 @@
     <tgroup cols="2">
      <tbody>
       <row>
- <entry><literal>SIG_IGN</literal></entry>
        <entry><literal>SIGFPE</literal></entry>
        <entry><literal>SIGCONT</literal></entry>
- </row>
- <row>
- <entry><literal>SIG_DFL</literal></entry>
        <entry><literal>SIGKILL</literal></entry>
- <entry><literal>SIGSTOP</literal></entry>
       </row>
       <row>
- <entry><literal>SIG_ERR</literal></entry>
+ <entry><literal>SIGSTOP</literal></entry>
        <entry><literal>SIGUSR1</literal></entry>
        <entry><literal>SIGTSTP</literal></entry>
       </row>
@@ -243,14 +244,10 @@
     &false; on failure.
    </para>
    <example>
- <title><function>pcntl_fork</function> Example</title>
+ <title><function>pcntl_signal</function> Example</title>
     <programlisting role="php">
 &lt;?php
 
-// setup signal handlers
-pcntl_signal(SIGTERM, "sig_handler");
-pcntl_signal(SIGHUP, "sig_handler");
-
 // signal handler function
 function sig_handler($signo) {
 
@@ -262,11 +259,29 @@
          case SIGHUP:
              // handle restart tasks
              break;
+ case SIGUSR1:
+ print "Caught SIGUSR1...\n";
+ break;
          default:
              // handle all other signals
      }
 
 }
+
+
+print "Installing signal handler...\n";
+
+// setup signal handlers
+pcntl_signal(SIGTERM, "sig_handler");
+pcntl_signal(SIGHUP, "sig_handler");
+pcntl_signal(SIGUSR1, "sig_handler");
+
+print "Generating signal SIGTERM to self...\n";
+
+// send SIGUSR1 to current process id
+posix_kill(posix_getpid(), SIGUSR1);
+
+print "Done\n"
 
 ?&gt;
     </programlisting>