pthread_self - Man Page

get the calling thread ID

Prolog

This manual page is part of the POSIX Programmer's Manual. The Linux implementation of this interface may differ (consult the corresponding Linux manual page for details of Linux behavior), or the interface may not be implemented on Linux.

Synopsis

#include <pthread.h>

pthread_t pthread_self(void);

Description

The pthread_self() function shall return the thread ID of the calling thread.

Return Value

The pthread_self() function shall always be successful and no return value is reserved to indicate an error.

Errors

No errors are defined.

The following sections are informative.

Examples

None.

Application Usage

None.

Rationale

The pthread_self() function provides a capability similar to the getpid() function for processes and the rationale is the same: the creation call does not provide the thread ID to the created thread.

Future Directions

None.

See Also

pthread_create(), pthread_equal()

The Base Definitions volume of POSIX.1-2017, <pthread.h>

Referenced By

pthread_equal(3p), pthread.h(0p), pthread_kill(3p).

2017 IEEE/The Open Group POSIX Programmer's Manual