/usr/include/threadweaver/DebuggingAids.h is in kdelibs5-dev 4:4.8.2-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 | /* -*- C++ -*-
This file declares debugging aids for multithreaded applications.
$ Author: Mirko Boehm $
$ Copyright: (C) 2004, 2005 Mirko Boehm $
$ Contact: mirko@kde.org
http://www.kde.org
http://www.hackerbuero.org $
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library 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
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
$Id: DebuggingAids.h 30 2005-08-16 16:16:04Z mirko $
*/
//krazy:excludeall=inline
#ifndef DEBUGGINGAIDS_H
#define DEBUGGINGAIDS_H
#include <QtCore/QtGlobal>
extern "C"
{
#include <stdarg.h>
#ifndef Q_WS_WIN
#include <unistd.h>
#endif
#include <stdio.h>
#include <stdlib.h>
#include <assert.h>
}
#include <QtCore/QMutex>
#include <QtCore/QString>
#include "threadweaver/threadweaver_export.h"
namespace ThreadWeaver {
extern THREADWEAVER_EXPORT bool Debug;
extern THREADWEAVER_EXPORT int DebugLevel;
extern THREADWEAVER_EXPORT QMutex GlobalMutex;
/** Set the debug log level.
@see debug
*/
extern inline void setDebugLevel (bool debug, int level);
/** This method prints a text message on the screen, if debugging is
enabled. Otherwise, it does nothing. The message is thread safe,
therefore providing that the messages appear in the order they where
issued by the different threads.
All messages are suppressed when Debug is false. All messages with a
lower importance (higher number) than DebugLevel will be suppressed,
too. Debug level 0 messages will always be printed as long as
Debug is true.
We use our own debugging method, since debugging threads is a more
complicated experience than debugging single threaded
contexts. This might change in future in the way that debug
prints its messages to another logging facility provided by
the platform.
Use setDebugLevel () to integrate adapt debug () to your platform.
*/
inline void debug(int severity, const char * cformat, ...)
#ifdef __GNUC__
__attribute__ ( (format (printf, 2, 3 ) ) )
#endif
;
/** Prints the message to the console if condition is true. */
inline void debug(bool condition, int severity, const char * cformat, ...)
#ifdef __GNUC__
__attribute__ ( (format (printf, 3, 4 ) ) )
#endif
;
/** PROTECT executes x with GlobalMutex locked.
Mostly used for debugging, as in P_ASSERT. */
#ifdef PROTECT
#undef PROTECT
#endif
#define PROTECT(x) do { QMutexLocker l(&ThreadWeaver::GlobalMutex); (x); } while (0)
/** P_ASSERT ensures that error messages occur in the correct order. */
#ifdef P_ASSERT
#undef P_ASSERT
#endif
#define P_ASSERT(x) do { QMutexLocker l(&ThreadWeaver::GlobalMutex); Q_ASSERT(x); } while (0)
inline void setDebugLevel (bool debug, int level)
{
Debug = debug;
DebugLevel = level;
}
#ifndef QT_NO_DEBUG
inline void debug(int severity, const char * cformat, ...)
{
if ( Debug == true && ( severity<=DebugLevel || severity == 0) )
{
QString text;
va_list ap;
va_start( ap, cformat );
PROTECT (vprintf (cformat, ap));
va_end (ap);
}
}
inline void debug(bool condition, int severity, const char *cformat, ...)
{
if (condition && Debug == true && ( severity<=DebugLevel || severity == 0) )
{
QString text;
va_list ap;
va_start( ap, cformat );
PROTECT (vprintf (cformat, ap));
va_end (ap);
}
}
#else
inline void debug(int, const char *, ...) {}
inline void debug(bool, int, const char *, ...) {}
#endif
inline bool invariant() { return true; }
#define INVARIANT Q_ASSERT_X (invariant(), __FILE__, "class invariant failed" );
#define REQUIRE(x) \
INVARIANT \
Q_ASSERT_X (x, Q_FUNC_INFO, "unfulfilled requirement " #x );
#define ENSURE(x) \
INVARIANT \
Q_ASSERT_X (x, Q_FUNC_INFO, "broken guarantee " #x );
#ifdef QT_NO_DEBUG
#define DEBUGONLY(x)
#else
#define DEBUGONLY(x) x
#endif
}
#endif // DEBUGGINGAIDS_H
|