File: README.syslog-ng-debun

package info (click to toggle)
syslog-ng 4.8.1-6
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 20,456 kB
  • sloc: ansic: 177,631; python: 13,035; cpp: 11,611; makefile: 7,012; sh: 5,147; java: 3,651; xml: 3,344; yacc: 1,377; lex: 599; perl: 193; awk: 190; objc: 162
file content (58 lines) | stat: -rw-r--r-- 2,306 bytes parent folder | download | duplicates (3)
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