X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fyaz-proxy-ref.xml;h=776f28aee69b884ea8549d246158374aa154a224;hb=550c148a623dd9c4dee6f2b065fba884785c61be;hp=c643b57308b5875e8ce1fe308d7305ca5facbe3d;hpb=09b40382c41a29b7e3de2fa1a0362f25422a4367;p=yazpp-moved-to-github.git
diff --git a/doc/yaz-proxy-ref.xml b/doc/yaz-proxy-ref.xml
index c643b57..776f28a 100644
--- a/doc/yaz-proxy-ref.xml
+++ b/doc/yaz-proxy-ref.xml
@@ -10,25 +10,38 @@
yaz-proxy
-a filename
- -c num
+ -m num
-v level
-t target
-u auth
-o level
-i seconds
+ -T seconds
+ -c config
host:port
DESCRIPTION
- The proxy runs stand-alone (not from
- inetd). The
- host:port
+ yaz-proxy is a Z39.50 optimizing proxy daemon.
+ The listening port must be specified on the command-line.
+ inetd operation is not supported.
+ The host:port
argument specifies host address to listen to, and the port to
listen on. Use the host @
to listen for connections coming from any address.
+
+ yaz-proxy can be configured using command-line
+ options or a configuration file.
+ Configuration file options override values specified
+ on the command-line.
+
+
+ yaz-proxy rereads its configuration file and
+ reopens log files when it receivies the hangup signal, SIGHUP.
+
OPTIONS
@@ -40,7 +53,7 @@
standard output.
- -c num
+ -m num
Specifies the maximum number of connections to be cached
[default 50].
@@ -78,14 +91,29 @@
-i seconds
- Specifies in seconds the idle time for communication
- for proxy. If a connection is inactive for this long
+ 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).
+
+
+ -T seconds
+
+ Specifies in seconds the idle time for communication between
+ proxy and backend target.
+ If a connection is inactive for this long
it willl be closed. Default: 600 seconds (10 minutes).
+ -c config
+
+ Specifies config filename. Configuration is in XML
+ and is only supported if the YAZ proxy is compiled with
+ libxml2.
+
+
-
+
EXAMPLES
The following command starts the proxy, listening on port
@@ -131,14 +159,22 @@
The YAZ command-line client,
- yaz-client,
- allows you to set the proxy target as part of the Initialize
- Request using option -p.
- For example, to connect to Index Data's target you could use:
+ yaz-client,
+ allows you to set the proxy address by specifying option -p. In
+ that case, the actual backend target is specified as part of the
+ Initialize Request.
+
+ Suppose you have a proxy running on localhost,
+ port 9000 and wish to connect to Index Data's test target at
+ indexdata.dk:210/gils you could use:
+
+ yaz-client -p localhost:9000 indexdata.dk:210/gils
+
+ Since port 210 is the default, the port can be omitted:
+
+ yaz-client -p localhost:9000 indexdata.dk/gils
+
-
- yaz-client -p indexdata.dk localhost:9000/gils
-