1 Possible compatibility problems with earlier versions marked with '*'.
3 Fix SSL libs for configure when --with-openssl=DIR is given.
7 Add autoconf m4 macro YAZ_DOC for YAZ documentation setup (docbook).
9 SSL comstack now uses yaz.pem certificate file on server side
10 by default. Certificate filename can be configured by calling
11 comstack function cs_set_ssl_certificate_file before cs_bind is used.
13 Fix bug regarding multiple calls to ZOOM_connection_connect.
15 Implement cs_set_ssl_ctx which sets SSL_CTX for SSL comstack.
17 Do not create SSL_CTX in cs_create (ssl_type). Create in tcpip_bind,
18 tcpip_rcvconnect instead. This allows user to set custom SSL_CTX.
20 ZOOM now allows inspection of X509 peer certificate for verification.
21 The X509 buffer is retrived by reading ZOOM option "sslPeerCert".
23 Removed libyazssl.la. When SSL is enabled, libyaz.la has SSL support and
24 all programs have too (yaz-ztest, yaz-client, zoom..). May not be
25 as "modular" but it simplifies things.
27 Added cs_get_peer_certificate to that returns peer X509 PEM.
29 Added cs_get_ssl that returns SSL handle (SSL *) for SSL comstack; returns
30 NULL if SSL is unavailable.
32 Documentation about MARC decoding tools.
34 Fix --disable-tcpd to really disable tcpd. Patch by Robin H. Johnson.
38 Rename CHANGELOG to NEWS to follow GNU style packing.
40 Fix bug with missing initialization of member in init_diagnostics.
41 This bug affects threaded version of GFS server.
45 Use wrbuf_xmlputs_n instead of wrbuf_write_cdata to avoid clash with
48 Ensure zlib.dll is packed with Windows install.
52 Fix encoding of xsd:string to use text instead of CDATA.
54 Fix endless loop in CQL parser with unbalanced ".
56 Use a more compact way to store MARC-8 conversion tables.
58 --- 2.0.16 2004/03/16 Debian only
60 Oleg Kolobov Fixed a bug in yaz_iconv regarding conversion to
63 Update CQL parser to use new CQL 1.1 modifiers for booleans and
70 Another fix for decoding of XML packed records.
74 Fixes for Chunked encoding. White space not ignored after length spec.
76 Update NS and use default NS for SRW diagnostic elements.
80 Implement ZOOM_resultset_cache_reset which resets record cache.
82 Implement ZOOM_resultset_sort which sorts a result set.
84 Implement chunked HTTP transfer.
86 For SSL, use -lssl -lcrypto on systems that don't have pkg-config.
90 Added member 'schema' to bend_explain_rr structure so that backend
91 can specify explain record identifier. Defaults to Zeerex 2.0.
93 Fix encoding of OID's of form 1.0.X. Bug introduced in 2.0.11.
97 * SRW/SRU 1.1 updates: updated diagnostic in srw.h to use uri instead
100 Added init command for yaz-client which sends "extra" init request.
102 Fixed two bugs in OID codec - ber_oidc. Throw error when encoding/decoding
103 bad truncated OID. Fix decoding of OID X.Y... when X=2 and Y>39.
105 Fixed a bug in ASN.1 compiler that caused Type-1 Operator codec to fail.
107 Make ZOOM error code for "invalid query".
109 Fixed compilation for SSL which wasn't properly enabled for all platforms.
111 --- 2.0.10 2004/02/05
113 For yaz.m4, allow second argument for YAZ_INIT to hold minimal version of
116 * SRW/SRU 1.1 updates. Diagnostic code now a URI.
118 Added option -p <file> to make Generic Frontend Server to write PID file.
120 Added option -D to put Generic Frontend Server in background on its own.
122 Make ZOOM C recognize option "password". If unset, "pass" is used
123 (for backwards compatibility).
125 Fixed a bug in Generic Frontend Server that could make it crash if a
126 client sets characterSetNegotation bit, but didn't pass negotiation stuff
129 New YAZ client command, zversion, that sets Z39.50 version (1,2,3..).
130 Must be issued before open, in order to be in effect.
132 --- 2.0.9-6 2004/01/12 Debian/Windows
134 Make the SRU server more picky WRT unknown params, etc.
136 Bug fix: ZOOM scan response didn't return displayTerm - when present.
138 New YAZ client command, options, that sets Z39.50 options.
140 New utility functions yaz_init_opt_{encode,decode} to encode/decode Z39.50
141 options from a string of tokens (one token for each option bit).
143 Update SRW diagnostic code messages.
145 --- 2.0.9-5 2004/01/07 Debian/Windows
147 Handle user defined stylesheet for SRW/SRU.
149 --- 2.0.9-4 2004/01/06 Debian/Windows
151 Fix bug in decoding of Content-Length.
153 --- 2.0.9-3 2004/01/06 Debian/Windows
155 Fix a bug with decoding of XML packed records.
157 --- 2.0.9-2 2004/01/05 Debian only
159 Allow empty ODR (NMEM=0) for odr_oiddup and odr_getoidbystr.
161 Fix bug in SRW/SRU diagnostics decoding.
165 Fixed bug in Generic Frontend Server which could drop records exceeding
166 preferred message size. Reported and fixed by Irina Dijour.
168 Fixed calculation of package size for structured records in Generic
169 Frontend Server. Reported and fixed by Irina Dijour.
171 Fixed namespace for SRW/SRU diagnostics.
173 Fixed SEGV in yaz-client that occured for HTTP connection errors.
177 * SRW/SRU 1.1. Since the Namespace has changed for SRW/SRU, it means that
178 this version is incompatible with version 1.0 and older YAZ SRW/SRU
181 CQL changes to reflect recent changes to the specification:
182 * Documentation talks about context sets instead of index sets.
183 * Documentation talks about indexes instead of qualifiers.
184 * The CQL-to-PQF transformer's configuration file now uses
185 "index.set.name = <attributes>" instead of the old form
186 "qualifier.set.name = <attributes>". (Both forms are still
187 understood but the latter is deprecated.)
188 * CQL terms with no explicit index specified are now interpreted as
189 cql.serverChoice instead of srw.serverChoice (which of course
190 behaves exactly the same.)
194 MARC conversion can now generate ISO2709 output in another
195 character set. yaz-marcdump uses this facility if you invoke it
198 Added missing C decl macros for include/yaz/{soap.h,srw.h,cql.h}, so that
199 functions from there can be used from C++.
203 Frontend server now transfers memory from decoded packages to stream
206 NMEM now clears freed blocks with 'Y' (hex 59) to force bad memory
207 references to show up.
209 ZOOM-C now supports standard ZOOM option names as described in v1.4 of
210 the ZOOM Abstract API. The older names for the same options are still
211 also supported for the benefit of old applications.
213 ZOOM-C supports "implementationId" and "implementationVersion" options
214 to go along with "implementationName". These allow the user code to
215 specify identification strings to be sent to servers.
216 Add OID for the new ExtLite attribute set.
218 Add OIDs for NACSIS-CATP, FINMARC2000 and MARC21-fin record-syntaxes,
219 as requested/supplid by Ere Maijala <ere@atp.fi>
221 For generic frontend server, reverse the order of
222 "toolkit-supplied / application-supplied" strings sent as implementationId,
223 Name and Version. Also, remove the spaces around the slash. This brings
224 the GFS in line with the behaviour of ZOOM-C on the client side.
226 Add function ZOOM_scanset_display_term.
228 yaz-client shows scan displayTerm if present.
230 Utility yaz-iconv is now installed by default along with the man page
233 Extend configure check for OpenSSL to use pkg-config where available (such
236 Incorporate patch by Morten Bogeskov which allows a Unix file socket
237 server to specify uid/gid/mask for socket using the format
238 unix:[user=uid,][group=gid,][umask=mask,]file=path
239 If file= is omitted the existing format is assumed, e.g.
241 in which case the mask is 0666 (rw for everybody).
243 Major restructure of YAZ source. All source in libyaz is in src directory.
244 Programs in client (yaz-client), ztest (yaz-ztest), zoom (zoom programs),
245 util (utility programs such as ASN.1 compiler, yaz-marcdump).
247 Added man page for utility yaz-marcdump (used to be called marcdump).
248 yaz-marcdump is installed by 'make install'.
250 Fixed a memory leak in Generic Frontend Server that occurred when decoding
251 of incoming package failed.
253 Fixed a potential DOS attack vulnerability in COMSTACK/ODR.
255 Change prototype of odr_perror: add const to message string.
257 New function yaz_log_reopen which reopens log file (for log rotate, etc.)
259 * Blocking parameter for COMSTACK cs_create is now a bit mask rather
260 than a blocking flag. Bit 0 is set for blocking, reset for non-blocking.
261 Bit 1 is set if cs_addrstr should avoid DNS lookup; reset for full
262 DNS lookup. There should not be any compatibility problems with this
263 assuming that blocking=1 or 0 is used.
265 Fix bad reference in UNIX comstack in function cs_addrstr.
267 Fix for compilation on AIX.
269 The generic front-end server (server/seshigh.c) now supports returning
270 Init diagnostics to the client in User-information-field, in
271 accordance with Z35.90 Implementor Agreement 5 (Returning diagnostics
276 Allow any CQL relation (not just all,any,exact,scr).
278 Fixes for OCLC UI ASN.1 to make it work with SilverPlatter targets
279 that features the same UI.
281 Implemented command update0 in YAZ client which is equivalent to
282 update but uses old of Ext Update ASN.1.
284 Use OID 1.2.840.10003.15.1000.81.1 for privately defined charsets
285 in charset negotiation. Added VAL_ID_CHARSET in oid.h.
286 Previously no OID was used for this info.
288 ZOOM uses smallSetUpperBound=1 instead of 0 for piggyback searches.
289 It apparantely upsets EBSCO Publishing IR Z39.50 Server which
290 returns 'malformed search term' otherwise.
292 SortResponse member resultCount now set to NULL in sort handler of
295 OPAC support ZOOM. ZOOM_record_get returns OPAC info (as XML) if
298 Add three new utility functions for translating OIDs between various
299 formats -- symbolic name such as "Usmarc", minus-1-terminated int
300 arrays and dotted strings such as "1.2.840.10003.9.5.1":
301 int *oid_name_to_oid(oid_class oclass, const char *name, int *oid);
302 char *oid_to_dotstring(const int *oid, char *oidbuf);
303 char *oid_name_to_dotstring(oid_class oclass, const char *name, char *oidbuf);
305 Reverted modifications for ES Update definition for z_IU0Update
306 (OID 1.2.840.10003.9.5.1 and 1.2.840.10003.9.5). The definition
307 is back to YAZ 2.0.2.
309 String value attributes for CCL parser.
311 Support for OCLC's locally registered "OCLC-UserInformation" PDU,
312 which their FirstSearch server returns in Init responses, sometimes
313 carrying useful diagnostic information when Init fails. This has the
314 OID 1.2.840.10003.10.1000.17.1 and is defined in the file
315 "z39.50/oclcui.asn", where its definition is somewhat different from
316 what OCLC document on their web-site, as required to interoperate with
319 Support for anonymous authentication in yaz-client. Use the command
322 * Fix the OID of the Index Data-local "admin" Extended Service from
323 1.2.840.10003.9.81.1 to 1.2.840.10003.9.1000.81.1. The omission of
324 the 1000, which indicates a locally-defined OID, was a mistake.
328 Fix CCL directive @case handling so that it affects string match for
329 both CCL keywords and qualifiers.
331 * ESFormat-Update updates. Packages with OID 1.2.840.10003.9.5.1 and
332 1.2.840.10003.9.5 are now handled by the same decoder z_IU0Update .
333 Decoder has been updated with ASN.1 changes as listed in
334 http://lcweb.loc.gov/z3950/agency/defns/updateES.html
335 Note that the "latest" DB Update, OID 1.2.840.10003.9.5.1.1 , handler
336 z_IUUpdate, remains unchanged.
338 ZOOM_record_get may now return a record in a specific character set.
339 For type use "form; charset=from[,to]" where form (render, xml, ..) ,
340 "from" is the character set of record as returned by target. "to" is
341 the character set to be returned. If omitted, "to" is UTF-8.
343 YAZ ASN.1 compiler renamed from yaz-comp to yaz-asncomp
345 New ODR utility, odr_getelement, which returns name of element for
346 which encoding/decoding failed.
348 Fixed ODR so that it returns error code OREQUIRED rather than ONONE
349 in cases where a required element was omitted.
351 Bug fix: some MARC8 sequences were not converted.
353 New ZOOM option "step" which specifies number of records to be
354 retrieved in one chunk. Used in conjunction with "start" and "count".
356 SRW support for yaz-client. Use scheme http: to use it, e.g.
359 yaz-client no longer does (un)intelligent character set conversions
360 by default. Can be enabled with charset and marc_charset commands.
362 xmalloc trace fix for 64-bit systems such as DEC alpha.
364 Solaris 2.6 compile fix.
366 New function, cql_strerror() translates SRW error codes, as returned
367 by cql_transform_error(), into human-readable English strings. Used
368 in yaz-client diagnostics when appropriate.
370 New CQL2RPN query-type for the command-line yaz-client, parses CQL and
371 converts it into a type-1 query which is sent to the server. This
372 makes CQL available for use with all Z-servers, as opposed to the tiny
373 minority that can handle CQL queries themselves.
377 New Debian package layout similar to the Redhat Package layout.
379 New ZOOM events ZOOM_EVENT_RECV_{RECORD,SEARCH} for receiving a record
380 and search result respectively.
384 Redhat package is now several packages: libyaz (runtime libraries),
385 libyaz-devel (development and documentation, and yaz (utility programs).
386 Package spec file by Morten Bøgeskov.
388 New member 'schema' in struct bend_fetch_rr which the name of requested
389 schema (SRW/SRU) for record (or NULL if none was given). The fetch
390 handler MAY set this to reflect the schema of the returned record.
392 New member 'display_term' in struct scan_entry. GFS now sets member entries
393 and allocates scan entries to be filled by user scan handler. In previous
394 version, entries member was allocated by the scan handler. That still works,
395 but the GFS will ignore member display_term - assuming it was NOT set by
396 the handler. The fact that the GFS now allocates the entries both allows
397 for new members and makes a scan handler easier to write.
399 Fix CQL lex buffer overflow.
401 SRW/SRU recordPacking. For SRW default recordPacking is string. For
402 SRU default recordPacking is string.
404 SRU protocol support for frontend server.
406 Fix compile bug for systems that have nl_langinfo but CODESET undefined.
408 Added missing PQF transform rules for <= and >= . Thanks to Peter Popovics.
410 Added scan for the ZOOM shell (zoomsh).
414 * String Identifers for Schemas (Amendment 5).
415 http://lcweb.loc.gov/z3950/agency/amend/am5.html
416 Old definition for schema
417 Odr_oid *schema; /* OPT */
422 Z_InternationalString *uri;
423 #define Z_Schema_oid 1
424 #define Z_Schema_uri 2
427 * resultCount parameter to Sort Response (Amendment 1).
428 http://lcweb.loc.gov/z3950/agency/amend/am1.html
430 Support for SRW 1.0 over HTTP. This is an optional feature and
431 requires libxml2 to operate. Enable SOAP by specifying --with-xml2
434 Generic frontend server supports HTTP/SOAP/SRW and Z39.50/BER
435 on the same port. SRW SearchRetrieveRequests are mapped
436 to bend_init,bend_search,bend_fetch,bend_close.
438 Z39.50 Query Type-104 added - to facilitate CQL within Z39.50.
440 CQL support. Source is directory 'cql'. CQL is supported in ZOOM
441 (both SRW and Z39.50) and the YAZ client (Z39.50 only).
443 ZOOM connections are SRW based if schem http is used for hostname
444 in connect, e.g. z = ZOOM_connection_new("http://myserver");
445 ZOOM_query may be of type CQL, e.g. ZOOM_query_cql(q, "dc.title=x");
447 CCL proximity operators !n, %n converts to PQF @prox 0 n 1 2 k 2
448 and @prox 0 n 0 1 k 2 respectively, meaning: exlusion=false,
449 distance=n, order=true/false, relation=le, prox unit=word. If
450 n is omitted, distance 1 is used.
452 Fixed problem with C compiler include path in wrong order.
454 For TCP/IP COMSTACK, set recv buffer to an appropriate "large" value
455 on Solaris. Patch from Ko van der Sloot.
457 New MARC decode API. All new functions operate on a yaz_marc_t
458 handle. The most important new functions are: yaz_marc_create,
459 yaz_marc_decode_{buf,wrbuf}, yaz_marc_destroy, .. to create handler,
460 decode and destroy respectively. Decoder can produce formats
461 MARC line, simple XML, OAI MARC and MARC XML (LoC). See
462 include/yaz/marcdisp.h.
464 YAZ Iconv utility now supports MARC8 decoding (marc8.c). Converts
465 to UTF-8, UCS-32, wchar_t or Latin-1.
467 * Prototypes for yaz_iconv_-functions moved to separate header
468 include/yaz/yaz-iconv.h.
470 Make a few private functions 'static' in unix.c. This prevents
471 duplicate unix_close in PHP with YAZ and imap. PHP Bug 20977.
473 For ZOOM connection, the options targetImplementation{Id,Name,Version}
474 are set when Init Response is received.
476 New function ZOOM_connection_error_x similar to ZOOM_connection_error
477 but returns diagnostic set as well.
479 New function yaz_strerror which is a portable wrapper for
480 strerror/strerror_r/GetLastMessage.
482 * ZOOM_record_get supports type "xml" in which case MARC XML (from LOC)
483 is returned for MARC. If type is "oai", then OAI MARC is returned.
485 Fix creation of lib/yaz-config so it works if srcdir != objdir. Patch
490 yaz_marc_decode uses OAI MARC as XML format for ISO2709 records.
492 Fix bad race conditions on SIGTERM and terminate gracefully in
495 Move retrieval (data1) module to Zebra since nobody seems to be
498 Add GRS-1 render for ZOOM using same format as yaz-client.
502 Added man pages: yaz-client(1), yaz-ztest(8), yaz(7), zoomsh(1).
504 Fix broken ESpec handling in data1 module.
506 SGML reader parses comments and makes them part of the data1 tree.
508 Added several type casts so that YAZ compiles as C++ code.
510 ZOOM didn't handle PDU encoding failures properly.
512 Added more Bib-1 diagnostics (approved extensions).
514 GNU configure: better check for iconv.
516 More portable use of accept, getpeername. Check for socklen_t. Use
517 int/size_t if socklen_t is not defined.
521 PQF parser rejects bad queries - including those with extra
522 characters in them. PQF parser used to silently ignore that.
523 Cleaner API for PQF added, which allows you to get detailed
524 error information for bad queries (see yaz/pquery.h).
526 Fixed bug in ZOOM_record_get for type "database".
528 Implemented mini iconv library supporting conversions between
529 UTF-8, UCS4, UCS4LE and ISO-8859-1. Implemented in util/siconv.c.
531 * Removed XML reader (d1_expat.c). It's part of Zebra instead.
535 Fixed ZOOM C record cache so that preferredRecordSyntax and
536 elementSetName is used to check for already fetched records.
540 Added three members in bend_initrequest structure to facilitate
541 character set negotiation.
543 Fixed a bug in frontend server that could cause indefinite
544 loops under rare conditions.
546 Revised character set utilities (charneg.h) so that encoding
547 UCS-4, UCSA-4, UTF-16 and UTF-8 are encoded non-privately.
549 For PQF, directive @term <type> sets term type for Scan/Search.
550 Here <type> is general, string, numeric, null. The term type
551 is inherited - just like @attr.
553 New call odr_set_charset that sets character set conversion for
554 international-strings on a ODR stream. Prototype is:
555 int odr_set_charset(ODR o, const char *to, const char *from);
556 The InternationalString is still represented as C string in YAZ
557 so native strings of type UTF-8, ASCII, etc. will work (UTF-16
558 won't). On the protocol level, you can use any encoding.
560 Support for UNIX sockets in ZOOM.
562 Solaris recv sometimes returns errno == ENOENT. It is treated as
563 EINPROGRESS. COMSTACK patch by Ko van der Sloot.
565 New COMSTACK of type UNIX Socket. Use "unix:/path" as address for
566 both client and server. Code by Morten Bøgeskov.
570 On Windows ZOOM functions are of type __stdcall rather than __cdecl, so
571 that they can be used directly from Visual Basic. You must recompile
572 your windows APP if you're using ZOOM.
574 Character Set and Language Negotiation(3) for ZOOM API and YAZ client.
575 Commands "lang" and "charset" sets language and character set respectively.
576 Options "lang" and "charset" is interpreted by the ZOOM API. Note, these
577 are not part of the official ZOOM spec) All is due to Oleg Kolobov.
579 Attributes from multiple CCL fields may be OR'ed rather than merged
580 using directive "@field or". Fields are still merged by default -
581 equivalent to "@field merge".
583 Fixed bug in ZOOM connect that occurred on OpenBSD (maybe others). Patch
586 Fixed bug in zget for parameter ExtendedServicesResponse.
592 Added PQF feature: '@attr type=value' may be written as '@type=value'.
594 Client displays USR.1:SearchResult-1 (hits per term).
596 Additional Search Info for search in Generic Frontend Server.
598 Fixed CCL parsing of "field=s".
600 WIN32 installer - using the excellent NSIS software from nullsoft.
602 Fixed CCL parsing of "field = - <number>".
604 Added function yaz_marc_decode that decodes MARC for line mode
605 display or XML (similar to that used by JZKit).
607 Fixed BER decoding of OPTIONAL CHOICE. The bug didn't affect the
608 Z39.50. But ISO/ILL was, however.
610 Added patch by Rustam T. Usmanov that implements Z39.50 duplicate
611 detection service (Z39.50-1995 Amendment 2) and Language Negotiation (3).
613 http://lcweb.loc.gov/z3950/agency/amend/am2.html
614 http://lcweb.loc.gov/z3950/agency/defns/charneg-3.html
618 New YAZ client features: Command completion and new commands:
619 push_command, set_apdufile, set_marcdump, set_cclfields, register_oid.
620 Code provided by Jacob Poulsen.
622 New call oid_trav, that visits all registered OIDs via callback.
624 Function ZOOM_record_get now returns const char pointer rather than
625 void pointer. It saves a lot of type casts.
627 For YAZ client, command "auth" now allows you to set authentication
628 in IdPass style. It is enabled when three tokens are given - order
629 is user, group and password.
631 Fix memory leaks in MARC record handling for ZOOM.
633 New option for YAZ client, -k <kilobytes> that sets
634 maximum record size. Similar to -k option for generic frontend
635 server and yaz-ztest.
637 More fixes for scan. Non-zero stepSize handled. OID's fixes.
639 Prefix query parser reports "fail" when bad attribute set is given.
641 Fix in MARC decoder. Proximity logging. Fix for attribute set
642 in scan handler for server. Patches by Shigeru Ishida.
644 SSL/COMSTACK updates. cs_rcvconnect completes SSL handshake. ZOOM
647 Configure option --with-openssl=<dir> now works when a directory is
648 specified. Patch provided by Morten Bøgeskov.
650 New option for YAZ client, -u <auth>, that sets authentication.
652 ZOOM fix: error information was sometimes "missing", since error
653 was cleared/reset too when it shouldn't.
655 ZOOM_record_get returns ISO2709 buffer when "raw" is given.
659 Scan for ZOOM API. New object ZOOM_scanset. New functions
660 ZOOM_connection_scan, ZOOM_scanset_size, ZOOM_scanset_term and
661 ZOOM_scanset_destroy.
663 New ZOOM function, ZOOM_connection_last_event, that returns type
664 of last event (such as "receive data", "send data", "apdu received",
667 New ZOOM option, schema, that specifies schema for retrieval.
669 New CCL feature. Qualifiers can be aliases for one or more
670 other qualifiers (if more than one is given, OR is used).
672 ZOOM uses named result sets if target supports it.
674 Two new YAZ client commands: . (dot, which sources a script of YAZ
675 client commands), and ! (to execute shell command.). Implemented
678 Working on Debian packages.
682 YAZ client enables named result sets only if target supports it.
684 *** ZOOM. Prefix for ZOOM definitions changed from Z3950_ to ZOOM_.
686 * ZOOM. Removed Z3950_connection_host. Use Z3950_connection_option_get
687 with key="host" to get same result.
689 * ZOOM. Added Z3950_record_clone and removed Z3950_resultset_get.
690 Function Z3950_resultset_record(s) returns references to records
691 "owned" by resultset. To become owner use Z3950_record_clone.
693 Function z_ext_record handles Extended Services. Thanks to
698 CCL Parser fix: ignore token comma when dealing with and-lists.
700 Documentation updates for COMSTACK.
702 * ZOOM changes. Query object renamed from Z3950_search to Z3950_query.
703 Changed prototype Z3950_records. For some functions, int parameters
704 were changed to size_t.
706 TCP/IP COMSTACK no longer uses getprotobyname to avoid memory leak
709 New MARC decode/display function, marc_display_exl, which properly rejects
710 non-ISO2709 records. YAZ client uses it.
714 Fix bug: local attribute set wasn't set correctly in PQF strings.
718 * Old Z39.50 codecs no longer supported.
720 Added ZOOM C binding. See http://zoom.z3950.org/
722 Renamed states for COMSTACKs to avoid confusion with events.
724 Implemented cs_look and proper cs_rcvconnect.
726 Fixed COMSTACK error that occurred on HPUX. Fix by Giannis Kosmas.
728 Configure detects POSIX threads on OpenBSD.
730 When sort flag 'i' was specified in yaz-client the caseSensitivy flag
731 was set to a wrong value. Thanks to Robert Sanderson for reporting this.
733 When error is returned from present handler, non-surrogate diagnostic
734 is returned in present response (and fetch handler is no longer called).
736 * Minor adjustments to pquery parser (PQF). Token characters may be
737 escaped by using backslash (C-style).
739 PQF parser allows string attribute values to be specified. For @attr,
740 non-numeric characters after the equal-sign are treated as strings
741 (e.g. @attr 9=title).
743 CCL trunction character may be defined (@truncation in file)
745 * function zget_ExtendedServicesRequest sets waitAction to
746 waitIfPossible (was wait).
748 Added cs_set_blocking to set change blocking mode of a COMSTACK. Thanks
751 CCL operator names may be set in field definition files (CCL_bibset).
752 See ccl/bib1 for an example.
754 Fixes in ASN.1 compiler for C++ compatibility.
756 * Renamed members "and" and "or" in struct Z_Operator to "op_and"
757 and "op_or" to avoid conflict with C++.
759 Fixed problem with GNU readline detection on Redhat 7.0.
761 Added step-size for Scan backend handler.
763 Fixed bug that made the frontend server crash when no attribute
764 set was specified for scan.
766 Front-end server automatically switches to original working directory
767 when installed as an NT service. Previously -w had to be specified to
770 Added extended attributes for retrieval module (data1), so that data1
771 records carry d1_readXML/SGML attributes. d1_read also supports
772 null-data rules ( <tag/>)
774 On UNIX when POSIX threads are available, a separate library libyazthread
775 is created. Programmers should link with that library and the yaz library
776 when using threads. The reason for the split was that some applications
777 on Linux, such as Apache, doesn't work well when using shared objects that
780 Added SSL support for the COMSTACK. You start yaz-client and yaz-ztest
781 (or any frontend server) in SSL mode by specifying ssl: followed by
782 address. Only tested on UNIX.
784 Added feature for CCL module. Virtual structure s=al or s=ol generates
785 and-list and or-list respectively instead of phrase search.
789 * Added prefix "yaz_" for the functions log_init.., log_file.. and
790 log_mask_str. This was done to avoid name conflicts with other libraries
791 (such as other PHP extensions).
793 Added raw OID member for preferred record syntax (request_format_raw)
794 and returned record syntax (output_format_raw) for backend fetch method.
796 Config file yaz-config now accepts options so that it returns specific
797 compile settings, etc. Thanks to Morten Bøgeskov <morten@bogeskov.dk>
799 Shared library support for UNIX using GNU libtool.
801 * Modified backend interface. Request/Response struct's replaced by
802 one read/write C struct. For example bend_fetchrequest and
803 bend_fetchresult have been replaced by single bend_fetch_rr struct.
804 Every handler - even search has to be registered in bend_init
805 handler. This means that the YAZ library no longer refers to
806 external functions and it makes it possible to make the whole
807 thing a single DLL/SO.
809 Added Segment handler for backend server.
811 Added Zmbol/Zebra administrative functions to YAZ client.
813 Threaded frontend server on UNIX (when POSIX Threads are available).
814 Starting the server with option -T enables multi-threading.
818 Added configure option --enable-comp/disable-comp to control use
819 of YAZ ASN.1 compiler. Use --disable-comp to use the old *coders
820 located in sub directory asn.
822 YAZ ASN.1 compiler renamed to yaz-comp in sub directory. It's installed
823 in ${exec_prefix}/bin along with the other programs yaz-client and
826 GNU automake used to maintain makefiles.
830 Changed retrieval module so that we can load records with no abstract
831 syntax defined. Tagpaths in these records are fully composed of string
834 Implemented ISO ILL protocol. Refer to stuff in sub directory ill.
838 On UNIX, the generated makefile now supports a proper 'make install'.
839 The prefix can be set via GNU configure to set the install location
840 (default is /usr/local).
842 * YAZ programs client and ztest were renamed to yaz-client and
843 yaz-ztest to avoid conflicts when users install YAZ in "standard"
844 locations, such as /usr/bin,/usr/local/bin,etc.
846 * YAZ Header files were moved from include to include/yaz. YAZ Header
847 files are referred to as include <yaz/log.h> rather than <log.h>.
848 The YAZ include path (-I ..) is therefore the same as before. Programmers
849 should update their #include statements or use -Ipath/include/yaz
850 instead. The main motivation for doing this change is that YAZ header files
851 can be installed in "standard" locations /usr/include,/usr/local/include
852 without introducing conflicts, since ALL YAZ header files are stored
853 in subdirectory yaz (under /usr/include for example).
855 Compilation of YAZ for WIN32 is now handled by an nmake-style makefile
856 rather than project/workspace files. We switched because project files
857 are incompatible between Visual C++ 5 and 6. Refer to windows.txt for
860 Changed name of logging function, logf, to yaz_log, to prevent name
861 clash with some math-log functions. The YAZ header log.h defines logf
862 to yaz_log (#define) so there should be no incompatibilities by this
865 Added bend_start/bend_stop handlers for server. These handler are
866 called on start/stop of server. For windows they are called whenever
867 a service is started/stopped.
869 * YAZ now auto-generates decoders/encoders for the Z39.50 protocol using
870 a fairly small ASN.1 compiler written in Tcl. The compiler is located
871 in util/yc.tcl. The auto-generated C code structures are, in a few
872 cases, incompatible with the old decoders. There are differences in the
873 following C structures Z_DiagRec, Z_External, Z_SortRequest, Z_SortResponse,
874 Z_AttributesPlusTerm, Z_ProximityOperator, Z_DefaultDiagFormat.
875 The preprocessor variable ASN_COMPILED is defined when the compiled
876 ASN.1 is being used. Encoder/decoder routines as well as the Z39.50
877 protocol ASN.1 is located sub directory <tt>z39.50</tt>. If you
878 wish to use the old encoders/decoders you can specify --disable-yc
881 Assigned OID for old DB Update (VAL_DBUPDATE0). Updated YAZ compiled
882 version so that it supports both new - and old version of DB Update
884 * Added 'name' parameter to ODR encoder/decoder routines to facilitate
885 pretty ODR print. Updated whole Z39.50 encoder/decoder to reflect the
886 change. The name parameter can be set to 0 in which no name is specified
887 for the construction. The macros odr_implicit and odr_explicit sets name
888 parameter to zero for the construction involved. New macros
889 odr_implicit_tag and odr_explicit_tag are similar to the others,
890 except that a name parameter is added. For programmers' that don't use
891 ODR they probably only need to change the call to z_APDU and z_External.
893 Added access control facility by interfacing the TCP wrapper library.
894 YAZ automatically attempts to find the TCP wrapper Library (-lwrap) and
895 tcpd.h on Unix systems. For the server, option -d<daemon> specifies the
896 name of the daemon and enables the access control as specified in
897 hosts.allow/hosts.deny. Refer to man pages tcpd(8) and hosts_access(5).
899 Fixed memory leak in ccl_find_str and ccl_qual_rm. Thanks to Hans van
900 den Dool <H.M.vdnDool@kub.nl>.
902 Added reference ID parameter to most functions in server API - refer
903 to backend.h. Thanks to Hans van den Dool <H.M.vdnDool@kub.nl>.
905 Changed name of ccl library to libccl.a (was ccl.a).
907 Fixed bug in decoder for Explain (Category TargetInfo).
909 Added support for GNU readline in client. Thanks to Jacob Poulsen
910 <ja7@dbc.dk>. GNU configure attempts to detect if readline is available.
912 * CHANGED DEFINITION OF ES: UPDATE (INCLUDING THE OID) to reflect the
913 new definition from the ZIG. NOTE THIS IF YOU HAVE AN UPDATE
914 IMPLEMENTATION! This change was made to the development version before
915 the ZIG decided to retract the amendment. If any users MUST be
916 compatible with the original Update definition, PLEASE CONTACT US, and
917 we will include a separate definition corresponding to the old Update
918 ES. Note that because of the change to the ASN.1 of the
919 TaskPackageRecordStructure we cannot define a single structure that
920 will support both versions.
922 * Added const modifier to buffer parameter for some ODR/BER encoding
923 routines: ber_dectag, ber_declen, odp_more_chunks, completeBER,
924 completeWAIS, odr_dumpBER.
926 Fixed bug in client.c which caused a crash when a scanResponse didn't
927 contain positionOfTerm.
929 * Fixed inconsistency in the ScanResponse/ListEntries protocol. This
930 * will cause an error in a client if a non-YAZ target sends both a
931 * list of Scan entries and non-surrogate diagnostics.
933 Retrieval module enhancements. Tag sets may be typed in the reference
934 to it. From the .abs-file the "tagset" directive takes a third optional
935 integer type for the tag set referenced. From a .tag-file the "include"
936 directive takes a third optional type as well. The old "type" directive
937 in the tag set itself is still recognized but acts as the default type
940 Backend interface change. Individual Scan terms returned from bend_scan
941 may also be tagged as Surrogate Diagnostics. Refer to struct scan_entry
942 in include/backend.h.
944 Retrieval module enhancements. Multiple tag sets and attribute sets may
945 be specified in abstract syntax specs. Revised the error/warning for
946 logging messages reported by the retrieval module when reading the
949 Object Identifier system (oid_..) changed. The API is backwards
950 compatible but the oid-routines now allocates new OID's when needed.
951 Raw OID's may be specified in oid_getvalbyname.
953 YAZ now uses GNU configure to generate Makefile(s).
955 * Minor changes in some of the member names of DeleteResultSetRequest and
956 DeleteResultSetResponse. See include/proto.h.
958 * Changed some C definitions regarding EXPLAIN record syntax (prt-exp.h)
959 and added member 'languages' in TargetInfo (which was missing).
961 Changed the way attribute sets are handled in the retrieval
962 module. These are now cached, just like the abstract syntaxes
965 Changed YAZ so that it links with compiled ASN.1.
967 Added Explain-schema definitions and mapping routines. The following
968 Explain categories have been implemented: AttributeDetails,
969 AttributeSetInfo, DatabaseInfo, CategoryList and TargetInfo.
971 Fixed minor bug in Windows version of Server Library.
973 --- 1.4pl2+ 1998/4/17 (Released with Zebra)
975 Added Extended Services to server (backend.h). Thanks to Charles Woodfield.
977 Added EXTERNAL: UNIverse Resource Report (non-standard).
979 Implemened odr_enum and odr_set_of functions to handle ASN.1 types
980 ENUMERATED and SET OF.
982 * Added 'const' to some of the char pointer arguments for the
983 functions, data1_read_node, data1_getelementbytagname,
984 data1_insert_taggeddata, data1_getesetbyname, data1_getelementbyname,
987 Fixed bug in data1_insert_taggeddata - the last_child member of
988 parent wasn't initialised.
990 * Changed data1_read_record and data1_read_node so that the supplied
991 "SGML"-buffer is read-only. In particular the resulting data1 - tree
992 doesn't refer to any parts of the "SGML"-buffer.
994 Fixed bug in server library (Windows version of statserv_remove).
996 * Changed code so that it compiles as C++. The type definition
997 of Odr_fun which is a member of Odr_arm was changed. The result is,
998 that an explicit typecast is needed for the fun pointer when
999 using Odr_arm - as in:
1000 {1, -1, -1, Z_IdAuthentication_idPass, (Odr_fun)z_IdPass},
1002 Updated TagSet-G and -M definitions (tagsetm.tag and tagsetg.tag).
1004 Implemented the new structured date and time definition as approved
1005 by the ZIG. Added schemaId element to the specificTag in Espec-1
1006 (also approved at the last ZIG). Thanks to RVDM.
1008 Added some Object identifiers (RVDM).
1010 Changed the Update Extended Service (RVDM).
1012 Added command "refid" to client which specifies referenceId for
1013 the following requests.
1015 Implemented extended service handling for server. See ztest.c
1016 for an example as well as backend.h. New handlers are registerd
1017 in the Init handler.
1019 * Changed interface for sort in server.
1021 Added new members to statserv_options_block. It allows a server
1022 to read options from another source than just the command line. Thanks
1023 to Charles Woodfield.
1025 * Changed definition of Z_Triple in file prt-grs.h - member boolean
1026 renamed to zboolean. Some C++ compilers complained about the name.
1028 Minor changes to gils.abs. Added index 's' (sort) on title
1029 and date/time-last-modified.
1031 --- 1.4pl2 1998/1/30
1033 Fixed bug in server library regarding inetd mode (-i). This bug
1034 was introduced by release 1.4.
1036 --- 1.4pl1 1998/1/29
1038 Added sort facility in client and backend server interface.
1040 Fixed problem with dependencies in Makefile(s).
1042 Fixed bugs for encoders/decoders of extended services and
1045 Implemented sub-tree feature for schemas. Sub-trees are
1046 referenced in *.abs-files. See explain.abs for an example
1047 of the use of this feature.
1049 Modified bib1.att; local attributes for ANY didn't include
1050 ANY itself (only affects use of the retrieval module).
1052 Fixed bug in plain SGML reader in function data1_read_node:
1053 tags with prefix "var" was incorrectly interpreted as variants.
1055 Added feature "sub-schemas" to enable references to - and definitions
1056 of - group of elements.
1058 * Removed member parent from type data1_element (in data1.h).
1060 Implemented function odr_nullval() that returns the value of
1063 * Removed member num_children from data1_node (in data1.h).
1065 Made NT service interface part of the server library. The
1066 function statserv_main uses the NT service when required and
1067 calls the statserv_start / statserv_close routines.
1069 Routine zget_SearchRequest and zget_PresentRequest fills
1070 resultSetName/Id member with "default" instead of "Default".
1072 Fixed memory leak in server. Request queue member wasn't freed.
1074 Fixed nmem_exit so that memory is freed.
1078 Revised the CCL parser utility to be thread safe.
1080 Added function, oid_ent_to_oid, to replace the function
1081 oid_getoidbyent, which is not thread safe.
1083 * Added nmem_init and nmem_exit to initialize and release
1084 NMEM resources. Function nmem_init should be called once in the
1085 initial thread before NMEM/ODR is used. statserv.c and client.c
1086 have been changed accordingly. The change was necessary to make
1087 NMEM thread safe. The NMEM memory pool is shared amongst threads
1088 in a process. Unix-based applications will still work fine without
1091 Added NT Services interface for the the Z39.50 (statserv) Server.
1092 Refer to the ztest.c source on the usage.
1094 Windows 95/NT port using MSVC5.0. Project files are included in the
1097 * Defined new 'global' handle for the retrieval (data1) system. The
1098 new handled, data1_handle, describes the state of the data1 system.
1099 This handle is passed as first argument to virtually all
1100 data1 related routines. The functions data1_create and data1_destroy
1101 creates and destroys a data1 handle respectively.
1103 Added ODR encode stream member to all backend request structures
1104 init, search, scan etc. This stream should be used to allocate all
1105 memory used for the response when thread safe operation is needed.
1107 Changed the comstack utility, cs_addstr, to be thread safe. The
1108 returned hostname string returned by the function is now part the
1111 Added comstack utility, cs_straddr, which replaces the tcpip_strtoaddr
1112 function. The cs_straddr takes a COMSTACK handle as argument, so this
1113 function must be used after cs_create and before bind/connect.
1114 This function is thread safe.
1116 Moved test server to 'ztest' directory - generic server code still
1117 in 'server' directory.
1119 Made prefix query (pquery.c) utility thread safe.
1121 Added new function modifier YAZ_EXPORT to 'export' public DLL
1122 functions when using windows (see include/yconfig.h).
1124 Added definitions to the OID database (util/oid.c) (RVDM).
1126 Added new BIB-1 diagnostic messages to the handler diagbib1_str.
1128 Added call to ccl_rpn_delete in client program.
1130 Added ODR argument to ccl_rpn_query and ccl_scan_query to provide
1131 release of RPN structure.
1133 Added support for C++, headers uses extern "C" for public definitions.
1134 With input from RVDM.
1136 In handling of SEQUENCE OF: Counter set to zero when SEQUENCE OF is absent.
1137 Thanks to Ronald van der Meer (RVDM).
1139 Added initializers (zget_ routines) for a number of PDUs. Thanks to RVDM.
1141 Added support for private extensions to the OID database
1142 (oid_setprivateoids()). Thanks to RVDM.
1144 Added optional, physical ANY (key replication)
1146 Fixed null-reference problem in GRS-1 output filter.
1148 Proximity operator added to Prefix Query Format (PQF).
1150 In test client command "base" accepts multiple databases.
1152 Fixed bug in cs_close stack that caused trouble with WINSOCK.
1156 Fixed tagging bug in ResourceReportResponse PDU encoder/decode.
1158 Smallish bug-fixes in the new encoders/decoders (explain).
1160 Bug fixed in DeleteRequest.
1162 Fixed tagging bug of type 101 query in SearchRequest-Query PDU encoder/decoder.
1164 Fixed tagging bug in ResourceReportResponse PDU encoder/decode.
1166 Added SOIF syntax (using private OID for now) to retrieval module and client.
1168 Added Update extended service.
1170 Added SearchResult-1 additional info structure.
1172 Added optional CCL (ISO8777) interpreter as separate module. Available
1175 --- 1.2 1996/6/10 (1st anniversary release)
1177 Added Summary record syntax. Lightly tested.
1179 Added OPAC record syntax. Untested.
1181 Added ResourceReport service encoders/decoders. Untested.
1183 Fixed bug in z_Unit - wrong tagging on unitSystem.
1185 Fixed bug in the DiagRecs decoder.
1187 Added options for max PDU size and session timeout to frontend-server.
1189 Added documentation of query-language parsers and other supporting utilities.
1191 [frontend-server] Added Attribute set to the bend_scanrequest API.
1193 [frontend-server] NextResultSetPosition was sometimes set incorrectly when
1194 surrogate diagnostics were generated.
1196 [retrieval] Allow multiple local values for attribute.
1198 [retrieval] Allow multiple attributes per element in .abs files. index type.
1200 [retrieval] Added Summary tagset, abstract syntax, and d1-node/ASN filter.
1202 --- 1.1pl2 1996/4/10
1204 Minor changes, mostly specific to Zebra's requirements (retrieval)
1208 Repaired bug in frontend server when running multiple listening
1209 endpoints in dynamic mode.
1211 z_External() now won't break if a known, ASN.1 value comes encapsulated
1212 in an octet-string. The value will pass through unmodified in an Odr_oct.
1214 Added a bit of code to the demo client to decode & display
1215 ASN.1-structured records represented in the octet-aligned branch of
1216 the EXTERNAL CHOICE. Thanks to CAS for prodding us to finally do this.
1218 Added z_ext_getentbyref() to the ASN module. Doc updated.
1220 * Completed the SCAN definition in the ASN module. This may break SCAN
1221 code based on older YAZ-versions at compile-time. The fix is easy -
1224 * Added 'displayTerm' and OtherInformation to the TermInfo structure
1225 under the SCAN definition. Remember to initialize this, server-people.
1227 Comstack should now support the WAIS protocol in TCP/IP mode. Note
1228 that this does not extend to ODR and ASN.
1230 Comstack allows insertion of established socket (primarily for
1231 inetd-operation of servers). Doc updated.
1233 Front-end server can now start from the inetd in TCP mode. Doc
1236 --- 1.0pl4 1996/1/24
1240 Fixed small problem in SUTRS-filter. A newline was sometimes inserted before
1241 the rank and record number.
1243 Adjustments to the frontend server.
1245 Fixed diagnostic BER dumper. It ignored the file argument.
1249 Various changes to retrieval module.
1251 Changed the union discriminators of the protocol files from enums to
1252 ints paired with #defines.
1254 *Changed oident.class to oident.oclass to avoid a reserved word in C++
1257 *Changed operator in the RPN structure to 'roperator', again to avoid a
1260 Fixed problems in Explain decoders/encoders.
1262 --- 1.0pl2 1995/12/6
1264 Memory bug in log module fixed.
1266 --- 1.0pl1 1995/12/5
1268 Occasional malloc() of 0 bytes fixed in d1_espec.c.
1270 Bug in Explain DatabaseInfo module fixed.
1272 Some '\r' snuck into one or two of the ret'l config tables. A curse on Windows.
1276 The shift to v1.0 signals that we now consider the *core* functionality
1277 of YAZ reasonably stable (the core being more or less equivalent to
1278 Z39.50-1992). Some of the really nifty v3 stuff is still not heavily
1279 tested (Explain not at all - though that will happen soonish).
1281 Minor changes to code to support Windows port.
1283 Various minor changes after we're getting to use GRS-1 & co. more.
1285 Added Espec-1 format.
1287 Added VisibleString field body type to GRS-1. It is illegal acc. to my copy
1288 of the protocol and it cannot be selected when encoding (maps into 'string'
1289 when decoding). Needed to talk to some servers.
1291 Demo client can request simple element set names.
1293 Added Diagnostic Format encoders/decoders.
1295 Added simple Close handling to frontend server (no hooks for resource
1296 reporting yet), and demonstration client.
1298 Added cs_addrstr() command to COMSTACK to retrieve peer hostname/address.
1300 --- 1.0b3 1995/08/24
1302 Fixed bug in the frontend-server. The numberOfRecordsReturned field was
1303 handled incorrectly when records were requested in the searchResponse. This
1304 will only affect you if you use the frontend-server.
1306 Added GRS-1 encoders/decoders to the service-level API. Lightly tested.
1307 Test-client will ask for and print GRS1. Ztest will return dummy records
1310 Added Explain encoders/decoders to the service-level API. Untested.
1312 Added Extended Services: Item Order encoders and decoders to the Service-
1313 level API. Untested. We could use a recent copy of the pertinent bits
1314 of the ILL protocol to add those bits.
1316 Added diagnostic format 1 encoders/decoders to the service-level API.
1319 Moved pretty-printing of structure-wrappers ({..}) from odr_seq.c to
1320 odr_cons.c, which causes a more correct output.
1322 Fixed handling of searchRequest in frontend server. NextResultSetPosition
1323 was always set to 0 when no records were requested in the searchRequest.
1325 * Added better external-handling. This shouldn't harm old code that
1326 *encodes* externals. It can break code that looks for a
1327 'single-ASN1-type' representation, since those types that are known
1328 are now decoded immediately. Look at the SUTRS sample code in
1329 seshigh.c and client.c. Documentation updated.
1331 Handling of structured records in bend_fetchresponse. Length -1 marks
1332 structured record, type is deduced from format field.
1334 --- 1.0b2 1995/06/27
1335 Fairly quick maintenance release to add SUTRS support.
1337 Fixed handling of SUTRS records in the demonstration client.
1339 * Added format field to the bend_fetchrequest and bend_fetchresponce
1340 structures of the backend API (frontend server). When the record is
1341 returned, the value of the format field is mapped to an OID. The
1342 value VAL_SUTRS will also cause a slightly different ASN.1 packaging
1343 of the record. The special value VAL_NONE in the bend_request means
1344 that no specific format was requested by the client. Documentation
1345 updated accordingly. Test server (ztest) will return a fixed dummy
1346 SUTRS record if your client requests SUTRS.
1348 Documentation updated accordingly.
1350 You can now set external libraries and RANLIB support in the top-level
1354 First public release.