1 Changed the way PQF queries are encoded in SRU GET/POST. PQF search
2 before: x-pquery=pqf . PQF search now: query=pqf&x-querytype=pqf . This
3 makes the SRU request more conformant because the required query parameter
4 is always present. PQF scan before: x-pScanClause=pqf . PQF scan now:
5 scanClause=pqf&x-querytype=pqf .
7 For the generic frontend server, the maximum record size is used as maximum
8 size of incoming packages (SRU + Z39.50). The value until was previously
9 only used in Z39.50 Init negotiation and, later, in a session controlled
10 sizes of records returned. This is controlled using -k option. It can be
11 specified, per server, with element maximumrecordsize in YAZ' GFS XML config.
15 TCP/IP comstack uses getaddrinfo now to resolve names. It should be IPV6
18 Fixed bug #644: Using Non Reentrant gethostbyname causes SIGSEGV.
20 New option for yaz-marcdump -lpos=value which allows setting a portion
21 of MARC header to a certain value.
23 Fixes for MARC generation when encoded as MARC-8 (bug 642, 643).
25 ZOOM-C reads option extraArgs. If set the value of extraArgs is appended to
26 SRU URI (POST/GET). Value must be URL encoded, such as x-id-a=v1&x-id-b=v2 .
30 Fixed problem with SRU mode type (soap, get, post) for yaz-client
33 Fixed problem another problem with ZOOM_EVENT_RECV_RECORD . Bug #626.
37 Fixed MARC ISO2709 encoding routines to deal with character set
40 Minor changes to GFS logging. Database included in search request log
43 Fixes for ZOOM-C: event ZOOM_EVENT_RECV_RECORD was not generated for
44 cached/multiple records.
46 Shared libraries are built by default on Unix+configure.
48 Changed cql2pqf transformation to use a different evaluation order. The
49 new order is: always, relation, structure, position, truncation, index
50 and relationModifier. Old order was: always, relation, relationModifier,
51 structure, index, position, truncation. Note that the the latter ones
52 override former ones for identical attributes.. The new scheme means that
53 it is possible to override any existing attribute with a relationModifier.
54 And also that it is possible to override everything for the index rule
55 (except the ones listed in relationModifier). No order is perfect but this
56 one, we believe, covers more real cases.. The "always" should have been
57 called "default", since the attributes there can be overridden with all
60 For Libxml2 and friends, YAZ defines YAZ_HAVE_{XML2,XSLT,EXSLT) in the
61 compilation phase, but also for yaz-config --cflags output. This allows
62 us to have public headers with Libxml2 stuff in them . It should also,
63 eventually, make Libxml2 checks redundant in packages using YAZ, such
68 Changed SRU update structure bend_update_rr so that SRU diagnostics are
69 stored in uri, message and details.. Previously diagnostics were stored
70 in errcode, errstring. Patch by Ko van der Sloot. Breaks binary
71 compatibility.. but he's probably the only one affected, so.
73 Added support for CCL, compiled on the client side, in ZOOM-C. This
74 is invoked using ZOOM_query_ccl2rpn() with the CCL configuration as
75 input; the resulting query objects can be used for for searching with
76 ZOOM_connection_search() and scanning with ZOOM_connection_scan1().
78 YAZ' configure searches for OpenSSL by default.
80 SSL comstack uses SL_CTX_use_certificate_chain_file rather than
81 SL_CTX_use_certificate_file. See
82 http://lists.indexdata.dk/pipermail/yazlist/2006-June/001615.html
83 for more info. Thanks to Ko van der Sloot.
87 Bug #600: SRU GET, POST support for yaz-client. Introduced
88 command 'sru' which selects method SOAP/GET/POST.
90 Allow missingValueAction to be specified for the sortspec string -
91 function yaz_sort_spec. By default, the missing value action is null.
92 Use ! to specify "abort". Use = followed by stringvalue to specify default
95 Ensured that Present-handler (if defined) is called in GFS before any call to
96 fetch-hhndler. This now includes piggy-backed presents as well as SRW/U
97 searchRetrieve requests.
99 Documentation for YAZ is now based on the Docbook XML/XSLT using
100 xsltproc + N Walsh's stylesheets. It means that the CVS version of YAZ
101 is no longer depending on jade/openjade or docbook-to-man scripts.
102 PDF is no longer part of the distribution - but can optionally be
103 made using DSSSL/jadetex or FOP.
105 Added retrieval handling support in Generic Frontend Server to support
106 conversion between MARC/XML as well as XSLTtransforms. See
107 etc/yazgfs.xml for an example.
109 Added Authentication support to Generic Frontend Server in SRU
110 mode. Authentication using HTTP Basic is supported, as is the use
111 of 'x-username' and 'x-password' parameters in the request itself.
113 Added support for a new character set MARC8s identical to MARC8 except
114 that it converts combined characters to single Unicode characters in the
115 Latin-1 range (when possible).
117 --- 2.1.18 2006/04/24
119 ASN.1 compiler 0.4: generates brief Doxygen file header for
120 generated .h/.c files.
122 Utility yaz_iconv now supports conversion to MARC-8.
124 New facilities for the MARC module. The reading - and writing of
125 content are separate methods for the yaz_marc_t handle. The following
126 read functions are available: yaz_marc_read_iso2709 (Reads MARC in
127 ISO2709 format), yaz_marc_read_xml (reads MARC in MARCXML/MarcXchange
128 format). Write functions have prefix yaz_marc_write_.. The existing
129 utilities yaz_marc_decode_wrbuf and yaz_marc_decode_buf are still
130 available. Removed support for OAI-MARC and simplexml (not the
131 simplexml from PHP5).
133 Added a new ZOOM event type ZOOM_EVENT_END which signals no more events
134 to be returned for this connection.
136 --- 2.1.16 2006/03/31
138 Allow multiple languages and charsets to be specified with
139 yaz-client. Each item must be separated by comma (NO BLANKS). E.g.
140 negcharset iso-8859-1,utf-8
142 Translation of proximity nodes from CQL into PQF now works.
144 Moved to automake 1.8, 1.9.
146 Added function yaz_log_set_handler which allows a log handler to be
147 installed. This handler will be called for all log messages. Output
148 to file is also produced; but that can be disabled by passing NULL
149 fname to yaz_log_init_file.
151 Fixed another problem with MARC-8 -> ISO-8859-1 conversions. Bug #537.
153 For SRW (including GFS), accept application/soap+xml as content-type
156 For GFS in SRU mode, an empty stylesheet in SRU URL (&stylesheet=&)
157 produces NO stylesheet reference even if a default stylesheet is specified
160 --- 2.1.14 2006/03/14
162 Updated Windows package to include yazd.dll + yazd.lib for the
163 Development component.
165 If the environment variable YAZ_LOG is set, then it is used as a
166 string indicating the default level of logging to use if not
167 overridden by calls to yaz_log_init() or yaz_log_init_level(). If
168 it's not defined, then the manifest constant YLOG_DEFAULT_LEVEL is
169 used as before. So, for example, to omit warnings from YAZ logging,
172 cql_transform() now map structure and other attributes before indexes,
173 so that index-specific structures and other attributes can override
174 defaults. So now a combination of mapping specifications such as:
176 index.dc.date = 1=date-modified 4=5
177 does the right thing.
179 cql_transform() now also respects the "always" mapping specification,
180 which establishes an initial set of attributes to be used for all
181 terms except where overridden by more specific attributes associated
182 with the index, relation or modifier.
184 Added SRU-GET and SRU-POST support for ZOOM C. Option "sru" specifies
185 which mode to use; one of "post", "get" or "soap" (SRW, default).
187 Fixes for yaz_iconv routines: changed trie-based character set conversions
188 to use only non-negative values for bit fields due to Sun's C compiler not
189 supporting negative values.
191 Fixed bug in character set conversion yaz_iconv. Some three byte UTF-8
192 sequences where not read correctly. Fix by Rustam Usmanov.
194 Updated win/makefile to use options, settings which makes things
195 compile with VS C 2005.
197 --- 2.1.12 2006/02/01
199 Fixed bug in yaz_oi_update which used incorrect value for categoryValue.
201 In ZOOM socket code, use select instead of poll on MacOSX.
203 ZOOM-C now support client-side compilation of CQL into RPN that is
204 sent to the server, enabling CQL to be used against all Z39.50
205 servers. Use ZOOM_query_cql2rpn() to set the compiled CQL into a
206 ZOOM_query object, and submit it using ZOOM_connection_search().
207 The CQL-to-RPN translation uses a configuration file, the name of
208 which must be specified in the Connection's "cqlfile" option.
210 ZOOM-C also support CQL scanning, via the new ZOOM_connection_scan1()
211 function, which takes as its start-term parameter a ZOOM_query object
212 (which may have had either CQL or RPN set into it).
215 --- 2.1.10 2005/11/29
217 Added ZiNG Update Support. New codecs are defined in srw.h. Extended the
218 GFS to support this as well. Backend handler, bend_srw_update, does the
219 update work. Code contributed by Ko van der Sloot.
221 Allow retrieval of Search Result-1 information in ZOOM by the use of
222 options that are attached to a result set. ZOOM documentation updated
225 Fixed bug #416: First/second comb characters not handled in the MARC-8 to
226 UTF-8 conversion. Patch by Raj Patel.
228 Added option -m to GFS to control formatting of timestamps in log file.
230 Added 'exit' as synonym for 'quit' in yaz-client
232 Added support for specifying SRW resultSetId + resultSetIdleTime in a
233 Generic Frontend Server's search handler. Refer to include/yaz/backend.h
234 for the new members. Patch by Ko van der Sloot.
236 Added support for SRU POST. It is supported for content-type
237 application/x-www-form-urlencoded only. Patch by Ko van der Sloot.
239 Do not build the separate Multi-threaded (MT) library libyazthread.la.
240 Instead make the library libyaz.la multi-threaded. Threading as a whole
241 can still be disabled by configure option --disable-threads. Previosly,
242 with older GLIBCs there were problems with MT libs under Apache. This
243 has now been fixed a long time ago.
245 Fixed bugs in yaz_log that occurred on Sparc Solaris in Multi-threaded
248 CQL module modified to be case insensitive for relations/indexes/operations.
250 Fixed bug in CQL transform code: incorrect value relationModifieder
253 Added 'show all' command for yaz-client which retrieves all results
256 Added new yaz-client, xmles, which takes a (private) OID and
257 a document to be sent as an extended service request.
259 Describe new yaz-client commands wait_response and set_auto_wait.
261 Increase TCP/IP listener backlog from 3 (which I am guessing was
262 copied from the SunOS manual entry way back when) so SOMAXCONN, so
263 that the socket will queue as many incoming connections as it's able
264 to handle ongoing connections. In other words, it will never now
265 refuse a connection that it would be able to handle merely because
266 it's not got around to accepting() enough of the pending connections
267 yet. This is the behaviour anyway under Linux, where the listen()
268 argument is ignored; but not under BSD and on systems such as
269 MS-Windows that use BSD-derived TCP/IP stacks. The behaviour of
270 YAZ-based servers should now be uniform across operating systems in
273 yaz-marcdump uses 64-bit file access on some systems. This is enabled
274 on Linux and other Unix variants where _FILE_OFSET_BITS=64 is supported.
275 This allows yaz-marcdump to read large MARC batches (>2 GB).
277 Modified all YAZ source files - except the source which is auto-generated
278 by tools - to use spaces rather than TABS. Emacs/VIM trailer added to
281 Add ZOOM_connection_option_getl() and ZOOM_options_getl(),
282 corresponding to the existing *_setl() function. These allow option
283 values containing arbitrary valuues.
285 Add ZOOM_resultset_sort1(), which should ALWAYS be used in place of
286 ZOOM_resultset_sort() in new applications. Its behaviour is identical
287 except that it returns an indicator of whether or not the sort
288 criterion was accepted (0 for OK, -1 for invalid).
292 Fixed bug in yaz_marc_decode_buf. By mistake the routine appended
293 MARC output rather than returning "new" buffer.
295 yaz-client warns about unknown init options.
297 Fixed bug #371: "options concurrentOperations ignores concurrentOperations"
301 Added support for SRW sort in Generic Frontend Server. Patch
302 by Ko van der Sloot. Member srw_sortKeys in bend_search_rr holds
303 sortKeys - or NULL if none is provided.
305 Fixed bug #307: It was impossible to specify indefinite/no timeout
306 for ZOOM_event. Special timeout value -1 now means indefinite timeout
309 Added support for multiple languages and charsets to be specified in
310 ZOOM. Each charset/language is separated by a blank. If negotiation is
311 in effect in init-response, Option
312 "negotiation-charset-in-effect-for-records" set to 1(true) or 0(false).
313 Code based on patch by Vasiliy Osadchuk.
315 Fixed bug #306: infinite recursion that occurred when calling
316 yaz_log_level_init as the first call (before other log level or
319 Fixed bug in scan handling in front end server: if preferred-Position-In-
320 Response was non-present, a NULL pointer referece was performed.
324 Changed include/yaz/diagbib1.h and added include/yaz/diagsrw.h with
325 diagnostic messages+codes for Bib-1 and SRW. Preprocessor defines are
326 now defined for all those error codes. So instead of putting 109 in
327 your program you'd use YAZ_BIB1_DATABASE_UNAVAILABLE. The messages
328 are generated from a .csv - file. See src/bib1.csv and srw/srw.csv.
330 Modified the yaz-marcdump utility to skip garbage bytes between MARC
333 Fixed bug - uninitialized memory - due to bad code for fix of bug #272.
335 Program yaz-client now exits and produces an error message if multiple
336 Z39.50 servers are specified on the command line (none or one allowed
339 Program yaz-marcdump skips garbage bytes between ISO2709 records rather
344 Fixed bug #273: Update for recent MARC-8 -> UNICODE changes.
346 Fixed bug #272: Preserve spacing for CCL terms.
350 Added support for virtual hosts and multiple backend servers for
351 the YAZ frontend server. The configution is XML based and
352 support specificition of CQL to RPN mappings and explain information.
353 See section "Virtual Hosts" in the YAZ manual.
355 Extended OPAC display utility. OPAC display utility renders
356 bibliographic (MARC) record as well. Added yaz_opac_decode_wrbuf
357 to supplement yaz_marc_decode_wrbuf.
359 Fixed a bug in MARC decoder that could caused it to crash for some
360 invalid MARC records. More diagnostics and warnings where added in
361 XML output (warnings, etc are stored in comments).
363 --- 2.0.34 2005/02/08
365 Fixes for UNIX domain sockets. Bug #261.
367 Fixes for MARC-8 to UTF-8 conversion. Bugs #258 and #260.
369 Fixed bug #263: YAZ MARCXML dump shows extra spaces after control fields.
370 Added yaz_marc_subfield_str which defines subfield lead string which is
371 used in YAZ_MARC_LINE format. Default string is blank+$. Added
372 yaz_marc_endline_str which defines end of fields string used in
373 YAZ_MARC_LINE format. Default string is newline.
375 Experimental support for MarcXChange. This format can be produced
376 by yaz-marcdump and is implemented in yaz_marc_decode - functions.
377 http://www.bs.dk/standards/MarcXchange.xsd
379 Added yaz-client commands scansize that sets maximum number of
380 entries to be returned by scan.
382 --- 2.0.32 2005/01/11
384 Added support for SRW scan in yaz-client and Generic Frontend Server.
386 * Added whereInList member to SRW Scan Term.
388 * Changed Z_SRW_scanRequest to be able to carry both CCL and PQF.
390 Fixed NMEM system to return aligned blocks on the smallest boundaries
391 that are suitably aligned for all possible types on the particular
392 architecture YAZ is being built for.
394 --- 2.0.30 2005/01/04
396 Fixed numerious warnings that was issued with newer versions of GCC.
398 Fixed NMEM system to return aligned blocks on 8 byte boundaries rather
399 than 4 bytes, since 4 may not be enough on some systems such as GCC 3.4.3
402 Make YAZ Generic Frontend Server slightly faster.
404 Enhance (and reduce) logging for Generic Frontend Server.
406 Revert YAZ log system so that it flushes every write operation
407 by default. (YAZ 2.0.26 and earlier verisons did that). Bug #240.
409 Modified the YAZ logging system. The LOG level defines use YLOG_ prefix
410 instead of LOG_, due to name clash with syslog(3). LOG_ are still
411 present. New applications should define YAZ_USE_NEW_LOG=1 - this
412 will effectively disable old definitions.
414 --- 2.0.28 2004/11/09
416 Added yaz_log_time_format which specifies log format using
419 Added yaz_log_module_level which returns mask for a module. Value
420 is non-zero mask a if module is enabled; zero if disabled.
422 * Fixed bug #148: CQL parser may leak. A few prototypes were changed
423 in include/yaz/cql.h.
425 Fixed bug #176: Dont throw diagnostics on empty SRU args.
427 Fixed bug #175: surrogate diagnostics in SRW lacking NS.
429 Fixed bug #172: RPM builds does not enable SSL.
431 Doxyfile.in part of dist. Doxyfile generated by configure.
433 Configure aborts if any of --with-xml2, --with-openssl, --enable-tcpd
434 are given and the corresponding component does not exist.
436 Extend CCL documentation in YAZ reference. Describe r=r.
438 --- 2.0.26 2004/10/01
440 Fixed MARC->MARCXML conversion to properly deal with
441 fields, subfields, indicators having non-ASCII characters.
443 Fixed MARC->MARCXML conversion so that ASCII control characters
444 except TAB,CR,LF are removed from resulting XML (XML 1.0 does not
447 Added YAZ GFS support for conversion from Z39.50 surrogate
448 diagnostics to SRW surrogate diagnostics.
450 Bug fix: YAZ GFS did not return schema in explainResponse.
452 --- 2.0.25 2004/09/30
454 The YAZ GFS when converting SRW/SRU requests to Z39.50 structures
455 now converts recordSchema to elementSetName as well as schema URI.
457 Fixed bug in COMSTACK that prevented HTTP request packages from being
460 --- 2.0.24 2004/09/29
462 Added CCL facility r=r "range" which is similar to r=o "ordered" but
463 does not require white-space before and after the dash in a range, e.g.
464 x=-1990 is equivalent to x <= 1990 iff r=r, but equivalent to x= -1980
467 Fixed a few AC_TRY_LINK configure tests that did not operate properly
468 due to new GCC removing "redundant" code.
470 Added yaz-client commands scanpos and scanstep that sets preferred
471 position and step-size for scan.
473 Macro YAZ_INIT in yaz.m4: option --with-yazconfig renamed to --with-yaz.
475 Added CCL utility ccl_qual_buf which parses one or more CCL
476 spec lines in a buffer.
478 Added CCL utility ccl_qual_line which adds CCL qualifier line consisting
479 of name and value - ignoring empty lines and comments.
481 On Windows, the debug DLL/import lib is now named yazd.{dll,lib}.
483 Added odr_get_element_path which returns current element path for an
484 ODR handle. This utility is useful in error handling or user-defined
487 Added ODR_PRINT utility odr_set_stream which is is a more generic
488 alternative to odr_setprint. odr_set_stream takes a stream handle, pointer
489 to a write function and pointer to close function. The close function - if
490 non-NULL - will be called during odr_destroy.
492 Fixed bug in CCL parser where truncation char was not removed from
493 right side when truncation=both was in effect.
495 Fixed CQL parser to use unsigned chars for isxxx from ctype.h due
498 --- 2.0.23 2004/08/11
500 Fix buffer overrun in CQL parser when dealing with proximity (%).
502 Fixes for MARC-8 in yaz_iconv character set utilies. The MARC-8
503 to UTF-8/UCS conversion is now only based on codetables.xml.
505 yaz_marc_decode_buf sets leader pos 9 to "a" for MARCXML output.
507 --- 2.0.22 2004/08/06
509 Add support for more "commit changes" in ZOOM (uses Extended Services).
511 For yaz-client, command set_marcdump <file> / -m <file> dumps SUTRS/XML/..
514 Yet another small fix for configure of SSL.
516 --- 2.0.21 2004/05/14
518 Fix SSL libs for configure when --with-openssl=DIR is given.
520 --- 2.0.20 2004/05/10
522 Add autoconf m4 macro YAZ_DOC for YAZ documentation setup (docbook).
524 SSL comstack now uses yaz.pem certificate file on server side
525 by default. Certificate filename can be configured by calling
526 comstack function cs_set_ssl_certificate_file before cs_bind is used.
528 Fix bug regarding multiple calls to ZOOM_connection_connect.
530 Implement cs_set_ssl_ctx which sets SSL_CTX for SSL comstack.
532 Do not create SSL_CTX in cs_create (ssl_type). Create in tcpip_bind,
533 tcpip_rcvconnect instead. This allows user to set custom SSL_CTX.
535 ZOOM now allows inspection of X509 peer certificate for verification.
536 The X509 buffer is retrived by reading ZOOM option "sslPeerCert".
538 Removed libyazssl.la. When SSL is enabled, libyaz.la has SSL support and
539 all programs have too (yaz-ztest, yaz-client, zoom..). May not be
540 as "modular" but it simplifies things.
542 Added cs_get_peer_certificate to that returns peer X509 PEM.
544 Added cs_get_ssl that returns SSL handle (SSL *) for SSL comstack; returns
545 NULL if SSL is unavailable.
547 Documentation about MARC decoding tools.
549 Fix --disable-tcpd to really disable tcpd. Patch by Robin H. Johnson.
551 --- 2.0.19 2004/03/30
553 Rename CHANGELOG to NEWS to follow GNU style packing.
555 Fix bug with missing initialization of member in init_diagnostics.
556 This bug affects threaded version of GFS server.
558 --- 2.0.18 2004/03/20
560 Use wrbuf_xmlputs_n instead of wrbuf_write_cdata to avoid clash with
563 Ensure zlib.dll is packed with Windows install.
565 --- 2.0.17 2004/03/17
567 Fix encoding of xsd:string to use text instead of CDATA.
569 Fix endless loop in CQL parser with unbalanced ".
571 Use a more compact way to store MARC-8 conversion tables.
573 --- 2.0.16 2004/03/16 Debian only
575 Oleg Kolobov Fixed a bug in yaz_iconv regarding conversion to
578 Update CQL parser to use new CQL 1.1 modifiers for booleans and
583 --- 2.0.15 2004/03/01
585 Another fix for decoding of XML packed records.
587 --- 2.0.14 2004/02/25
589 Fixes for Chunked encoding. White space not ignored after length spec.
591 Update NS and use default NS for SRW diagnostic elements.
593 --- 2.0.13 2004/02/23
595 Implement ZOOM_resultset_cache_reset which resets record cache.
597 Implement ZOOM_resultset_sort which sorts a result set.
599 Implement chunked HTTP transfer.
601 For SSL, use -lssl -lcrypto on systems that don't have pkg-config.
603 --- 2.0.12 2004/02/16
605 Added member 'schema' to bend_explain_rr structure so that backend
606 can specify explain record identifier. Defaults to Zeerex 2.0.
608 Fix encoding of OID's of form 1.0.X. Bug introduced in 2.0.11.
610 --- 2.0.11 2004/02/16
612 * SRW/SRU 1.1 updates: updated diagnostic in srw.h to use uri instead
615 Added init command for yaz-client which sends "extra" init request.
617 Fixed two bugs in OID codec - ber_oidc. Throw error when encoding/decoding
618 bad truncated OID. Fix decoding of OID X.Y... when X=2 and Y>39.
620 Fixed a bug in ASN.1 compiler that caused Type-1 Operator codec to fail.
622 Make ZOOM error code for "invalid query".
624 Fixed compilation for SSL which wasn't properly enabled for all platforms.
626 --- 2.0.10 2004/02/05
628 For yaz.m4, allow second argument for YAZ_INIT to hold minimal version of
631 * SRW/SRU 1.1 updates. Diagnostic code now a URI.
633 Added option -p <file> to make Generic Frontend Server to write PID file.
635 Added option -D to put Generic Frontend Server in background on its own.
637 Make ZOOM C recognize option "password". If unset, "pass" is used
638 (for backwards compatibility).
640 Fixed a bug in Generic Frontend Server that could make it crash if a
641 client sets characterSetNegotation bit, but didn't pass negotiation stuff
644 New YAZ client command, zversion, that sets Z39.50 version (1,2,3..).
645 Must be issued before open, in order to be in effect.
647 --- 2.0.9-6 2004/01/12 Debian/Windows
649 Make the SRU server more picky WRT unknown params, etc.
651 Bug fix: ZOOM scan response didn't return displayTerm - when present.
653 New YAZ client command, options, that sets Z39.50 options.
655 New utility functions yaz_init_opt_{encode,decode} to encode/decode Z39.50
656 options from a string of tokens (one token for each option bit).
658 Update SRW diagnostic code messages.
660 --- 2.0.9-5 2004/01/07 Debian/Windows
662 Handle user defined stylesheet for SRW/SRU.
664 --- 2.0.9-4 2004/01/06 Debian/Windows
666 Fix bug in decoding of Content-Length.
668 --- 2.0.9-3 2004/01/06 Debian/Windows
670 Fix a bug with decoding of XML packed records.
672 --- 2.0.9-2 2004/01/05 Debian only
674 Allow empty ODR (NMEM=0) for odr_oiddup and odr_getoidbystr.
676 Fix bug in SRW/SRU diagnostics decoding.
680 Fixed bug in Generic Frontend Server which could drop records exceeding
681 preferred message size. Reported and fixed by Irina Dijour.
683 Fixed calculation of package size for structured records in Generic
684 Frontend Server. Reported and fixed by Irina Dijour.
686 Fixed namespace for SRW/SRU diagnostics.
688 Fixed SEGV in yaz-client that occured for HTTP connection errors.
692 * SRW/SRU 1.1. Since the Namespace has changed for SRW/SRU, it means that
693 this version is incompatible with version 1.0 and older YAZ SRW/SRU
696 CQL changes to reflect recent changes to the specification:
697 * Documentation talks about context sets instead of index sets.
698 * Documentation talks about indexes instead of qualifiers.
699 * The CQL-to-PQF transformer's configuration file now uses
700 "index.set.name = <attributes>" instead of the old form
701 "qualifier.set.name = <attributes>". (Both forms are still
702 understood but the latter is deprecated.)
703 * CQL terms with no explicit index specified are now interpreted as
704 cql.serverChoice instead of srw.serverChoice (which of course
705 behaves exactly the same.)
709 MARC conversion can now generate ISO2709 output in another
710 character set. yaz-marcdump uses this facility if you invoke it
713 Added missing C decl macros for include/yaz/{soap.h,srw.h,cql.h}, so that
714 functions from there can be used from C++.
718 Frontend server now transfers memory from decoded packages to stream
721 NMEM now clears freed blocks with 'Y' (hex 59) to force bad memory
722 references to show up.
724 ZOOM-C now supports standard ZOOM option names as described in v1.4 of
725 the ZOOM Abstract API. The older names for the same options are still
726 also supported for the benefit of old applications.
728 ZOOM-C supports "implementationId" and "implementationVersion" options
729 to go along with "implementationName". These allow the user code to
730 specify identification strings to be sent to servers.
731 Add OID for the new ExtLite attribute set.
733 Add OIDs for NACSIS-CATP, FINMARC2000 and MARC21-fin record-syntaxes,
734 as requested/supplid by Ere Maijala <ere@atp.fi>
736 For generic frontend server, reverse the order of
737 "toolkit-supplied / application-supplied" strings sent as implementationId,
738 Name and Version. Also, remove the spaces around the slash. This brings
739 the GFS in line with the behaviour of ZOOM-C on the client side.
741 Add function ZOOM_scanset_display_term.
743 yaz-client shows scan displayTerm if present.
745 Utility yaz-iconv is now installed by default along with the man page
748 Extend configure check for OpenSSL to use pkg-config where available (such
751 Incorporate patch by Morten Bogeskov which allows a Unix file socket
752 server to specify uid/gid/mask for socket using the format
753 unix:[user=uid,][group=gid,][umask=mask,]file=path
754 If file= is omitted the existing format is assumed, e.g.
756 in which case the mask is 0666 (rw for everybody).
758 Major restructure of YAZ source. All source in libyaz is in src directory.
759 Programs in client (yaz-client), ztest (yaz-ztest), zoom (zoom programs),
760 util (utility programs such as ASN.1 compiler, yaz-marcdump).
762 Added man page for utility yaz-marcdump (used to be called marcdump).
763 yaz-marcdump is installed by 'make install'.
765 Fixed a memory leak in Generic Frontend Server that occurred when decoding
766 of incoming package failed.
768 Fixed a potential DOS attack vulnerability in COMSTACK/ODR.
770 Change prototype of odr_perror: add const to message string.
772 New function yaz_log_reopen which reopens log file (for log rotate, etc.)
774 * Blocking parameter for COMSTACK cs_create is now a bit mask rather
775 than a blocking flag. Bit 0 is set for blocking, reset for non-blocking.
776 Bit 1 is set if cs_addrstr should avoid DNS lookup; reset for full
777 DNS lookup. There should not be any compatibility problems with this
778 assuming that blocking=1 or 0 is used.
780 Fix bad reference in UNIX comstack in function cs_addrstr.
782 Fix for compilation on AIX.
784 The generic front-end server (server/seshigh.c) now supports returning
785 Init diagnostics to the client in User-information-field, in
786 accordance with Z35.90 Implementor Agreement 5 (Returning diagnostics
791 Allow any CQL relation (not just all,any,exact,scr).
793 Fixes for OCLC UI ASN.1 to make it work with SilverPlatter targets
794 that features the same UI.
796 Implemented command update0 in YAZ client which is equivalent to
797 update but uses old of Ext Update ASN.1.
799 Use OID 1.2.840.10003.15.1000.81.1 for privately defined charsets
800 in charset negotiation. Added VAL_ID_CHARSET in oid.h.
801 Previously no OID was used for this info.
803 ZOOM uses smallSetUpperBound=1 instead of 0 for piggyback searches.
804 It apparantely upsets EBSCO Publishing IR Z39.50 Server which
805 returns 'malformed search term' otherwise.
807 SortResponse member resultCount now set to NULL in sort handler of
810 OPAC support ZOOM. ZOOM_record_get returns OPAC info (as XML) if
813 Add three new utility functions for translating OIDs between various
814 formats -- symbolic name such as "Usmarc", minus-1-terminated int
815 arrays and dotted strings such as "1.2.840.10003.9.5.1":
816 int *oid_name_to_oid(oid_class oclass, const char *name, int *oid);
817 char *oid_to_dotstring(const int *oid, char *oidbuf);
818 char *oid_name_to_dotstring(oid_class oclass, const char *name, char *oidbuf);
820 Reverted modifications for ES Update definition for z_IU0Update
821 (OID 1.2.840.10003.9.5.1 and 1.2.840.10003.9.5). The definition
822 is back to YAZ 2.0.2.
824 String value attributes for CCL parser.
826 Support for OCLC's locally registered "OCLC-UserInformation" PDU,
827 which their FirstSearch server returns in Init responses, sometimes
828 carrying useful diagnostic information when Init fails. This has the
829 OID 1.2.840.10003.10.1000.17.1 and is defined in the file
830 "z39.50/oclcui.asn", where its definition is somewhat different from
831 what OCLC document on their web-site, as required to interoperate with
834 Support for anonymous authentication in yaz-client. Use the command
837 * Fix the OID of the Index Data-local "admin" Extended Service from
838 1.2.840.10003.9.81.1 to 1.2.840.10003.9.1000.81.1. The omission of
839 the 1000, which indicates a locally-defined OID, was a mistake.
843 Fix CCL directive @case handling so that it affects string match for
844 both CCL keywords and qualifiers.
846 * ESFormat-Update updates. Packages with OID 1.2.840.10003.9.5.1 and
847 1.2.840.10003.9.5 are now handled by the same decoder z_IU0Update .
848 Decoder has been updated with ASN.1 changes as listed in
849 http://lcweb.loc.gov/z3950/agency/defns/updateES.html
850 Note that the "latest" DB Update, OID 1.2.840.10003.9.5.1.1 , handler
851 z_IUUpdate, remains unchanged.
853 ZOOM_record_get may now return a record in a specific character set.
854 For type use "form; charset=from[,to]" where form (render, xml, ..) ,
855 "from" is the character set of record as returned by target. "to" is
856 the character set to be returned. If omitted, "to" is UTF-8.
858 YAZ ASN.1 compiler renamed from yaz-comp to yaz-asncomp
860 New ODR utility, odr_getelement, which returns name of element for
861 which encoding/decoding failed.
863 Fixed ODR so that it returns error code OREQUIRED rather than ONONE
864 in cases where a required element was omitted.
866 Bug fix: some MARC8 sequences were not converted.
868 New ZOOM option "step" which specifies number of records to be
869 retrieved in one chunk. Used in conjunction with "start" and "count".
871 SRW support for yaz-client. Use scheme http: to use it, e.g.
874 yaz-client no longer does (un)intelligent character set conversions
875 by default. Can be enabled with charset and marc_charset commands.
877 xmalloc trace fix for 64-bit systems such as DEC alpha.
879 Solaris 2.6 compile fix.
881 New function, cql_strerror() translates SRW error codes, as returned
882 by cql_transform_error(), into human-readable English strings. Used
883 in yaz-client diagnostics when appropriate.
885 New CQL2RPN query-type for the command-line yaz-client, parses CQL and
886 converts it into a type-1 query which is sent to the server. This
887 makes CQL available for use with all Z-servers, as opposed to the tiny
888 minority that can handle CQL queries themselves.
892 New Debian package layout similar to the Redhat Package layout.
894 New ZOOM events ZOOM_EVENT_RECV_{RECORD,SEARCH} for receiving a record
895 and search result respectively.
899 Redhat package is now several packages: libyaz (runtime libraries),
900 libyaz-devel (development and documentation, and yaz (utility programs).
901 Package spec file by Morten Bøgeskov.
903 New member 'schema' in struct bend_fetch_rr which the name of requested
904 schema (SRW/SRU) for record (or NULL if none was given). The fetch
905 handler MAY set this to reflect the schema of the returned record.
907 New member 'display_term' in struct scan_entry. GFS now sets member entries
908 and allocates scan entries to be filled by user scan handler. In previous
909 version, entries member was allocated by the scan handler. That still works,
910 but the GFS will ignore member display_term - assuming it was NOT set by
911 the handler. The fact that the GFS now allocates the entries both allows
912 for new members and makes a scan handler easier to write.
914 Fix CQL lex buffer overflow.
916 SRW/SRU recordPacking. For SRW default recordPacking is string. For
917 SRU default recordPacking is string.
919 SRU protocol support for frontend server.
921 Fix compile bug for systems that have nl_langinfo but CODESET undefined.
923 Added missing PQF transform rules for <= and >= . Thanks to Peter Popovics.
925 Added scan for the ZOOM shell (zoomsh).
929 * String Identifers for Schemas (Amendment 5).
930 http://lcweb.loc.gov/z3950/agency/amend/am5.html
931 Old definition for schema
932 Odr_oid *schema; /* OPT */
937 Z_InternationalString *uri;
938 #define Z_Schema_oid 1
939 #define Z_Schema_uri 2
942 * resultCount parameter to Sort Response (Amendment 1).
943 http://lcweb.loc.gov/z3950/agency/amend/am1.html
945 Support for SRW 1.0 over HTTP. This is an optional feature and
946 requires libxml2 to operate. Enable SOAP by specifying --with-xml2
949 Generic frontend server supports HTTP/SOAP/SRW and Z39.50/BER
950 on the same port. SRW SearchRetrieveRequests are mapped
951 to bend_init,bend_search,bend_fetch,bend_close.
953 Z39.50 Query Type-104 added - to facilitate CQL within Z39.50.
955 CQL support. Source is directory 'cql'. CQL is supported in ZOOM
956 (both SRW and Z39.50) and the YAZ client (Z39.50 only).
958 ZOOM connections are SRW based if schem http is used for hostname
959 in connect, e.g. z = ZOOM_connection_new("http://myserver");
960 ZOOM_query may be of type CQL, e.g. ZOOM_query_cql(q, "dc.title=x");
962 CCL proximity operators !n, %n converts to PQF @prox 0 n 1 2 k 2
963 and @prox 0 n 0 1 k 2 respectively, meaning: exlusion=false,
964 distance=n, order=true/false, relation=le, prox unit=word. If
965 n is omitted, distance 1 is used.
967 Fixed problem with C compiler include path in wrong order.
969 For TCP/IP COMSTACK, set recv buffer to an appropriate "large" value
970 on Solaris. Patch from Ko van der Sloot.
972 New MARC decode API. All new functions operate on a yaz_marc_t
973 handle. The most important new functions are: yaz_marc_create,
974 yaz_marc_decode_{buf,wrbuf}, yaz_marc_destroy, .. to create handler,
975 decode and destroy respectively. Decoder can produce formats
976 MARC line, simple XML, OAI MARC and MARC XML (LoC). See
977 include/yaz/marcdisp.h.
979 YAZ Iconv utility now supports MARC8 decoding (marc8.c). Converts
980 to UTF-8, UCS-32, wchar_t or Latin-1.
982 * Prototypes for yaz_iconv_-functions moved to separate header
983 include/yaz/yaz-iconv.h.
985 Make a few private functions 'static' in unix.c. This prevents
986 duplicate unix_close in PHP with YAZ and imap. PHP Bug 20977.
988 For ZOOM connection, the options targetImplementation{Id,Name,Version}
989 are set when Init Response is received.
991 New function ZOOM_connection_error_x similar to ZOOM_connection_error
992 but returns diagnostic set as well.
994 New function yaz_strerror which is a portable wrapper for
995 strerror/strerror_r/GetLastMessage.
997 * ZOOM_record_get supports type "xml" in which case MARC XML (from LOC)
998 is returned for MARC. If type is "oai", then OAI MARC is returned.
1000 Fix creation of lib/yaz-config so it works if srcdir != objdir. Patch
1003 --- 1.9.2 2002/11/26
1005 yaz_marc_decode uses OAI MARC as XML format for ISO2709 records.
1007 Fix bad race conditions on SIGTERM and terminate gracefully in
1010 Move retrieval (data1) module to Zebra since nobody seems to be
1013 Add GRS-1 render for ZOOM using same format as yaz-client.
1015 --- 1.9.1 2002/10/05
1017 Added man pages: yaz-client(1), yaz-ztest(8), yaz(7), zoomsh(1).
1019 Fix broken ESpec handling in data1 module.
1021 SGML reader parses comments and makes them part of the data1 tree.
1023 Added several type casts so that YAZ compiles as C++ code.
1025 ZOOM didn't handle PDU encoding failures properly.
1027 Added more Bib-1 diagnostics (approved extensions).
1029 GNU configure: better check for iconv.
1031 More portable use of accept, getpeername. Check for socklen_t. Use
1032 int/size_t if socklen_t is not defined.
1036 PQF parser rejects bad queries - including those with extra
1037 characters in them. PQF parser used to silently ignore that.
1038 Cleaner API for PQF added, which allows you to get detailed
1039 error information for bad queries (see yaz/pquery.h).
1041 Fixed bug in ZOOM_record_get for type "database".
1043 Implemented mini iconv library supporting conversions between
1044 UTF-8, UCS4, UCS4LE and ISO-8859-1. Implemented in util/siconv.c.
1046 * Removed XML reader (d1_expat.c). It's part of Zebra instead.
1048 --- 1.8.9 2002/08/20
1050 Fixed ZOOM C record cache so that preferredRecordSyntax and
1051 elementSetName is used to check for already fetched records.
1053 --- 1.8.8 2002/08/02
1055 Added three members in bend_initrequest structure to facilitate
1056 character set negotiation.
1058 Fixed a bug in frontend server that could cause indefinite
1059 loops under rare conditions.
1061 Revised character set utilities (charneg.h) so that encoding
1062 UCS-4, UCSA-4, UTF-16 and UTF-8 are encoded non-privately.
1064 For PQF, directive @term <type> sets term type for Scan/Search.
1065 Here <type> is general, string, numeric, null. The term type
1066 is inherited - just like @attr.
1068 New call odr_set_charset that sets character set conversion for
1069 international-strings on a ODR stream. Prototype is:
1070 int odr_set_charset(ODR o, const char *to, const char *from);
1071 The InternationalString is still represented as C string in YAZ
1072 so native strings of type UTF-8, ASCII, etc. will work (UTF-16
1073 won't). On the protocol level, you can use any encoding.
1075 Support for UNIX sockets in ZOOM.
1077 Solaris recv sometimes returns errno == ENOENT. It is treated as
1078 EINPROGRESS. COMSTACK patch by Ko van der Sloot.
1080 New COMSTACK of type UNIX Socket. Use "unix:/path" as address for
1081 both client and server. Code by Morten Bøgeskov.
1083 --- 1.8.7 2002/05/22
1085 On Windows ZOOM functions are of type __stdcall rather than __cdecl, so
1086 that they can be used directly from Visual Basic. You must recompile
1087 your windows APP if you're using ZOOM.
1089 Character Set and Language Negotiation(3) for ZOOM API and YAZ client.
1090 Commands "lang" and "charset" sets language and character set respectively.
1091 Options "lang" and "charset" is interpreted by the ZOOM API. Note, these
1092 are not part of the official ZOOM spec) All is due to Oleg Kolobov.
1094 Attributes from multiple CCL fields may be OR'ed rather than merged
1095 using directive "@field or". Fields are still merged by default -
1096 equivalent to "@field merge".
1098 Fixed bug in ZOOM connect that occurred on OpenBSD (maybe others). Patch
1101 Fixed bug in zget for parameter ExtendedServicesResponse.
1105 --- 1.8.6 2002/03/25
1107 Added PQF feature: '@attr type=value' may be written as '@type=value'.
1109 Client displays USR.1:SearchResult-1 (hits per term).
1111 Additional Search Info for search in Generic Frontend Server.
1113 Fixed CCL parsing of "field=s".
1115 WIN32 installer - using the excellent NSIS software from nullsoft.
1117 Fixed CCL parsing of "field = - <number>".
1119 Added function yaz_marc_decode that decodes MARC for line mode
1120 display or XML (similar to that used by JZKit).
1122 Fixed BER decoding of OPTIONAL CHOICE. The bug didn't affect the
1123 Z39.50. But ISO/ILL was, however.
1125 Added patch by Rustam T. Usmanov that implements Z39.50 duplicate
1126 detection service (Z39.50-1995 Amendment 2) and Language Negotiation (3).
1128 http://lcweb.loc.gov/z3950/agency/amend/am2.html
1129 http://lcweb.loc.gov/z3950/agency/defns/charneg-3.html
1131 --- 1.8.5 2002/02/03
1133 New YAZ client features: Command completion and new commands:
1134 push_command, set_apdufile, set_marcdump, set_cclfields, register_oid.
1135 Code provided by Jacob Poulsen.
1137 New call oid_trav, that visits all registered OIDs via callback.
1139 Function ZOOM_record_get now returns const char pointer rather than
1140 void pointer. It saves a lot of type casts.
1142 For YAZ client, command "auth" now allows you to set authentication
1143 in IdPass style. It is enabled when three tokens are given - order
1144 is user, group and password.
1146 Fix memory leaks in MARC record handling for ZOOM.
1148 New option for YAZ client, -k <kilobytes> that sets
1149 maximum record size. Similar to -k option for generic frontend
1150 server and yaz-ztest.
1152 More fixes for scan. Non-zero stepSize handled. OID's fixes.
1154 Prefix query parser reports "fail" when bad attribute set is given.
1156 Fix in MARC decoder. Proximity logging. Fix for attribute set
1157 in scan handler for server. Patches by Shigeru Ishida.
1159 SSL/COMSTACK updates. cs_rcvconnect completes SSL handshake. ZOOM
1162 Configure option --with-openssl=<dir> now works when a directory is
1163 specified. Patch provided by Morten Bøgeskov.
1165 New option for YAZ client, -u <auth>, that sets authentication.
1167 ZOOM fix: error information was sometimes "missing", since error
1168 was cleared/reset too when it shouldn't.
1170 ZOOM_record_get returns ISO2709 buffer when "raw" is given.
1172 --- 1.8.4 2002/01/04
1174 Scan for ZOOM API. New object ZOOM_scanset. New functions
1175 ZOOM_connection_scan, ZOOM_scanset_size, ZOOM_scanset_term and
1176 ZOOM_scanset_destroy.
1178 New ZOOM function, ZOOM_connection_last_event, that returns type
1179 of last event (such as "receive data", "send data", "apdu received",
1182 New ZOOM option, schema, that specifies schema for retrieval.
1184 New CCL feature. Qualifiers can be aliases for one or more
1185 other qualifiers (if more than one is given, OR is used).
1187 ZOOM uses named result sets if target supports it.
1189 Two new YAZ client commands: . (dot, which sources a script of YAZ
1190 client commands), and ! (to execute shell command.). Implemented
1193 Working on Debian packages.
1195 --- 1.8.3 2001/11/19
1197 YAZ client enables named result sets only if target supports it.
1199 *** ZOOM. Prefix for ZOOM definitions changed from Z3950_ to ZOOM_.
1201 * ZOOM. Removed Z3950_connection_host. Use Z3950_connection_option_get
1202 with key="host" to get same result.
1204 * ZOOM. Added Z3950_record_clone and removed Z3950_resultset_get.
1205 Function Z3950_resultset_record(s) returns references to records
1206 "owned" by resultset. To become owner use Z3950_record_clone.
1208 Function z_ext_record handles Extended Services. Thanks to
1211 --- 1.8.2 2001/11/12
1213 CCL Parser fix: ignore token comma when dealing with and-lists.
1215 Documentation updates for COMSTACK.
1217 * ZOOM changes. Query object renamed from Z3950_search to Z3950_query.
1218 Changed prototype Z3950_records. For some functions, int parameters
1219 were changed to size_t.
1221 TCP/IP COMSTACK no longer uses getprotobyname to avoid memory leak
1224 New MARC decode/display function, marc_display_exl, which properly rejects
1225 non-ISO2709 records. YAZ client uses it.
1227 --- 1.8.1 2001/10/29
1229 Fix bug: local attribute set wasn't set correctly in PQF strings.
1233 * Old Z39.50 codecs no longer supported.
1235 Added ZOOM C binding. See http://zoom.z3950.org/
1237 Renamed states for COMSTACKs to avoid confusion with events.
1239 Implemented cs_look and proper cs_rcvconnect.
1241 Fixed COMSTACK error that occurred on HPUX. Fix by Giannis Kosmas.
1243 Configure detects POSIX threads on OpenBSD.
1245 When sort flag 'i' was specified in yaz-client the caseSensitivy flag
1246 was set to a wrong value. Thanks to Robert Sanderson for reporting this.
1248 When error is returned from present handler, non-surrogate diagnostic
1249 is returned in present response (and fetch handler is no longer called).
1251 * Minor adjustments to pquery parser (PQF). Token characters may be
1252 escaped by using backslash (C-style).
1254 PQF parser allows string attribute values to be specified. For @attr,
1255 non-numeric characters after the equal-sign are treated as strings
1256 (e.g. @attr 9=title).
1258 CCL trunction character may be defined (@truncation in file)
1260 * function zget_ExtendedServicesRequest sets waitAction to
1261 waitIfPossible (was wait).
1263 Added cs_set_blocking to set change blocking mode of a COMSTACK. Thanks
1266 CCL operator names may be set in field definition files (CCL_bibset).
1267 See ccl/bib1 for an example.
1269 Fixes in ASN.1 compiler for C++ compatibility.
1271 * Renamed members "and" and "or" in struct Z_Operator to "op_and"
1272 and "op_or" to avoid conflict with C++.
1274 Fixed problem with GNU readline detection on Redhat 7.0.
1276 Added step-size for Scan backend handler.
1278 Fixed bug that made the frontend server crash when no attribute
1279 set was specified for scan.
1281 Front-end server automatically switches to original working directory
1282 when installed as an NT service. Previously -w had to be specified to
1285 Added extended attributes for retrieval module (data1), so that data1
1286 records carry d1_readXML/SGML attributes. d1_read also supports
1287 null-data rules ( <tag/>)
1289 On UNIX when POSIX threads are available, a separate library libyazthread
1290 is created. Programmers should link with that library and the yaz library
1291 when using threads. The reason for the split was that some applications
1292 on Linux, such as Apache, doesn't work well when using shared objects that
1295 Added SSL support for the COMSTACK. You start yaz-client and yaz-ztest
1296 (or any frontend server) in SSL mode by specifying ssl: followed by
1297 address. Only tested on UNIX.
1299 Added feature for CCL module. Virtual structure s=al or s=ol generates
1300 and-list and or-list respectively instead of phrase search.
1304 * Added prefix "yaz_" for the functions log_init.., log_file.. and
1305 log_mask_str. This was done to avoid name conflicts with other libraries
1306 (such as other PHP extensions).
1308 Added raw OID member for preferred record syntax (request_format_raw)
1309 and returned record syntax (output_format_raw) for backend fetch method.
1311 Config file yaz-config now accepts options so that it returns specific
1312 compile settings, etc. Thanks to Morten Bøgeskov <morten@bogeskov.dk>
1314 Shared library support for UNIX using GNU libtool.
1316 * Modified backend interface. Request/Response struct's replaced by
1317 one read/write C struct. For example bend_fetchrequest and
1318 bend_fetchresult have been replaced by single bend_fetch_rr struct.
1319 Every handler - even search has to be registered in bend_init
1320 handler. This means that the YAZ library no longer refers to
1321 external functions and it makes it possible to make the whole
1322 thing a single DLL/SO.
1324 Added Segment handler for backend server.
1326 Added Zmbol/Zebra administrative functions to YAZ client.
1328 Threaded frontend server on UNIX (when POSIX Threads are available).
1329 Starting the server with option -T enables multi-threading.
1333 Added configure option --enable-comp/disable-comp to control use
1334 of YAZ ASN.1 compiler. Use --disable-comp to use the old *coders
1335 located in sub directory asn.
1337 YAZ ASN.1 compiler renamed to yaz-comp in sub directory. It's installed
1338 in ${exec_prefix}/bin along with the other programs yaz-client and
1341 GNU automake used to maintain makefiles.
1343 Added several OID's.
1345 Changed retrieval module so that we can load records with no abstract
1346 syntax defined. Tagpaths in these records are fully composed of string
1349 Implemented ISO ILL protocol. Refer to stuff in sub directory ill.
1353 On UNIX, the generated makefile now supports a proper 'make install'.
1354 The prefix can be set via GNU configure to set the install location
1355 (default is /usr/local).
1357 * YAZ programs client and ztest were renamed to yaz-client and
1358 yaz-ztest to avoid conflicts when users install YAZ in "standard"
1359 locations, such as /usr/bin,/usr/local/bin,etc.
1361 * YAZ Header files were moved from include to include/yaz. YAZ Header
1362 files are referred to as include <yaz/log.h> rather than <log.h>.
1363 The YAZ include path (-I ..) is therefore the same as before. Programmers
1364 should update their #include statements or use -Ipath/include/yaz
1365 instead. The main motivation for doing this change is that YAZ header files
1366 can be installed in "standard" locations /usr/include,/usr/local/include
1367 without introducing conflicts, since ALL YAZ header files are stored
1368 in subdirectory yaz (under /usr/include for example).
1370 Compilation of YAZ for WIN32 is now handled by an nmake-style makefile
1371 rather than project/workspace files. We switched because project files
1372 are incompatible between Visual C++ 5 and 6. Refer to windows.txt for
1375 Changed name of logging function, logf, to yaz_log, to prevent name
1376 clash with some math-log functions. The YAZ header log.h defines logf
1377 to yaz_log (#define) so there should be no incompatibilities by this
1380 Added bend_start/bend_stop handlers for server. These handler are
1381 called on start/stop of server. For windows they are called whenever
1382 a service is started/stopped.
1384 * YAZ now auto-generates decoders/encoders for the Z39.50 protocol using
1385 a fairly small ASN.1 compiler written in Tcl. The compiler is located
1386 in util/yc.tcl. The auto-generated C code structures are, in a few
1387 cases, incompatible with the old decoders. There are differences in the
1388 following C structures Z_DiagRec, Z_External, Z_SortRequest, Z_SortResponse,
1389 Z_AttributesPlusTerm, Z_ProximityOperator, Z_DefaultDiagFormat.
1390 The preprocessor variable ASN_COMPILED is defined when the compiled
1391 ASN.1 is being used. Encoder/decoder routines as well as the Z39.50
1392 protocol ASN.1 is located sub directory <tt>z39.50</tt>. If you
1393 wish to use the old encoders/decoders you can specify --disable-yc
1396 Assigned OID for old DB Update (VAL_DBUPDATE0). Updated YAZ compiled
1397 version so that it supports both new - and old version of DB Update
1399 * Added 'name' parameter to ODR encoder/decoder routines to facilitate
1400 pretty ODR print. Updated whole Z39.50 encoder/decoder to reflect the
1401 change. The name parameter can be set to 0 in which no name is specified
1402 for the construction. The macros odr_implicit and odr_explicit sets name
1403 parameter to zero for the construction involved. New macros
1404 odr_implicit_tag and odr_explicit_tag are similar to the others,
1405 except that a name parameter is added. For programmers' that don't use
1406 ODR they probably only need to change the call to z_APDU and z_External.
1408 Added access control facility by interfacing the TCP wrapper library.
1409 YAZ automatically attempts to find the TCP wrapper Library (-lwrap) and
1410 tcpd.h on Unix systems. For the server, option -d<daemon> specifies the
1411 name of the daemon and enables the access control as specified in
1412 hosts.allow/hosts.deny. Refer to man pages tcpd(8) and hosts_access(5).
1414 Fixed memory leak in ccl_find_str and ccl_qual_rm. Thanks to Hans van
1415 den Dool <H.M.vdnDool@kub.nl>.
1417 Added reference ID parameter to most functions in server API - refer
1418 to backend.h. Thanks to Hans van den Dool <H.M.vdnDool@kub.nl>.
1420 Changed name of ccl library to libccl.a (was ccl.a).
1422 Fixed bug in decoder for Explain (Category TargetInfo).
1424 Added support for GNU readline in client. Thanks to Jacob Poulsen
1425 <ja7@dbc.dk>. GNU configure attempts to detect if readline is available.
1427 * CHANGED DEFINITION OF ES: UPDATE (INCLUDING THE OID) to reflect the
1428 new definition from the ZIG. NOTE THIS IF YOU HAVE AN UPDATE
1429 IMPLEMENTATION! This change was made to the development version before
1430 the ZIG decided to retract the amendment. If any users MUST be
1431 compatible with the original Update definition, PLEASE CONTACT US, and
1432 we will include a separate definition corresponding to the old Update
1433 ES. Note that because of the change to the ASN.1 of the
1434 TaskPackageRecordStructure we cannot define a single structure that
1435 will support both versions.
1437 * Added const modifier to buffer parameter for some ODR/BER encoding
1438 routines: ber_dectag, ber_declen, odp_more_chunks, completeBER,
1439 completeWAIS, odr_dumpBER.
1441 Fixed bug in client.c which caused a crash when a scanResponse didn't
1442 contain positionOfTerm.
1444 * Fixed inconsistency in the ScanResponse/ListEntries protocol. This
1445 * will cause an error in a client if a non-YAZ target sends both a
1446 * list of Scan entries and non-surrogate diagnostics.
1448 Retrieval module enhancements. Tag sets may be typed in the reference
1449 to it. From the .abs-file the "tagset" directive takes a third optional
1450 integer type for the tag set referenced. From a .tag-file the "include"
1451 directive takes a third optional type as well. The old "type" directive
1452 in the tag set itself is still recognized but acts as the default type
1455 Backend interface change. Individual Scan terms returned from bend_scan
1456 may also be tagged as Surrogate Diagnostics. Refer to struct scan_entry
1457 in include/backend.h.
1459 Retrieval module enhancements. Multiple tag sets and attribute sets may
1460 be specified in abstract syntax specs. Revised the error/warning for
1461 logging messages reported by the retrieval module when reading the
1464 Object Identifier system (oid_..) changed. The API is backwards
1465 compatible but the oid-routines now allocates new OID's when needed.
1466 Raw OID's may be specified in oid_getvalbyname.
1468 YAZ now uses GNU configure to generate Makefile(s).
1470 * Minor changes in some of the member names of DeleteResultSetRequest and
1471 DeleteResultSetResponse. See include/proto.h.
1473 * Changed some C definitions regarding EXPLAIN record syntax (prt-exp.h)
1474 and added member 'languages' in TargetInfo (which was missing).
1476 Changed the way attribute sets are handled in the retrieval
1477 module. These are now cached, just like the abstract syntaxes
1480 Changed YAZ so that it links with compiled ASN.1.
1482 Added Explain-schema definitions and mapping routines. The following
1483 Explain categories have been implemented: AttributeDetails,
1484 AttributeSetInfo, DatabaseInfo, CategoryList and TargetInfo.
1486 Fixed minor bug in Windows version of Server Library.
1488 --- 1.4pl2+ 1998/4/17 (Released with Zebra)
1490 Added Extended Services to server (backend.h). Thanks to Charles Woodfield.
1492 Added EXTERNAL: UNIverse Resource Report (non-standard).
1494 Implemened odr_enum and odr_set_of functions to handle ASN.1 types
1495 ENUMERATED and SET OF.
1497 * Added 'const' to some of the char pointer arguments for the
1498 functions, data1_read_node, data1_getelementbytagname,
1499 data1_insert_taggeddata, data1_getesetbyname, data1_getelementbyname,
1502 Fixed bug in data1_insert_taggeddata - the last_child member of
1503 parent wasn't initialised.
1505 * Changed data1_read_record and data1_read_node so that the supplied
1506 "SGML"-buffer is read-only. In particular the resulting data1 - tree
1507 doesn't refer to any parts of the "SGML"-buffer.
1509 Fixed bug in server library (Windows version of statserv_remove).
1511 * Changed code so that it compiles as C++. The type definition
1512 of Odr_fun which is a member of Odr_arm was changed. The result is,
1513 that an explicit typecast is needed for the fun pointer when
1514 using Odr_arm - as in:
1515 {1, -1, -1, Z_IdAuthentication_idPass, (Odr_fun)z_IdPass},
1517 Updated TagSet-G and -M definitions (tagsetm.tag and tagsetg.tag).
1519 Implemented the new structured date and time definition as approved
1520 by the ZIG. Added schemaId element to the specificTag in Espec-1
1521 (also approved at the last ZIG). Thanks to RVDM.
1523 Added some Object identifiers (RVDM).
1525 Changed the Update Extended Service (RVDM).
1527 Added command "refid" to client which specifies referenceId for
1528 the following requests.
1530 Implemented extended service handling for server. See ztest.c
1531 for an example as well as backend.h. New handlers are registerd
1532 in the Init handler.
1534 * Changed interface for sort in server.
1536 Added new members to statserv_options_block. It allows a server
1537 to read options from another source than just the command line. Thanks
1538 to Charles Woodfield.
1540 * Changed definition of Z_Triple in file prt-grs.h - member boolean
1541 renamed to zboolean. Some C++ compilers complained about the name.
1543 Minor changes to gils.abs. Added index 's' (sort) on title
1544 and date/time-last-modified.
1546 --- 1.4pl2 1998/1/30
1548 Fixed bug in server library regarding inetd mode (-i). This bug
1549 was introduced by release 1.4.
1551 --- 1.4pl1 1998/1/29
1553 Added sort facility in client and backend server interface.
1555 Fixed problem with dependencies in Makefile(s).
1557 Fixed bugs for encoders/decoders of extended services and
1560 Implemented sub-tree feature for schemas. Sub-trees are
1561 referenced in *.abs-files. See explain.abs for an example
1562 of the use of this feature.
1564 Modified bib1.att; local attributes for ANY didn't include
1565 ANY itself (only affects use of the retrieval module).
1567 Fixed bug in plain SGML reader in function data1_read_node:
1568 tags with prefix "var" was incorrectly interpreted as variants.
1570 Added feature "sub-schemas" to enable references to - and definitions
1571 of - group of elements.
1573 * Removed member parent from type data1_element (in data1.h).
1575 Implemented function odr_nullval() that returns the value of
1578 * Removed member num_children from data1_node (in data1.h).
1580 Made NT service interface part of the server library. The
1581 function statserv_main uses the NT service when required and
1582 calls the statserv_start / statserv_close routines.
1584 Routine zget_SearchRequest and zget_PresentRequest fills
1585 resultSetName/Id member with "default" instead of "Default".
1587 Fixed memory leak in server. Request queue member wasn't freed.
1589 Fixed nmem_exit so that memory is freed.
1593 Revised the CCL parser utility to be thread safe.
1595 Added function, oid_ent_to_oid, to replace the function
1596 oid_getoidbyent, which is not thread safe.
1598 * Added nmem_init and nmem_exit to initialize and release
1599 NMEM resources. Function nmem_init should be called once in the
1600 initial thread before NMEM/ODR is used. statserv.c and client.c
1601 have been changed accordingly. The change was necessary to make
1602 NMEM thread safe. The NMEM memory pool is shared amongst threads
1603 in a process. Unix-based applications will still work fine without
1606 Added NT Services interface for the the Z39.50 (statserv) Server.
1607 Refer to the ztest.c source on the usage.
1609 Windows 95/NT port using MSVC5.0. Project files are included in the
1612 * Defined new 'global' handle for the retrieval (data1) system. The
1613 new handled, data1_handle, describes the state of the data1 system.
1614 This handle is passed as first argument to virtually all
1615 data1 related routines. The functions data1_create and data1_destroy
1616 creates and destroys a data1 handle respectively.
1618 Added ODR encode stream member to all backend request structures
1619 init, search, scan etc. This stream should be used to allocate all
1620 memory used for the response when thread safe operation is needed.
1622 Changed the comstack utility, cs_addstr, to be thread safe. The
1623 returned hostname string returned by the function is now part the
1626 Added comstack utility, cs_straddr, which replaces the tcpip_strtoaddr
1627 function. The cs_straddr takes a COMSTACK handle as argument, so this
1628 function must be used after cs_create and before bind/connect.
1629 This function is thread safe.
1631 Moved test server to 'ztest' directory - generic server code still
1632 in 'server' directory.
1634 Made prefix query (pquery.c) utility thread safe.
1636 Added new function modifier YAZ_EXPORT to 'export' public DLL
1637 functions when using windows (see include/yconfig.h).
1639 Added definitions to the OID database (util/oid.c) (RVDM).
1641 Added new BIB-1 diagnostic messages to the handler diagbib1_str.
1643 Added call to ccl_rpn_delete in client program.
1645 Added ODR argument to ccl_rpn_query and ccl_scan_query to provide
1646 release of RPN structure.
1648 Added support for C++, headers uses extern "C" for public definitions.
1649 With input from RVDM.
1651 In handling of SEQUENCE OF: Counter set to zero when SEQUENCE OF is absent.
1652 Thanks to Ronald van der Meer (RVDM).
1654 Added initializers (zget_ routines) for a number of PDUs. Thanks to RVDM.
1656 Added support for private extensions to the OID database
1657 (oid_setprivateoids()). Thanks to RVDM.
1659 Added optional, physical ANY (key replication)
1661 Fixed null-reference problem in GRS-1 output filter.
1663 Proximity operator added to Prefix Query Format (PQF).
1665 In test client command "base" accepts multiple databases.
1667 Fixed bug in cs_close stack that caused trouble with WINSOCK.
1671 Fixed tagging bug in ResourceReportResponse PDU encoder/decode.
1673 Smallish bug-fixes in the new encoders/decoders (explain).
1675 Bug fixed in DeleteRequest.
1677 Fixed tagging bug of type 101 query in SearchRequest-Query PDU encoder/decoder.
1679 Fixed tagging bug in ResourceReportResponse PDU encoder/decode.
1681 Added SOIF syntax (using private OID for now) to retrieval module and client.
1683 Added Update extended service.
1685 Added SearchResult-1 additional info structure.
1687 Added optional CCL (ISO8777) interpreter as separate module. Available
1690 --- 1.2 1996/6/10 (1st anniversary release)
1692 Added Summary record syntax. Lightly tested.
1694 Added OPAC record syntax. Untested.
1696 Added ResourceReport service encoders/decoders. Untested.
1698 Fixed bug in z_Unit - wrong tagging on unitSystem.
1700 Fixed bug in the DiagRecs decoder.
1702 Added options for max PDU size and session timeout to frontend-server.
1704 Added documentation of query-language parsers and other supporting utilities.
1706 [frontend-server] Added Attribute set to the bend_scanrequest API.
1708 [frontend-server] NextResultSetPosition was sometimes set incorrectly when
1709 surrogate diagnostics were generated.
1711 [retrieval] Allow multiple local values for attribute.
1713 [retrieval] Allow multiple attributes per element in .abs files. index type.
1715 [retrieval] Added Summary tagset, abstract syntax, and d1-node/ASN filter.
1717 --- 1.1pl2 1996/4/10
1719 Minor changes, mostly specific to Zebra's requirements (retrieval)
1723 Repaired bug in frontend server when running multiple listening
1724 endpoints in dynamic mode.
1726 z_External() now won't break if a known, ASN.1 value comes encapsulated
1727 in an octet-string. The value will pass through unmodified in an Odr_oct.
1729 Added a bit of code to the demo client to decode & display
1730 ASN.1-structured records represented in the octet-aligned branch of
1731 the EXTERNAL CHOICE. Thanks to CAS for prodding us to finally do this.
1733 Added z_ext_getentbyref() to the ASN module. Doc updated.
1735 * Completed the SCAN definition in the ASN module. This may break SCAN
1736 code based on older YAZ-versions at compile-time. The fix is easy -
1739 * Added 'displayTerm' and OtherInformation to the TermInfo structure
1740 under the SCAN definition. Remember to initialize this, server-people.
1742 Comstack should now support the WAIS protocol in TCP/IP mode. Note
1743 that this does not extend to ODR and ASN.
1745 Comstack allows insertion of established socket (primarily for
1746 inetd-operation of servers). Doc updated.
1748 Front-end server can now start from the inetd in TCP mode. Doc
1751 --- 1.0pl4 1996/1/24
1755 Fixed small problem in SUTRS-filter. A newline was sometimes inserted before
1756 the rank and record number.
1758 Adjustments to the frontend server.
1760 Fixed diagnostic BER dumper. It ignored the file argument.
1764 Various changes to retrieval module.
1766 Changed the union discriminators of the protocol files from enums to
1767 ints paired with #defines.
1769 *Changed oident.class to oident.oclass to avoid a reserved word in C++
1772 *Changed operator in the RPN structure to 'roperator', again to avoid a
1775 Fixed problems in Explain decoders/encoders.
1777 --- 1.0pl2 1995/12/6
1779 Memory bug in log module fixed.
1781 --- 1.0pl1 1995/12/5
1783 Occasional malloc() of 0 bytes fixed in d1_espec.c.
1785 Bug in Explain DatabaseInfo module fixed.
1787 Some '\r' snuck into one or two of the ret'l config tables. A curse on Windows.
1791 The shift to v1.0 signals that we now consider the *core* functionality
1792 of YAZ reasonably stable (the core being more or less equivalent to
1793 Z39.50-1992). Some of the really nifty v3 stuff is still not heavily
1794 tested (Explain not at all - though that will happen soonish).
1796 Minor changes to code to support Windows port.
1798 Various minor changes after we're getting to use GRS-1 & co. more.
1800 Added Espec-1 format.
1802 Added VisibleString field body type to GRS-1. It is illegal acc. to my copy
1803 of the protocol and it cannot be selected when encoding (maps into 'string'
1804 when decoding). Needed to talk to some servers.
1806 Demo client can request simple element set names.
1808 Added Diagnostic Format encoders/decoders.
1810 Added simple Close handling to frontend server (no hooks for resource
1811 reporting yet), and demonstration client.
1813 Added cs_addrstr() command to COMSTACK to retrieve peer hostname/address.
1815 --- 1.0b3 1995/08/24
1817 Fixed bug in the frontend-server. The numberOfRecordsReturned field was
1818 handled incorrectly when records were requested in the searchResponse. This
1819 will only affect you if you use the frontend-server.
1821 Added GRS-1 encoders/decoders to the service-level API. Lightly tested.
1822 Test-client will ask for and print GRS1. Ztest will return dummy records
1825 Added Explain encoders/decoders to the service-level API. Untested.
1827 Added Extended Services: Item Order encoders and decoders to the Service-
1828 level API. Untested. We could use a recent copy of the pertinent bits
1829 of the ILL protocol to add those bits.
1831 Added diagnostic format 1 encoders/decoders to the service-level API.
1834 Moved pretty-printing of structure-wrappers ({..}) from odr_seq.c to
1835 odr_cons.c, which causes a more correct output.
1837 Fixed handling of searchRequest in frontend server. NextResultSetPosition
1838 was always set to 0 when no records were requested in the searchRequest.
1840 * Added better external-handling. This shouldn't harm old code that
1841 *encodes* externals. It can break code that looks for a
1842 'single-ASN1-type' representation, since those types that are known
1843 are now decoded immediately. Look at the SUTRS sample code in
1844 seshigh.c and client.c. Documentation updated.
1846 Handling of structured records in bend_fetchresponse. Length -1 marks
1847 structured record, type is deduced from format field.
1849 --- 1.0b2 1995/06/27
1850 Fairly quick maintenance release to add SUTRS support.
1852 Fixed handling of SUTRS records in the demonstration client.
1854 * Added format field to the bend_fetchrequest and bend_fetchresponce
1855 structures of the backend API (frontend server). When the record is
1856 returned, the value of the format field is mapped to an OID. The
1857 value VAL_SUTRS will also cause a slightly different ASN.1 packaging
1858 of the record. The special value VAL_NONE in the bend_request means
1859 that no specific format was requested by the client. Documentation
1860 updated accordingly. Test server (ztest) will return a fixed dummy
1861 SUTRS record if your client requests SUTRS.
1863 Documentation updated accordingly.
1865 You can now set external libraries and RANLIB support in the top-level
1869 First public release.