varnish-cache/include/tbl/vsl_tags.h
1
/*-
2
 * Copyright (c) 2006 Verdens Gang AS
3
 * Copyright (c) 2006-2015 Varnish Software AS
4
 * All rights reserved.
5
 *
6
 * Author: Poul-Henning Kamp <phk@phk.freebsd.dk>
7
 *
8
 * Redistribution and use in source and binary forms, with or without
9
 * modification, are permitted provided that the following conditions
10
 * are met:
11
 * 1. Redistributions of source code must retain the above copyright
12
 *    notice, this list of conditions and the following disclaimer.
13
 * 2. Redistributions in binary form must reproduce the above copyright
14
 *    notice, this list of conditions and the following disclaimer in the
15
 *    documentation and/or other materials provided with the distribution.
16
 *
17
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20
 * ARE DISCLAIMED.  IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE
21
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27
 * SUCH DAMAGE.
28
 *
29
 * Define the tags in the shared memory in a reusable format.
30
 * Whoever includes this get to define what the SLTM macro does.
31
 *
32
 * REMEMBER to update the documentation (especially the varnishlog(1) man
33
 * page) whenever this list changes.
34
 *
35
 * XXX: Please add new entries a the end to not break saved log-segments.
36
 * XXX: we can resort them when we have a major release.
37
 *
38
 * Arguments:
39
 *      Tag-Name
40
 *      Flags
41
 *      Short Description (1 line, max ? chars)
42
 *      Long Description (in RST "definition list" format)
43
 */
44
45
/*lint -save -e525 -e539 */
46
47
#define NODEF_NOTICE \
48
    "NB: This log record is masked by default.\n\n"
