radsecproxy-1.6.5.
[libradsec.git] / README
1 This is radsecproxy 1.6.5 from 2013-09-06.
2
3 radsecproxy is a generic RADIUS proxy that supports both UDP and TLS
4 (RadSec) RADIUS transports.  There is also experimental support for
5 TCP and DTLS.
6
7 It should build on most Unix and OSX platforms by simply typing
8 "./configure && make".  It is possible to specify which RADIUS
9 transport the build should support.  Without any special options to
10 configure, all transports supported by the system will be enabled.
11 See the output from "configure --help" for how to change this.
12
13 Known build issues:
14 - Older BSD's (like NetBSD 4.x) need newer OpenSSL in order to support
15   DTLS.  Workaround: ./configure --disable-dtls.
16
17 - FreeBSD 6.x need newer OpenSSL to build at all.  OpenSSL 1.0.0c from
18   ports is fine f.ex., configure radsecproxy with `--with-ssl=/usr/local'.
19
20 To use radsecproxy you need to create a config file which normally is
21 called "/etc/radsecproxy.conf".  You can also specify the location
22 with the "-c" command line option (see below).  For further
23 instructions, please see the enclosed example file and the
24 documentation at
25 http://software.uninett.no/radsecproxy/?page=documentation
26
27 The following options may be specified on the command line:
28 "-c configfile" to specify a non-default config file path.
29 "-d loglevel" to set a loglevel of 1, 2, 3, 4 and 5 where 5 is the
30               most detailed.
31 "-f" to run the proxy in the foreground with logging to stderr.
32      Without "-f" the default is to detach as a daemon and log to
33      syslog.
34 "-i pidfile" to name a file to which the PID is written.
35 "-v" just prints version information and exits.
36 "-p" (pretend) makes the proxy go through the configuration files as
37      normal, but stops before creating any sockets or doing any
38      serious work.  This is useful for validating config files.