*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->OpenBSD man pages -> pthread_create (3)              



NAME    [Toc]    [Back]

     pthread_create - create a new thread

SYNOPSIS    [Toc]    [Back]

     #include <pthread.h>

     pthread_create(pthread_t   *thread,   const   pthread_attr_t
             void *(*start_routine)(void *), void *arg);

DESCRIPTION    [Toc]    [Back]

     The  pthread_create()  function  is  used  to  create  a new
thread, with attributes
 specified by attr, within a process.   If  attr  is
NULL, the default
  attributes  are  used. If the attributes specified by
attr are modified
 later, the thread's attributes are not affected.   Upon
     completion pthread_create() will store the ID of the created
thread in
     the location specified by thread.

     The thread is created executing start_routine  with  arg  as
its sole argument.
   If  the  start_routine  returns, the effect is as if
there was an implicit
 call to pthread_exit()  using  the  return  value  of
start_routine as
     the  exit  status.  Note that the thread in which main() was
originally invoked
 differs from this.  When it returns from  main(),  the
effect is as
     if  there  was  an  implicit call to exit() using the return
value of main()
     as the exit status.

     The signal state of the new thread is initialized as:

           +o   The signal mask is  inherited  from  the  creating

           +o    The  set of signals pending for the new thread is

RETURN VALUES    [Toc]    [Back]

     If successful, the pthread_create() function will return zero.  Otherwise
     an error number will be returned to indicate the error.

ERRORS    [Toc]    [Back]

     pthread_create() will fail if:

     [EAGAIN]       The  system lacked the necessary resources to
create another
                   thread, or the system-imposed limit on the total number of
                   threads  in  a  process  [PTHREAD_THREADS_MAX]
would be exceeded.

     [EINVAL]      The value specified by attr is invalid.

SEE ALSO    [Toc]    [Back]

     fork(2),    pthread_attr_init(3),    pthread_attr_setdetachstate(3),
     pthread_attr_setstackaddr(3), pthread_attr_setstacksize(3),
     pthread_cleanup_pop(3), pthread_cleanup_push(3), pthread_exit(3),

STANDARDS    [Toc]    [Back]

     pthread_create()    conforms    to    ISO/IEC    9945-1:1996

OpenBSD      3.6                           April      4,     1996
[ Back ]
 Similar pages
Name OS Title
pthread_create IRIX create and start a thread
rfork_thread FreeBSD create a rfork-based process thread
pthread_setspecific Tru64 Sets the thread-specific data value associated with the specified key for the current thread
pthread_cancel Tru64 Allows a thread to request a thread to terminate execution
pthread_join Tru64 Causes the calling thread to wait for the termination of the specified thread
pthread_getname_np Tru64 Obtain the object name from the thread object of an existing thread
pthread_setname_np Tru64 Changes the object name in the thread object for an existing thread
pthread_equal Tru64 Compares one thread identifier to another thread identifier
pthread_set_name_np FreeBSD set the thread name
pthread_set_name_np OpenBSD set the name of a thread
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service