Versions Compared

Key

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

Mutexes are often used to prevent multiple threads from accessing critical causing a data race by accessing shared resources at the same time. Sometimes, when locking mutexes, multiple threads hold each other's lock, and the program consequently deadlocks. There Four conditions are four requirements required for deadlock to occur:

  • Mutual exclusion
  • Hold and wait
  • No preemption
  • Circular wait

Deadlock requires needs all four conditions, so to prevent deadlock, prevent preventing deadlock requires preventing any one of the four conditions. This guideline recommends locking One simple solution is to lock the mutexes in a predefined order to prevent , which prevents circular wait.

Noncompliant Code Example

The following code has behavior that behavior of this noncompliant code example depends on the runtime environment and the platform's scheduler. However, with proper timing, the main() function will deadlock when running thr1 and thr2, where thr1 tries The program is susceptible to deadlock if thread thr1 attempts to lock ba2's mutex , while thr2 tries at the same time thread thr2 attempts to lock ba1's mutex in the deposit() function, and the program will not progress.

Code Block
bgColor#ffcccc
langc
#include <stdlib.h>
#include <threads.h>
 
typedef struct {
  int balance;
  mtx_t balance_mutex;
} bank_account;

typedef struct {
  bank_account *from;
  bank_account *to;
  int amount;
} deposit_thr_argstransaction;

void create_bank_account(bank_account **ba,
                         int initial_amount) {
  int result;
  bank_account *nba = (bank_account *)malloc(
    sizeof(bank_account)
  );
  if (nba == NULL) {
    /* Handle Errorerror */
  }

  nba->balance = initial_amount;
  if (thrd_success
     result != mtx_init(&nba->balance_mutex, mtx_plain);
  if (result == thrd_error) {
    /* Handle error */
  }

  *ba = nba;
}


int deposit(void *ptr) {
  int result;
  deposit_thr_args transaction *args = (deposit_thr_argstransaction *)ptr;

  if ((resultthrd_success != mtx_lock(&(args->from->balance_mutex))) != thrd_success) {
    /* Handle error */
  }

  /* notNot enough balance to transfer */
  if (args->from->balance < args->amount) {
    if ((result thrd_success
        != mtx_unlock(&(args->from->balance_mutex))) != thrd_success) {
      /* Handle error  */
    }
    return -1;  /* Indicate error */
  }

  if ((resultthrd_success != mtx_lock(&(args->to->balance_mutex))) != thrd_success) {
    /* Handle error */
  }

  args->from->balance -= args->amount;
  args->to->balance += args->amount;

  if ((result thrd_success
      != mtx_unlock(&(args->from->balance_mutex))) != thrd_success) {
    /* Handle error */
  }

  if ((result thrd_success
      != mtx_unlock(&(args->to->balance_mutex))) != thrd_success) {
    /* Handle error */
  }

  free(ptr);
  
  return 0;
}


int main(void) {

  pthreadthrd_t thr1, thr2;
  inttransaction result*arg1;
  transaction *arg2;
  bank_account *ba1;
  bank_account *ba2;

  create_bank_account(&ba1, 1000);
  create_bank_account(&ba2, 1000);

  deposit_thr_args *arg1 = (transaction *)malloc(sizeof(deposit_thr_argstransaction));
  if (arg1 == NULL) {
    /* Handle error */
  }
  deposit_thr_args *arg2 = (transaction *)malloc(sizeof(deposit_thr_argstransaction));
  if (arg2 == NULL) {
    /* Handle error */
  }

  arg1->from = ba1;
  arg1->to = ba2;
  arg1->amount = 100;

  arg2->from = ba2;
  arg2->to = ba1;
  arg2->amount = 100;

  /* performPerform the deposits */
  if ((result thrd_success
     != thrd_create(&thr1, deposit, (void *)arg1)) != thrd_success) {
    /* Handle error */
  }
  if ((result thrd_success
      != thrd_create(&thr2, deposit, (void *)arg2)) != thrd_success) {
    /* Handle error */
  }

  return 0;
}
 

Compliant Solution

The This compliant solution to the deadlock problem is to use eliminates the circular wait condition by establishing a predefined order for the locks locking in the deposit() function. In the following compliant solution, each Each thread will lock on the basis of the bank_account ID,  defined in the struct initialization. This solution prevents the circular wait problem:which is set when the bank_account struct is initialized.

Code Block
bgColor#ccccff
langc
#include <stdlib.h>
#include <threads.h>
 
typedef struct {
  int balance;
  mtx_t balance_mutex;
 
  /* Should not change after initialization */
  unsigned int id; /* Should never be changed after initialized */
} bank_account
} bank_account;

