X-Git-Url: http://git.indexdata.com/?p=yazproxy-moved-to-github.git;a=blobdiff_plain;f=doc%2Fyaz-proxy-ref.xml;h=da0c713b117d1148616bdb339557becd36cd2e03;hp=c44603da99386589c7df1f8de243426261afef6d;hb=8bc5868c392af49bdbaf3c8cd372dbb1d8d6e777;hpb=e751544e4f8f678eafaf851a215033af6a779684 diff --git a/doc/yaz-proxy-ref.xml b/doc/yaz-proxy-ref.xml index c44603d..da0c713 100644 --- a/doc/yaz-proxy-ref.xml +++ b/doc/yaz-proxy-ref.xml @@ -10,17 +10,18 @@ yazproxy -a filename + -c config + -i seconds -l filename -m num - -v level - -t target - -U auth + -n num -o level - -i seconds - -T seconds + -t target -p pidfile + -T seconds -u userid - -c config + -v level + -X host:port @@ -58,6 +59,20 @@ standard output. + -c config + + Specifies config filename. Configuration is in XML + and is only supported if the YAZ proxy is compiled with + libxml2. + + + -i seconds + + Specifies in seconds the idle time for communication between + client and proxy. If a connection is inactive for this long + it will be closed. Default: 600 seconds (10 minutes). + + -l filename Specifies the name of a file to which to write a log of the @@ -68,30 +83,15 @@ -m num - Specifies the maximum number of connections to be cached - [default 50]. - - - -v level - - Sets the logging level. level is - a comma-separated list of members of the set - {fatal,debug,warn,log,malloc,all,none}. + Specifies the maximum number of client connections to be + offered [default 150]. - -t target + -n num - Specifies the default backend target to use when a client - connects that does not explicitly specify a target in its - initRequest. - - - -U auth - - Specifies authentication info to be sent to the backend target. - This is useful if you happen to have an internal target that - requires authentication, or if the client software does not allow - you to set it. + Sets maximum number of open files to num. + This is only available on systems that offers the + setrlimit(2) call. -o level @@ -102,11 +102,18 @@ features. By default optimization is enabled (value 1). - -i seconds + -p pidfile - Specifies in seconds the idle time for communication between - client and proxy. If a connection is inactive for this long - it will be closed. Default: 600 seconds (10 minutes). + When specified, yazproxy will create pidfile + with the process ID of the proxy. The pidfile will be generated + before the process changes identity (see option -u). + + + -t target + + Specifies the default backend target to use when a client + connects that does not explicitly specify a target in its + initRequest. -T seconds @@ -117,13 +124,6 @@ it will be closed. Default: 600 seconds (10 minutes). - -p pidfile - - When specified, yazproxy will create pidfile - with the process ID of the proxy. The pidfile will be generated - before the process changes identity (see option -u). - - -u userid When specified, yazproxy will change identity to the user ID @@ -132,11 +132,19 @@ if specified by option -u. - -c config + -v level - Specifies config filename. Configuration is in XML - and is only supported if the YAZ proxy is compiled with - libxml2. + Sets the logging level. level is + a comma-separated list of members of the set + {fatal,debug,warn,log,malloc,all,none}. + + + -X + + Enables debugging mode for the proxy. When specified, the proxy will + not fork itself, thus any violations becomes fatal. Useful if + you run yazproxy inside gdb. + Don't run this in production.