README

   1 This is a revision from the radsecproxy 1.2 devel branch.
   2
   3 radsecproxy is a generic RADIUS proxy that can support various
   4 RADIUS clients over UDP or TLS (RadSec).
   5
   6 It should build on most Linux and BSD platforms by simply typing
   7 "make". You may also try to use autoconf, but this is currently
   8 unsupported.
   9
  10 To use it you need to create a config file which normally is
  11 called "/etc/radsecproxy.conf". You can also specify the location
  12 with the "-c" command line option (see below). For further
  13 instructions, please see the enclosed example file and the
  14 documentation at
  15 http://software.uninett.no/radsecproxy/?page=documentation
  16
  17 There are five options that may be specified on the command line.
  18 "-c configfile" to specify a non-default config file path;
  19 "-d loglevel" to set a loglevel of 1, 2, 3 or 4 where 4 is the most
  20 detailed; and "-f" to run the proxy in the foreground with logging
  21 to stderr. Without "-f" the default is to detach as a daemon and
  22 log to syslog. "-v" just prints version information and exits, while
  23 "-p" (pretend) makes the proxy go through the configuration files as
  24 normal, but stops before creating any sockets or doing any serious
  25 work. This is useful for validating config files.
  26
  27 Thanks to Stefan Winter and Andreas Solberg for talking me into
  28 doing this, and the funding from GEANT2. Stefan as well as Kolbjørn
  29 Barmen, Ralf Paffrath and Maja Wolniewicz have helped with early
  30 testing of the code.
  31
  32 All of the above plus Milan Sova have provided good feedback on
  33 several implementation choices. Finally thanks to Hans Zandbelt
  34 for providing the autoconf stuff. I may have forgotten someone,
  35 let me know if you feel left out.
  36
  37 For more information, feedback etc. please see the information
  38 at http://software.uninett.no/radsecproxy/
  39
  40 Stig Venaas <venaas@uninett.no> -- 2008.05.14