From db2c19e7a91be715f1fa9d70936ce0eae3e8eac3 Mon Sep 17 00:00:00 2001 From: venaas Date: Wed, 18 Feb 2009 14:34:00 +0000 Subject: updated documentation git-svn-id: https://svn.testnett.uninett.no/radsecproxy/trunk@479 e88ac4ed-0b26-0410-9574-a7f39faa03bf --- radsecproxy.conf.5 | 26 ++++++++++++++++---------- 1 file changed, 16 insertions(+), 10 deletions(-) diff --git a/radsecproxy.conf.5 b/radsecproxy.conf.5 index 600f398..aaeb9b3 100644 --- a/radsecproxy.conf.5 +++ b/radsecproxy.conf.5 @@ -5,7 +5,7 @@ \\$2 \(la\\$1\(ra\\$3 .. .if \n(.g .mso www.tmac -.TH "radsecproxy.conf " 5 2008-11-06 "radsecproxy devel 2008-11-06" "" +.TH "radsecproxy.conf " 5 2009-02-18 "radsecproxy devel 2009-02-18" "" .SH NAME radsecproxy.conf \- Radsec proxy configuration file @@ -130,7 +130,7 @@ you can do e.g. \*(T<192.168.1.1:1812\*(T> or \*(T<[2001:db8::1]:1812\*(T>. The port may be omitted if you want the default one (like in these examples). These examples are equivalent to \*(T<192.168.1.1\*(T> and \*(T<2001:db8::1\*(T>. Note that -you must use brackets around the IPv6 address if you specify port number. +you must use brackets around the IPv6 address. This option may be specified multiple times to listen to multiple addresses and/or ports. .TP @@ -150,11 +150,6 @@ This is similar to the \*(T option, except that it is used for receiving connections from DTLS clients. The default port number is \*(T<2083\*(T>. .TP -\*(T -This is similar to the \*(T option, except that it is -used for specifying port and optionally the address to receive UDP Accounting -messages on. -.TP \*(T This can be used to specify source address and/or source port that the proxy will use for sending UDP client messages (e.g. Access Request). @@ -215,7 +210,8 @@ The client block is used to configure a client. That is, tell the proxy about a client, and what parameters should be used for that client. The name of the client block must (with one exception, see below) be either the IP address (IPv4 or IPv6) of the client, an IP prefix (IPv4 or IPv6) of the form -IpAddress/PrefixLength, or a domain name (FQDN). +IpAddress/PrefixLength, or a domain name (FQDN). Note that literal IPv6 +addresses must be enclosed in brackets. .PP If a domain name is specified, then this will be resolved immediately to all the addresses associated with the name, and the proxy will not care about any @@ -234,7 +230,8 @@ client name is an IP prefix. Alternatively one may use the \*(T option inside a client block. In that case, the value of the \*(T option is used as above, while the name of the block is only used as a descriptive name for the -administrator. +administrator. The host option may be used multiple times, and can be a mix of +addresses, FQDNs and prefixes. .PP The allowed options in a client block are \*(T, \*(T, \*(T, \*(T, @@ -325,7 +322,16 @@ name of the server must match the FQDN or IP address in the server certificate. Alternatively one may use the \*(T option inside a server block. In that case, the value of the \*(T option is used as above, while the name of the block is only used as a descriptive name for the -administrator. +administrator. Note that multiple host options may be used. This will then be +treated as multiple names/addresses for the same server. When initiating a TCP/TLS +connection, all addresses of all names may be attempted, but there is no failover +between the different host values. For failover one must use separate server +blocks. +.PP +Note that the name of the block, or values of host options may include a +port number (separated with a column). This port number will then override the +default port or a port option in the server block. Also note that literal IPv6 +addresses must be enclosed in brackets. .PP The allowed options in a server block are \*(T, \*(T, \*(T, \*(T, -- cgit v1.1