X-Git-Url: http://www.project-moonshot.org/gitweb/?p=libradsec.git;a=blobdiff_plain;f=README;h=4c0d27756aae706a915b093c89c681c48eefd061;hp=c038cf00535c2f7a26bbc554a9ee61ba02025b9c;hb=HEAD;hpb=ac0608ea776d4437632490cccd570e68cfd7abd0 diff --git a/README b/README index c038cf0..4c0d277 100644 --- a/README +++ b/README @@ -1,49 +1,48 @@ -This is radsecproxy 1.4.1 from June 11 2010. - -radsecproxy is a generic RADIUS proxy that can support various -RADIUS clients over UDP or TLS (RadSec). - -It should build on most Linux and BSD platforms by simply typing -"make". You may also try to use autoconf. It is possible to -specify which RADIUS transport the build should support. With -just doing "make" one will support only UDP and TLS. See the -Makefile for how to change this. With autoconf (configure) there -will normally be support for all transport. You can use the -configure options --enable-udp, --enable-tcp, --enable-tls and ---enable-dtls where each of them may be set to yes or no to -enable or disable them. - -To use it 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 - -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; 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. "-v" just prints version information and exits, while -"-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. - -Thanks to Stefan Winter and Andreas Solberg for talking me into -doing this, and the funding from GEANT2. Stefan as well as Kolbjørn -Barmen, Ralf Paffrath and Maja Wolniewicz have helped with early -testing of the code. - -Thanks for contributing code goes to Arne Schwabe, Maja Wolniewicz, -Simon Leinen and Stefan Winter. - -All of the above plus Milan Sova have provided good feedback on -several implementation choices. Finally thanks to Hans Zandbelt -for providing the autoconf stuff. I may have forgotten someone, -let me know if you feel left out. - -For more information, feedback etc. please see the information -at http://software.uninett.no/radsecproxy/ - -Stig Venaas -- 2009.07.22 +Libradsec is a RADIUS library for clients doing RADIUS over UDP or +TLS. The goal is to add support for writing servers (and thus proxies) +and to add transports TCP and DTLS. + + +The canonical pickup point is +http://git.nordu.net/?p=radsecproxy.git;a=shortlog;h=refs/heads/libradsec + + +The source code is licensed under a 3-clause BSD license. See the +LICENSE file. + + +Libradsec depends on +- libconfuse +- libevent2 +- openssl (unless configured with --disable-tls) + + +To compile the library and the examples, do something like + + sh autogen.sh && ./configure && make + + +There are a couple of options that can be used when configuring. See + + ./configure --help + +for the full list. Worth mentioning here is --enable-tls-psk. + +If the preprocessor has a hard time finding some of the header files +are, try setting environment variable CPPFLAGS at configure +time. Example: + + CPPFLAGS="-I/usr/local/include" ./configure --enable-tls + +If the link editor has trouble finding any of the libraries needed, +try setting environment variable LDFLAGS at configure time. Example: + + LDFLAGS="-L/usr/local/lib" ./configure --enable-tls + + +The parts of the library which has been tested has been so on Linux +(Debian) with libconfuse (2.7), libevent (2.0.19) and OpenSSL +(1.0.1c). + +The file HACKING contains more detailed info on the state of the +various parts of the library.