php-doc-en/reference/pcntl/functions/pcntl-fork.xml
Hannes Magnusson ba5e388f61 See also to setproctitle
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@310617 c90b9560-bf6c-de11-be94-00142212c4b1
2011-04-28 10:08:02 +00:00

92 lines
2.2 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xml:id="function.pcntl-fork" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>pcntl_fork</refname>
<refpurpose>Forks the currently running process</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>pcntl_fork</methodname>
<void/>
</methodsynopsis>
<para>
The <function>pcntl_fork</function> function creates a child
process that differs from the parent process only in its PID and
PPID. Please see your system's fork(2) man page for specific details as to
how fork works on your system.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
On success, the PID of the child process is returned in the
parent's thread of execution, and a 0 is returned in the child's
thread of execution. On failure, a -1 will be returned in the
parent's context, no child process will be created, and a PHP
error is raised.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>pcntl_fork</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
$pid = pcntl_fork();
if ($pid == -1) {
die('could not fork');
} else if ($pid) {
// we are the parent
pcntl_wait($status); //Protect against Zombie children
} else {
// we are the child
}
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>pcntl_waitpid</function></member>
<member><function>pcntl_signal</function></member>
<member><function>setproctitle</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- 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:"~/.phpdoc/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
-->