Home | History | Annotate | Download | only in Include
      1 /* Static DTrace probes interface */
      2 
      3 #ifndef Py_DTRACE_H
      4 #define Py_DTRACE_H
      5 #ifdef __cplusplus
      6 extern "C" {
      7 #endif
      8 
      9 #ifdef WITH_DTRACE
     10 
     11 #include "pydtrace_probes.h"
     12 
     13 /* pydtrace_probes.h, on systems with DTrace, is auto-generated to include
     14    `PyDTrace_{PROBE}` and `PyDTrace_{PROBE}_ENABLED()` macros for every probe
     15    defined in pydtrace_provider.d.
     16 
     17    Calling these functions must be guarded by a `PyDTrace_{PROBE}_ENABLED()`
     18    check to minimize performance impact when probing is off. For example:
     19 
     20        if (PyDTrace_FUNCTION_ENTRY_ENABLED())
     21            PyDTrace_FUNCTION_ENTRY(f);
     22 */
     23 
     24 #else
     25 
     26 /* Without DTrace, compile to nothing. */
     27 
     28 static inline void PyDTrace_LINE(const char *arg0, const char *arg1, int arg2) {}
     29 static inline void PyDTrace_FUNCTION_ENTRY(const char *arg0, const char *arg1, int arg2)  {}
     30 static inline void PyDTrace_FUNCTION_RETURN(const char *arg0, const char *arg1, int arg2) {}
     31 static inline void PyDTrace_GC_START(int arg0) {}
     32 static inline void PyDTrace_GC_DONE(int arg0) {}
     33 static inline void PyDTrace_INSTANCE_NEW_START(int arg0) {}
     34 static inline void PyDTrace_INSTANCE_NEW_DONE(int arg0) {}
     35 static inline void PyDTrace_INSTANCE_DELETE_START(int arg0) {}
     36 static inline void PyDTrace_INSTANCE_DELETE_DONE(int arg0) {}
     37 
     38 static inline int PyDTrace_LINE_ENABLED(void) { return 0; }
     39 static inline int PyDTrace_FUNCTION_ENTRY_ENABLED(void) { return 0; }
     40 static inline int PyDTrace_FUNCTION_RETURN_ENABLED(void) { return 0; }
     41 static inline int PyDTrace_GC_START_ENABLED(void) { return 0; }
     42 static inline int PyDTrace_GC_DONE_ENABLED(void) { return 0; }
     43 static inline int PyDTrace_INSTANCE_NEW_START_ENABLED(void) { return 0; }
     44 static inline int PyDTrace_INSTANCE_NEW_DONE_ENABLED(void) { return 0; }
     45 static inline int PyDTrace_INSTANCE_DELETE_START_ENABLED(void) { return 0; }
     46 static inline int PyDTrace_INSTANCE_DELETE_DONE_ENABLED(void) { return 0; }
     47 
     48 #endif /* !WITH_DTRACE */
     49 
     50 #ifdef __cplusplus
     51 }
     52 #endif
     53 #endif /* !Py_DTRACE_H */
     54