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". If this is not found, the
  12 proxy will look for radsecproxy.conf in the current directory.
  13 You can also specify the location with the "-c" command line
  14 option (see below). For further instructions, please see the
  15 enclosed example file and the documentation at
  16 http://software.uninett.no/radsecproxy/?page=documentation
  17
  18 There are five options that may be specified on the command line.
  19 "-c configfile" to specify a non-default config file path;
  20 "-d loglevel" to set a loglevel of 1, 2, 3 or 4 where 4 is the most
  21 detailed; and "-f" to run the proxy in the foreground with logging
  22 to stderr. Without "-f" the default is to detach as a daemon and
  23 log to syslog. "-v" just prints version information and exits, while
  24 "-p" (pretend) makes the proxy go through the configuration files as
  25 normal, but stops before creating any sockets or doing any serious
  26 work. This is useful for validating config files.
  27
  28 Thanks to Stefan Winter and Andreas Solberg for talking me into
  29 doing this, and the funding from GEANT2. Stefan as well as Kolbjørn
  30 Barmen, Ralf Paffrath and Maja Wolniewicz have helped with early
  31 testing of the code.
  32
  33 All of the above plus Milan Sova have provided good feedback on
  34 several implementation choices. Finally thanks to Hans Zandbelt
  35 for providing the autoconf stuff. I may have forgotten someone,
  36 let me know if you feel left out.
  37
  38 For more information, feedback etc. please see the information
  39 at http://software.uninett.no/radsecproxy/
  40
  41 Stig Venaas <venaas@uninett.no> -- 2007.12.27