Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
RFORK_THREAD(3)		 BSD Library Functions Manual	       RFORK_THREAD(3)

NAME
     rfork_thread -- create a rfork-based process thread

LIBRARY
     Standard C	Library	(libc, -lc)

SYNOPSIS
     #include <unistd.h>

     int
     rfork_thread(int flags, void *stack, int (*func)(void *arg), void *arg);

DESCRIPTION
     rfork_thread() is a helper	function for rfork(2).	It arranges for	a new
     process to	be created and the child process will call the specified func-
     tion with the specified argument, while running on	the supplied stack.

     Using this	function should	avoid the need to implement complex stack swap
     code.

RETURN VALUES
     Upon successful completion, rfork_thread()	returns	the process ID of the
     child process to the parent process.  Otherwise, a	value of -1 is re-
     turned to the parent process, no child process is created,	and the	global
     variable errno is set to indicate the error.

     The child process context is not aware of a return	from the
     rfork_thread() function as	it begins executing directly with the supplied
     function.

ERRORS
     See rfork(2) for error return codes.

SEE ALSO
     fork(2), intro(2),	minherit(2), rfork(2), vfork(2)

HISTORY
     The rfork_thread()	function call first appeared in	FreeBSD	4.3.

BSD				 July 29, 2000				   BSD

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=rfork_thread&sektion=3&manpath=FreeBSD+5.0-RELEASE>

home | help