-
Notifications
You must be signed in to change notification settings - Fork 0
/
gettid.html
152 lines (112 loc) · 3.97 KB
/
gettid.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
<!-- Creator : groff version 1.22.4 -->
<!-- CreationDate: Wed Jan 29 11:25:44 2020 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; vertical-align: top }
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
h1 { text-align: center }
</style>
<title>GETTID</title>
</head>
<body>
<h1 align="center">GETTID</h1>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#RETURN VALUE">RETURN VALUE</a><br>
<a href="#ERRORS">ERRORS</a><br>
<a href="#VERSIONS">VERSIONS</a><br>
<a href="#CONFORMING TO">CONFORMING TO</a><br>
<a href="#NOTES">NOTES</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<a href="#COLOPHON">COLOPHON</a><br>
<hr>
<h2>NAME
<a name="NAME"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">gettid - get
thread identification</p>
<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>#include
<sys/types.h></b></p>
<p style="margin-left:11%; margin-top: 1em"><b>pid_t
gettid(void);</b></p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>gettid</b>()
returns the caller’s thread ID (TID). In a
single-threaded process, the thread ID is equal to the
process ID (PID, as returned by <b>getpid</b>(2)). In a
multithreaded process, all threads have the same PID, but
each one has a unique TID. For further details, see the
discussion of <b>CLONE_THREAD</b> in <b>clone</b>(2).</p>
<h2>RETURN VALUE
<a name="RETURN VALUE"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">On success,
returns the thread ID of the calling thread.</p>
<h2>ERRORS
<a name="ERRORS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">This call is
always successful.</p>
<h2>VERSIONS
<a name="VERSIONS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The
<b>gettid</b>() system call first appeared on Linux in
kernel 2.4.11. Library support was added in glibc 2.30.
(Earlier glibc versions did not provide a wrapper for this
system call, necessitating the use of
<b>syscall</b>(2).)</p>
<h2>CONFORMING TO
<a name="CONFORMING TO"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>gettid</b>()
is Linux-specific and should not be used in programs that
are intended to be portable.</p>
<h2>NOTES
<a name="NOTES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The thread ID
returned by this call is not the same thing as a POSIX
thread ID (i.e., the opaque value returned by
<b>pthread_self</b>(3)).</p>
<p style="margin-left:11%; margin-top: 1em">In a new thread
group created by a <b>clone</b>(2) call that does not
specify the <b>CLONE_THREAD</b> flag (or, equivalently, a
new process created by <b>fork</b>(2)), the new process is a
thread group leader, and its thread group ID (the value
returned by <b>getpid</b>(2)) is the same as its thread ID
(the value returned by <b>gettid</b>()).</p>
<h2>SEE ALSO
<a name="SEE ALSO"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>capget</b>(2),
<b>clone</b>(2), <b>fcntl</b>(2), <b>fork</b>(2),
<b>getpid</b>(2), <b>get_robust_list</b>(2),
<b>ioprio_set</b>(2), <b>perf_event_open</b>(2),
<b>sched_setaffinity</b>(2), <b>sched_setparam</b>(2),
<b>sched_setscheduler</b>(2), <b>tgkill</b>(2),
<b>timer_create</b>(2)</p>
<h2>COLOPHON
<a name="COLOPHON"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">This page is
part of release 5.02 of the Linux <i>man-pages</i> project.
A description of the project, information about reporting
bugs, and the latest version of this page, can be found at
https://www.kernel.org/doc/man-pages/.</p>
<hr>
</body>
</html>