2 * Copyright (C) 2014, United States Government, as represented by the
3 * Administrator of the National Aeronautics and Space Administration.
6 * The Java Pathfinder core (jpf-core) platform is licensed under the
7 * Apache License, Version 2.0 (the "License"); you may not use this file except
8 * in compliance with the License. You may obtain a copy of the License at
10 * http://www.apache.org/licenses/LICENSE-2.0.
12 * Unless required by applicable law or agreed to in writing, software
13 * distributed under the License is distributed on an "AS IS" BASIS,
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 * See the License for the specific language governing permissions and
16 * limitations under the License.
18 package gov.nasa.jpf.listener;
20 import gov.nasa.jpf.Config;
21 import gov.nasa.jpf.JPF;
22 import gov.nasa.jpf.ListenerAdapter;
23 import gov.nasa.jpf.search.Search;
24 import gov.nasa.jpf.jvm.bytecode.*;
25 import gov.nasa.jpf.vm.*;
26 import gov.nasa.jpf.vm.bytecode.LocalVariableInstruction;
27 import gov.nasa.jpf.vm.bytecode.ReadInstruction;
28 import gov.nasa.jpf.vm.bytecode.StoreInstruction;
29 import gov.nasa.jpf.vm.bytecode.WriteInstruction;
31 import java.io.PrintWriter;
36 * Listener using data flow analysis to find conflicts between smartApps.
39 public class ConflictTracker extends ListenerAdapter {
41 private final PrintWriter out;
42 private final HashSet<String> conflictSet = new HashSet<String>(); // Variables we want to track
43 private final HashSet<String> appSet = new HashSet<String>(); // Apps we want to find their conflicts
44 private final HashSet<String> manualSet = new HashSet<String>(); // Writer classes with manual inputs to detect direct-direct(No Conflict) interactions
45 private final HashMap<Integer, Node> nodes = new HashMap<Integer, Node>(); // Nodes of a graph
46 private ArrayList<NameValuePair> tempSetSet = new ArrayList<NameValuePair>();
48 private long startTime;
49 private Node parentNode = new Node(-2);
50 private String operation;
51 private String detail;
52 private String errorMessage;
55 private boolean conflictFound = false;
56 private boolean manual = false;
58 private final String SET_LOCATION_METHOD = "setLocationMode";
59 private final String LOCATION_VAR = "locationMode";
61 public ConflictTracker(Config config, JPF jpf) {
62 out = new PrintWriter(System.out, true);
64 String[] conflictVars = config.getStringArray("variables");
65 // We are not tracking anything if it is null
66 if (conflictVars != null) {
67 for (String var : conflictVars) {
71 String[] apps = config.getStringArray("apps");
72 // We are not tracking anything if it is null
74 for (String var : apps) {
78 String[] manualClasses = config.getStringArray("manualClasses");
79 // We are not tracking anything if it is null
80 if (manualClasses != null) {
81 for (String var : manualClasses) {
86 // Timeout input from config is in minutes, so we need to convert into millis
87 timeout = config.getInt("timeout", 0) * 60 * 1000;
88 startTime = System.currentTimeMillis();
91 boolean propagateTheChange(Node currentNode) {
92 HashSet<Node> changed = new HashSet<Node>(currentNode.getSuccessors());
94 while(!changed.isEmpty()) {
95 // Get the first element of HashSet and remove it from the changed set
96 Node nodeToProcess = changed.iterator().next();
97 changed.remove(nodeToProcess);
100 boolean isChanged = updateEdge(currentNode, nodeToProcess);
102 // Check for a conflict in this transition(currentNode -> nodeToProcess)
103 if (checkForConflict(nodeToProcess))
106 // Checking if the out set has changed or not(Add its successors to the change list!)
108 propagateTheChange(nodeToProcess);
115 String createErrorMessage(NameValuePair pair, HashMap<String, String> valueMap, HashMap<String, Integer> writerMap) {
116 String message = "Conflict found between the two apps. App"+pair.getAppNum()+
117 " has written the value: "+pair.getValue()+
118 " to the variable: "+pair.getVarName()+" while App"+
119 writerMap.get(pair.getVarName())+" is overwriting the value: "
120 +valueMap.get(pair.getVarName())+" to the same variable!";
121 System.out.println(message);
125 boolean checkForConflict(Node nodeToProcess) {
126 HashMap<String, String> valueMap = new HashMap<String, String>(); // HashMap from varName to value
127 HashMap<String, Integer> writerMap = new HashMap<String, Integer>(); // HashMap from varName to appNum
129 // Update the valueMap
130 for (int i = 0;i < nodeToProcess.getSetSet().size();i++) {
131 NameValuePair nameValuePair = nodeToProcess.getSetSet().get(i);
133 if (valueMap.containsKey(nameValuePair.getVarName())) {
134 // Check if we have a same writer
135 if (!writerMap.get(nameValuePair.getVarName()).equals(nameValuePair.getAppNum())) {
136 // Check if we have a conflict or not
137 if (!valueMap.get(nameValuePair.getVarName()).equals(nameValuePair.getValue())) {
138 errorMessage = createErrorMessage(nameValuePair, valueMap, writerMap);
140 } else { // We have two writers writing the same value
141 writerMap.put(nameValuePair.getVarName(), 3); // 3 represents both apps
144 // Check if we have more than one value with the same writer
145 if (!valueMap.get(nameValuePair.getVarName()).equals(nameValuePair.getValue())) {
146 valueMap.put(nameValuePair.getVarName(), "twoValue"); // We have one writer writing more than one value in a same event
150 valueMap.put(nameValuePair.getVarName(), nameValuePair.getValue());
151 writerMap.put(nameValuePair.getVarName(), nameValuePair.getAppNum());
155 // Comparing the outSet to setSet
156 for (NameValuePair i : nodeToProcess.getOutSet()) {
157 if (valueMap.containsKey(i.getVarName())) {
158 String value = valueMap.get(i.getVarName());
159 Integer writer = writerMap.get(i.getVarName());
160 if ((value != null)&&(writer != null)) {
161 if (!value.equals(i.getValue())&&!writer.equals(i.getAppNum())) { // We have different values
162 errorMessage = createErrorMessage(i, valueMap, writerMap);
172 boolean updateEdge(Node parentNode, Node currentNode) {
173 ArrayList<NameValuePair> setSet = currentNode.getSetSetMap().get(parentNode);
174 HashSet<String> updatedVarNames = new HashSet<String>();
175 boolean isChanged = false;
177 if (setSet != null) {
178 for (int i = 0;i < setSet.size();i++) {
179 updatedVarNames.add(setSet.get(i).getVarName());
183 for (NameValuePair i : parentNode.getOutSet()) {
184 if (!updatedVarNames.contains(i.getVarName()))
185 isChanged |= currentNode.getOutSet().add(i);
188 if (setSet != null) {
189 for (int i = 0;i < setSet.size();i++) {
190 if (currentNode.getOutSet().contains(setSet.get(i)))
191 currentNode.getOutSet().remove(setSet.get(i));
192 isChanged |= currentNode.getOutSet().add(setSet.get(i));
201 HashSet<Node> predecessors = new HashSet<Node>();
202 HashSet<Node> successors = new HashSet<Node>();
203 HashSet<NameValuePair> outSet = new HashSet<NameValuePair>();
204 HashMap<Node, ArrayList<NameValuePair>> setSetMap = new HashMap<Node, ArrayList<NameValuePair>>();
205 ArrayList<NameValuePair> setSet = new ArrayList<NameValuePair>();
212 void addPredecessor(Node node) {
213 predecessors.add(node);
216 void addSuccessor(Node node) {
217 successors.add(node);
220 void setSetSet(ArrayList<NameValuePair> setSet, boolean isManual) {
222 this.setSet = new ArrayList<NameValuePair>();
224 for (int i = 0;i < setSet.size();i++) {
225 this.setSet.add(new NameValuePair(setSet.get(i).getAppNum(), setSet.get(i).getValue(),
226 setSet.get(i).getVarName(), setSet.get(i).getIsManual()));
234 HashSet<Node> getPredecessors() {
238 HashSet<Node> getSuccessors() {
242 ArrayList<NameValuePair> getSetSet() {
246 HashSet<NameValuePair> getOutSet() {
250 HashMap<Node, ArrayList<NameValuePair>> getSetSetMap() {
255 static class NameValuePair {
261 NameValuePair(Integer appNum, String value, String varName, boolean isManual) {
262 this.appNum = appNum;
264 this.varName = varName;
265 this.isManual = isManual;
268 void setAppNum(Integer appNum) {
269 this.appNum = appNum;
272 void setValue(String value) {
276 void setVarName(String varName) {
277 this.varName = varName;
280 void setIsManual(String varName) {
281 this.isManual = isManual;
284 Integer getAppNum() {
292 String getVarName() {
296 boolean getIsManual() {
301 public boolean equals(Object o) {
302 if (o instanceof NameValuePair) {
303 NameValuePair other = (NameValuePair) o;
304 if (varName.equals(other.getVarName()))
305 return appNum.equals(other.getAppNum());
311 public int hashCode() {
312 return appNum.hashCode() * 31 + varName.hashCode();
317 public void stateRestored(Search search) {
318 id = search.getStateId();
319 depth = search.getDepth();
320 operation = "restored";
323 out.println("The state is restored to state with id: "+id+", depth: "+depth);
325 // Update the parent node
326 if (nodes.containsKey(id)) {
327 parentNode = nodes.get(id);
329 parentNode = new Node(id);
334 public void searchStarted(Search search) {
335 out.println("----------------------------------- search started");
340 public void stateAdvanced(Search search) {
341 String theEnd = null;
342 id = search.getStateId();
343 depth = search.getDepth();
344 operation = "forward";
346 // Add the node to the list of nodes
347 if (nodes.get(id) == null)
348 nodes.put(id, new Node(id));
350 Node currentNode = nodes.get(id);
352 // Update the setSet for this new node
353 currentNode.setSetSet(tempSetSet, manual);
354 tempSetSet = new ArrayList<NameValuePair>();
357 if (search.isNewState()) {
363 if (search.isEndState()) {
364 out.println("This is the last state!");
368 out.println("The state is forwarded to state with id: "+id+", depth: "+depth+" which is "+detail+" state: "+"% "+theEnd);
370 // Updating the predecessors for this node
371 // Check if parent node is already in successors of the current node or not
372 if (!(currentNode.getPredecessors().contains(parentNode)))
373 currentNode.addPredecessor(parentNode);
375 // Update the successors for this node
376 // Check if current node is already in successors of the parent node or not
377 if (!(parentNode.getSuccessors().contains(currentNode)))
378 parentNode.addSuccessor(currentNode);
381 // Update the setSetMap of the current node
382 for (Node i : currentNode.getPredecessors()) {
383 currentNode.getSetSetMap().put(i, i.getSetSet());
386 // Update the edge and check if the outset of the current node is changed or not to propagate the change
387 boolean isChanged = updateEdge(parentNode, currentNode);
389 // Check for the conflict in this edge
390 conflictFound = checkForConflict(currentNode);
392 // Check if the outSet of this state has changed, update all of its successors' sets if any
394 conflictFound = conflictFound || propagateTheChange(currentNode);
396 // Update the parent node
397 if (nodes.containsKey(id)) {
398 parentNode = nodes.get(id);
400 parentNode = new Node(id);
405 public void stateBacktracked(Search search) {
406 id = search.getStateId();
407 depth = search.getDepth();
408 operation = "backtrack";
411 out.println("The state is backtracked to state with id: "+id+", depth: "+depth);
413 // Update the parent node
414 if (nodes.containsKey(id)) {
415 parentNode = nodes.get(id);
417 parentNode = new Node(id);
422 public void searchFinished(Search search) {
423 out.println("----------------------------------- search finished");
426 private String getValue(ThreadInfo ti, Instruction inst, byte type) {
430 frame = ti.getTopFrame();
432 if ((inst instanceof JVMLocalVariableInstruction) ||
433 (inst instanceof JVMFieldInstruction))
435 if (frame.getTopPos() < 0)
439 hi = frame.getTopPos() >= 1 ? frame.peek(1) : 0;
441 return(decodeValue(type, lo, hi));
444 if (inst instanceof JVMArrayElementInstruction)
445 return(getArrayValue(ti, type));
450 private final static String decodeValue(byte type, int lo, int hi) {
452 case Types.T_ARRAY: return(null);
453 case Types.T_VOID: return(null);
455 case Types.T_BOOLEAN: return(String.valueOf(Types.intToBoolean(lo)));
456 case Types.T_BYTE: return(String.valueOf(lo));
457 case Types.T_CHAR: return(String.valueOf((char) lo));
458 case Types.T_DOUBLE: return(String.valueOf(Types.intsToDouble(lo, hi)));
459 case Types.T_FLOAT: return(String.valueOf(Types.intToFloat(lo)));
460 case Types.T_INT: return(String.valueOf(lo));
461 case Types.T_LONG: return(String.valueOf(Types.intsToLong(lo, hi)));
462 case Types.T_SHORT: return(String.valueOf(lo));
464 case Types.T_REFERENCE:
465 ElementInfo ei = VM.getVM().getHeap().get(lo);
469 ClassInfo ci = ei.getClassInfo();
473 if (ci.getName().equals("java.lang.String"))
474 return('"' + ei.asString() + '"');
476 return(ei.toString());
479 System.err.println("Unknown type: " + type);
484 private String getArrayValue(ThreadInfo ti, byte type) {
488 frame = ti.getTopFrame();
490 hi = frame.getTopPos() >= 1 ? frame.peek(1) : 0;
492 return(decodeValue(type, lo, hi));
495 private byte getType(ThreadInfo ti, Instruction inst) {
500 frame = ti.getTopFrame();
501 if ((frame.getTopPos() >= 0) && (frame.isOperandRef())) {
502 return (Types.T_REFERENCE);
507 if (inst instanceof JVMLocalVariableInstruction) {
508 type = ((JVMLocalVariableInstruction) inst).getLocalVariableType();
509 } else if (inst instanceof JVMFieldInstruction){
510 fi = ((JVMFieldInstruction) inst).getFieldInfo();
514 if (inst instanceof JVMArrayElementInstruction) {
515 return (getTypeFromInstruction(inst));
519 return (Types.T_VOID);
522 return (decodeType(type));
525 private final static byte getTypeFromInstruction(Instruction inst) {
526 if (inst instanceof JVMArrayElementInstruction)
527 return(getTypeFromInstruction((JVMArrayElementInstruction) inst));
529 return(Types.T_VOID);
532 private final static byte decodeType(String type) {
533 if (type.charAt(0) == '?'){
534 return(Types.T_REFERENCE);
536 return Types.getBuiltinType(type);
540 // Find the variable writer
541 // It should be one of the apps listed in the .jpf file
542 private String getWriter(List<StackFrame> sfList, HashSet<String> writerSet) {
543 // Start looking from the top of the stack backward
544 for(int i=sfList.size()-1; i>=0; i--) {
545 MethodInfo mi = sfList.get(i).getMethodInfo();
546 if(!mi.isJPFInternal()) {
547 String method = mi.getStackTraceName();
548 // Check against the writers in the writerSet
549 for(String writer : writerSet) {
550 if (method.contains(writer)) {
560 private void writeWriterAndValue(String writer, String value, String var) {
561 // Update the temporary Set set.
562 NameValuePair temp = new NameValuePair(1, value, var, manual);
563 if (writer.equals("App2"))
564 temp = new NameValuePair(2, value, var, manual);
566 tempSetSet.add(temp);
570 public void instructionExecuted(VM vm, ThreadInfo ti, Instruction nextInsn, Instruction executedInsn) {
572 if (System.currentTimeMillis() - startTime > timeout) {
573 StringBuilder sbTimeOut = new StringBuilder();
574 sbTimeOut.append("Execution timeout: " + (timeout / (60 * 1000)) + " minutes have passed!");
575 Instruction nextIns = ti.createAndThrowException("java.lang.RuntimeException", sbTimeOut.toString());
576 ti.setNextPC(nextIns);
581 StringBuilder sb = new StringBuilder();
582 sb.append(errorMessage);
583 Instruction nextIns = ti.createAndThrowException("java.lang.RuntimeException", sb.toString());
584 ti.setNextPC(nextIns);
586 if (conflictSet.contains(LOCATION_VAR)) {
587 MethodInfo mi = executedInsn.getMethodInfo();
588 // Find the last load before return and get the value here
589 if (mi.getName().equals(SET_LOCATION_METHOD) &&
590 executedInsn instanceof ALOAD && nextInsn instanceof ARETURN) {
591 byte type = getType(ti, executedInsn);
592 String value = getValue(ti, executedInsn, type);
594 // Extract the writer app name
595 ClassInfo ci = mi.getClassInfo();
596 String writer = ci.getName();
598 // Update the temporary Set set.
599 writeWriterAndValue(writer, value, LOCATION_VAR);
602 if (executedInsn instanceof WriteInstruction) {
603 String varId = ((WriteInstruction) executedInsn).getFieldInfo().getFullName();
605 for (String var : conflictSet) {
606 if (varId.contains(var)) {
608 byte type = getType(ti, executedInsn);
609 String value = getValue(ti, executedInsn, type);
610 String writer = getWriter(ti.getStack(), appSet);
611 // Just return if the writer is not one of the listed apps in the .jpf file
615 if (getWriter(ti.getStack(), manualSet) != null)
618 // Update the temporary Set set.
619 writeWriterAndValue(writer, value, var);