1DQTOOL(1) The dqtool tool manual page DQTOOL(1)
2
3
4
6 dqtool - Display the contents of a disk-buffer file created with
7
9 dqtool [command] [options]
10
12 NOTE: The dqtool application is distributed with the system logging
13 application, and is usually part of the syslog-ng package. The latest
14 version of the syslog-ng application is available at the official
15 syslog-ng website[1].
16
17 This manual page is only an abstract, for the complete documentation of
18 syslog-ng, see The Administrator Guide[2].
19
20 The dqtool application is a utility that can be used to display and
21 format the messages stored in a disk-buffer file.
22
24 cat [options] [file]
25
26 Use the cat command to display the log messages stored in the
27 disk-buffer (also called disk-queue) file, and also information from
28 the header of the disk queue file. The messages are printed to the
29 standard output (stdout), so it is possible to use grep and other tools
30 to find particular log messages, e.g., dqtool cat /var/log/messages.lgs
31 |grep 192.168.1.1.
32
33 The cat command has the following options:
34
35 --debug or -d
36 Print diagnostic and debugging messages to stderr.
37
38 --help or -h
39 Display a brief help message.
40
41 --template=<template> or -t
42 Format the messages using the specified template.
43
44 --verbose or -v
45 Print verbose messages to stderr.
46
47 --version or -V
48 Display version information.
49
50 Example:
51
52 ./dqtool cat ../var/syslog-ng-00000.qf
53
54 The output looks like:
55
56 Disk-buffer state loaded; filename='../var/syslog-ng-00000.qf', qout_length='65', qbacklog_length='0', qoverflow_length='9205', qdisk_length='0'
57 Mar 3 10:52:05 tristram localprg[1234]: seq: 0000011630, runid: 1267609923, stamp: 2010-03-03T10:52:05 PADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADD
58 Mar 3 10:52:05 tristram localprg[1234]: seq: 0000011631, runid: 1267609923, stamp: 2010-03-03T10:52:05 PADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADDPADD
59
61 /usr/local/bin/dqtool
62
64 syslog-ng.conf(5)
65
66 syslog-ng(8)
67
68 Note
69 For the detailed documentation of see The 3.37 Administrator
70 Guide[3]
71
72 If you experience any problems or need help with syslog-ng, visit
73 the syslog-ng mailing list[4].
74
75 For news and notifications about of syslog-ng, visit the syslog-ng
76 blogs[5].
77
79 This manual page was written by the Balabit Documentation Team
80 <documentation@balabit.com>.
81
84 1. official syslog-ng website
85 https://www.balabit.com/log-management
86
87 2. The Administrator Guide
88 https://www.balabit.com/support/documentation/
89
90 3. The 3.37 Administrator Guide
91 https://www.balabit.com/documents/syslog-ng-ose-latest-guides/en/syslog-ng-ose-guide-admin/html/index.html
92
93 4. syslog-ng mailing list
94 https://lists.balabit.hu/mailman/listinfo/syslog-ng
95
96 5. syslog-ng blogs
97 https://syslog-ng.org/blogs/
98
99
100
1013.37 06/03/2022 DQTOOL(1)