X-Git-Url: http://www.project-moonshot.org/gitweb/?a=blobdiff_plain;f=README;h=9ba577ffd7d3733208c8409d5f0a32e921892e02;hb=58828098b4d64dc96318359886f6aea7a1488864;hp=dce3195a937c944692042fce63ee0cdb7b3239c0;hpb=36f1a92cea2b74a44ba521701d6cb31df8ce3cd1;p=radsecproxy.git diff --git a/README b/README index dce3195..9ba577f 100644 --- a/README +++ b/README @@ -1,21 +1,35 @@ -This is a beta version of a generic RADIUS proxy that can support -various RADIUS clients over UDP or TLS (RadSec). +This is unreleased radsecproxy 2.0-alpha. + +radsecproxy is a generic RADIUS proxy that supports both UDP and TLS +(RadSec) RADIUS transports. There is also experimental support for +TCP and DTLS. It should build on most Linux and BSD platforms by simply typing -"make". To use it you need to create a config file called -"radsecproxy.conf" which must be in /etc/radsecproxy (unless -you alter it in the header file), the current directory, or -you can specify the location with the "-c" command line -option (see below). See the enclosed example file for further -instructions. +"./configure && make". It is possible to specify which RADIUS +transport the build should support. Without any special options to +configure, all transports supported by the system will be enabled. +See the output from "configure --help" for how to change this. -There are three options that may be specified on the command line. -"-c configfile" to specify a non-default config file path; -"-d loglevel" to set a loglevel of 1, 2, 3 or 4 where 4 is the most -detailed; and "-f" to run the proxy in the foreground with logging -to stderr. Without "-f" the default is to detach as a daemon and -log to syslog. +Known build issues: +- Older BSD's (like NetBSD 4.x) need newer OpenSSL in order to support + DTLS. Workaround: ./configure --disable-dtls. +- FreeBSD 6.x needs newer OpenSSL to build at all. -For more information, feedback etc. contact . +To use radsecproxy you need to create a config file which normally is +called "/etc/radsecproxy.conf". You can also specify the location +with the "-c" command line option (see below). For further +instructions, please see the enclosed example file and the +documentation at +http://software.uninett.no/radsecproxy/?page=documentation -Stig Venaas, 2007.05.15 +There are five options that may be specified on the command line: +"-c configfile" to specify a non-default config file path. +"-d loglevel" to set a loglevel of 1, 2, 3, 4 and 5 where 5 is the + most detailed. +"-f" to run the proxy in the foreground with logging to stderr. + Without "-f" the default is to detach as a daemon and log to + syslog. +"-v" just prints version information and exits. +"-p" (pretend) makes the proxy go through the configuration files as + normal, but stops before creating any sockets or doing any + serious work. This is useful for validating config files.