From 7a8b8195358610868a183c6b72844c94dc317f2b Mon Sep 17 00:00:00 2001 From: Adam Dickmeiss Date: Wed, 10 Jan 2001 09:14:08 +0000 Subject: [PATCH] Added more info. --- README.txt | 57 ++++++++++++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 50 insertions(+), 7 deletions(-) diff --git a/README.txt b/README.txt index e1a7d5d..e912279 100644 --- a/README.txt +++ b/README.txt @@ -1,6 +1,6 @@ YAZ++ - A C++ library for YAZ -$Id: README.txt,v 1.7 2000-10-26 21:31:50 adam Exp $ +$Id: README.txt,v 1.8 2001-01-10 09:14:08 adam Exp $ o Introduction @@ -31,8 +31,7 @@ Directory structure of the YAZ++ package. o Installation, Unix -Make sure you have a C - and C++ compiler available. gcc and -g++ works fine. +Make sure you have a C - and C++ compiler available. gcc and g++ works fine. Before compilation can take place YAZ must be installed. It goes, roughly, like this: @@ -50,13 +49,57 @@ Then, build YAZ++: o Installation, Windows -Software is WIN32 and should run on Windows 95/98 and Windows NT 4.0. -Yaz++ was build using Microsoft Visual C++ 6.0. Other compilers should -work but makefile/project files will have to be created for those -compiler environments. +YAZ++ for WIN32 should run on Windows 95/98/2K and Windows NT 4.0. +Yaz++ was built using Microsoft Visual C++ 6.0. Other compilers +should work but makefile/project files will have to be created for +those compilers. Workspace yazxx.dsw includes the projects yazxx.dsp - builds yazxx.dll yazclient.dsp - builds yazclient.exe yazserver.dsp - builds yazserver.exe yazproxy.dsp - builds yazproxy.exe + +o About the proxy.. + +For the proxy the actual target is determined in by the OtherInfo +part of the InitRequest. We've defined an OID for this which we call +PROXY. OID is 1.2.840.10003.10.1000.81.1. + + OtherInformation ::= [201] IMPLICIT SEQUENCE OF SEQUENCE{ + category [1] IMPLICIT InfoCategory OPTIONAL, + information CHOICE{ + characterInfo [2] IMPLICIT InternationalString, + binaryInfo [3] IMPLICIT OCTET STRING, + externallyDefinedInfo [4] IMPLICIT EXTERNAL, + oid [5] IMPLICIT OBJECT IDENTIFIER}} +-- + InfoCategory ::= SEQUENCE{ + categoryTypeId [1] IMPLICIT OBJECT IDENTIFIER OPTIONAL, + categoryValue [2] IMPLICIT INTEGER} + +The InfoCategory is present with categoryTypeId set to the PROXY OID +and categoryValue set to 0. The information in OtherInformation uses +characterInfo to represent the target using the form target[:port][/db]. + +For the client that doesn't set the PROXY OtherInformation, a default +target can be specified using option -t for proxy. + +Example: + We start the proxy so that it listens on port 9000. The default + target is Bell Labs Library unless it is specified by a client in + the InitRequest. + + $ ./yaz-proxy -t z3950.bell-labs.com/books @:9000 + + The client is started and talks to the proxy without specifying + a target. Hence this client will talk to the Bell Labs server. + $ ./yaz-client localhost:9000 + + The client is started and it specifies the actual target itself. + $ ./yaz-client -p localhost:9000 bagel.indexdata.dk/gils + + For ZAP the equivalent would be + proxy=localhost:9000 + target=bagel.indexdata.dk/gils + Simple, huh! -- 1.7.10.4