tau_register_fork(3) [debian man page]

TAU_REGISTER_FORK(3)					      TAU Instrumentation API					      TAU_REGISTER_FORK(3)

NAME

       TAU_REGISTER_FORK - Informs the measurement system that a fork has taken place

SYNOPSIS

       C/C++:

       TAU_REGISTER_FORK(int pid, enum TauFork_t option);

DESCRIPTION

       To register a child process obtained from the fork() syscall, invoke the TAU_REGISTER_FORK macro. It takes two parameters, the first is the
       node id of the child process (typically the process id returned by the fork call or any 0..N-1 range integer). The second parameter
       specifies whether the performance data for the child process should be derived from the parent at the time of fork (
       TAU_INCLUDE_PARENT_DATA ) or should be independent of its parent at the time of fork ( TAU_EXCLUDE_PARENT_DATA ). If the process id is used
       as the node id, before any analysis is done, all profile files should be converted to contiguous node numbers (from 0..N-1). It is highly
       recommended to use flat contiguous node numbers in this call for profiling and tracing.

EXAMPLE

       C/C++ :

       pID = fork();
       if (pID == 0) {
	 printf("Parent : pid returned %d
", pID)
       }  else {
	 // If we'd used the TAU_INCLUDE_PARENT_DATA, we get
	 // the performance data from the parent in this process
	 // as well.
	 TAU_REGISTER_FORK(pID, TAU_EXCLUDE_PARENT_DATA);
	 printf("Child : pid = %d", pID);
       }

								    08/31/2005						      TAU_REGISTER_FORK(3)

fork(2) 							System Calls Manual							   fork(2)

Name
       fork - create a new process

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

       pid = fork()
       pid_t pid;

Description
       The  system  call causes creation of a new process.  The new process (child process) is an exact copy of the calling process except for the
       following:

       o    The child process has a unique process ID.

       o    The child process has a different parent process ID (that is, the process ID of the parent process).

       o    The child process has its own copy of the parent's descriptors.  These descriptors reference the same underlying objects, so that, for
	    instance,  file  pointers  in file objects are shared between the child and the parent, so that a on a descriptor in the child process
	    can affect a subsequent read or write by the parent.  This descriptor copying is also used by the shell to	establish  standard  input
	    and output for newly created processes as well as to set up pipes.

       o    The child processes resource utilizations are set to 0.  For further information, see

Return Values
       Upon  successful  completion,  returns  a  value  of  0	to the child process and returns the process ID of the child process to the parent
       process.  Otherwise, a value of -1 is returned to the parent process, no child process is created, and the global variable errno is set	to
       indicate the error.

Diagnostics
       The system call fails and no child process are created under the following conditions:

       [EAGAIN]       The system-imposed limit {PROC_MAX} on the total number of processes under execution would be exceeded.

       [EAGAIN]       The system-imposed limit {CHILD_MAX} on the total number of processes under execution by a single user would be exceeded.

       [ENOMEM]       There is insufficient swap space for the new process.

See Also
       execve(2), wait(2)

																	   fork(2)