pcntl_fork(3) [php man page]

PCNTL_FORK(3)								 1							     PCNTL_FORK(3)

pcntl_fork - Forks the currently running process

SYNOPSIS

       int pcntl_fork (void  )

DESCRIPTION

	The pcntl_fork(3) 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.

RETURN VALUES

	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.

EXAMPLES

       Example #1

	      pcntl_fork(3) example

	      <?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
	      }

	      ?>

SEE ALSO

       pcntl_waitpid(3), pcntl_signal(3), setproctitle(3).

PHP Documentation Group 													     PCNTL_FORK(3)

FORK(2) 						     Linux Programmer's Manual							   FORK(2)

NAME

       fork - create a child process

SYNOPSIS

       #include <sys/types.h>
       #include <unistd.h>

       pid_t fork(void);

DESCRIPTION

       fork  creates a child process that differs from the parent process only in its PID and PPID, and in the fact that resource utilizations are
       set to 0.  File locks and pending signals are not inherited.

       Under Linux, fork is implemented using copy-on-write pages, so the only penalty incurred by fork is the time and memory required to  dupli-
       cate the parent's page tables, and to create a unique task structure for the child.

RETURN VALUE

       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 exe-
       cution.	On failure, a -1 will be returned in the parent's context, no child process will be created, and errno will be set appropriately.

ERRORS

       EAGAIN fork cannot allocate sufficient memory to copy the parent's page tables and allocate a task structure for the child.

       ENOMEM fork failed to allocate the necessary kernel structures because memory is tight.

CONFORMING TO

       The fork call conforms to SVr4, SVID, POSIX, X/OPEN, BSD 4.3.

SEE ALSO

       clone(2), execve(2), vfork(2), wait(2)

Linux 1.2.9							    1995-06-10								   FORK(2)