pthread_create(3POSIX)

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO

NAME

pthread_create- create a thread

SYNOPSIS

$(OS_DIR)/lib/libpthreads.a
#include <pthread.h>

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

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

DESCRIPTION

The pthread_create() function creates a new thread, with attributes specified by attr, within the current actor. 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. On successful completion, pthread_create() stores the identifier of the created thread in the location referenced by thread.

On creation, the new thread begins executing the function start_routine() with arg as its sole argument. If that function returns, the effect is the same as if the thread had called pthread_exit() using the return value of start_routine() as the exit status.

If pthread_create() fails, no new thread is created, and the contents of the location referenced by thread are undefined.

RETURN VALUE

On successful completion, pthread_create() returns a value of zero. Otherwise, an error code is returned.

---

Note -

This call does not set errno.

---

ERRORS

[EINVAL]

One or more attribute values specified by attr are invalid.

[EAGAIN]

A new thread could not be created because PTHREAD_THREADS_MAX would have been exceeded. Insufficient memory or system resources are available to create a new thread.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

pthread_exit(3POSIX), pthread_join(3POSIX)

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO