X-Git-Url: http://git.indexdata.com/?p=yaz-moved-to-github.git;a=blobdiff_plain;f=doc%2Fbook.xml;h=203dd7cecdda7f37ff1e1bbcf6871644306ac390;hp=eaa87cae447629530801a6270ff15d193809fb1f;hb=30af0a1ebbea75c3e757eb03d3f988c61fce8511;hpb=d802116821b20c1dac70011b1ff36edfc4a3119b diff --git a/doc/book.xml b/doc/book.xml index eaa87ca..203dd7c 100644 --- a/doc/book.xml +++ b/doc/book.xml @@ -3171,7 +3171,7 @@ If you have a database system that you would like to make available by - means of Z39.50 or SRU, &yaz; basically offers your two options. You + means of Z39.50 or SRU, &yaz; basically offers two options. You can use the APIs provided by the &asn;, &odr;, and &comstack; modules to create and decode PDUs, and exchange them with a client. @@ -3316,8 +3316,8 @@ int statserv_main(int argc, char **argv, A boolean value, which determines whether the server will fork on each incoming request (TRUE), or not (FALSE). Default is - TRUE. This flag is only read by UNIX-based servers (WIN32 based servers - doesn't fork). + TRUE. This flag is only read by UNIX-based servers (WIN32-based servers + do not fork). @@ -3334,7 +3334,7 @@ int statserv_main(int argc, char **argv, int inetd A boolean value, which determines whether the server - will operates under a UNIX INET daemon (inetd). Default is FALSE. + will operate under a UNIX INET daemon (inetd). Default is FALSE. @@ -3399,12 +3399,12 @@ int statserv_main(int argc, char **argv, Pointer to function which is called after the command line options have been parsed - but before the server starts listening. - For forked UNIX servers this handler is called in the mother - process; for threaded servers this handler is called in the + For forked UNIX servers, this handler is called in the mother + process; for threaded servers, this handler is called in the main thread. The default value of this pointer is NULL in which case it isn't invoked by the frontend server. - When the server operates as an NT service this handler is called + When the server operates as an NT service, this handler is called whenever the service is started. @@ -3415,7 +3415,7 @@ int statserv_main(int argc, char **argv, Pointer to function which is called whenever the server has stopped listening for incoming connections. This function pointer has a default value of NULL in which case it isn't called. - When the server operates as an NT service this handler is called + When the server operates as an NT service, this handler is called whenever the service is stopped. @@ -3431,14 +3431,14 @@ int statserv_main(int argc, char **argv, The pointer returned by statserv_getcontrol points to a static area. You are allowed to change the contents of the structure, - but the changes will not take effect before you call + but the changes will not take effect until you call void statserv_setcontrol(statserv_options_block *block); - that you should generally update this structure before calling + You should generally update this structure before calling statserv_main(). @@ -3470,7 +3470,7 @@ bend_initresult (*bend_init)(bend_initrequest *r); Unlike previous versions of YAZ, the bend_init also serves as a handler that defines the Z39.50 services that the backend - wish to support. Pointers to all service handlers, + intends to support. Pointers to all service handlers, including search - and fetch must be specified here in this handler. @@ -3576,7 +3576,7 @@ typedef struct bend_initresult The auth member holds the authentication information - part of the Z39.50 Initialize Request. Interpret this if your serves + part of the Z39.50 Initialize Request. Interpret this if your server requires authentication. @@ -3632,7 +3632,7 @@ typedef struct { The bend_search handler is a fairly close - approximation of a protocol Z39.50 Search Request - and Response PDUs + approximation of a protocol Z39.50 Search Request - and Response PDUs. The setname is the resultSetName from the protocol. You are required to establish a mapping between the set name and whatever your backend database likes to use. @@ -3803,7 +3803,7 @@ typedef struct { Delete - For back-ends that supports delete of a result set only one handler + For back-ends that supports delete of a result set, only one handler must be defined. @@ -3870,12 +3870,12 @@ typedef struct bend_scan_rr { This backend server handles both Z39.50 scan and SRU scan. In order for a handler to distinguish between SRU (CQL) scan - Z39.50 Scan , it must check for a non-NULL value of + Z39.50 Scan, it must check for a non-NULL value of scanClause. - if designed today, it would be a choice using a union or similar, + If designed today, it would be a choice using a union or similar, but that would break binary compatibility with existing servers. @@ -3955,14 +3955,14 @@ typedef struct bend_scan_rr { - The above for the Apache 1.3 series. + The above is for the Apache 1.3 series. Running a server with local access only - Servers that is only being accessed from the local host should listen - on UNIX file socket rather than a Internet socket. To listen on + A server that is only being accessed from the local host should listen + on UNIX file socket rather than an Internet socket. To listen on /tmp/mysocket start the server as follows: application unix:/tmp/mysocket