Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Do not send an uncaught signal to kill a thread because the signal kills the entire process, not just the individual thread. This rule is a specific instance of recommendation SIG02-C. Avoid using signals to implement normal functionality.

...

Code Block
bgColor#ffcccc
langc

void func(void *foo){
  /* Execution of thread */
}

int main(void) {
  int result;
  pthread_t thread;

  if ((result = pthread_create(&thread, NULL, func, 0)) != 0) {
    /* Handle Error */
  }
  if ((result = pthread_kill(thread, SIGKILL)) != 0) {
    /* Handle Error */
  }

  /* Continue executing until the signal kills the process */

  return 0;
}

...

This compliant code uses instead the pthread_cancel() function to terminate the thread. The thread continues to run until it reaches a cancellation point. See The Open Group Base Specifications Issue 6, IEEE Std 1003.1, 2004 Edition [Open Group 2004] for lists of functions that are required and allowed to be cancellation points. If the cancellation type is set to asynchronous, the thread is terminated immediately. However, POSIX only requires the only the pthread_cancel(), pthread_setcancelstate(), and pthread_setcanceltype() functions to be async-cancel safe. An application that calls other POSIX functions with asynchronous cancellation enabled is non-conformingnonconforming. Consequently, we recommend disallowing asynchronous cancellation, as explained by rule POS47-C. Do not use threads that can be canceled asynchronously.

Code Block
bgColor#ccccff
langc

void func(void *foo) {
  /* Execution of thread */
}

int main(void) {
  int result;
  pthread_t thread;

  if ((result = pthread_create(&thread, NULL, func, 0)) != 0) {
    /* Handle Error */
  }
  if ((result = pthread_cancel(thread)) != 0) {
    /* Handle Error */
  }

  /* Continue executing */

  return 0;
}

...