CertC-CON39¶
Do not join or detach a thread that was previously joined or detached
Required inputs: IR
The C Standard, 7.28.5.6 paragraph 2 [ ISO/IEC 9899:2024 ], states that a thread shall not be joined once it was previously joined or detached.
The termination of the other thread synchronizes with the completion of the thrd_join function. The thread identified by thr shall not have been previously detached or joined with another thread.
Similarly, subclause 7.28.5.3 paragraph 2 [ ISO/IEC 9899:2024 ], states that a thread shall not be detached once it was previously joined or detached.
The thrd_detach function tells the operating system to dispose of any resources allocated to the thread identified by thr when that thread terminates. The thread identified by thr shall not have been previously detached or joined with another thread.
Violating either of these subclauses results in undefined behavior 211 .
Noncompliant Code Example
This noncompliant code example detaches a thread that is later joined.
#include <stddef.h>
#include <threads.h>
int thread_func(void *arg) {
/* Do work */
thrd_detach(thrd_current());
return 0;
}
int main(void) {
thrd_t t;
if (thrd_success != thrd_create(&t, thread_func, NULL)) {
/* Handle error */
return 0;
}
if (thrd_success != thrd_join(t, 0)) {
/* Handle error */
return 0;
}
return 0;
}
|
Compliant Solution
This compliant solution does not detach the thread. Its resources are released upon successfully joining with the main thread:
#include <stddef.h>
#include <threads.h>
int thread_func(void *arg) {
/* Do work */
return 0;
}
int main(void) {
thrd_t t;
if (thrd_success != thrd_create(&t, thread_func, NULL)) {
/* Handle error */
return 0;
}
if (thrd_success != thrd_join(t, 0)) {
/* Handle error */
return 0;
}
return 0;
}
|
Risk Assessment
Joining or detaching a previously joined or detached thread is undefined behavior 211 .
| Rule | Severity | Likelihood | Detectable | Repairable | Priority | Level |
|---|---|---|---|---|---|---|
| CON39-C | Low | Likely | No | No | P3 | L3 |
Bibliography
| [ ISO/IEC 9899:2024 ] | Subclause 7.28.5.3, "The thrd_detach Function"Subclause 7.28.5.6, "The thrd_join Function" |
Possible Messages
Key |
Text |
Severity |
Disabled |
|---|---|---|---|
already_detached |
Target thread is possibly already detached. |
None |
False |
already_joined |
Target thread is possibly already joined. |
None |
False |
Options
This rule shares the following common options: confidence, exclude_in_macros, exclude_messages_in_system_headers, excludes, extend_exclude_to_macro_invocations, includes, justification_checker, languages, post_processing, provider, report_at, severity
The following places define options that affect this rule: Stylechecks, Analysis-GlobalOptions
This rule has no individual options.