49
50 4
SLTM(Debug, SLT_F_UNSAFE, "Debug messages",
51
        "Debug messages can normally be ignored, but are sometimes"
52
        " helpful during trouble-shooting.  Most debug messages must"
53
        " be explicitly enabled with parameters.\n\n"
54
        "Debug messages may be added, changed or removed without"
55
        " prior notice and shouldn't be considered stable.\n\n"
56
)
57
58 4
SLTM(Error, 0, "Error messages",
59
        "Error messages are stuff you probably want to know.\n\n"
60
)
61
62 4
SLTM(CLI, 0, "CLI communication",
63
        "CLI communication between varnishd master and child process.\n\n"
64
)
65
66
/*---------------------------------------------------------------------*/
67
68 4
SLTM(SessOpen, 0, "Client connection opened",
69
        "The first record for a client connection, with the socket-endpoints"
70
        " of the connection.\n\n"
71
        "The format is::\n\n"
72
        "\t%s %d %s %s %s %d\n"
73
        "\t|  |  |  |  |  |\n"
74
        "\t|  |  |  |  |  +- File descriptor number\n"
75
        "\t|  |  |  |  +---- Local TCP port / 0 for UDS\n"
76
        "\t|  |  |  +------- Local IPv4/6 address / 0.0.0.0 for UDS\n"
77
        "\t|  |  +---------- Socket name (from -a argument)\n"
78
        "\t|  +------------- Remote TCP port / 0 for UDS\n"
79
        "\t+---------------- Remote IPv4/6 address / 0.0.0.0 for UDS\n"
80
        "\n"
81
)
82
83 4
SLTM(SessClose, 0, "Client connection closed",
84
        "SessClose is the last record for any client connection.\n\n"
85
        "The format is::\n\n"
86
        "\t%s %f\n"
87
        "\t|  |\n"
88
        "\t|  +- How long the session was open\n"
89
        "\t+---- Why the connection closed\n"
90
        "\n"
91
)
92
93
/*---------------------------------------------------------------------*/
94
95 4
SLTM(BackendOpen, 0, "Backend connection opened",
96
        "Logged when a new backend connection is opened.\n\n"
97
        "The format is::\n\n"
98
        "\t%d %s %s %s %s %s\n"
99
        "\t|  |  |  |  |  |\n"
100
        "\t|  |  |  |  |  +- Local port\n"
101
        "\t|  |  |  |  +---- Local address\n"
102
        "\t|  |  |  +------- Remote port\n"
103
        "\t|  |  +---------- Remote address\n"
104
        "\t|  +------------- Backend display name\n"
105
        "\t+---------------- Connection file descriptor\n"
106
        "\n"
107
)
108
109 4
SLTM(BackendReuse, 0, "Backend connection put up for reuse",
110
        "Logged when a backend connection is put up for reuse by a later"
111
        " connection.\n\n"
112
        "The format is::\n\n"
113
        "\t%d %s\n"
114
        "\t|  |\n"
115
        "\t|  +- Backend display name\n"
116
        "\t+---- Connection file descriptor\n"
117
        "\n"
118
)
119
120 4
SLTM(BackendClose, 0, "Backend connection closed",
121
        "Logged when a backend connection is closed.\n\n"
122
        "The format is::\n\n"
123
        "\t%d %s [ %s ]\n"
124
        "\t|  |    |\n"
125
        "\t|  |    +- Optional reason\n"
126
        "\t|  +------ Backend display name\n"
127
        "\t+--------- Connection file descriptor\n"
128
        "\n"
129
)
130
131 4
SLTM(HttpGarbage, SLT_F_UNSAFE, "Unparseable HTTP request",
132
        "Logs the content of unparseable HTTP requests.\n\n"
133
)
134
135 4
SLTM(Proxy, 0, "PROXY protocol information",
136
        "PROXY protocol information.\n\n"
137
        "The format is::\n\n"
138
        "\t%d %s %d %s %d\n"
139
        "\t|  |  |  |  |\n"
140
        "\t|  |  |  |  +- server port\n"
141
        "\t|  |  |  +---- server ip\n"
142
        "\t|  |  +------- client port\n"
143
        "\t|  +---------- client ip\n"
144
        "\t+------------- PROXY protocol version\n"
145
        "\t\n"
146
        "\tAll fields are \"local\" for PROXY local connections (command 0x0)\n"
147
        "\n"
148
)
149
150 4
SLTM(ProxyGarbage, 0, "Unparseable PROXY request",
151
        "A PROXY protocol header was unparseable.\n\n"
152
)
153
154 4
SLTM(Backend, 0, "Backend selected",
155
        "Logged when a connection is selected for handling a backend"
156
        " request.\n\n"
157
        "The format is::\n\n"
158
        "\t%d %s %s\n"
159
        "\t|  |  |\n"
160
        "\t|  |  +- Backend display name\n"
161
        "\t|  +---- VCL name\n"
162
        "\t+------- Connection file descriptor\n"
163
        "\n"
164
)
165
166 4
SLTM(Length, 0, "Size of object body",
167
        "Logs the size of a fetch object body.\n\n"
168
)
169
170
/*
171
 * XXX generate HTC info below from tbl include
172
 *
173
 * #include <stdio.h>
174
 * int main(void) {
175
 * #define HTC_STATUS(e, n, s, l) \
176
 *      printf("\t\"\\t* %s (%d): %s\\n\"\n", s, n, l);
177
 * #include "include/tbl/htc.h"
178
 *      return (0);
179
 * }
180
 */
181
182 4
SLTM(FetchError, 0, "Error while fetching object",
183
        "Logs the error message of a failed fetch operation.\n\n"
184
        "Error messages should be self-explanatory, yet the http connection"
185
        "(HTC) class of errors is reported with these symbols:\n\n"
186
        "\t* junk (-5): Received unexpected data\n"
187
        "\t* close (-4): Connection closed\n"
188
        "\t* timeout (-3): Timed out\n"
189
        "\t* overflow (-2): Buffer/workspace too small\n"
190
        "\t* eof (-1): Unexpected end of input\n"
191
        "\t* empty (0): Empty response\n"
192
        "\t* more (1): More data required\n"
193
        "\t* complete (2): Data complete (no error)\n"
194
        "\t* idle (3): Connection was closed while idle\n"
195
        "\nNotice that some HTC errors are never emitted."
196
        )
