Home | History | Annotate | Download | only in tsan
      1 /* Copyright (c) 2008-2010, Google Inc.
      2  * All rights reserved.
      3  *
      4  * Redistribution and use in source and binary forms, with or without
      5  * modification, are permitted provided that the following conditions are
      6  * met:
      7  *
      8  *     * Redistributions of source code must retain the above copyright
      9  * notice, this list of conditions and the following disclaimer.
     10  *     * Neither the name of Google Inc. nor the names of its
     11  * contributors may be used to endorse or promote products derived from
     12  * this software without specific prior written permission.
     13  *
     14  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     15  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     16  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
     17  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     18  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
     19  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
     20  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
     21  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
     22  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
     24  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     25  */
     26 
     27 // This file is part of ThreadSanitizer, a dynamic data race detector.
     28 // Author: Evgeniy Stepanov.
     29 
     30 // This file contains the parser and matcher for valgrind-compatible
     31 // suppressions. It supports extended suppression syntax, see details at
     32 // http://code.google.com/p/data-race-test/wiki/ThreadSanitizerSuppressions
     33 
     34 #ifndef TSAN_SUPPRESSIONS_H_
     35 #define TSAN_SUPPRESSIONS_H_
     36 
     37 #include "common_util.h"
     38 
     39 class Suppressions {
     40  public:
     41   Suppressions();
     42   ~Suppressions();
     43 
     44   // Read suppressions file from string. May be called several times.
     45   // Return the number of parsed suppressions or -1 if an error occured.
     46   int ReadFromString(const string &str);
     47 
     48   // Returns the string describing the last error. Undefined if there was no
     49   // error.
     50   string GetErrorString();
     51 
     52   // Returns the line number of the last error. Undefined if there was no error.
     53   int GetErrorLineNo();
     54 
     55   // Checks if a given stack trace is suppressed.
     56   bool StackTraceSuppressed(string tool_name, string warning_name,
     57       const vector<string>& function_names_mangled,
     58       const vector<string>& function_names_demangled,
     59       const vector<string>& object_names,
     60       string *name_of_suppression);
     61 
     62  private:
     63   struct SuppressionsRep;
     64   SuppressionsRep* rep_;
     65 };
     66 
     67 #endif  // TSAN_SUPPRESSIONS_H_
     68