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
|
README for syslog-ng-debun, the Syslog-ng DEBUg buNdle generator
The main purpose of this software is to collect and save information about
your syslog-ng installation / implementation for that case, if you want to
ask help about your syslog-ng related problem.
usage examples:
# syslog-ng-debun -r
Create a simple debug bundle, collecting about your environmental
information. eg. list of packages, which contains the word: syslog
ldd of your syslog-binary, etc.
# syslog-ng-debun -r -l
Like previuos, but left out some information, which may you think
harm your privacy. Eg fstab, df's output, mount info, ip / network
interface configuration, DNS resolv info, and process tree is NOT
collected.
# syslog-ng-debun -r -d
Besides collecting information, it stops system's syslog-ng, then
start in debug mode with -Fedv --enable-core, and until you do not
press enter, it stays in that mode. Debug's output is collected into
a separate file, and also collected.
# syslog-ng-debun -r -p
Will run packet capture with filter: "port 514 or port 601 or port 53"
Also wait for pressing enter, like debug mode.
# syslog-ng-debun -r -p -t 10
Like the previous one, but do not wait for pressing enter, it will
exit from tcpdump mode after 10 seconds. (noninteractive debug mode)
# syslog-ng-debun -r -P "host 1.2.3.4" -D "-Fev --enable-core"
packet capturing's filter will be changed from default to
host 1.2.3.4
Debugging paramters will be changed from default to
-Fev --enable-core
And, since a timout is not given, it will wait for pressing enter.
# syslog-ng-debun -r -p -d -w 5 -t 10
Collect pcap and debug mode output following this scenario:
* start packet capture with default params
* wait 5 seconds
* stop system's syslog-ng
* start syslog-ng in debug mode with default params, syslog's debug
messages are also appearing on your console
* wait 10 seconds
* stop syslog-ng debugging
* start system's syslog-ng
* stops packet capturing
# syslog-ng-debun -r -W /var/tmp -R /usr/local
Collect debug info, but the temporary files, and the result will be
in /var/tmp instead of /tmp and don't try to search syslog-ng in
/opt/syslog-ng, it will search in /usr/local
# syslog-ng-debun -r -s -t 10
Collect debug info, start tracing, and exit tracing after 10 seconds
|