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"
Excerpt from SEI CERT C Coding Standard: Rules for Developing Safe, Reliable, and Secure Systems (2016 Edition) and SEI CERT C Coding Standard [https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/concurrency-con/con39-c], Copyright (C) 1995-2026 Carnegie Mellon University. See 9.4 3rd-Party Licenses in the documentation for full details.

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