Page History

...

These are typically true when only one thread is waiting. Otherwise, if either doesn't hold, incorrect program behavior may result.

Noncompliant Code Example

This noncompliant example demonstrates a violation of liveness. A lock is held on a shared object list and three threads are started. Two condition predicates, one checking whether the buffer has zero elements and another that checks if the buffer is full with ten elements, have been used. Initially the buffer is neither full nor empty. Conditions are created so that first the buffer becomes empty and thread 1 goes into wait state, followed by thread 2.

...

Code Block

bgColor	#FFcccc

import java.util.LinkedList;
import java.io.IOException;

public class MissedSignal implements Runnable{
  private static LinkedList list = new LinkedList();
  private static int buffer_count = 5;
  private int number;      //selects function based on thread number	
        
  public MissedSignal(int number) {
    this.number = number;
  }
        
  public  void run (){
    synchronized(list) {
      try {
            if(number == 1) {	  
              System.out.println("Thread 1 started..."); 
              while(buffer_count == 0) { 
      	        System.out.println("Beginning wait() Thread 1...");	
      	        list.wait();		  
      	        System.out.println("Thread 1 got notified this time...");
      	    }  
      	    System.out.println("Exiting because Thread 1 condition is false...");	
      	  }  
      	  else if(number == 2) {  	    		  
      	    System.out.println("Thread 2...");
      	    while(buffer_count > 0) {	
      	      System.out.println("Beginning wait() Thread 2...");	
      	      list.wait();   	    		    	  
      	      System.out.println("Thread 2 got notified this time...");
      	    }
      	    System.out.println("Exiting because the thread 2 condition is false...");
      	  }
      	  else if(number == 3) {
      	    Thread.sleep(2000);	   		    			   
            list.notify();      	   		  
          } 	    	  
      }catch (InterruptedException ie) {ie.printStackTrace(); }
    }	  
  }

  public static void makeThread1True() {
    buffer_count = 0;
  }
        
  public static void makeThread2True() {
    buffer_count = 10;
  }
        
  public static void main(String[] args) throws IOException {
    makeThread1True();
    Runnable runnable1 = new MissedSignal(1);
    Thread t1 = new Thread(runnable1);
    t1.start();
  		  
    try {
  	  new Thread().sleep(5000);
	  makeThread2True();
    } catch (InterruptedException e) { e.printStackTrace(); }
  		   
    Runnable runnable2 = new MissedSignal(2);
    Thread t2 = new Thread(runnable2);
    t2.start();
  		  
    Runnable runnable3 = new MissedSignal(3);
    Thread t3 = new Thread(runnable3);
    t3.start();
  }
}

Compliant Solution

This compliant solution uses notifyAll() which sends notifications to all threads that wait on the same object. As a result, liveness is not affected unlike the noncompliant example. Ensure that the lock is released promptly after the call to notifyAll().

Code Block

bgColor	#ccccff

else if(number == 3) {
  Thread.sleep(2000);	   		    			   
  list.notifyAll();      	   		  
}

Risk Assessment

To guarantee the liveness of a system, the method notifyAll() should be called rather than notify().

Rule	Severity	Likelihood	Remediation Cost	Priority	Level
CON32-J	low	unlikely	medium	P2	L3

Automated Detection

TODO

Related Vulnerabilities

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

References

Wiki Markup

\[[JLS 05|AA. Java References#JLS 05]\] [Chapter 17, Threads and Locks|http://java.sun.com/docs/books/jls/third_edition/html/memory.html]
\[[Goetz 06|AA. Java References#Goetz 06]\] Section 14.2.4, Notification
\[[Bloch 01|AA. Java References#Bloch 01]\] Item 50: Never invoke wait outside a loop

...

Space shortcuts

Page tree

Versions Compared

Old Version 13

New Version 14

Key