xref: /openbsd/regress/usr.sbin/relayd/README (revision d415bd75)
1Run relayd regressions tests.  The framework runs a client, and a
2server, and a relayd.  Currently the tcp and http forwarding code
3path is covered.  Each test creates a special relayd.conf and starts
4those three processes.  All processes write log files that are
5checked for certain messages.  The test arguments are kept in the
6args-*.pl files.  To find socket splicing bugs, each test is run
7in both copy and splice mode.
8
9SUDO=doas
10As relayd needs root privileges either run the tests as root or set
11this variable and run make as a regular user.  Only the code that
12requires it, is run as root.
13
14KTRACE=ktrace
15Set this variable if you want a ktrace output from relayd.  Note that
16ktrace is invoked after sudo as sudo would disable it.
17
18RELAYD=/usr/src/usr.sbin/relayd/obj/relayd
19Start an alternative relayd program that is not in the path.
20
21LOCAL_ADDR, REMOTE_ADDR, REMOTE_SSH
22Set these to run the relayd on a remote machine.  As the client and
23server run locally, network timing may influence the test results.
24
25Changes here have to be discussed with bluhm@, reyk@ or benno@.
26