X-Git-Url: http://www.project-moonshot.org/gitweb/?p=libradsec.git;a=blobdiff_plain;f=README;h=4c0d27756aae706a915b093c89c681c48eefd061;hp=14df14e89ec3393002fb13874c009f34a9704274;hb=HEAD;hpb=0be487506195d069c468fa71c32dc2cd50450363 diff --git a/README b/README index 14df14e..4c0d277 100644 --- a/README +++ b/README @@ -1,6 +1,48 @@ -This is not radsecproxy, it's libradsec (see lib/) sharing the -radsecproxy repository. +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. -For radsecproxy, see branch 'master'. -The repository ca be found at http://git.nordu.net/?p=radsecproxy.git;a=summary . +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.