X-Git-Url: http://sru.miketaylor.org.uk/?a=blobdiff_plain;f=doc%2Fproxy.xml;h=3948f4efa8d6cbd9e4def57dd64e949d3fab03ab;hb=ed3df7ad6c5f8c8dbd9c1c97c5c9cd2957a24ad9;hp=d64d6cfe9ad23e136e43bfee7cf9f2b6742bad00;hpb=c2f14867d5abde02ffe548fb0e269aa37756915f;p=yazpp-moved-to-github.git diff --git a/doc/proxy.xml b/doc/proxy.xml index d64d6cf..3948f4e 100644 --- a/doc/proxy.xml +++ b/doc/proxy.xml @@ -1,10 +1,10 @@ - + YAZ Proxy The YAZ proxy is a transparent Z39.50 to Z39.50 gateway. It is useful for debugging Z39.50 software, redirect - Z39.50 packages through firewalls, etc. + Z39.50 packages through fire walls, etc. Furthermore, the proxy offers facilities that often @@ -18,14 +18,15 @@ It does not store "state" information on the hard drive except the log files you want. -
Specifying the backend target +
+ Specifying the backend target When a Z39.50 client session is accepted by the proxy, the proxy determines the backend target by the following rules: If the Initialize Request PDU from the client - includes OtherInformation, with OID, + includes Other-Information, with OID, 1.2.840.10003.10.1000.81.1, that specifies the target. @@ -43,7 +44,8 @@
-
Keep-alive facility for Stateless clients +
+ Keep-alive facility for Stateless clients Stateless clients may generate a cookie for a Z39.50 session which is sent to the proxy as part of PDUs. @@ -58,13 +60,14 @@ point of view should be considered stateless. - As for the target specification, the OtherInformation + As for the target specification, the Other-Information area is used to hold the cookie with OID 1.2.840.10003.10.1000.81.2.
-
Query Caching +
+ Query Caching Simple stateless clients often sends identical Z39.50 searches in a relatively short period of time (full-list, next-page, @@ -84,13 +87,16 @@
-
Other optimizations +
+ Other optimizations We've had some plans to support caching of result set records, but this had not yet been implemented.
-
Proxy usage + +
+ Proxy usage @@ -117,7 +123,7 @@ DESCRIPTION - The proxy is a daemon on its own and runs standalone (no + The proxy is a daemon on its own and runs stand-alone (no inetd support). The host:port specifies host address and listening port respectively. Use @ for ANY address. @@ -157,7 +163,7 @@ Sets level for optimization. Use zero to disable; non-zero to enable. Handling for this is not fully implemented; - we will probably use a bitmask to enable/disable specific + we will probably use a bit mask to enable/disable specific features.