197
198
#define SLTH(tag, ind, req, resp, sdesc, ldesc) \
199
        SLTM(Req##tag, (req ? 0 : SLT_F_UNUSED), "Client request " sdesc, ldesc)
200
#include "tbl/vsl_tags_http.h"
201
#undef SLTH
202
203
#define SLTH(tag, ind, req, resp, sdesc, ldesc) \
204
        SLTM(Resp##tag, (resp ? 0 : SLT_F_UNUSED), "Client response " sdesc, \
205
            ldesc)
206
#include "tbl/vsl_tags_http.h"
207
#undef SLTH
208
209
#define SLTH(tag, ind, req, resp, sdesc, ldesc) \
210
        SLTM(Bereq##tag, (req ? 0 : SLT_F_UNUSED), "Backend request " sdesc, \
211
            ldesc)
212
#include "tbl/vsl_tags_http.h"
213
#undef SLTH
214
215
#define SLTH(tag, ind, req, resp, sdesc, ldesc) \
216
        SLTM(Beresp##tag, (resp ? 0 : SLT_F_UNUSED), "Backend response " \
217
            sdesc, ldesc)
218
#include "tbl/vsl_tags_http.h"
219
#undef SLTH
220
221
#define SLTH(tag, ind, req, resp, sdesc, ldesc) \
222
        SLTM(Obj##tag, (resp ? 0 : SLT_F_UNUSED), "Object  " sdesc, ldesc)
223
#include "tbl/vsl_tags_http.h"
224
#undef SLTH
225
226 4
SLTM(BogoHeader, 0, "Bogus HTTP received",
227
        "Contains the first 20 characters of received HTTP headers we could"
228
        " not make sense of.  Applies to both req.http and beresp.http.\n\n"
229
)
230
231 4
SLTM(LostHeader, 0, "Failed attempt to set HTTP header",
232
        "Logs the header name of a failed HTTP header operation due to"
233
        " resource exhaustion or configured limits.\n\n"
234
)
235
236 4
SLTM(TTL, 0, "TTL set on object",
237
        "A TTL record is emitted whenever the ttl, grace or keep"
238
        " values for an object is set as well as whether the object is "
239
        " cacheable or not.\n\n"
240
        "The format is::\n\n"
241
        "\t%s %d %d %d %d [ %d %d %u %u ] %s\n"
242
        "\t|  |  |  |  |    |  |  |  |    |\n"
243
        "\t|  |  |  |  |    |  |  |  |    +- \"cacheable\" or \"uncacheable\"\n"
244
        "\t|  |  |  |  |    |  |  |  +------ Max-Age from Cache-Control header\n"
245
        "\t|  |  |  |  |    |  |  +--------- Expires header\n"
246
        "\t|  |  |  |  |    |  +------------ Date header\n"
247
        "\t|  |  |  |  |    +--------------- Age (incl Age: header value)\n"
248
        "\t|  |  |  |  +-------------------- Reference time for TTL\n"
249
        "\t|  |  |  +----------------------- Keep\n"
250
        "\t|  |  +-------------------------- Grace\n"
251
        "\t|  +----------------------------- TTL\n"
252
        "\t+-------------------------------- \"RFC\", \"VCL\" or \"HFP\"\n"
253
        "\n"
254
        "The four optional fields are only present in \"RFC\" headers.\n\n"
255
        "Examples::\n\n"
256
        "\tRFC 60 10 -1 1312966109 1312966109 1312966109 0 60 cacheable\n"
257
        "\tVCL 120 10 0 1312966111 uncacheable\n"
258
        "\tHFP 2 0 0 1312966113 uncacheable\n"
259
        "\n"
260
)
261
262 4
SLTM(Fetch_Body, 0, "Body fetched from backend",
263
        "Ready to fetch body from backend.\n\n"
264
        "The format is::\n\n"
265
        "\t%d (%s) %s\n"
266
        "\t|   |    |\n"
267
        "\t|   |    +---- 'stream' or '-'\n"
268
        "\t|   +--------- Text description of body fetch mode\n"
269
        "\t+------------- Body fetch mode\n"
270
        "\n"
271
)
272
273 4
SLTM(VCL_acl, 0, "VCL ACL check results",
274
        "Logs VCL ACL evaluation results.\n\n"
275
)
276
277 4
SLTM(VCL_call, 0, "VCL method called",
278
        "Logs the VCL method name when a VCL method is called.\n\n"
279
)
280
281 4
SLTM(VCL_trace, 0, "VCL trace data",
282
        "Logs VCL execution trace data.\n\n"
283
        "The format is::\n\n"
284
        "\t%s %u %u.%u.%u\n"
285
        "\t|  |  |  |  |\n"
286
        "\t|  |  |  |  +- VCL program line position\n"
287
        "\t|  |  |  +---- VCL program line number\n"
288
        "\t|  |  +------- VCL program source index\n"
289
        "\t|  +---------- VCL trace point index\n"
290
        "\t+------------- VCL configname\n"
291
        "\n"
292
        NODEF_NOTICE
293
)
294
295 4
SLTM(VCL_return, 0, "VCL method return value",
296
        "Logs the VCL method terminating statement.\n\n"
297
)
298
299 4
SLTM(ReqStart, 0, "Client request start",
300
        "Start of request processing. Logs the client address, port number "
301
        " and listener endpoint name (from the -a command-line argument).\n\n"
302
        "The format is::\n\n"
303
        "\t%s %s %s\n"
304
        "\t|  |  |\n"
305
        "\t|  |  +-- Listener name (from -a)\n"
306
        "\t|  +----- Client Port number (0 for Unix domain sockets)\n"
307
        "\t+-------- Client IP4/6 address (0.0.0.0 for UDS)\n"
308
        "\n"
309
)
310
311 4
SLTM(Hit, 0, "Hit object in cache",
312
        "Object looked up in cache.\n\n"
313
        "The format is::\n\n"
314
        "\t%u %f %f %f\n"
315
        "\t|  |  |  |\n"
316
        "\t|  |  |  +- Keep period\n"
317
        "\t|  |  +---- Grace period\n"
318
        "\t|  +------- Remaining TTL\n"
319
        "\t+---------- VXID of the object\n"
320
        "\n"
321
)
322
323 4
SLTM(HitPass, 0, "Hit for pass object in cache.",
324
        "Hit-for-pass object looked up in cache.\n\n"
325
        "The format is::\n\n"
326
        "\t%u %f\n"
327
        "\t|  |\n"
328
        "\t|  +- Remaining TTL\n"
329
        "\t+---- VXID of the object\n"
330
        "\n"
331
)
332
333 4
SLTM(ExpBan, 0, "Object evicted due to ban",
334
        "Logs the VXID when an object is banned.\n\n"
335
)
336
337 4
SLTM(ExpKill, 0, "Object expiry event",
338
        "Logs events related to object expiry. The events are:\n\n"
339
        "EXP_Rearm\n"
340
        "\tLogged when the expiry time of an object changes.\n\n"
341
        "EXP_Inbox\n"
342
        "\tLogged when the expiry thread picks an object from the inbox for"
343
        " processing.\n\n"
344
        "EXP_Kill\n"
345
        "\tLogged when the expiry thread kills an object from the inbox.\n\n"
346
        "EXP_When\n"
347
        "\tLogged when the expiry thread moves an object on the binheap.\n\n"
348
        "EXP_Expired\n"
349
        "\tLogged when the expiry thread expires an object.\n\n"
350
        "LRU_Cand\n"
351
        "\tLogged when an object is evaluated for LRU force expiry.\n\n"
352
        "LRU\n"
353
        "\tLogged when an object is force expired due to LRU.\n\n"
354
        "LRU_Fail\n"
355
        "\tLogged when no suitable candidate object is found for LRU force"
356
        " expiry.\n\n"
357
        "The format is::\n\n"
358
        "\tEXP_Rearm p=%p E=%f e=%f f=0x%x\n"
359
        "\tEXP_Inbox p=%p e=%f f=0x%x\n"
360
        "\tEXP_Kill p=%p e=%f f=0x%x\n"
361
        "\tEXP_When p=%p e=%f f=0x%x\n"
362
        "\tEXP_Expired x=%u t=%f\n"
363
        "\tLRU_Cand p=%p f=0x%x r=%d\n"
364
        "\tLRU x=%u\n"
365
        "\tLRU_Fail\n"
366
        "\t\n"
367
        "\tLegend:\n"
368
        "\tp=%p         Objcore pointer\n"
369
        "\tt=%f         Remaining TTL (s)\n"
370
        "\te=%f         Expiry time (unix epoch)\n"
371
        "\tE=%f         Old expiry time (unix epoch)\n"
372
        "\tf=0x%x       Objcore flags\n"
373
        "\tr=%d         Objcore refcount\n"
374
        "\tx=%u         Object VXID\n"
375
        "\n"
376
)
377
378 4
SLTM(WorkThread, 0, "Logs thread start/stop events",
379
        "Logs worker thread creation and termination events.\n\n"
380
        "The format is::\n\n"
381
        "\t%p %s\n"
382
        "\t|  |\n"
383
        "\t|  +- [start|end]\n"
384
        "\t+---- Worker struct pointer\n"
385
        "\n"
386
        NODEF_NOTICE
387
)
388
389 4
SLTM(ESI_xmlerror, 0, "ESI parser error or warning message",
390
        "An error or warning was generated during parsing of an ESI object."
391
        " The log record describes the problem encountered."
392
)
393
394 4
SLTM(Hash, SLT_F_UNSAFE, "Value added to hash",
395
        "This value was added to the object lookup hash.\n\n"
396
        NODEF_NOTICE
397
)
398
399
/*
400
 * Probe window bits:
401
 *
402
 * the documentation below could get auto-generated like so:
403
 *
404
 * ( echo '#define PROBE_BITS_DOC \' ; \
405
 *   $CC -D 'BITMAP(n, c, t, b)="\t" #c ": " t "\n" \' \
406
 *       -E ./include/tbl/backend_poll.h | grep -E '^"' ; \
407
 *  echo '""' ) >./include/tbl/backend_poll_doc.h
408
 *
409
 * as this has a hackish feel to it, the documentation is included here as text
410
 * until we find a better solution or the above is accepted
411
 */
412
413 4
SLTM(Backend_health, 0, "Backend health check",
414
        "The result of a backend health probe.\n\n"
415
        "The format is::\n\n"
416
        "\t%s %s %s %u %u %u %f %f %s\n"
417
        "\t|  |  |  |  |  |  |  |  |\n"
418
        "\t|  |  |  |  |  |  |  |  +- Probe HTTP response / error information\n"
419
        "\t|  |  |  |  |  |  |  +---- Average response time\n"
420
        "\t|  |  |  |  |  |  +------- Response time\n"
421
        "\t|  |  |  |  |  +---------- Probe window size\n"
422
        "\t|  |  |  |  +------------- Probe threshold level\n"
423
        "\t|  |  |  +---------------- Number of good probes in window\n"
424
        "\t|  |  +------------------- Probe window bits\n"
425
        "\t|  +---------------------- Status message\n"
426
        "\t+------------------------- Backend name\n"
427
        "\n"
428
429
        "Probe window bits are::\n\n"
430
        "\t" "'4'" ": " "Good IPv4" "\n"
431
        "\t" "'6'" ": " "Good IPv6" "\n"
432
        "\t" "'U'" ": " "Good UNIX" "\n"
433
        "\t" "'x'" ": " "Error Xmit" "\n"
434
        "\t" "'X'" ": " "Good Xmit" "\n"
435
        "\t" "'r'" ": " "Error Recv" "\n"
436
        "\t" "'R'" ": " "Good Recv" "\n"
437
        "\t" "'H'" ": " "Happy" "\n"
438
        "\n"
439
)
440
441 4
SLTM(VCL_Log, 0, "Log statement from VCL",
442
        "User generated log messages insert from VCL through std.log()"
443
)
444
445 4
SLTM(VCL_Error, 0, "VCL execution error message",
446
        "Logs error messages generated during VCL execution.\n\n"
447
)
448
449 4
SLTM(Gzip, 0, "G(un)zip performed on object",
450
        "A Gzip record is emitted for each instance of gzip or gunzip"
451
        " work performed. Worst case, an ESI transaction stored in"
452
        " gzip'ed objects but delivered gunziped, will run into many of"
453
        " these.\n\n"
454
        "The format is::\n\n"
455
        "\t%c %c %c %d %d %d %d %d\n"
456
        "\t|  |  |  |  |  |  |  |\n"
457
        "\t|  |  |  |  |  |  |  +- Bit length of compressed data\n"
458
        "\t|  |  |  |  |  |  +---- Bit location of 'last' bit\n"
459
        "\t|  |  |  |  |  +------- Bit location of first deflate block\n"
460
        "\t|  |  |  |  +---------- Bytes output\n"
461
        "\t|  |  |  +------------- Bytes input\n"
462
        "\t|  |  +---------------- 'E': ESI, '-': Plain object\n"
463
        "\t|  +------------------- 'F': Fetch, 'D': Deliver\n"
464
        "\t+---------------------- 'G': Gzip, 'U': Gunzip, 'u': Gunzip-test\n"
465
        "\n"
466
        "Examples::\n\n"
467
        "\tU F E 182 159 80 80 1392\n"
468
        "\tG F E 159 173 80 1304 1314\n"
469
        "\n"
470
)
471
472 4
SLTM(Link, 0, "Links to a child VXID",
473
        "Links this VXID to any child VXID it initiates.\n\n"
474
        "The format is::\n\n"
475
        "\t%s %d %s\n"
476
        "\t|  |  |\n"
477
        "\t|  |  +- Reason\n"
478
        "\t|  +---- Child vxid\n"
479
        "\t+------- Child type (\"req\" or \"bereq\")\n"
480
        "\n"
481
)
482
483 4
SLTM(Begin, 0, "Marks the start of a VXID",
484
        "The first record of a VXID transaction.\n\n"
485
        "The format is::\n\n"
486
        "\t%s %d %s\n"
487
        "\t|  |  |\n"
488
        "\t|  |  +- Reason\n"
489
        "\t|  +---- Parent vxid\n"
490
        "\t+------- Type (\"sess\", \"req\" or \"bereq\")\n"
491
        "\n"
492
)
493
494 4
SLTM(End, 0, "Marks the end of a VXID",
495
        "The last record of a VXID transaction.\n\n"
496
)
497
498 4
SLTM(VSL, 0, "VSL API warnings and error message",
499
        "Warnings and error messages generated by the VSL API while"
500
        " reading the shared memory log.\n\n"
501
)
502
503 4
SLTM(Storage, 0, "Where object is stored",
504
        "Type and name of the storage backend the object is stored in.\n\n"
505
        "The format is::\n\n"
506
        "\t%s %s\n"
507
        "\t|  |\n"
508
        "\t|  +- Name of storage backend\n"
509
        "\t+---- Type (\"malloc\", \"file\", \"persistent\" etc.)\n"
510
        "\n"
511
)
512
513 4
SLTM(Timestamp, 0, "Timing information",
514
        "Contains timing information for the Varnish worker threads.\n\n"
515
        "Time stamps are issued by Varnish on certain events,"
516
        " and show the absolute time of the event, the time spent since the"
517
        " start of the work unit, and the time spent since the last timestamp"
518
        " was logged. See the TIMESTAMPS section below for information about"
519
        " the individual time stamps.\n\n"
520
        "The format is::\n\n"
521
        "\t%s: %f %f %f\n"
522
        "\t|   |  |  |\n"
523
        "\t|   |  |  +- Time since last timestamp\n"
524
        "\t|   |  +---- Time since start of work unit\n"
525
        "\t|   +------- Absolute time of event\n"
526
        "\t+----------- Event label\n"
527
        "\n"
528
)
529
530 4
SLTM(ReqAcct, 0, "Request handling byte counts",
531
        "Contains byte counts for the request handling.\n"
532
        "The body bytes count includes transmission overhead"
533
        " (ie: chunked encoding).\n"
534
        "ESI sub-requests show the body bytes this ESI fragment including"
535
        " any subfragments contributed to the top level request.\n"
536
        "The format is::\n\n"
537
        "\t%d %d %d %d %d %d\n"
538
        "\t|  |  |  |  |  |\n"
539
        "\t|  |  |  |  |  +- Total bytes transmitted\n"
540
        "\t|  |  |  |  +---- Body bytes transmitted\n"
541
        "\t|  |  |  +------- Header bytes transmitted\n"
542
        "\t|  |  +---------- Total bytes received\n"
543
        "\t|  +------------- Body bytes received\n"
544
        "\t+---------------- Header bytes received\n"
545
        "\n"
546
)
547
548 4
SLTM(PipeAcct, 0, "Pipe byte counts",
549
        "Contains byte counters for pipe sessions.\n\n"
550
        "The format is::\n\n"
551
        "\t%d %d %d %d\n"
552
        "\t|  |  |  |\n"
553
        "\t|  |  |  +------- Piped bytes to client\n"
554
        "\t|  |  +---------- Piped bytes from client\n"
555
        "\t|  +------------- Backend request headers\n"
556
        "\t+---------------- Client request headers\n"
557
        "\n"
558
)
559
560 4
SLTM(BereqAcct, 0, "Backend request accounting",
561
        "Contains byte counters from backend request processing.\n\n"
562
        "The format is::\n\n"
563
        "\t%d %d %d %d %d %d\n"
564
        "\t|  |  |  |  |  |\n"
565
        "\t|  |  |  |  |  +- Total bytes received\n"
566
        "\t|  |  |  |  +---- Body bytes received\n"
567
        "\t|  |  |  +------- Header bytes received\n"
568
        "\t|  |  +---------- Total bytes transmitted\n"
569
        "\t|  +------------- Body bytes transmitted\n"
570
        "\t+---------------- Header bytes transmitted\n"
571
        "\n"
572
)
573
574 4
SLTM(VfpAcct, 0, "Fetch filter accounting",
575
        "Contains name of VFP and statistics.\n\n"
576
        "The format is::\n\n"
577
        "\t%s %d %d\n"
578
        "\t|  |  |\n"
579
        "\t|  |  +- Total bytes produced\n"
580
        "\t|  +---- Number of calls made\n"
581
        "\t+------- Name of filter\n"
582
        "\n"
583
        NODEF_NOTICE
584
)
585
586 4
SLTM(Witness, 0, "Lock order witness records",
587
        "Diagnostic recording of locking order.\n"
588
)
589
590 4
SLTM(BackendStart, 0, "Backend request start",
591
        "Start of backend processing. Logs the backend IP address and port"
592
        " number.\n\n"
593
        "The format is::\n\n"
594
        "\t%s %s\n"
595
        "\t|  |\n"
596
        "\t|  +- Backend Port number\n"
597
        "\t+---- Backend IP4/6 address\n"
598
        "\n"
599
)
600
601 4
SLTM(H2RxHdr, SLT_F_BINARY, "Received HTTP2 frame header",
602
        "Binary data"
603
)
604
605 4
SLTM(H2RxBody, SLT_F_BINARY, "Received HTTP2 frame body",
606
        "Binary data"
607
)
608
609 4
SLTM(H2TxHdr, SLT_F_BINARY, "Transmitted HTTP2 frame header",
610
        "Binary data"
611
)
612
613 4
SLTM(H2TxBody, SLT_F_BINARY, "Transmitted HTTP2 frame body",
614
        "Binary data"
615
)
616
617 4
SLTM(HitMiss, 0, "Hit for miss object in cache.",
618
        "Hit-for-miss object looked up in cache.\n\n"
619
        "The format is::\n\n"
620
        "\t%u %f\n"
621
        "\t|  |\n"
622
        "\t|  +- Remaining TTL\n"
623
        "\t+---- VXID of the object\n"
624
        "\n"
625
)
626
627 4
SLTM(Filters, 0, "Body filters",
628
        "List of filters applied to the body"
629
)
630
631 4
SLTM(SessError, 0, "Client connection accept failed",
632
        "Accepting a client connection has failed.\n\n"
633
        "The format is::\n\n"
634
        "\t%s %s %s %d %d %s\n"
635
        "\t|  |  |  |  |  |\n"
636
        "\t|  |  |  |  |  +- Detailed error message\n"
637
        "\t|  |  |  |  +---- Error Number (errno) from accept(2)\n"
638
        "\t|  |  |  +------- File descriptor number\n"
639
        "\t|  |  +---------- Local TCP port / 0 for UDS\n"
640
        "\t|  +------------- Local IPv4/6 address / 0.0.0.0 for UDS\n"
641
        "\t+---------------- Socket name (from -a argument)\n"
642
        "\n"
643
)
644
645
#undef NODEF_NOTICE
646
#undef SLTM
647
648
/*lint -restore */