X-Git-Url: http://sru.miketaylor.org.uk/?a=blobdiff_plain;f=doc%2Fyaz-proxy-ref.xml;h=252ed1ddc822f8cdfdc5f592102eaa4c651e7e39;hb=4747b581a54bf1a0e80eefd324b3096b03399821;hp=ba4aaa5127a5ba7afb1ef48a4be1621aa55f6096;hpb=4b58a5d2d97f7ae989a2d31475af52de9c47a06a;p=yazpp-moved-to-github.git
diff --git a/doc/yaz-proxy-ref.xml b/doc/yaz-proxy-ref.xml
index ba4aaa5..252ed1d 100644
--- a/doc/yaz-proxy-ref.xml
+++ b/doc/yaz-proxy-ref.xml
@@ -10,13 +10,16 @@
yaz-proxy
-a filename
+ -l filename
-m num
-v level
-t target
- -u auth
+ -U auth
-o level
-i seconds
-T seconds
+ -p pidfile
+ -u userid
-c config
host:port
@@ -24,13 +27,24 @@
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 receives the hangup signal, SIGHUP.
+
OPTIONS
@@ -42,6 +56,14 @@
standard output.
+ -l filename
+
+ Specifies the name of a file to which to write a log of the
+ YAZ proxy activity. This uses the logging facility as provided
+ by the YAZ toolkit. If this options is omitted, the output
+ directed to stderr.
+
+
-m num
Specifies the maximum number of connections to be cached
@@ -50,7 +72,7 @@
-v level
- Sets the logging level. level is
+ Sets the logging level. level is
a comma-separated list of members of the set
{fatal,debug,warn,log,malloc,all,none}.
@@ -62,7 +84,7 @@
initRequest.
- -u auth
+ -U auth
Specifies authentication info to be sent to the backend target.
This is useful if you happen to have an internal target that
@@ -90,7 +112,22 @@
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).
+ it will be closed. Default: 600 seconds (10 minutes).
+
+
+ -p pidfile
+
+ When specified, yaz-proxy 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, yaz-proxy will change identity to the user ID
+ specified, just after the proxy has started listening to a
+ possibly privileged port and after the PID file has been created
+ if specified by option -u.
-c config
@@ -148,14 +185,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
-