typedef struct {
  bank_account *from;
  bank_account *to;
  int amount;
} transaction;

unsigned int global_id = 1;

void create_bank_account(bank_account **ba,
                         int initial_amount) {
  int result;
  bank_account *nba = (bank_account *)malloc(
    sizeof(bank_account)
  );
  if (nba == NULL) {
    /* Handle error */
  }

  nba->balance = initial_amount;
  result if (thrd_success
      != mtx_init(&nba->balance_mutex, mtx_plain);
  if (result != thrd_success) {
    /* Handle error */
  }

  nba->id = global_id++;
  *ba = nba;
}


int deposit(void *ptr) {
  deposit_thr_argstransaction *args = (deposit_thr_argstransaction *)ptr;
  int result = -1;
  mtx_t *first;
  mtx_t *second;

  if (args->from->id == args->to->id)
		 {
    return -1;  /* Indicate error */
  }

  /* Ensure proper ordering for locking */
  if (args->from->id < args->to->id) {
    iffirst ((result = mtx_lock(&(args->from->balance_mutex))) != thrd_success) {;
    second  /* Handle error */= &args->to->balance_mutex;
  } else }{
    if ((resultfirst = mtx_lock(&(args->to->balance_mutex))) != thrd_success) {;
    second  /* Handle error */
    }
  } else {
  = &args->from->balance_mutex;
  }
  if ((resultthrd_success != mtx_lock(&(args->to->balance_mutex))) != thrd_successfirst)) {
      /* Handle error */
    }
    if ((resultthrd_success != mtx_lock(&(args->from->balance_mutexsecond))) != thrd_success) {
      /* Handle error */
    }
  }

  /* notNot enough balance to transfer */
  if (args->from->balance <>= args->amount) {
    if ((result = mtx_unlock(&(args->from->balance_mutex))) != thrd_success) {
      /* Handle error */
    }
    if ((result = mtx_unlock(&(-= args->amount;
    args->to->balance_mutex))) != thrd_success) {
      /* Handle error */
    }
    return -1;  /* Indicate error */
  }

  args->from->balance -= args->amount;
  args->to->balance += args->amount;+= args->amount;
    result = 0;
  }

  if ((resultthrd_success != mtx_unlock(&(args->from->balance_mutex))) != thrd_successsecond)) {
    /* Handle error */
  }
  if ((resultthrd_success != mtx_unlock(&(args->to->balance_mutexfirst))) != thrd_success) {
    /* Handle error */
  }

  free(ptr);

   returnreturn 0result;
}
 

Risk Assessment

Deadlock prevents multiple threads from progressing, thus halting the executing program execution. A denial-of-service attack is possible because if the attacker can force deadlock situations. Deadlock is likely to occur in multithreaded programs that manage multiple shared resources.create the conditions for deadlock.

Rule

Recommendation

Severity

Likelihood

Remediation Cost

Priority

Level

CON35-C

low

Low

probable

Probable

medium

Medium

P4

L3

Related Vulnerabilities

Search for vulnerabilities resulting from the violation of this rule on the CERT website.

Automated Detection

ToolVersionCheckerDescription
Astrée
Include Page
Astrée_V
Astrée_V
deadlockSupported by sound analysis (deadlock alarm)
CodeSonar
Include Page
CodeSonar_V
CodeSonar_V
CONCURRENCY.LOCK.ORDERConflicting lock order
Coverity
Include Page
Coverity_V
Coverity
6.5DEADLOCKFully implemented

...

_V
ORDER_REVERSALFully implemented
Cppcheck Premium

Include Page
Cppcheck Premium_V
Cppcheck Premium_V

premium-cert-con35-cPartially implemented
Helix QAC

Include Page
Helix QAC_V
Helix QAC_V

C1772, C1773
Klocwork
Include Page
Klocwork_V
Klocwork_V

CONC.DL
CONC.NO_UNLOCK


Parasoft C/C++test
Include Page
Parasoft_V
Parasoft_V
CERT_C-CON35-a

Do not acquire locks in different order

PC-lint Plus

Include Page
PC-lint Plus_V
PC-lint Plus_V

2462

Fully supported

Polyspace Bug Finder

Include Page
Polyspace Bug Finder_V
Polyspace Bug Finder_V

CERT C: Rule CON35-C

Checks for deadlock (rule partially covered)

Related Guidelines

Key here (explains table format and definitions)

Bibliography

[Barney 2010]pthread_mutex tutorial
[Bryant 2003]Chapter 13, "Concurrent Programming"
Prior to 2018-01-12: CERT: Unspecified Relationship

   

...

Image Modified Image Modified Image Modified