summaryrefslogtreecommitdiff
path: root/regress/usr.sbin/syslogd/README
blob: 4d8234855a5bcff7cf2bd73631cb84eddb6b0ed0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
Run syslogd regressions tests.  As only one syslogd can run per
machine, each test kills any syslogd first.  At the end the system's
syslogd gets restarted.
The test framework runs a client, and a server, and a syslogd.  The
messages are passed via the log socket or via UDP from the client
to syslogd.  From there UDP transport is used to reach the server.
All processes write log files where the message has to show up.
The test arguments are kept in the args-*.pl files.
The content of a log file, the data sent to a pipe process and what
the server received are checked.  The invocation of the sendsyslog(2)
syscall is checked with ktrace, the open file descriptors of syslogd
are checked with fstat.

SUDO=sudo
As syslogd needs root privileges either run the tests as root or
set this variable and run make as a regular user.  Only the code
that requires it, is run as root.

KTRACE=ktrace
Set this variable if you want a ktrace output from syslogd.  Note that
ktrace is invoked after sudo as sudo would disable it.

SYSLOGD=/usr/src/usr.sbin/syslogd/obj/syslogd
Start an alternative syslogd program that is not in the path.