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
  
// -*- pike -*- 
// 
// Some stuff to do logging of a request through the server. 
// 
// $Id: request_trace.h,v 1.10 2002/03/19 13:27:42 mast Exp $ 
 
#ifndef REQUEST_TRACE_H 
#define REQUEST_TRACE_H 
 
#include <roxen.h> 
#include <module.h> 
 
// Note that TRACE_ENTER and TRACE_LEAVE take html encoded message 
// strings. Messages are preferably a single line, and they should not 
// end with period and/or newline. 
 
#ifdef REQUEST_TRACE 
 
# define TRACE_ENTER(A,B) Roxen->trace_enter (id, (A), (B)) 
# define TRACE_LEAVE(A) Roxen->trace_leave (id, (A)) 
 
#else 
 
# define TRACE_ENTER(A,B) do{ \ 
    function(string,mixed ...:void) _trace_enter; \ 
    if(id && \ 
       (_trace_enter = \ 
        [function(string,mixed ...:void)]([mapping(string:mixed)]id->misc)-> \ 
          trace_enter)) \ 
      _trace_enter((A), (B)); \ 
  }while(0) 
 
# define TRACE_LEAVE(A) do{ \ 
    function(string:void) _trace_leave; \ 
    if(id && \ 
       (_trace_leave = \ 
        [function(string:void)]([mapping(string:mixed)]id->misc)-> \ 
          trace_leave)) \ 
      _trace_leave(A); \ 
  }while(0) 
 
#endif 
 
// SIMPLE_TRACE_ENTER and SIMPLE_TRACE_LEAVE are simpler variants of 
// the above macros: They handle sprintf style format lists and don't 
// take html encoded messages. Note the reversed argument order in 
// SIMPLE_TRACE_ENTER compared to TRACE_ENTER. 
 
#define SIMPLE_TRACE_ENTER(OBJ, MSG...) do {                          \ 
    array _msg_arr_;                                                    \ 
    TRACE_ENTER (Roxen.html_encode_string (                             \ 
                   (_msg_arr_ = ({MSG}),                                \ 
                    sizeof (_msg_arr_) > 1 ? sprintf (@_msg_arr_) :     \ 
                    (sizeof (_msg_arr_) ? _msg_arr_[0] : ""))),         \ 
                 (OBJ));                                                \ 
  } while (0) 
 
#define SIMPLE_TRACE_LEAVE(MSG...) do {                                       \ 
    array _msg_arr_;                                                    \ 
    TRACE_LEAVE (Roxen.html_encode_string (                             \ 
                   (_msg_arr_ = ({MSG}),                                \ 
                    sizeof (_msg_arr_) > 1 ? sprintf (@_msg_arr_) :     \ 
                    (sizeof (_msg_arr_) ? _msg_arr_[0] : ""))));        \ 
  } while (0) 
 
// The following variant should be used inside RXML.Frame callbacks 
// such as do_enter. In addition to the request trace, it does rxml 
// debug logging which is activated with the DEBUG define in 
// combination with the magic _debug_ tag argument or the RXML_VERBOSE 
// or RXML_REQUEST_VERBOSE defines. 
// 
// These two macros do not take html encoded messages, as opposed to 
// TRACE_ENTER and TRACE_LEAVE. 
 
#define TAG_TRACE_ENTER(MSG...) do {                                  \ 
    array _msg_arr_;                                                    \ 
    string _msg_;                                                       \ 
    TRACE_ENTER ("tag &lt;" + (tag && tag->name) + "&gt; " +            \ 
                 Roxen.html_encode_string (                             \ 
                   (_msg_arr_ = ({MSG}),                                \ 
                    _msg_ = sizeof (_msg_arr_) > 1 ? sprintf (@_msg_arr_) : \ 
                    (sizeof (_msg_arr_) ? _msg_arr_[0] : ""))),         \ 
                 tag);                                                  \ 
    DO_IF_DEBUG (                                                       \ 
      if (TAG_DEBUG_TEST (flags & RXML.FLAG_DEBUG))                     \ 
        tag_debug ("%O:   %s\n", this_object(),                         \ 
                   _msg_ ||                                             \ 
                   (_msg_arr_ = ({MSG}),                                \ 
                    sizeof (_msg_arr_) > 1 ? sprintf (@_msg_arr_) :     \ 
                    (sizeof (_msg_arr_) ? _msg_arr_[0] : "")));         \ 
    );                                                                  \ 
  } while (0) 
 
#define TAG_TRACE_LEAVE(MSG...) do {                                  \ 
    array _msg_arr_;                                                    \ 
    string _msg_;                                                       \ 
    TRACE_LEAVE (Roxen.html_encode_string (                             \ 
                   (_msg_arr_ = ({MSG}),                                \ 
                    _msg_ = sizeof (_msg_arr_) > 1 ? sprintf (@_msg_arr_) : \ 
                    (sizeof (_msg_arr_) ? _msg_arr_[0] : ""))));        \ 
    DO_IF_DEBUG (                                                       \ 
      if (TAG_DEBUG_TEST (flags & RXML.FLAG_DEBUG)) {                   \ 
        if (!_msg_) {                                                   \ 
          _msg_arr_ = ({MSG});                                          \ 
          _msg_ =                                                       \ 
            sizeof (_msg_arr_) > 1 ? sprintf (@_msg_arr_) :             \ 
            (sizeof (_msg_arr_) ? _msg_arr_[0] : "");                   \ 
        }                                                               \ 
        if (sizeof (_msg_)) tag_debug ("%O:   %s\n", this_object(), _msg_); \ 
      }                                                                 \ 
    );                                                                  \ 
  } while (0) 
 
#ifdef AVERAGE_PROFILING 
#define PROF_ENTER(X,Y) id->conf->avg_prof_enter( X, Y, id ) 
#define PROF_LEAVE(X,Y) id->conf->avg_prof_leave( X, Y, id ) 
#define COND_PROF_ENTER(X,Y,Z) if(X)PROF_ENTER(Y,Z) 
#define COND_PROF_LEAVE(X,Y,Z) if(X)PROF_LEAVE(Y,Z) 
#else 
#define PROF_ENTER(X,Y) 
#define PROF_LEAVE(X,Y) 
#define COND_PROF_ENTER(X,Y,Z) 
#define COND_PROF_LEAVE(X,Y,Z) 
#endif 
 
#endif        // !REQUEST_TRACE_H