// OpenSTA, Static Timing Analyzer // Copyright (c) 2020, Parallax Software, Inc. // // This program is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with this program. If not, see . #pragma once #include #include "Machine.hh" #include "DisallowCopyAssign.hh" #include "Map.hh" #include "StringUtil.hh" namespace sta { class Report; class Pin; // Flag that is set when any debug mode is enabled. // Debug macros bypass Debug::check map lookup unless some debug mode // is enabled. extern bool debug_on; typedef Map DebugMap; class Debug { public: explicit Debug(Report *&report); ~Debug(); bool check(const char *what, int level) const; int level(const char *what); void setLevel(const char *what, int level); int statsLevel() const { return stats_level_; } void print(const char *fmt, ...) const __attribute__((format (printf, 2, 3))); protected: Report *&report_; DebugMap *debug_map_; int stats_level_; private: DISALLOW_COPY_AND_ASSIGN(Debug); }; // Low overhead predicate. inline bool debugCheck(const Debug *debug, const char *what, int level) { return debug_on && debug->check(what, level); } // Inlining a varargs function would eval the args, which can // be expensive, so use macros. #define debugPrint0(debug, what, level, msg) \ if (sta::debug_on && debug->check(what, level)) { \ debug->print("%s: %s", what, msg); \ } #define debugPrint1(debug, what, level, fmt, arg1) \ if (sta::debug_on && debug->check(what, level)) { \ debug->print("%s: ", what); \ debug->print(fmt, arg1); \ } #define debugPrint2(debug, what, level, fmt, arg1, arg2) \ if (sta::debug_on && debug->check(what, level)) { \ debug->print("%s: ", what); \ debug->print(fmt, arg1, arg2); \ } #define debugPrint3(debug, what, level, fmt, arg1, arg2, arg3) \ if (sta::debug_on && debug->check(what, level)) { \ debug->print("%s: ", what); \ debug->print(fmt, arg1, arg2, arg3); \ } #define debugPrint4(debug, what, level, fmt, arg1, arg2, arg3, arg4) \ if (sta::debug_on && debug->check(what, level)) { \ debug->print("%s: ", what); \ debug->print(fmt, arg1, arg2, arg3, arg4); \ } #define debugPrint5(debug, what, level, fmt, arg1, arg2, arg3, arg4, arg5) \ if (sta::debug_on && debug->check(what, level)) { \ debug->print("%s: ", what); \ debug->print(fmt, arg1, arg2, arg3, arg4, arg5); \ } #define debugPrint6(debug,what,level,fmt,arg1,arg2,arg3,arg4,arg5,arg6) \ if (sta::debug_on && debug->check(what, level)) { \ debug->print("%s: ", what); \ debug->print(fmt, arg1, arg2, arg3, arg4, arg5, arg6); \ } #define debugPrint7(debug,what,level,fmt,arg1,arg2,arg3,arg4,arg5,arg6,arg7) \ if (sta::debug_on && debug->check(what, level)) { \ debug->print("%s: ", what); \ debug->print(fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7); \ } #define debugPrint8(debug,what,level,fmt,arg1,arg2,arg3,arg4,arg5,arg6,arg7,arg8) \ if (sta::debug_on && debug->check(what, level)) { \ debug->print("%s: ", what); \ debug->print(fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8); \ } #define debugPrint9(debug,what,level,fmt,arg1,arg2,arg3,arg4,arg5,arg6,arg7,arg8,arg9) \ if (sta::debug_on && debug->check(what, level)) { \ debug->print("%s: ", what); \ debug->print(fmt, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9); \ } } // namespace