betz Thu Aug 1 19:05:27 2002 EDT
Added files:
/phpdoc/en/reference/pcntl constants.xml
Modified files:
/phpdoc/en/reference/pcntl reference.xml
Log:
new structure applied and constants added
Index: phpdoc/en/reference/pcntl/reference.xml
diff -u phpdoc/en/reference/pcntl/reference.xml:1.2
phpdoc/en/reference/pcntl/reference.xml:1.3
--- phpdoc/en/reference/pcntl/reference.xml:1.2 Mon Apr 15 17:57:12 2002
+++ phpdoc/en/reference/pcntl/reference.xml Thu Aug 1 19:05:27 2002
@@ -1,112 +1,65 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<reference id="ref.pcntl">
<title>Process Control Functions</title>
<titleabbrev>PCNTL</titleabbrev>
+
<partintro>
- <para>
- Process Control support in PHP implements the Unix style of
- process creation, program execution, signal handling and process
- termination. Process Control should not be enabled within a
- webserver environment and unexpected results may happen if any
- Process Control functions are used within a webserver environment.
- </para>
- <para>
- This documentation is intended to explain the general usage of
- each of the Process Control functions. For detailed information
- about Unix process control you are encouraged to consult your
- systems documentation including fork(2), waitpid(2) and signal(2)
- or a comprehensive reference such as Advanced Programming in the
- UNIX Environment by W. Richard Stevens (Addison-Wesley).
- </para>
- <para>
- Process Control support in PHP is not enabled by default. You
- will need to use the <link
- linkend="install.configure.enable-pcntl">--enable-pcntl</link>
- configuration option when compiling PHP to enable Process Control
- support.
- </para>
- <note>
+ <section id="pcntl.intro">
+ &reftitle.intro;
<para>
- Currently, this module will not function on non-Unix platforms
- (Windows).
+ Process Control support in PHP implements the Unix style of
+ process creation, program execution, signal handling and process
+ termination. Process Control should not be enabled within a
+ webserver environment and unexpected results may happen if any
+ Process Control functions are used within a webserver environment.
</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
- of the default behavior of these signals.
- <table>
- <title>Supported Signals</title>
- <tgroup cols="2">
- <tbody>
- <row>
- <entry><literal>SIGFPE</literal></entry>
- <entry><literal>SIGCONT</literal></entry>
- <entry><literal>SIGKILL</literal></entry>
- </row>
- <row>
- <entry><literal>SIGSTOP</literal></entry>
- <entry><literal>SIGUSR1</literal></entry>
- <entry><literal>SIGTSTP</literal></entry>
- </row>
- <row>
- <entry><literal>SIGHUP</literal></entry>
- <entry><literal>SIGUSR2</literal></entry>
- <entry><literal>SIGTTIN</literal></entry>
- </row>
- <row>
- <entry><literal>SIGINT</literal></entry>
- <entry><literal>SIGSEGV</literal></entry>
- <entry><literal>SIGTTOU</literal></entry>
- </row>
- <row>
- <entry><literal>SIGQUIT</literal></entry>
- <entry><literal>SIGPIPE</literal></entry>
- <entry><literal>SIGURG</literal></entry>
- </row>
- <row>
- <entry><literal>SIGILL</literal></entry>
- <entry><literal>SIGALRM</literal></entry>
- <entry><literal>SIGXCPU</literal></entry>
- </row>
- <row>
- <entry><literal>SIGTRAP</literal></entry>
- <entry><literal>SIGTERM</literal></entry>
- <entry><literal>SIGXFSZ</literal></entry>
- </row>
- <row>
- <entry><literal>SIGABRT</literal></entry>
- <entry><literal>SIGSTKFLT</literal></entry>
- <entry><literal>SIGVTALRM</literal></entry>
- </row>
- <row>
- <entry><literal>SIGIOT</literal></entry>
- <entry><literal>SIGCHLD</literal></entry>
- <entry><literal>SIGPROF</literal></entry>
- </row>
- <row>
- <entry><literal>SIGBUS</literal></entry>
- <entry><literal>SIGCLD</literal></entry>
- <entry><literal>SIGWINCH</literal></entry>
- </row>
- <row>
- <entry><literal>SIGPOLL</literal></entry>
- <entry><literal>SIGIO</literal></entry>
- <entry><literal>SIGPWR</literal></entry>
- </row>
- <row>
- <entry><literal>SIGSYS</literal></entry>
- <entry><literal></literal></entry>
- <entry><literal></literal></entry>
- </row>
- </tbody>
- </tgroup>
- </table>
+ <para>
+ This documentation is intended to explain the general usage of
+ each of the Process Control functions. For detailed information
+ about Unix process control you are encouraged to consult your
+ systems documentation including fork(2), waitpid(2) and signal(2)
+ or a comprehensive reference such as Advanced Programming in the
+ UNIX Environment by W. Richard Stevens (Addison-Wesley).
</para>
+ </section>
+
+ <section id="pcntl.requirenments">
+ &reftitle.required;
+ &no.requirement;
+ </section>
+
+ <section id="pcntl.installation">
+ &reftitle.install;
+ <para>
+ Process Control support in PHP is not enabled by default. You will need
+ to use the <link
+ linkend="install.configure.enable-pcntl">--enable-pcntl</link>
+ 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>
+ </section>
+
+ <section id="pcntl.configuration">
+ &reftitle.runtime;
+ &no.config;
+ </section>
+
+ <section id="pcntl.resources">
+ &reftitle.resources;
+ &no.resource;
+ </section>
+
+ &reference.pcntl.constants;
- <section id="pcntl-example">
- <title>Process Control Example</title>
+ <section id="pcntl.example">
+ &reftitle.examples;
<para>
This example forks off a daemon process with a signal handler.
</para>
@@ -162,6 +115,16 @@
</programlisting>
</example>
</section>
+
+ <section id="pcntl.seealso">
+ &reftitle.seealso;
+ <para>
+ A look at the section about
+ <link linkend="ref.posix">POSIX functions</link>
+ may be useful.
+ </para>
+ </section>
+
</partintro>
&reference.pcntl.functions;
Index: phpdoc/en/reference/pcntl/constants.xml
+++ phpdoc/en/reference/pcntl/constants.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<section id="pcntl.constants">
&reftitle.constants;
<para>
The following list of signals are supported by the Process Control
functions. Please see your systems signal(7) man page for details
of the default behavior of these signals.
</para>
<variablelist>
<varlistentry>
<term>
<constant>WNOHANG</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>WUNTRACED</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIG_IGN</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIG_DFL</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIG_ERR</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGHUP</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGINT</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGQUIT</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGILL</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGTRAP</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGABRT</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGIOT</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGBUS</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGFPE</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGKILL</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGUSR1</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGSEGV</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGUSR2</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGPIPE</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGALRM</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGTERM</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGSTKFLT</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGCLD</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGCHLD</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGCONT</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGSTOP</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGTSTP</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGTTIN</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGTTOU</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGURG</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGXCPU</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGXFSZ</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGVTALRM</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGPROF</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGWINCH</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGPOLL</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGIO</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGPWR</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGSYS</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>SIGBABY</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
