int
pthread_create(
pthread_t * restrict thread
, const pthread_attr_t * restrict attr
, void *(*start_routine)(void *)
, void * restrict arg
)
)
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 attribute object pointed to by
attr
are modified later, the thread's attributes are not affected.
Upon
successful 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:
)
function will return zero.
Otherwise an error number will be returned to
indicate the error.
)
shall fail if:
EAGAIN
]
PTHREAD_THREADS_MAX
would be exceeded.
EINVAL
]
attr
is invalid.
)
conforms to
ISO/IEC 9945-1:1996 (``POSIX.1'') .