1 yaz-url and url functions: allow max HTTP redirects to be controlled.
3 New functions yaz_file_glob2, yaz_xml_include_glob.
4 These functions takes a flags parameter, which, for now only controls
5 whether to fail inclusion of a non-existing file (without glob
6 pattern) - flags YAZ_FILE_GLOB_FAIL_NOTEXIST.
10 For MARC XML parsing, allow record without leader. A fake/default leader
11 is inserted and a warning is tagged with the record.
13 ICU: fix leak in in icu_iter_get_org_info.
17 ICU: fix bug in icu_iter_get_org_info (un-init variable).
21 Implement z_HTTP_header_remove.
25 ICU: Disallow 0 ptrs for some ICU string utilities.
27 ICU: new utilities icu_iter_get_org_info and icu_chain_get_org_info:
28 returns original tokens (before normalization).
30 CCL: avoid z39.58/regex truncation when not needed. Apply only the
31 conversion of those masks, when absolutely necessary.
33 CCL: configurable masking character - @mask. Default masking character
36 HTTP encoding: remove Transfer-Encoding header. YAZ uses content_len and
37 full response anyway, so a Transfer-Encoding header will obstruct the
42 COMSTACK: @ uses AF_UNSPEC . But we prefer AF_INET6 over others when
43 picking a socket. Problem is that some systems has IPV6 support, but
44 we can't create sockets for them, so we pick AF_UNSPEC first.
46 HTTP encode. Proper Content-Length YAZ-660. For yaz_encode_http_response
47 use content_len to determine resulting Content-Length in HTTP response
48 and NOT Content-Length supplied in headers by user.
50 z_HTTP_header_add_basic_auth uses z_HTTP_header_set rather than
51 z_HTTP_header_add, to avoid having two Authorization headers by mistake.
53 Fix problem with HTTP decoding. For HTTP 1XX, 204, 304 assume no
56 Fix yaz_base64decode to use proper signed. Problem occurred on platforms
57 with big endian and unsigned char (by default).
61 Fix yaz-client connect (crash in 4.2.55).
65 Fix proxy/host problem for ZOOM that could occur if unix sockets
68 New Debian package libyaz4-dbg.
70 Fix problem with cs_close hang/wait in SSL mode. Invoke gnutls_bye
71 differently in tcpip_close.
75 Windows installer of YAZ includes YAZ4J as a component.
77 CQL: allow "extra terms" again, by default. Thus, the CQL parser
78 accepts a superset the standard. This reverts to CQL as of YAZ 4.2.51
79 and earlier. CQL parser may operate in strict mode where queries
80 not conforming to the standard BNF are rejected (syntax error).
81 Whether the CQL parser operates in strict mode is controlled with
82 cql_parser_strict . Strict mode enabled with option -S for utilities
83 cql2pqf and cql2xcql .
85 yaz-ztest: returns OPACXML records for syntax=XML and element set=OP.
89 New charset, MARC-8c, which is like MARC-8 but allows control characters
90 0x01 through 0x1F, except ESC to be passed through verbatim.
92 Fix a problem with duplicate sub field character in MARC output. Problem
93 happened only when output was MARC-8 encoded.
97 yaz-ztest: Use hash for fake hit count. Before, random number was used.
98 This is problematic for unit tests using yaz-ztest. This patch also makes
99 a hash for CQL queries. For RPN, any term with a leading digit will be
100 treated as pseudu hit count (to force any particular hit count by a client).
102 yaz-ztest: return unique MARC dummy records. Beyond record offset
103 24, the author surname is patched with offset to make all records
106 COMSTACK: make @ bind to IPV6+IPV4 consistenly and avoid depending
107 on system wide default (/proc/sys/net/ipv6/bindv6only).
108 @4 binds to IPV4 only. @6 binds to IPV6 only.
110 Update CQL API documentation a bit
112 CQL: don't accept extra terms for queries. Makes the CQL parser
113 stricly conformant to the standard.
115 --- 4.2.51 2013/02/12
117 GFS: scan handler gets extra_args from request and may return extra
118 response data . That's for SRU only.
120 Solr scan support for ZOOM and yaz-client. Patch from Simon Jacob.
122 --- 4.2.50 2013/01/30
124 New function, yaz_xml_to_opac, to convert from OPACXML to Z39.50 OPAC.
126 OPACXML: sync spelling of availabilityDate in XML to that of Schema
127 opaxxml.xsd. The schema had the correct spelling of this member always.
128 The ASN.1 was mis-spelled and still is (API change) - we are
129 not changing this. However, the OPAC to XML conversion had yet
132 GFS: Allow conversion between Z39.50 OPAC and OPACXML via retrieval
135 New function, z_ext_record_oid_nmem, which is similar to
136 z_ext_record_oid but takes NMEM rather than ODR
138 --- 4.2.49 2013/01/18
140 ICU: New conversion element 'join' which joins tokens into one
141 with a custom character given by rule attribute.
143 --- 4.2.48 2013/01/10
145 New GFS search member: present_number. This is a hint to the
146 search handler how many records are going to be fetched immediately
147 following search. There's no guarantee that it's going to be the case,
148 since it depends on hit count (for Z39.50 piggyback) and whether errors
151 Make a few functions static (private). The functions getbyte_stream,
152 ungetbyte_stream and yaz_gets are now private. They were never declared
155 yaz-marcdump: exit(5) for serious decoding errors
157 ISO2709 decoding: be more picky WRT header
159 GFS: bail out of fetch if last_in_set is set. Until now, last_in_set,
160 was only used as to indicate that next-result-set-position should be
162 http://www.loc.gov/z3950/agency/markup/04.html#Next-result-set-position
163 Based on patch from Ashley Sanders.
165 Make some functions static/private in PQF parsing. Those functions were
166 never declared in a public header and so should not be in use by
167 applications based on YAZ.
169 --- 4.2.47 2012/11/23
171 ZOOM: special options to control APDU logging.
172 Using ZOOM_connection_option_set(c, "saveAPDU", "1") will enable
173 logging of APDUs until "saveAPDU" option is set again. If logging is
174 already enabled the effect is that current APDU buffer is cleared.
175 Using ZOOM_connection_option_set(c, "saveAPDU", "0") disables
176 logging (default behavior on new connection).
177 The APDUs sent/received can be obtained by using
178 Using ZOOM_connection_option_get(c, "APDU") or
179 ZOOM_connection_option_getl(c, "APDU", &l).
181 GFS: relay implementation_version from backend
182 From 3.0.40 and later, implementation_version from backend was
183 not used in init response at all.
185 --- 4.2.46 2012/11/15
187 Fix cs_rcvconnect for SSL comstack GNUTLS. Did not work in non-blocking
188 mode at all. Probably never did.
190 Make a new version of ztest.pem that, at least, is not expired.
192 --- 4.2.45 2012/11/13
194 Fix description of CCL directive 'case'.
196 More tight checking of form arguments (yaz_uri_to_array). Makes
197 YAZ better at rejecting big and/or bad POSTs.
199 SRU decoding does not report more than up to 10 invalid arguments.
201 rpn2cql: less quotes in generated terms. Semantics unchanged, but
202 it's prettier this way.
204 --- 4.2.44 2012/10/25
206 New utility yaz_decode_init_diag. Defined in proto.h.
208 Allow HTTP protocol on unix local socket. Also Z39.50 database may be
209 given for unix local socket.
210 The COMSTACK string for doing so is:
213 unix:/myfile:tcp:localhost:9999/mybase
214 unix:/myfile:localhost:9999/mybase
215 unix:/myfile:http://fakehost/mybase
217 debian: Use dpkg-buildflags in build process.
219 --- 4.2.43 2012/10/19
221 ZOOM C: don't trust recordPosition always. Some servers, such as IGI
222 global's SRU service uses a recordPosition scheme starting from zero.
223 First record's position should be one
224 according to the standard.
226 --- 4.2.42 2012/10/18
228 Allow more namespaces for SRU. This is to allow, for example, an
229 incorrect namespace returned from server
230 http://services.igi-global.com/sru .
232 Minor fixes for compilation on Windows.
234 --- 4.2.41 2012/10/11
236 daemon: log total number of bad signals from child on stop so that it
237 is more easy to spot problems with child worker processes.
239 retrieval: empty backend name attribute omits element set
240 from being used in retrieval.
242 --- 4.2.40 2012/10/04
244 Implement Solr sort strategy "solr", similar to sru11 sorting.
245 This will implement the correct parameters on Solr requst to do
248 --- 4.2.39 2012/09/28
250 Implement ccl_qual_fitem2. Like ccl_qual_fitem but with diagnostic
253 MARC: Extra/missing indicator handled for MARCXML.
254 The indicator length is given in header and is the same for the
255 whole record. If attributes ind1, ind2 are missing, then content
256 character defaults to blank. Extra indicator attributes (beyond)
257 indicator length are treated as an error.
259 Reformat: delete trailing whitespace
261 --- 4.2.38 2012/09/17
263 MARC: fix non-ASCII characters for leader. This is to ensure we can
264 generate XML in UTF-8.
266 CCL: new special attribute s=ag . Almost s=pw,al but preserves words
267 in one node with structure word.
269 --- 4.2.37 2012/09/04
271 yaz-json-parse: JSON output may be pretty printed by using option
274 Increase default value of max message for Z39.50 Init for GFS, ZOOM
275 and yaz-client. Old value was 1 MB. New value is 64 MB.
277 --- 4.2.36 2012/08/22
279 yaz-client: don't display bogus records from SRU servers. Some SRU servers
280 return more records than given by *maximumRecords*. Skipping those in
283 record_render: simplify buffer return handling and fix at least one bad
284 memory reference, that broke the test_embed_record sometimes.
286 Allow http://user:pass@host notation for yaz_url_exec.
288 zoomsh: allow shell command to be executed. Via the system(3) call.
290 yaz_poll: Allow num_fds == 0
292 yaz-client: fix bad encoding of "itemorder item". The itemorder
293 item <no> - command forgot to use length of encoded Item Request
294 package. Error present since YAZ 3.
296 yaz-ztest: fix bad usage of session handle. Bug was introduced when
297 result sets were saved (271a9c83).
299 SRU recordPacking: guess record packing in response rather than looking
300 at the recordPacking element which, OF COURSE, changed semantics in SRU
303 Decode SRU 2.0 responses. The official namespace for responses, according
304 to http://docs.oasis-open.org/search-ws/searchRetrieve/v1.0/cs01/schemas/sruRes
305 appears to be http://docs.oasis-open.org/ns/search-ws/sruResponse .
306 nature.com's server, however, usee namespace
307 http://docs.oasis-open.org/ns/search-ws/sru-2-0-response . For this reason
308 we are now using a glob-expr to match up the namespace. ZOOM C and
309 yaz-client updated. Perhaps SRU 1.2 uses same namespace, I don't know.
310 I can not find a single real example showing the "real" namespace in
311 the documentation from OASIS. The namespace for requests is different
312 from responses, but this is not added to YAZ yet, when we don't encode
315 --- 4.2.35 2012/06/26
317 zoom/record_render: add support for Base64 decoding fo MARC records
318 within XML element. For example: "xml; charset=marc-8; base64=/my/text()"
319 which will decode base64 + ISO2709 marc-8 encoded material from text node
322 --- 4.2.34 2012/06/07
324 Add missing definitions ZOOM_resultset_get_facet_field_by_index
325 and ZOOM_resultset_facets_names.
327 zoom: fix bad free for ZOOM_connect - happened when ZOOM connection
330 Change APDU dump printing to avoid long leading blanks. For levels 16
331 or larger the level is shown and the indentation is truncated but
332 recursed with modula 8. This makes it still reasonable easy to read
333 - even for nested BER dumps.
335 Fix bug completeBER_n WRT too nested BER. Function completeBER_n could
336 return 0 (incomplete package) in case where the BER package was
337 considered too nested (return value of -2).
339 dumpber: lines of level 15 are not indented further. Two spaces per
340 indentation; indentation 15 or more is indented to a fixed indentation
341 and augmented with a level=<no> indication.
343 zoomsh: increase max size of command+args
345 GFS: No limit in RPN buf size in CQL to RPN conversion.
347 --- 4.2.33 2012/05/09
349 New function for daemon utility, yaz_daemon_stop .
351 Makes yaz_srw_sortkeys_to_sort_spec public on Windows.
353 --- 4.2.32 2012/04/25
355 Add some Bib-1/SRU diagnostics + mappings. Bib-1: 1073 and
356 Bib-1 1074: Proxy failure. SRU: 1074: Proxy failure
358 --- 4.2.31 2012/04/23
360 YAZ daemon utility relays SIGUSR1 to child process.
362 ZOOM: handle trailing slash for Z39.50 urls. Previously localhost:9999/
363 would result in en empty database list - which in turn would result in
364 encoding failure for search.
366 Fix reading beyond string in yaz_sort_spec.
368 --- 4.2.30 2012/04/11
370 Add two new SRU diagnostics:
371 236: Access to specified database denied
372 1015: Init/AC: Maximum number of simultaneous sessions for Userid
374 Document the very useful ZOOM-C option "apdulog".
376 CQL to RPN: term may be passed through verbatim. This is enabled with
377 truncation.cql . The assumption being that the term is already CQL.
379 --- 4.2.29 2012/03/20
381 record_conv: leader spec may be given for marc element.
382 The leader spec is given as attribute leaderspec for element marc.
383 For example to convert a MARC21 record from MARC-8 to UTF-8:
384 <marc inputformat="marc" outputformat="marc"
385 inputcharset="marc-8" outputcharset="utf-8 "leaderspec="9='a'"/>
387 record_conv: allow user-XSLT params. For example:
388 <xslt stylesheet="MARC21slim2DC.xsl">
389 <param name="myparameter" value="myvalue"/>
390 <param name="otherparameter" value="othervalue"/>
393 record_conv: fix error handling for missing marc charsets.
395 CQL: fix extra terms in wrong order.
397 --- 4.2.28 2012/03/06
399 record_conv: modify new API for conversion types. The conversion types
400 may be passed in new functions yaz_record_conv_configure_t and
401 yaz_retrieval_configure_t. Removing yaz_record_conv_add_type .
403 Avoid mixed statement/variable declare; fixes compilation with Visual
406 --- 4.2.27 2012/02/28
408 Add non-standard SRU diagnostic: 235: "Database does not exist".
409 Couldn't live without it. HTTP 404: "Not found" is just so anonymous.
410 Update SRU to Bib-1 diagnostic maps accordingly.
412 CCL: add two new diagnostics for unsupported masking. The new
413 diagnostics are: "Embedded truncation not supported" and
414 "Single charcacter mask not supported".
416 --- 4.2.26 2012/02/23
418 CCL: fix use of "term" field in sub queries. Bug introduced in YAZ 4.2.25.
420 --- 4.2.25 2012/01/11
422 Build YAZ for Ubuntu Oneiric.
424 CCL: allow parantheses for proximity operands. For example CCL query
425 (a) % (b) is now allowed.
427 GFS: fix bend_assoc_is_alive. When cs_get returns 0 the association is
428 marked dead, rather then being destroyed. If not, the session memory is
429 being free'd before the search/scan handler is finished. Also destroy
430 'request' memory in request_release rather than in various places,
431 which resulted in leaks from time to time.
433 --- 4.2.24 2011/12/21
435 cql_sortby_to_sortkeys: honor sort prefix.
437 RPN to CQL: always quote resulting terms. For bizarre reasons, JSTOR's
438 SRU server returns 0 hits on ISSN searches unless a CQL term is quoted.
439 The rpn2cql family of functions now always returns quoted CQL terms.
441 Fix CQL to CCL conversion for multiple terms. Add two test cases as well.
443 --- 4.2.23 2011/12/15
445 Allow =val to be omitted for yaz_uri_to_array. Also, multiple &'s in
446 sequence is treated as one. For example, &&a=b&&&c& is identical to
449 --- 4.2.22 2011/12/05
451 Add ZOOM_connection_save_apdu_wrbuf. This function may be used to save
452 APDUs for a connection to a WRBUF.
454 --- 4.2.21 2011/11/23
456 Fix cql_sortby_to_sortkeys. Completely broken before.
458 Make CCL's @truncation work again.
460 --- 4.2.20 2011/11/09
462 New ZOOM connection setting: tproxy. It's like proxy, but does not
463 set Z39.50 proxy OID or change HTTP for proxy behavior. Can be used
464 to set resolved address + port for a connection outside ZOOM itself.
466 Fix atoi_n_check digit test. Thanks to Giannis Kosmas for spotting it.
468 --- 4.2.19 2011/11/07
470 Fix uninitialized variable in Solr spell support (could cause SEGV
471 for SRU response decoding).
473 Error handling for Z_APDU_close uses ZOOM_set_dset_error() to pass
474 back-end's addinfo through into the ZOOM response addinfo.
476 When ZOOM_set_dset_error() is passed an addinfo2 as well as addinfo,
477 they are separated by a colon and a space rather than simply
480 --- 4.2.18 2011/10/28
482 Add support for Solr spell-checking/suggestions through ZOOM.
483 If a Solr target has been configured correctly for spelling-checking
484 and suggestions, these will now be returned on the ResultSet option
485 "suggestions". zoomsh has been extended to show this with the cmd suggestions.
487 --- 4.2.17 2011/09/28
489 Fix function nmem_strsplit_escape2 which extends nmem_strsplit_escape
490 with a flag whether to substitute escape sequences or not.
492 --- 4.2.16 2011/09/22
494 Fix nmem_strsplit_escape to substitute escape char properly.
496 New option for zoomsh -e , which makes it abort on first error and
497 return process exit code to indicate success/failure.
499 YAZ options utility supports special option -- which makes all it treat
500 all following arguments as non-options.
502 --- 4.2.15 2011/09/16
504 Fix yaz_file_path_resolve/yaz_path_fopen/yaz_fopen so that path is not
505 searched if absolute filename is given.
507 Fix conv_xslt() error-reporting when stylesheet is not found.
508 (The value of fullpath is meaningless in this situation.)
510 --- 4.2.14 2011/09/07
512 Fix problem in CQL sort node creation: un-initialized memory.
514 New ZOOM utility ZOOM_query_sortby2. That takes a strategy parameter: one of
515 "z3950", "type7", "cql", "sru11" or "embed". The "embed" chooses type-7 or
516 CQL sortby depending on whether Type-1 or CQL is actually sent to the
519 New sortspec utilities: yaz_srw_sortkeys_to_sort_spec,
520 yaz_sort_spec_to_srw_sortkeys, yaz_sort_spec_to_type and 7yaz_sort_spec_to_cql.
522 rpn2solr supports Z39.58 truncation (104). Thus, CCL truncation mode t=z
523 will make it possible to use both single-character mask (#) and wildcard (?)
524 in CCL . Throw diagnostic for left truncation because that is not supported
527 --- 4.2.13 2011/09/01
529 Fixes for cql2rpn, cql2ccl and ccl2rpn; mostly in the area of special
530 cases using escapes (\-sequences) and masking.
532 PQF parse fix: A trailing backslash followed by end-of-string (\0)
533 would result in a read one byte beyond string.
535 rpn2ccl may use Z39.50 masking for terms (t=z).
537 ICU check fix. Don't include library -lCrun on Solaris, unless present.
539 ICU check fix: Use --cppflags-searchpath to determine ICU include files;
540 not --cppflags (which seeems like an error in icu-config).
542 --- 4.2.12 2011/08/27 RPM package only
544 cql2ccl: fix conversion of terms: operator characters were not
547 --- 4.2.11 2011/08/25 RPM package only
549 ccl2rpn: Conversion to regexp-1 terms (trunc=102). For mode t=x, the
550 CCL parser will map both # and ? to their regular expression
551 quivalents (. and .*).
553 rpn2cql: deal with truncation=102 (regexp-1). And ensure proper quoting
554 of reserved CQL characters.
556 cql2ccl: deal with both * and ? in conversion. Also leave escaped ones as
557 is, so that they are passed through.
559 --- 4.2.10 2011/08/24
561 ZOOM SRU mode: more aggressive re-connect.
563 Private function prox_unit_name() renamed to yaz_prox_unit_name() and
564 made available as a utility function, declared in <yaz/logrpn.h>
566 rpn2cql_structure() supports proximity nodes (except that the Type-1
567 proximity node's "exclusion" binary is ignored, as there is no way to
568 express that in CQL). Fixes bug #4564.
572 Fix SEGV that could occur if set command of zoomsh was given without
573 value (2nd argument).
575 Fix SEGV that could occur if unsupported transport was given for
576 COMSTACK - say https (when SSL was unavailable).
578 Build yaz-url on Windows too.
582 New utility to get web content. Header is url.h. A command line tool
583 yaz-url is part of the distribution and packages.
585 Fixes for SSL COMSTACK (when gnutls is in use).
587 New functions yaz_base64{encode,decode}. Header is base64.h.
591 ZOOM C includes HTTP response buffer as additional info if it fails
592 to decode the SRU response.
594 Make wrbuf_json_puts available.
598 zoom: throw diagnostic for invalid value for option "sru". Before a
599 bad SRU request was sent.
601 Adding new utility wrbuf_vp_puts.
603 Add cclxmlconfig.obj to win/makefile. It was missing completely.
607 ZOOM HTTP: use absoluteURI's in proxy mode as required by RFC 2616 (HTTP).
608 Fix a bug in handling of cookies. Fix a bug that would occur if proxy +
609 redirect was used at the same time.
611 MARC line mode decoding: be less picky about length given - first
612 5 digits of header that is.
614 CQL to CCL conversion: deal with CQL proximity (cql_to_ccl function).
616 Changes to decoding of SRU records: a record with recordPacking=xml is
617 modified with a new root element <yaz_record> if the recordData contains
618 multiple children elements. This is to make the record XML parseable
621 RPN to Solr conversion: encode special characters.
623 Generic Frontend Server: fix uinitialized member, stepSize.
627 Fix a bug in SRU decoding of records.. The database records stored
628 had un-initialized memory, but it would only be seen with yaz_record_render
629 and type_spec="ext" .
631 Fix a bug in ccl_qual_dup introduced in 4.2.3.
635 Add new CCL utility, ccl_qual_dup, which makes a copy of a CCL bibset.
639 Add new utilities to convert from CQL to CCL . These utilities have
640 prefix cql_to_ccl defined in cql.h.
642 Defensive coding for an off-by-one bug in ucol_getSortKey. This could
643 lead to memory heap corruptions when ICU utilities were in use.
647 Make compilation work without Libxml2.
649 yaz-client: remove redundant blanks in display of searchResult-1 term
654 CQL: parse CQL sortby spec. The resulting sort spec is stored in the
655 resulting CQL node (tree) in a new node CQL_NODE_SORT.
657 CQL and GFS: add utility cql_sortby_to_sortkeys which converts CQL sortby
658 1.2 node tree to CQL 1.1 spec. This in turn allows the generic frontend
659 server to only consider srw_sortkeys and support both SRU 1.1 and 1.2.
660 Note that the CQL sortby spec is only converted when the GFS is already
661 converting from CQL to RPN (cql2rpn element).
663 New function nmem_strsplitx. This is like nmem_strsplit but allows us to
664 specify whether to collapse delimitors or not. The existing nmem_strsplit
665 do collapse (collapse parameter = 1).
667 Windows installer: For NSIS, set InstallDir depending on x86/x64.
669 Rename internal func yaz_use_attribute_create. While non-static, this
670 function is not declared in a public header.
674 Add -lCrun when linking with ICU on Solaris.
676 More quicks character set conversions for OPAC records.
680 fix problem with record_render: records were converted (character set
681 wise) even if no charset was given. Problem introduced in YAZ 4.1.5.
685 SRU: add methods for handling DADS SRU-proxy facets.
687 Separate OPAC record character set for ZOOM_record. yaz_record_render
688 allows a character set given as charset=from/opacfrom,to where 'from' is
689 the character set of a bibliographic record, 'opacfrom' is character set
690 of OPAC record and 'to' is the target character set.
694 yaz-client: show may XML format records. Command show followed by 'format'
695 will format XML records retrieved using Libxml2's xmlDocDumpFormatMemory
698 src/stemmer.c: Avoid using unnamed union. It is not supported by some
701 For PHPYAZ: set YAZVERSION, not YAZ_VERSION.
704 Update yaz.spec to operate on both SLES11 / Centos 5.5.
706 RPM: Release includes 'indexdata' name. Use indexdata in release name so
707 this package can be distinguished from other vendors.
709 yaz-config: Use exec_prefix, libdir, includedir . Use these variables
710 as determined by configure
712 yaz-config: set YAZ_VERSION env. php_yaz relies on it.
714 GFS: Z_PresentStatus_partial_4 for missing record. If bend_fetch handler
715 returns no error and no record, the present request is considered
716 partial (only a subset of the records could be returned by backend), and
717 so it is appropriate to set Present Status to partial-4.
721 Move yaz-config man pages to section 1.
723 More documentation about Solr.
725 tcp comstack: change behavior for @-specs (anyaddr). @ listens on
726 AF_INET (IPV4) peers, and @6 listens to AF_INET6 (ipv6) peers.
727 Previously @ listened on AF_INET6 which accepted both IPV4 and IPV6
728 peers on some Linux systems. However, in general that does not work
729 so YAZ can not rely on that to work. Debian changed behavior in this
730 respect from Debian lenny to Debian squeeze (still testing as of Oct
732 http://www.mail-archive.com/debian-devel@lists.debian.org/msg277726.html
734 zoomsh: remove "debugging" output. Was added by mistake in 4.1.0.
738 Fix yaz-config output: echo_source not set correctly by configure.
742 Solr Web Service support for yaz-client and ZOOM.
744 Define record syntax JSON. OID: 1.2.840.10003.5.1000.81.3 .
746 --- 4.0.12 2010/08/17
748 Z39.50 facet support. Facet specifications are passed for search in
749 other-information with ASN.1 as defined in facet.asn and OID
750 .10.1000.81.5 . Facets are expressed as an Attribute list as known
751 from Type-1/RPN queries. Type 1 is field. Type 2 is sort order. Type
752 3 is limit (number of entries to get in response). yaz-ztest returns
753 dummy facets if a client asks for them.
755 --- 4.0.11 2010/07/09
757 CCL fixes: bug 2895 and bug 3539.
759 GR1-display: add comma in display - was removed by mistake in
762 Windows installer: bundle MSVCP90.dll - used by icuuc42.dll.
764 SRU: Merge cookies on HTTP redirects (Giannis Kosmas <kosmas@lib.uoc.gr>).
766 --- 4.0.10 2010/06/18
768 ZOOM C: Add ZOOM_resultset_release. ZOOM_resultset_release releases a
769 result set from a connection. The result set will be on its own
770 thereafter; no operations on it will perform retrievals from a target.
771 Only cached copies are returned.
773 ZOOM C:fix case for HTTP servers responding with Connection:close.
774 Ensure that if there is a current task it is resumed (like fetching
775 more records in a result set) . Bug #3484.
777 PQF parser: use odr_atoi for Odr_int (not atoi)
779 Minor PQF encoding and decoding changes; reformat. PQF decoding: attribute
780 values that contain any non-digits are treated as string attributes
781 (previously decoding only checked for leading character ([0-9]). PQF
782 encoding: attribute string values are not surrounded by double-quotes.
786 New utility for managing threads - thread_create.h.
788 Add socket pipe utility - spipe.h. The socket pipe has same purpose as
789 Unix pipe . Unfortunately Windows pipes do not work on select/poll -
790 but YAZ' implementation do.
792 Fixes for yaz_cond-functions on Windows 7.
794 DLL export more symbols.
796 zoomsh: show record do NOT render opac.
798 Remove *.la files from Debian and RPM packages.
802 Debian package libyaz-dev depends on libgnutls-dev again (was
803 removed in YAZ 4.0.6, but due to Libtool it is still needed
804 even though yaz-config do not list libgnutls libs).
806 ZOOM: Use only one WRBUF for returning string results for
807 ZOOM_resultset. Reduces memory usage for ZOOM in general.
809 ZOOM: ZOOM_connection do not use a shared pointer to
810 ZOOM_resultset after ZOOM_resultset is destructed by
811 user. Reverts to YAZ 4.0.4 behavior.
815 record-conv: fix problem with at least one XSL conversion -
816 due to probably incorrect usage of XML XSL documents.
820 Fix yaz-config for static mode and the use of SSL (gnutls).
824 Forward decl timeval struct in mutex.h and gettimeofday.h.
826 yaz-config: fix 'static' mode linking.
830 Add functions yaz_cond_{create,destroy,wait,signal,broadcast}. These
831 are wrappers for pthreads or Windows. For Windows these are put in
832 a separate DLL: yaz_cond4.
834 libyaz.la (whole source) is compiled with thread. If thread support
835 is enabled enabled, all source of YAZ is compiled with treading support.
836 This allows core utilities such as yaz_log to use thread facilities.
837 Previously (YAZ 3 and YAZ 4 releases), only libyaz_server.la was using
838 thread utilities. This commit moves mutex utilities (mutex.c) from
839 libyaz_server.la to libyaz.la.
841 yaz-json-parse displays leading text until error.
845 Handle HTTP redirect for SRU GET in yaz-client and ZOOM C. Based on
846 patch from Giannis Kosmas.
848 SRU: no longer URL encode SRU database. The URL for an SRU server is
849 a URL and such is alreeady encoded - at least when given with leading
850 http:// or https://. This reverts behavior to YAZ 3.0.50.
852 Support for new MARC XML notation TurboMARC which like MARCXML is a
853 complete representation of MARC/ISO2709.. This one, however, is more
854 compact and allows for faster processing with XSLT. TurboMARC can be
855 used in the marcdisp.h API, from the yaz-marcdump utility and from
858 yaz-ztest can be configured - via the database - to perform certain
859 delays when it performs operations search, present and single record
860 fetch. This allows testers to make yaz-ztest act as a real or even slow
861 Z39.50 server. Refer to the yaz-ztest man pages for details.
865 wrbuf_destroy allows NULL WRBUF passed to it.
867 Fix CCL qualifier aliases (did not work since YAZ 2.1.56).
869 Add ZOOM_connection_close.
871 No fixed size buffers for ZOOM shell - bug #3257.
873 tstodr: make it work on s390 platform.
875 New icu iterator-functions. The new icu_iter-functions makes it possible
876 to use ICU chains from many threads.
878 yaz-client: better syntax check for show command.
882 New glob file pattern utility. Like POSIX glob. For Windows too. Refer to
885 New simple local-file XML include facility which allows file glob-patterns.
886 Refer to yaz/xml_include.h.
888 Utility yaz-json-parse which parses JSON and demonstrates the JSON parser
891 ZOOM_record_get supports new parameter "format" which makes it format XML
894 Fix JSON parser WRT start symbol. The start grammar symbol (referred to as
895 JSONText in ECMA-262) is JSONValue, not JSONObject.
899 Windows binaries for YAZ now compiled with Visual Studio 2008 (VC9).
900 Older versions of YAZ was compiled with Visual Studio 6.0 (1998).
902 Update so/DLL to version 4. Windows version builds YAZ4.DLL.
903 POSIX/Unix builds .so with major version 4.
905 Remove old LOG_-defines from log.h. They have been obsolete and
906 undefined by default for the last 5 years.
908 Odr_int is now of type 'long long'. Used to be 'int' in YAZ 3 series.
910 GFS: Remove socket (int *fd) from search_rr handler. The socket
911 descriptor ptr is a facility that allowed a search handler to supply
912 a socket which would serve as a callback - when search was complete.
913 This facility has now been in use for years.
915 COMSTACK API changes: cs_stackerr, cs_addrstr. COMSTACK method cs_stackerr
916 removed. It is not implemented by tcpip or unix COMSTACK, perhaps for ISO
917 SR which was removed 7 years ago. COMSTACK macro / method cs_addrstr now
918 returns 'const char *' rather than 'char *. The returned string is
919 read-only and should not be modified by applications. COMSTACK cs_close is
920 now a void function - it no longer returns int. No applications check for
921 the value and the implementations has always returned 0.
923 ZOOM: use size_t for scan hit counts and str size. Functions
924 ZOOM_scanset_term and ZOOM_scanset_display_term have changed, so that
925 occ (hit count) and len (string length) are now of type size_t pointer
926 rather than int pointer. This is to be able to represent large hit counts
927 and to also just to use the proper type for string length (strlen result).
929 New JSON parser. Refer to include/yaz/json.h .
931 WRBUF API changes.. For size parameters for WRBUF size_t is now used ..
932 Used to be int in some cases. Many wrbuf_-functions used to return an int
933 indicating some length.. These return values were never used. And so they
936 ODR: odr_malloc, odr_total now takes size_t for size.
938 clone_z_type: fix leak; occurred for encoding failures.
940 --- 3.0.52 2009/12/03
942 tcpip comstack: fix use of uinitialized variable in cs_straddr. This
943 bug was introduced in 3.0.51.
945 --- 3.0.51 2009/12/02
947 tcpip comstack: Remove TCP receiver buffer optimizations for Solaris.
949 tcpip comstack: fix leak for getaddrinfo.
951 Encoding of SRU database is performed by yaz_encode_sru_dbpath_odr or
952 yaz_encode_sru_dbpath_buf. Now used by yaz-client and the ZOOM API.
953 Decoding of SRU "path" database is performed by private function
954 yaz_decode_sru_dbpath_odr . This in turn is used by yaz_srw_decode
955 and yaz_sru_decode in server applications, GFS, yazproxy, metaproxy.
957 yaz-client: honor base command for SRU. Change when database setting
958 is applied for SRU and ensure it is kept when a connection is reset.
959 Change also the way errors are displayed or SRU (decoding of packages).
961 --- 3.0.50 2009/11/02
963 Add support for extra request / response data for SRU codecs and GFS.
964 The Z_SRW_PDU structure has two new members extraResponseData_{buf,len}
965 for extra data response buffer and length. For the GFS, both request
966 and response data (XML) is carried in extra_args and extra_response_data
967 for the search handler. Patch by Ko van der Sloot.
969 ZOOM: For queries that cannot be converted to the specified rpnCharset,
970 ZOOM now returns a diagnostic on the client-side ('invalid query' /
971 10010). This fixes bug #2113.
973 yaz-client fix: If cmdfile is passed to yaz-client (option -f) and that
974 cmdfile included a 'quit' command that would result in a memory violation.
976 --- 3.0.49 2009/10/01
978 Make a number of functions defined in xmlquery.c static. These have
979 never been declared in a public header file (yaz/xmlquery.h) and was
980 made public by mistake.
982 Improve speed of character conversions (iconv utilities). This makes
983 conversions from MARC-8 faster.
985 ZOOM_record_get returns 0 pointer if a MARC record can not be decoded -
986 unless type desired is "raw". This will prevent type "xml" from
987 returning ISO2709 .. Which obviously can not be XML parsed.
989 Fix memory leak in ZOOM that would occur if option apdulog was used
990 on a re-used connection.
992 Frontend server logs HTTP requests.
994 Frontend server now sends Z39.50 close when it times out (sesssion has
995 been idle for too long). Versions 2.0.30 and earlier also sent close.
996 But due to a mistake this was disabled in all versions after that, i.e.
997 the server would just close the socket immediately.
999 yaz-client emits a better message when receiving an unrecognised
1000 userInformationField.
1002 Skip zero-length subfields when decoding ISO2709. This rare case happens
1003 if a record has two FS characters in a sequence. Without this patch
1004 there would be a reference beyond char array in using_code_len fragments
1007 Fix yaz-marcdump error that would occur if option -n was used (bug #3028).
1009 --- 3.0.48 2009/08/28
1011 The show command offered by the zoomsh command now takes a 3d optional
1012 parameter type which is what is passed to ZOOM_record. If the type
1013 argument is omitted, "render" is used.
1015 RPN to CQL conv may use USE string attributes (bug #2978).
1017 MarcXchange NS is now info:lc/xmlns/marcxchange-v1 .
1019 --- 3.0.47 2009/07/08
1021 Function yaz_xml2query allows a diagnostic element in the PQF XML
1022 representation .. diagnostic@code and diagnostic@addinfo is diagnostic
1023 code and additional info respectively.
1025 The BER BOOLEAN is now the integral type Odr_bool which still happens
1026 to be an 'int'. The BER INTEGER which used to be a plain 'int' is now
1027 typedef'd to Odr_int. This is still an integral 'int', but it may be
1028 changed to 64-bit via a one-liner in nmem.h (NMEM_64=1). The documentation,
1029 ASN-1 compiler as well as programs has been updated to use the new types.
1031 --- 3.0.46 2009/06/08
1033 zoom: ZOOM_record_get now renders OPAC records when type=xml. Previously
1034 only the bibliographic record was rendered. For type=opac, an OPAC
1035 record is only returned if it is present.
1037 iconv: small fix for encoding of advancegreek.
1039 yaz-client: avoid double display of SRU/SRW records (bug #2798).
1041 yaz-client: option auto_reconnect=on really reconnects.
1043 yaz-client: fix bug #2770 - avoid length limit for auth parameters.
1045 server: avoid null ptr ref for for yaz_poll errors.
1047 build: fix RPM build for RHEL 5.3.
1049 comstack: prefer IPV6 addresses over IPV4 - should refix bug #2350
1051 --- 3.0.45 2009/03/31
1053 Fixed bug #2709: TCP connect returns Invalid argument.
1055 Fixed compilation for mingw.
1057 Honor charset for raw records (ZOOM_record_get).
1059 Fixed use of errno for threaded mode that was seen on Solaris 10.
1061 Fixed argument passing with blanks in value for Windows Service.
1063 Disable YAZ' own log rotate by default (no 1 GB limit).
1064 The variable l_max_size which specifies the log file limit is set to 0
1065 (DISABLED): This is due to the fact that YAZ is most often deployed using
1066 logrotate. Also YAZ can not perform log rotate because of unsufficient
1067 permissions (setuid).
1069 --- 3.0.44 2009/02/17
1071 List supported encodings in man page for yaz-iconv.
1073 Fixed missing SSL libs for --libs output
1075 Re-established OID record syntax application-xml. Nobody should use it
1076 but we don't want to change soname because of this symbol being absent.
1078 --- 3.0.42 2009/02/02
1080 YAZ' RPM spec works for both SUSE Linux Enterprise and RedHat Fedora.
1082 Added member named_result_sets for init handler struct for the GFS. This
1083 allows a server to disable named result sets.
1085 Removed OID record syntax application-xml.
1087 Added support for rule-based transliterator for ICU wrapper of YAZ.
1089 Fixed bug #1902: yaz-icu XML output.
1091 Make YAZ checks Emacs friendly.
1093 BITSTRING value shows value. Bug #2346.
1095 ISO2709 decoding: skip control characters from indicator data.
1097 Omit sort key by default in yaz-icu's output.
1099 Allow combined single char options (again) for YAZ' options function.
1101 Utility yaz-marcdump got option to display YAZ version (-V).
1103 Allow YAZ to use ICU 3.4.
1105 Added new ICU test case which illustrates removal of diacritics.
1107 --- 3.0.41 2008/12/29
1109 Fixed Fixed test that makes VERSION_SHA1 appear on dist versions too.
1111 --- 3.0.40 2008/12/29
1113 For configure, using option --without-xml2 also disables Libxslt/Libexslt
1116 Fixed bug #2352: yaz-marcdump crashes for certain record.
1118 Added man page 'bib1-attr' which includes list of common Bib-1 attributes.
1120 Added support for Danmarc2 to UTF-8 conversion.
1122 Added support for ISO5426 to UTF-8 conversion.
1124 zget_InitRequest/zget_InitResponse returns GIT SHA1 hash as part of
1125 implementation version.
1127 Function yaz_version returns GIT SHA1 hash for parameter sha1_str.
1129 --- 3.0.38 2008/11/10
1131 ZOOM C now only fires one ZOOM_EVENT_SEARCH per search-task. Previously,
1132 ZOOM_EVENT_SEARCH was fired for each searchRetrieve Response received.
1134 ZOOM C now interprets databaseName option for ZOOM connection as path
1137 Windows version bundled with Libxml2 2.7.1 / Libxslt 1.1.24 / ICU 4.0.
1139 Fixed CCL to RPN/PQF conversion which could result in invalid PQF.
1141 Dummy Libxml2 types no longer defined in headers of YAZ'.
1143 Fixed memory violation for ZOOM C - could occur when SRU diagnostics was
1146 --- 3.0.36 2008/09/26
1148 Various ODR chapter fixes.
1150 Windows version uses libxml2 2.6.32+, libxslt 1.1.23+ and ICU 4.0.
1152 Added missing source for Windows compilation, mutex.c.
1154 Fixed compilation of YAZ for Visual Studio 2008. Bug #2256.
1156 For SRU connections in ZOOM all records up to "count" are now fetched.
1158 Fixed crash in generic frontend server (and yaz-ztest) which occurred
1159 in Windows due to bad error handling for Libxml2.
1161 Added facility for sending arbitrary records (ASN.1 any) using
1162 ZOOM C's Extended service update. Patch by Sam Reynolds.
1164 New options for ZOOM C's connection, logapdu which makes ZOOM log
1167 --- 3.0.34 2008/06/18
1169 YAZ uses GNU TLS without the OpenSSL compatibility wrapper.
1171 --- 3.0.32 2008/06/12
1173 Fixed memory violation that could occur when decoding UTF-8. This bug
1174 was only present in 3.0.30 of YAZ.
1176 --- 3.0.30 2008/06/06
1178 Implemented SSL sockets using GNU TLS. OpenSSL is still supported, but
1179 GNU TLS is used by default (if found).
1181 yaz-ztest returns OPAC records if a client asks for OPAC.
1183 Improved speed of MARC-8 encoding.
1185 Added support for lossy and loss-less MARC-8 encoding.
1187 Changed yaz_record_conv_record to be reentrant for XSLT conversions.
1189 Added new Windows Service wrapper (sc).
1191 yaz-client's itemorder command may now send a file.
1193 Fixed yaz-marcdump to allow the use of NS prefix for record element.
1195 Added new function yaz_log_xml_errors.
1197 Allow (but warn) unknown XML attributes in MARCXML parsing.
1199 Handle G1 sequneces in MARC-8 decoding. Bug #2115.
1201 The UTF-8 to MARC-8 conversion now uses a different set of characters
1202 for Greek symbols. Bug #2120.
1204 --- 3.0.26 2008/02/21
1206 Added yaz_daemon (daemon.h).
1208 Fixed bug #2068: pkg-config trouble
1210 Fixed bug #395: ZOOM_record / OPAC record encoding problems.
1212 --- 3.0.24 2008/01/28
1214 Document --with-xml2 option.
1216 Added OPAC XML XSD (etc/opacxml.xsd).
1218 Allow glob mask for name attribute in retrieval element for the
1219 generic frontend server's retrieval facility.
1221 Changed yaz_poll_poll to return yaz_poll_except for all returned events
1222 except POLLIN/POLLOUT.
1224 Fixed error handling in cs_listen. Bug #2037.
1226 --- 3.0.22 2008/01/20
1228 Fixed version in yaz/yaz-version.h.
1230 Fixed bug #2027: Crash when closing connection.
1232 Changed configure so that ICU support is only enabled if only ICU
1233 and Libxml2 is available (because the ICU chain is XML based).
1235 --- 3.0.20 2008/01/15
1237 YAZ now makes ICU utilities for Windows. A separate DLL, yaz_icu3.dll,
1238 is built. Only this DLL depends on the ICU runtime.
1240 yaz-ziffy is no longer part of YAZ. It is distributed separately by
1241 Index Data because ziffy's license is GPL2 rather then 'Revised BSD'.
1243 Changed license of CCL module to 'Revised BSD'. After consultation with
1244 remaining members of the original EUROPAGATE consortium, we are re-issuing
1245 the CCL module without a separate license. The software was developed by
1246 Index Data as part of a research project. The special license was included
1247 to help feed usage information back to the project consortium to support
1248 project evaluation. At this time, the project consortium has long-since
1249 disbanded, and the majority of the original principals have retired. At the
1250 same time, we have significantly modified the software during the following
1251 years, to the point where very practically no original code remains. To
1252 simplify re-use of the software, we have contacted those members of the
1253 consortium who could be reached, and agreed to re-issue the module as a
1254 proper part of the YAZ package.
1256 Tcl scripts uses /usr/bin/tclsh as preferred shell.
1258 CQL closer to being version 1.2 compliant. CQL also allows free-form
1259 terms, such as 'title=a b', and thus, make the CQL parser more CCL-like
1262 Fixed bug in ZOOM_options_getl WRT setting of parameter lenp. This
1263 bug could make Extended services handling crash in the ZOOM layer. This
1264 bug was only present in YAZ 3.0.18.
1266 --- 3.0.18 2007/12/19
1268 ziffy uses YAZ' options rather than getopt; getopt is unavailable on
1271 yaz-marcdump reads and writes collection wrapped records.
1273 Handle OPAC for record conversion module.
1275 Fixes for ICU wrapper.
1277 Allow ICU libs to be controlled with --with-icu .
1279 --- 3.0.16 2007/11/12
1281 Added yaz_poll which is a wrapper for select/poll. When poll is available
1282 and non-buggy, it is used, by yaz_poll . This allows more than 1024
1283 sockets to be in use.
1285 Added ICU wrapper library which exposes ICU http://www.icu-project.org/
1286 functionality through an XML based configuration (ICU chain). This system
1287 is useful for search facilities such as Pazpar2 and Zebra that needs to
1288 perform tokenization of indexed material. The ICU code in a separate
1289 library libyaz3_icu.a.
1291 Added HTTP tunnel facility for COMSTACK, bug #1752.
1292 This is a facility that allows a Web proxy, such as squid, to tunnel
1293 Z39.50 traffic. This facility is "transparent" to must applications
1294 using YAZ. It's enabled by using pseudo transport connect: followed by
1295 the proxy address, followed by command, then follwed by he regular
1296 "virtual" addresss. For example,
1297 connect:webproxy.com:3128,tcp:z3950.loc.gov:7090/voyager .
1299 More MARC-8/UTF-8 conversion fixes. Bugs #1666, #1667, #1778.
1301 --- 3.0.14 2007/09/21
1303 Fixed bad memory reference in ZOOM_record - cuased by member not being
1304 initialized. This was a problem only in YAZ 3.0.12.
1306 Fixed bug in conversion from MARC to XML: Non-XML characters in control
1307 fields were not removed.
1309 Changed the way C code is generated from codetables.xml. Made a MARC-8
1310 conversion trie for each characterSet section rather than codeTable.
1311 This is ensure the code can deal with G0/G1 sequences. Use of a newer version
1312 of codetables.xml from Larry Dixson, LOC. Bug #1464.
1314 --- 3.0.12 2007/09/12
1316 ZOOM C now handles SRU surrogate diagnostics (i.e. errors returned
1317 from ZOOM_record_error).
1319 ZOOM C function ZOOM_record_get returns record schema for type="schema".
1321 Implemented HTTP Basic authentication to SRU/GET, SRU/POST and SRW requests.
1323 Added new ZOOM C connection option 'sru_option' which specifies SRU version.
1325 Better SRW-to-Bib-1 diagnostic mapping.
1327 ZOOM C and yaz-client announces SRU version 1.2 by default.
1329 yaz-client 'sru' command may specifiy both SRU version and transport (SOAP,
1332 Fixed in yaz_sru_decode to allow other version than 1.1.
1334 --- 3.0.10 2007/08/22
1336 Added support for SRU scan for ZOOM.
1338 Added support for the use of the older versions or Extended Service
1339 Update in ZOOM. To faciliate this, an option "updateVersion" may be
1340 set to the version , 1=first, 2=second, 3=third. The third version is
1341 what ZOOM C has used so far. And that, obviously, is the default.
1343 Added support for CCL queries in Z39.50 queries sent to the GFS (and
1344 therefore in Zebra and in SimpleServer-based applications). The new
1345 <ccl2rpn> element in a GFS configuration file, if present, names a CCL
1346 qualifier file used to transform incoming CCL queries into Type-1 RPN,
1347 which is passed into the back-end search callback function.
1349 Added support for HTTP Basic authentication in clients: the SRU/W
1350 codec encodes the username/password elements of the PDU structure
1351 appropriately, and these may be set using the "user" and "password"
1352 options in ZOOM-C applications (the same options that are used for
1353 Z39.50 authentication).
1355 --- 3.0.8 2007/06/25
1357 Fixed bug #1208: SSL appears to be broken in ZOOM.
1359 Fixed bug #1206: Libxml2 include path weirdness.
1361 Added oid_name_to_dotstring.
1363 Allow elementSetName to be specified for ZOOM C record update.
1365 Allow waitAction to be specified for ZOOM C based for Extended Services.
1367 Fixed NULL ptr reference bug in yaz-ztest - caused by omitted record
1368 syntax OID. Bug introduced in YAZ 3 series.
1370 Updated WIN32 build to include Libxml2 2.6.28 / Libxslt 1.1.19.
1372 --- 3.0.6 2007/06/06
1374 Fixed bug #1157: yaz-client does not read .yazclientrc from current
1375 directory. yaz-client now reads commands from file given by option -f
1376 if specified; then tries to read .yazclientrc in current directory.
1377 Failing that, it reads .yazclientrc from user's home directory.
1379 Added support for correlationInfo Note and ID for Record Update via
1382 Added yaz-client command querycharset which specifies character set for
1383 query terms for Z39.50 RPN queries and Z39.50 Scan Requests
1384 (termListAndStartPoint).
1386 Charset ISO5428:1984 is an alias for ISO5428-1984.
1388 Implemented a way to perform scan in a result set using Z39.50. This
1389 is achieved by attaching the result set name in the characterInfo
1390 (type InternationalString) of OtherInformation in the Scan Request PDU.
1391 The result set is identified in the otherinformation by the new OID:
1392 USERINFO, Z3950_PREFIX.10.1000.81.4, "Scan-Set
1393 This allows for scan in result set and faceted search . Zebra did some
1394 of this in the APT term using attribute type 8 and value being result
1395 set. Using the OtherInformation approach for this is cleaner and easier
1396 to work with in proxies and the like. This facility can be used in
1397 yaz-client using new command setscan which takes a result set as first
1398 argument, start position (APT) as second.
1400 Changed decoding of SRU XML packed records to deal with servers that
1401 have recordData with XML data with multiple root nodes. Also make
1402 comparison for recordPacking case insensitive. Again, one server
1403 returns "XML" where others return "xml".
1405 For SRU responses allow Content-Type application/xml as well as text/xml.
1407 --- 3.0.4 2007/05/21
1409 Fixed bug in character set conversion of BER strings. Bug introduced
1412 --- 3.0.2 2007/05/08
1414 For OIDs use Odr_oid type everywhere, i.e. do not assume Odr_oid=int.
1416 For OID class, use oid_class consistently.
1418 Fixed external handling for SUTRS and Explain records (bug appeared in 3.0
1421 Added partial support for ISO5428-1984, which is the "Greek alphabet coded
1422 character set for bibliographic information interchange". By Giannis Kosmas.
1424 Added documentation on new OID API.
1426 --- 3.0.0 2007/05/02
1428 Changes to generic frontend server interface: added new member
1429 'query_charset' for bend_initrequest structure. A backend init handler
1430 should set this member to its native character set for query terms.
1431 When defined, the frontend server logic will announce this character set
1432 to a client if the negotiationModel bit is set by the client. All server
1433 implementors are encouraged to specify this. If a backend server does not
1434 specify this a warning is issued using yaz_log(YLOG_WARN,..).
1436 Added CCL utility to remove terms (stop words) from resulting RPN
1437 tree. This is handled by functions with prefix ccl_stop_words_ .
1439 New ZOOM C option, "rpnCharset", which allows client-side conversion of
1440 terms in RPN queries.
1442 Clean-up the CCL API. Moved some internal structures from ccl.h to
1443 private header cclp.h. Changed ccl_parser_create so that a Bibset must
1444 be supplied. Removed tokenize API from ccl.h - including ccl_parser_find.
1445 This is replaced by ccl_parser_find_str which takes a string instead.
1447 Split YAZ library into two libs : libyaz.la and libyaz_server.la.
1448 libyaz.la is the core of YAZ except the generic frontend server and
1449 does not depend on POSIX threads anymore. libyaz_server.la is the
1450 generic frontend server facilities and uses POSIX thread functionality
1451 if available. The libyaz.la no longer depends on POSIX threads because
1452 the number of global structures is limited. NMEM no longer re-uses blocks
1453 between threads ; it simply free's memory immediately but allocates in
1454 "large" chunks as usual. We don't expect any performance penalties
1455 because of this. The yaz_log system is still using a global log_level so
1456 caution must be taken when modifying it with yaz_log_init_.. +
1457 yaz_log_mask_str. This, however, should not cause any trouble because
1458 these functions are called during initialization of application code
1459 anyway. `yaz-config --libs server` returns libs for server applications;
1460 `yaz-config --libs` returns libs for non-server applications.
1462 New OID database - with public definitions in oid_db.h. Removed old OID
1463 database including the head oid.h and definitions such as enum oid_value
1464 and struct oident. The new OID database uses the same string names as
1465 before but the 'protocol' is gone. There are now only two representations
1466 raw OID (int *) and string. Functions with prefix yaz_string_to_oid
1467 converts from string to OID; functions with prefix yaz_oid_to_string
1468 converts the other way.
1470 Change to emit_term() in CQL-to-PQF query translation: when a term has
1471 the /regexp relation modifier, do not process it for leading and
1472 trailing "^" and "*", which have quite different meanings in regular
1475 Attempted fix of bug #976: Segfault in yaz_iconv. The yaz_iconv function
1476 write handlers no longer carries a 'last' parameter. This will make
1477 yaz_iconv flush "less" characters. A flush is performed by call to
1478 yaz_iconv(cd, 0, 0, &outbut, &outbytesleft) .
1480 Definition of wrbuf_diags moved to querytowrbuf.h. Function wrbuf_put_zquery
1481 removed, because function yaz_query_to_wrbuf does the same.
1483 API changes to WRBUF. wrbuf_free removed; replaced by wrbuf_destroy. And
1484 wrbuf_puts no longer appends '\0'. Use wrbuf_cstr to get C-string out.
1486 Deprecated MARC utility functions removed.
1488 Changed prototype of yaz_marc_decode_buf: const char for result and size_t
1491 Branch split: YAZ_2_1_55_branch
1493 --- 2.1.54 2007/03/16
1495 Fix to ZOOM-C so that transparent reconnection is properly handled on
1496 connections that are in asynchronous mode.
1498 Fixed compilation on OpenBSD 4.0.
1500 Large strings in GRS-1 records are now properly displayed in yaz-client.
1502 Added character conversion support for "advancegreek"; based on patch from
1505 Fixed yaz_iconv to return YAZ_ICONV_EINVAL if an incomplete MARC-8 combo
1506 sequence is met. Before the error was not set so it would be unknown.
1508 Adjust yaz-marcdump MARC reader so that it skips until record separator
1511 --- 2.1.52 2007/03/07
1513 ZOOM-C: Removed hardcoded limit of 1024 sockets in ZOOM_event_sys_poll().
1514 Note that ZOOM_event_sys_select() still has the limit due to the fixed-size
1515 fd_set structure used as a bitmask for the FDs to be selected on.
1517 Using ACX_PTHREAD macro to check for POSIX threads.
1519 Fixed have-vsnprintf check.
1521 --- 2.1.50 2007/02/23
1523 Fixes for configure on BSD. Bug #900.
1525 Added snprintf/vsnprintf wrappers for systems that don't have
1526 limits (heavens forbid).
1528 Fixed bug in ZOOM-C's event and task handling. If a ZOOM task was
1529 created before all previous tasks were completed and removed from the
1530 task queue, the new task could be removed by a mistake.
1532 Fixed bug #615: Document retrievalInfo facilities for Frontend Server.
1534 Implemented pass-through CQL-to-PQF conversions. Bug #861.
1536 Fixed bug #832: Problem with MARC/charset in yaz-client.
1538 Fixed bug #668: save command line history for yaz-client.
1540 Fixed bug #830: pkg-config support.
1542 --- 2.1.48 2007/01/23
1544 Extended ZOOM result set options with two options that may be read by
1545 a client: resultSetStatus and presentStatus with values as specified for
1547 http://www.loc.gov/z3950/agency/markup/04.html#Search-status
1549 Fixed bug #827: Using SSL fails on Debian etch.
1551 Fixed bug #826: Weird looking chars for set of MARC records.
1553 Implemented alternative Item Order package for ZOOM. If option "doc" is set,
1554 that is treated as an ItemOrder with itemRequest being an XML document
1555 external. The value of "doc" is the content.
1557 Extended the GFS search facility. New member of bend_search_rr
1558 'estimated_hit_count' signals that hits is known to be an estmate
1559 (higher or lower than real hit count). New member 'partial_resultset'
1560 signals that the search was partial (hit count is lower or equal than
1561 real hit count). For Z39.50, the information is stored in resultSetStatus
1562 member of SearchResponse APDU. For SRU, the information is signalled
1563 via SRU diagnostic 59: "Result set created with valid partial results
1566 Switched from jade/pdfjdaetex to dblatex for Docbook documentation in PDF.
1568 --- 2.1.46 2007/01/13
1570 Implemented bug #806: Deal with HTTP clients sending LF in HTTP headers.
1572 Added ZOOM_connection_peek_event.
1574 Implemented Generic select hook for ZOOM (bug #803). This is achieved with
1575 the following new functions:
1576 ZOOM_event_nonblock, ZOOM_connection_process,
1577 ZOOM_connection_get_{socket,mask,timeout},
1578 ZOOM_connection_fire_event_{timeout,socket}.
1579 The existing blocking event handler, ZOOM_event, is a wrapper for the
1580 + blocking ZOOM_event_sys_{poll,select}.
1582 Implemented function ccl_xml_config which parses XML version of CCL
1583 configuration (bug #798).
1585 Fixed bug #797: yaz_marc_write_xml does not honor character conversion.
1587 Added timings utility (yaz/timing.h)
1589 --- 2.1.44 2007/01/03
1591 Added yaz_marc_write_xml which creates MARCXML/MarcXchange record as
1594 Fixed bug #779: Rotation of apdu.log fails.
1596 Fixed for character set conversions:
1597 Unicode to MARC-8 conversion for certain less preferred UTF-8 sequences.
1598 Honor G1 set in MARC-8 decoding.
1600 --- 2.1.42 2006/12/17
1602 Fixed bug #775: char conversion does not handle Alternative UTF-8
1605 Implemented function yaz_marc_read_line which parses MARC line format
1606 records. There is a wealth of formats out there. So far, this function
1607 reads line records produced by yaz_marc_write_line.
1609 yaz-marcdump's options -x, -X, -I, -e have been replaced with the
1610 more generic and easier to remember(!) options: -i format and -o format
1611 which specifies input format and output format respectively - where
1612 format is one of "marc", "marcxml", "line", "marcxchange".
1614 Added 'check only' option for MARC utilities. Option -n for yaz-marcdump
1615 does not print anything except warnings for records.
1617 For yaz-marcdump, added support for MARC split into files (-s) with a given
1620 Changed the SRU update structures and codecs to reflect the SRU pre 1.0
1621 spec, at http://www.loc.gov/standards/sru/record-update/
1622 This has changed the binary layout of the following structs:
1623 Z_SRW_extra_record, Z_SRW_updateRequest, Z_SRW_updateResponse and
1624 bend_update_rr . Patch by Ko van der Sloot.
1626 Added GFS utility function bend_assoc_is_alive which returns 1 if
1627 association is still alive (client is connected); 0 otherwise (client
1628 closed connection). This allows busy servers to stop working for
1631 Added ziffy: the promiscuous Z39.50 APDU sniffer. until now, ziffy has
1632 been a separate piece of software. This version of ziffy has been modified
1633 to fit with YAZ. ziffy is copyright Rocco Carbone and covered by GPL v2.
1635 Fixed bug #740: Handle SRU records referring to xmlns's outside recordData.
1637 Fixed bug #722: Allow Z39.50 Init Options to be specified / retrieved.
1638 Client code may now interrogate options such as "init_opt_sort" to
1639 find out whether the server claims to support various options.
1641 --- 2.1.40 2006/11/27
1643 Added utilities yaz_{set,get}_esn to set/get element set name from
1646 Removed the build of libyazthread.la. The libyaz.so is the threaded version
1647 of YAZ and has been so since YAZ 2.1.10.
1649 Implemented ZOOM_record_error which returns error information for
1650 record (surrogate diagnostic).
1652 --- 2.1.38 2006/10/31
1654 Updates for SRU Update by Ko van der Sloot:
1655 1. Changed name from "operation" to "action"
1656 2. Fixed that that "recordIdentifier" was called "recordId". Kept the old
1657 versions in the code, marked as 'backward compatible'.
1658 3. Added diagnostics for SRU Update.
1660 Fixed bug #709: Records are fetched in wrong format when tasks are queued.
1662 Fixed bug #707: CQL->RPN ignores lines with leading spaces.
1664 Fixed bug #706: XML hex encoding UTF-8 chars out of range 0-255.
1666 For GFS, fixed problem with SRU diagnostic 'First record position out of
1667 range' being issued for 0 hits.
1669 zoomtst10 part of Windows Build.
1671 --- 2.1.36 2006/10/13
1673 Implemented yaz_filepath_comp which splits a path into file path
1674 components (required by Zebra 2.0.3+).
1676 Change wording of YAZ license to the 'Revised BSD License'. YAZ has used a
1677 BSD inspired license until now so this should not have any real impact on
1678 anybody. See http://www.opensource.org/licenses/bsd-license.php
1680 Fixed bug #687: Missing log lines.
1682 Fixed bug #678: CQL to PQF translation does not preserve double-quote
1685 Fixed bug #689: SRU diagnostics to be added.
1687 Implemented new ZOOM function, ZOOM_connection_is_idle, which checks
1688 whether a connection is idle (no more work do do).
1690 --- 2.1.34 2006/10/04
1692 Change type of optval from long to int for invocation of setsockopt with
1693 the SO_REUSEADDR option. Thanks to Ateeq A. Altaf, Talis.
1695 Added support for specifying the max log file size for the Generic
1696 Frontend Server. The size is given with option -r.
1698 --- 2.1.32 2006/09/21
1700 Fix problem introduced in YAZ 2.1.28 WRT unix sockets in the ZOOM code.
1702 --- 2.1.30 2006/09/17
1704 Fixes for getaddrinfo use, Bugs #655 + #660. These bugs were introduced
1707 Fixed bug in Generic Frontend Server that could cause a server to stop
1708 accepting new connections. Bug only seen on dual CPU Windows 2003 server.
1710 For the generic frontend server, the maximum record size is used as maximum
1711 size of incoming packages (SRU + Z39.50). The value until was previously
1712 only used in Z39.50 Init negotiation and, later, in a session controlled
1713 sizes of records returned. This is controlled using -k option. It can be
1714 specified, per server, with element maximumrecordsize in YAZ' GFS XML config.
1716 --- 2.1.28 2006/09/04
1718 TCP/IP comstack uses getaddrinfo now to resolve names. It should be IPV6
1721 Fixed bug #644: Using Non Reentrant gethostbyname causes SIGSEGV.
1723 New option for yaz-marcdump -lpos=value which allows setting a portion
1724 of MARC header to a certain value.
1726 Fixes for MARC generation when encoded as MARC-8 (bug 642, 643).
1728 ZOOM-C reads option extraArgs. If set the value of extraArgs is appended to
1729 SRU URI (POST/GET). Value must be URL encoded, such as x-id-a=v1&x-id-b=v2 .
1731 --- 2.1.26 2006/08/15
1733 Fixed problem with SRU mode type (soap, get, post) for yaz-client
1736 Fixed problem another problem with ZOOM_EVENT_RECV_RECORD . Bug #626.
1738 --- 2.1.24 2006/08/08
1740 Fixed MARC ISO2709 encoding routines to deal with character set
1743 Minor changes to GFS logging. Database included in search request log
1746 Fixes for ZOOM-C: event ZOOM_EVENT_RECV_RECORD was not generated for
1747 cached/multiple records.
1749 Shared libraries are built by default on Unix+configure.
1751 Changed cql2pqf transformation to use a different evaluation order. The
1752 new order is: always, relation, structure, position, truncation, index
1753 and relationModifier. Old order was: always, relation, relationModifier,
1754 structure, index, position, truncation. Note that the the latter ones
1755 override former ones for identical attributes.. The new scheme means that
1756 it is possible to override any existing attribute with a relationModifier.
1757 And also that it is possible to override everything for the index rule
1758 (except the ones listed in relationModifier). No order is perfect but this
1759 one, we believe, covers more real cases.. The "always" should have been
1760 called "default", since the attributes there can be overridden with all
1763 For Libxml2 and friends, YAZ defines YAZ_HAVE_{XML2,XSLT,EXSLT) in the
1764 compilation phase, but also for yaz-config --cflags output. This allows
1765 us to have public headers with Libxml2 stuff in them . It should also,
1766 eventually, make Libxml2 checks redundant in packages using YAZ, such
1769 --- 2.1.22 2006/06/15
1771 Changed SRU update structure bend_update_rr so that SRU diagnostics are
1772 stored in uri, message and details.. Previously diagnostics were stored
1773 in errcode, errstring. Patch by Ko van der Sloot. Breaks binary
1774 compatibility.. but he's probably the only one affected, so.
1776 Added support for CCL, compiled on the client side, in ZOOM-C. This
1777 is invoked using ZOOM_query_ccl2rpn() with the CCL configuration as
1778 input; the resulting query objects can be used for for searching with
1779 ZOOM_connection_search() and scanning with ZOOM_connection_scan1().
1781 YAZ' configure searches for OpenSSL by default.
1783 SSL comstack uses SL_CTX_use_certificate_chain_file rather than
1784 SL_CTX_use_certificate_file. See
1785 http://lists.indexdata.dk/pipermail/yazlist/2006-June/001615.html
1786 for more info. Thanks to Ko van der Sloot.
1788 --- 2.1.20 2006/06/02
1790 Bug #600: SRU GET, POST support for yaz-client. Introduced
1791 command 'sru' which selects method SOAP/GET/POST.
1793 Allow missingValueAction to be specified for the sortspec string -
1794 function yaz_sort_spec. By default, the missing value action is null.
1795 Use ! to specify "abort". Use = followed by stringvalue to specify default
1798 Ensured that Present-handler (if defined) is called in GFS before any call to
1799 fetch-hhndler. This now includes piggy-backed presents as well as SRW/U
1800 searchRetrieve requests.
1802 Documentation for YAZ is now based on the Docbook XML/XSLT using
1803 xsltproc + N Walsh's stylesheets. It means that the CVS version of YAZ
1804 is no longer depending on jade/openjade or docbook-to-man scripts.
1805 PDF is no longer part of the distribution - but can optionally be
1806 made using DSSSL/jadetex or FOP.
1808 Added retrieval handling support in Generic Frontend Server to support
1809 conversion between MARC/XML as well as XSLTtransforms. See
1810 etc/yazgfs.xml for an example.
1812 Added Authentication support to Generic Frontend Server in SRU
1813 mode. Authentication using HTTP Basic is supported, as is the use
1814 of 'x-username' and 'x-password' parameters in the request itself.
1816 Added support for a new character set MARC8s identical to MARC8 except
1817 that it converts combined characters to single Unicode characters in the
1818 Latin-1 range (when possible).
1820 --- 2.1.18 2006/04/24
1822 ASN.1 compiler 0.4: generates brief Doxygen file header for
1823 generated .h/.c files.
1825 Utility yaz_iconv now supports conversion to MARC-8.
1827 New facilities for the MARC module. The reading - and writing of
1828 content are separate methods for the yaz_marc_t handle. The following
1829 read functions are available: yaz_marc_read_iso2709 (Reads MARC in
1830 ISO2709 format), yaz_marc_read_xml (reads MARC in MARCXML/MarcXchange
1831 format). Write functions have prefix yaz_marc_write_.. The existing
1832 utilities yaz_marc_decode_wrbuf and yaz_marc_decode_buf are still
1833 available. Removed support for OAI-MARC and simplexml (not the
1834 simplexml from PHP5).
1836 Added a new ZOOM event type ZOOM_EVENT_END which signals no more events
1837 to be returned for this connection.
1839 --- 2.1.16 2006/03/31
1841 Allow multiple languages and charsets to be specified with
1842 yaz-client. Each item must be separated by comma (NO BLANKS). E.g.
1843 negcharset iso-8859-1,utf-8
1845 Translation of proximity nodes from CQL into PQF now works.
1847 Moved to automake 1.8, 1.9.
1849 Added function yaz_log_set_handler which allows a log handler to be
1850 installed. This handler will be called for all log messages. Output
1851 to file is also produced; but that can be disabled by passing NULL
1852 fname to yaz_log_init_file.
1854 Fixed another problem with MARC-8 -> ISO-8859-1 conversions. Bug #537.
1856 For SRW (including GFS), accept application/soap+xml as content-type
1859 For GFS in SRU mode, an empty stylesheet in SRU URL (&stylesheet=&)
1860 produces NO stylesheet reference even if a default stylesheet is specified
1863 --- 2.1.14 2006/03/14
1865 Updated Windows package to include yazd.dll + yazd.lib for the
1866 Development component.
1868 If the environment variable YAZ_LOG is set, then it is used as a
1869 string indicating the default level of logging to use if not
1870 overridden by calls to yaz_log_init() or yaz_log_init_level(). If
1871 it's not defined, then the manifest constant YLOG_DEFAULT_LEVEL is
1872 used as before. So, for example, to omit warnings from YAZ logging,
1873 export YAZ_LOG=-warn
1875 cql_transform() now map structure and other attributes before indexes,
1876 so that index-specific structures and other attributes can override
1877 defaults. So now a combination of mapping specifications such as:
1879 index.dc.date = 1=date-modified 4=5
1880 does the right thing.
1882 cql_transform() now also respects the "always" mapping specification,
1883 which establishes an initial set of attributes to be used for all
1884 terms except where overridden by more specific attributes associated
1885 with the index, relation or modifier.
1887 Added SRU-GET and SRU-POST support for ZOOM C. Option "sru" specifies
1888 which mode to use; one of "post", "get" or "soap" (SRW, default).
1890 Fixes for yaz_iconv routines: changed trie-based character set conversions
1891 to use only non-negative values for bit fields due to Sun's C compiler not
1892 supporting negative values.
1894 Fixed bug in character set conversion yaz_iconv. Some three byte UTF-8
1895 sequences where not read correctly. Fix by Rustam Usmanov.
1897 Updated win/makefile to use options, settings which makes things
1898 compile with VS C 2005.
1900 --- 2.1.12 2006/02/01
1902 Fixed bug in yaz_oi_update which used incorrect value for categoryValue.
1904 In ZOOM socket code, use select instead of poll on MacOSX.
1906 ZOOM-C now support client-side compilation of CQL into RPN that is
1907 sent to the server, enabling CQL to be used against all Z39.50
1908 servers. Use ZOOM_query_cql2rpn() to set the compiled CQL into a
1909 ZOOM_query object, and submit it using ZOOM_connection_search().
1910 The CQL-to-RPN translation uses a configuration file, the name of
1911 which must be specified in the Connection's "cqlfile" option.
1913 ZOOM-C also support CQL scanning, via the new ZOOM_connection_scan1()
1914 function, which takes as its start-term parameter a ZOOM_query object
1915 (which may have had either CQL or RPN set into it).
1918 --- 2.1.10 2005/11/29
1920 Added ZiNG Update Support. New codecs are defined in srw.h. Extended the
1921 GFS to support this as well. Backend handler, bend_srw_update, does the
1922 update work. Code contributed by Ko van der Sloot.
1924 Allow retrieval of Search Result-1 information in ZOOM by the use of
1925 options that are attached to a result set. ZOOM documentation updated
1928 Fixed bug #416: First/second comb characters not handled in the MARC-8 to
1929 UTF-8 conversion. Patch by Raj Patel.
1931 Added option -m to GFS to control formatting of timestamps in log file.
1933 Added 'exit' as synonym for 'quit' in yaz-client
1935 Added support for specifying SRW resultSetId + resultSetIdleTime in a
1936 Generic Frontend Server's search handler. Refer to include/yaz/backend.h
1937 for the new members. Patch by Ko van der Sloot.
1939 Added support for SRU POST. It is supported for content-type
1940 application/x-www-form-urlencoded only. Patch by Ko van der Sloot.
1942 Do not build the separate Multi-threaded (MT) library libyazthread.la.
1943 Instead make the library libyaz.la multi-threaded. Threading as a whole
1944 can still be disabled by configure option --disable-threads. Previosly,
1945 with older GLIBCs there were problems with MT libs under Apache. This
1946 has now been fixed a long time ago.
1948 Fixed bugs in yaz_log that occurred on Sparc Solaris in Multi-threaded
1951 CQL module modified to be case insensitive for relations/indexes/operations.
1953 Fixed bug in CQL transform code: incorrect value relationModifieder
1956 Added 'show all' command for yaz-client which retrieves all results
1959 Added new yaz-client, xmles, which takes a (private) OID and
1960 a document to be sent as an extended service request.
1962 Describe new yaz-client commands wait_response and set_auto_wait.
1964 Increase TCP/IP listener backlog from 3 (which I am guessing was
1965 copied from the SunOS manual entry way back when) so SOMAXCONN, so
1966 that the socket will queue as many incoming connections as it's able
1967 to handle ongoing connections. In other words, it will never now
1968 refuse a connection that it would be able to handle merely because
1969 it's not got around to accepting() enough of the pending connections
1970 yet. This is the behaviour anyway under Linux, where the listen()
1971 argument is ignored; but not under BSD and on systems such as
1972 MS-Windows that use BSD-derived TCP/IP stacks. The behaviour of
1973 YAZ-based servers should now be uniform across operating systems in
1976 yaz-marcdump uses 64-bit file access on some systems. This is enabled
1977 on Linux and other Unix variants where _FILE_OFSET_BITS=64 is supported.
1978 This allows yaz-marcdump to read large MARC batches (>2 GB).
1980 Modified all YAZ source files - except the source which is auto-generated
1981 by tools - to use spaces rather than TABS. Emacs/VIM trailer added to
1984 Add ZOOM_connection_option_getl() and ZOOM_options_getl(),
1985 corresponding to the existing *_setl() function. These allow option
1986 values containing arbitrary valuues.
1988 Add ZOOM_resultset_sort1(), which should ALWAYS be used in place of
1989 ZOOM_resultset_sort() in new applications. Its behaviour is identical
1990 except that it returns an indicator of whether or not the sort
1991 criterion was accepted (0 for OK, -1 for invalid).
1993 --- 2.1.8 2005/06/07
1995 Fixed bug in yaz_marc_decode_buf. By mistake the routine appended
1996 MARC output rather than returning "new" buffer.
1998 yaz-client warns about unknown init options.
2000 Fixed bug #371: "options concurrentOperations ignores concurrentOperations"
2002 --- 2.1.6 2005/05/24
2004 Added support for SRW sort in Generic Frontend Server. Patch
2005 by Ko van der Sloot. Member srw_sortKeys in bend_search_rr holds
2006 sortKeys - or NULL if none is provided.
2008 Fixed bug #307: It was impossible to specify indefinite/no timeout
2009 for ZOOM_event. Special timeout value -1 now means indefinite timeout
2012 Added support for multiple languages and charsets to be specified in
2013 ZOOM. Each charset/language is separated by a blank. If negotiation is
2014 in effect in init-response, Option
2015 "negotiation-charset-in-effect-for-records" set to 1(true) or 0(false).
2016 Code based on patch by Vasiliy Osadchuk.
2018 Fixed bug #306: infinite recursion that occurred when calling
2019 yaz_log_level_init as the first call (before other log level or
2022 Fixed bug in scan handling in front end server: if preferred-Position-In-
2023 Response was non-present, a NULL pointer referece was performed.
2025 --- 2.1.4 2005/04/26
2027 Changed include/yaz/diagbib1.h and added include/yaz/diagsrw.h with
2028 diagnostic messages+codes for Bib-1 and SRW. Preprocessor defines are
2029 now defined for all those error codes. So instead of putting 109 in
2030 your program you'd use YAZ_BIB1_DATABASE_UNAVAILABLE. The messages
2031 are generated from a .csv - file. See src/bib1.csv and srw/srw.csv.
2033 Modified the yaz-marcdump utility to skip garbage bytes between MARC
2036 Fixed bug - uninitialized memory - due to bad code for fix of bug #272.
2038 Program yaz-client now exits and produces an error message if multiple
2039 Z39.50 servers are specified on the command line (none or one allowed
2042 Program yaz-marcdump skips garbage bytes between ISO2709 records rather
2045 --- 2.1.2 2005/03/16
2047 Fixed bug #273: Update for recent MARC-8 -> UNICODE changes.
2049 Fixed bug #272: Preserve spacing for CCL terms.
2051 --- 2.1.0 2005/03/14
2053 Added support for virtual hosts and multiple backend servers for
2054 the YAZ frontend server. The configution is XML based and
2055 support specificition of CQL to RPN mappings and explain information.
2056 See section "Virtual Hosts" in the YAZ manual.
2058 Extended OPAC display utility. OPAC display utility renders
2059 bibliographic (MARC) record as well. Added yaz_opac_decode_wrbuf
2060 to supplement yaz_marc_decode_wrbuf.
2062 Fixed a bug in MARC decoder that could caused it to crash for some
2063 invalid MARC records. More diagnostics and warnings where added in
2064 XML output (warnings, etc are stored in comments).
2066 --- 2.0.34 2005/02/08
2068 Fixes for UNIX domain sockets. Bug #261.
2070 Fixes for MARC-8 to UTF-8 conversion. Bugs #258 and #260.
2072 Fixed bug #263: YAZ MARCXML dump shows extra spaces after control fields.
2073 Added yaz_marc_subfield_str which defines subfield lead string which is
2074 used in YAZ_MARC_LINE format. Default string is blank+$. Added
2075 yaz_marc_endline_str which defines end of fields string used in
2076 YAZ_MARC_LINE format. Default string is newline.
2078 Experimental support for MarcXChange. This format can be produced
2079 by yaz-marcdump and is implemented in yaz_marc_decode - functions.
2080 http://www.bs.dk/standards/MarcXchange.xsd
2082 Added yaz-client commands scansize that sets maximum number of
2083 entries to be returned by scan.
2085 --- 2.0.32 2005/01/11
2087 Added support for SRW scan in yaz-client and Generic Frontend Server.
2089 * Added whereInList member to SRW Scan Term.
2091 * Changed Z_SRW_scanRequest to be able to carry both CCL and PQF.
2093 Fixed NMEM system to return aligned blocks on the smallest boundaries
2094 that are suitably aligned for all possible types on the particular
2095 architecture YAZ is being built for.
2097 --- 2.0.30 2005/01/04
2099 Fixed numerious warnings that was issued with newer versions of GCC.
2101 Fixed NMEM system to return aligned blocks on 8 byte boundaries rather
2102 than 4 bytes, since 4 may not be enough on some systems such as GCC 3.4.3
2105 Make YAZ Generic Frontend Server slightly faster.
2107 Enhance (and reduce) logging for Generic Frontend Server.
2109 Revert YAZ log system so that it flushes every write operation
2110 by default. (YAZ 2.0.26 and earlier verisons did that). Bug #240.
2112 Modified the YAZ logging system. The LOG level defines use YLOG_ prefix
2113 instead of LOG_, due to name clash with syslog(3). LOG_ are still
2114 present. New applications should define YAZ_USE_NEW_LOG=1 - this
2115 will effectively disable old definitions.
2117 --- 2.0.28 2004/11/09
2119 Added yaz_log_time_format which specifies log format using
2122 Added yaz_log_module_level which returns mask for a module. Value
2123 is non-zero mask a if module is enabled; zero if disabled.
2125 * Fixed bug #148: CQL parser may leak. A few prototypes were changed
2126 in include/yaz/cql.h.
2128 Fixed bug #176: Dont throw diagnostics on empty SRU args.
2130 Fixed bug #175: surrogate diagnostics in SRW lacking NS.
2132 Fixed bug #172: RPM builds does not enable SSL.
2134 Doxyfile.in part of dist. Doxyfile generated by configure.
2136 Configure aborts if any of --with-xml2, --with-openssl, --enable-tcpd
2137 are given and the corresponding component does not exist.
2139 Extend CCL documentation in YAZ reference. Describe r=r.
2141 --- 2.0.26 2004/10/01
2143 Fixed MARC->MARCXML conversion to properly deal with
2144 fields, subfields, indicators having non-ASCII characters.
2146 Fixed MARC->MARCXML conversion so that ASCII control characters
2147 except TAB,CR,LF are removed from resulting XML (XML 1.0 does not
2150 Added YAZ GFS support for conversion from Z39.50 surrogate
2151 diagnostics to SRW surrogate diagnostics.
2153 Bug fix: YAZ GFS did not return schema in explainResponse.
2155 --- 2.0.25 2004/09/30
2157 The YAZ GFS when converting SRW/SRU requests to Z39.50 structures
2158 now converts recordSchema to elementSetName as well as schema URI.
2160 Fixed bug in COMSTACK that prevented HTTP request packages from being
2163 --- 2.0.24 2004/09/29
2165 Added CCL facility r=r "range" which is similar to r=o "ordered" but
2166 does not require white-space before and after the dash in a range, e.g.
2167 x=-1990 is equivalent to x <= 1990 iff r=r, but equivalent to x= -1980
2170 Fixed a few AC_TRY_LINK configure tests that did not operate properly
2171 due to new GCC removing "redundant" code.
2173 Added yaz-client commands scanpos and scanstep that sets preferred
2174 position and step-size for scan.
2176 Macro YAZ_INIT in yaz.m4: option --with-yazconfig renamed to --with-yaz.
2178 Added CCL utility ccl_qual_buf which parses one or more CCL
2179 spec lines in a buffer.
2181 Added CCL utility ccl_qual_line which adds CCL qualifier line consisting
2182 of name and value - ignoring empty lines and comments.
2184 On Windows, the debug DLL/import lib is now named yazd.{dll,lib}.
2186 Added odr_get_element_path which returns current element path for an
2187 ODR handle. This utility is useful in error handling or user-defined
2190 Added ODR_PRINT utility odr_set_stream which is is a more generic
2191 alternative to odr_setprint. odr_set_stream takes a stream handle, pointer
2192 to a write function and pointer to close function. The close function - if
2193 non-NULL - will be called during odr_destroy.
2195 Fixed bug in CCL parser where truncation char was not removed from
2196 right side when truncation=both was in effect.
2198 Fixed CQL parser to use unsigned chars for isxxx from ctype.h due
2201 --- 2.0.23 2004/08/11
2203 Fix buffer overrun in CQL parser when dealing with proximity (%).
2205 Fixes for MARC-8 in yaz_iconv character set utilies. The MARC-8
2206 to UTF-8/UCS conversion is now only based on codetables.xml.
2208 yaz_marc_decode_buf sets leader pos 9 to "a" for MARCXML output.
2210 --- 2.0.22 2004/08/06
2212 Add support for more "commit changes" in ZOOM (uses Extended Services).
2214 For yaz-client, command set_marcdump <file> / -m <file> dumps SUTRS/XML/..
2217 Yet another small fix for configure of SSL.
2219 --- 2.0.21 2004/05/14
2221 Fix SSL libs for configure when --with-openssl=DIR is given.
2223 --- 2.0.20 2004/05/10
2225 Add autoconf m4 macro YAZ_DOC for YAZ documentation setup (docbook).
2227 SSL comstack now uses yaz.pem certificate file on server side
2228 by default. Certificate filename can be configured by calling
2229 comstack function cs_set_ssl_certificate_file before cs_bind is used.
2231 Fix bug regarding multiple calls to ZOOM_connection_connect.
2233 Implement cs_set_ssl_ctx which sets SSL_CTX for SSL comstack.
2235 Do not create SSL_CTX in cs_create (ssl_type). Create in tcpip_bind,
2236 tcpip_rcvconnect instead. This allows user to set custom SSL_CTX.
2238 ZOOM now allows inspection of X509 peer certificate for verification.
2239 The X509 buffer is retrived by reading ZOOM option "sslPeerCert".
2241 Removed libyazssl.la. When SSL is enabled, libyaz.la has SSL support and
2242 all programs have too (yaz-ztest, yaz-client, zoom..). May not be
2243 as "modular" but it simplifies things.
2245 Added cs_get_peer_certificate to that returns peer X509 PEM.
2247 Added cs_get_ssl that returns SSL handle (SSL *) for SSL comstack; returns
2248 NULL if SSL is unavailable.
2250 Documentation about MARC decoding tools.
2252 Fix --disable-tcpd to really disable tcpd. Patch by Robin H. Johnson.
2254 --- 2.0.19 2004/03/30
2256 Rename CHANGELOG to NEWS to follow GNU style packing.
2258 Fix bug with missing initialization of member in init_diagnostics.
2259 This bug affects threaded version of GFS server.
2261 --- 2.0.18 2004/03/20
2263 Use wrbuf_xmlputs_n instead of wrbuf_write_cdata to avoid clash with
2266 Ensure zlib.dll is packed with Windows install.
2268 --- 2.0.17 2004/03/17
2270 Fix encoding of xsd:string to use text instead of CDATA.
2272 Fix endless loop in CQL parser with unbalanced ".
2274 Use a more compact way to store MARC-8 conversion tables.
2276 --- 2.0.16 2004/03/16 Debian only
2278 Oleg Kolobov Fixed a bug in yaz_iconv regarding conversion to
2281 Update CQL parser to use new CQL 1.1 modifiers for booleans and
2286 --- 2.0.15 2004/03/01
2288 Another fix for decoding of XML packed records.
2290 --- 2.0.14 2004/02/25
2292 Fixes for Chunked encoding. White space not ignored after length spec.
2294 Update NS and use default NS for SRW diagnostic elements.
2296 --- 2.0.13 2004/02/23
2298 Implement ZOOM_resultset_cache_reset which resets record cache.
2300 Implement ZOOM_resultset_sort which sorts a result set.
2302 Implement chunked HTTP transfer.
2304 For SSL, use -lssl -lcrypto on systems that don't have pkg-config.
2306 --- 2.0.12 2004/02/16
2308 Added member 'schema' to bend_explain_rr structure so that backend
2309 can specify explain record identifier. Defaults to Zeerex 2.0.
2311 Fix encoding of OID's of form 1.0.X. Bug introduced in 2.0.11.
2313 --- 2.0.11 2004/02/16
2315 * SRW/SRU 1.1 updates: updated diagnostic in srw.h to use uri instead
2318 Added init command for yaz-client which sends "extra" init request.
2320 Fixed two bugs in OID codec - ber_oidc. Throw error when encoding/decoding
2321 bad truncated OID. Fix decoding of OID X.Y... when X=2 and Y>39.
2323 Fixed a bug in ASN.1 compiler that caused Type-1 Operator codec to fail.
2325 Make ZOOM error code for "invalid query".
2327 Fixed compilation for SSL which wasn't properly enabled for all platforms.
2329 --- 2.0.10 2004/02/05
2331 For yaz.m4, allow second argument for YAZ_INIT to hold minimal version of
2334 * SRW/SRU 1.1 updates. Diagnostic code now a URI.
2336 Added option -p <file> to make Generic Frontend Server to write PID file.
2338 Added option -D to put Generic Frontend Server in background on its own.
2340 Make ZOOM C recognize option "password". If unset, "pass" is used
2341 (for backwards compatibility).
2343 Fixed a bug in Generic Frontend Server that could make it crash if a
2344 client sets characterSetNegotation bit, but didn't pass negotiation stuff
2347 New YAZ client command, zversion, that sets Z39.50 version (1,2,3..).
2348 Must be issued before open, in order to be in effect.
2350 --- 2.0.9-6 2004/01/12 Debian/Windows
2352 Make the SRU server more picky WRT unknown params, etc.
2354 Bug fix: ZOOM scan response didn't return displayTerm - when present.
2356 New YAZ client command, options, that sets Z39.50 options.
2358 New utility functions yaz_init_opt_{encode,decode} to encode/decode Z39.50
2359 options from a string of tokens (one token for each option bit).
2361 Update SRW diagnostic code messages.
2363 --- 2.0.9-5 2004/01/07 Debian/Windows
2365 Handle user defined stylesheet for SRW/SRU.
2367 --- 2.0.9-4 2004/01/06 Debian/Windows
2369 Fix bug in decoding of Content-Length.
2371 --- 2.0.9-3 2004/01/06 Debian/Windows
2373 Fix a bug with decoding of XML packed records.
2375 --- 2.0.9-2 2004/01/05 Debian only
2377 Allow empty ODR (NMEM=0) for odr_oiddup and odr_getoidbystr.
2379 Fix bug in SRW/SRU diagnostics decoding.
2381 --- 2.0.9 2004/01/05
2383 Fixed bug in Generic Frontend Server which could drop records exceeding
2384 preferred message size. Reported and fixed by Irina Dijour.
2386 Fixed calculation of package size for structured records in Generic
2387 Frontend Server. Reported and fixed by Irina Dijour.
2389 Fixed namespace for SRW/SRU diagnostics.
2391 Fixed SEGV in yaz-client that occured for HTTP connection errors.
2393 --- 2.0.8 2003/12/22
2395 * SRW/SRU 1.1. Since the Namespace has changed for SRW/SRU, it means that
2396 this version is incompatible with version 1.0 and older YAZ SRW/SRU
2399 CQL changes to reflect recent changes to the specification:
2400 * Documentation talks about context sets instead of index sets.
2401 * Documentation talks about indexes instead of qualifiers.
2402 * The CQL-to-PQF transformer's configuration file now uses
2403 "index.set.name = <attributes>" instead of the old form
2404 "qualifier.set.name = <attributes>". (Both forms are still
2405 understood but the latter is deprecated.)
2406 * CQL terms with no explicit index specified are now interpreted as
2407 cql.serverChoice instead of srw.serverChoice (which of course
2408 behaves exactly the same.)
2410 --- 2.0.7 2003/12/16
2412 MARC conversion can now generate ISO2709 output in another
2413 character set. yaz-marcdump uses this facility if you invoke it
2416 Added missing C decl macros for include/yaz/{soap.h,srw.h,cql.h}, so that
2417 functions from there can be used from C++.
2419 --- 2.0.6 2003/12/04
2421 Frontend server now transfers memory from decoded packages to stream
2424 NMEM now clears freed blocks with 'Y' (hex 59) to force bad memory
2425 references to show up.
2427 ZOOM-C now supports standard ZOOM option names as described in v1.4 of
2428 the ZOOM Abstract API. The older names for the same options are still
2429 also supported for the benefit of old applications.
2431 ZOOM-C supports "implementationId" and "implementationVersion" options
2432 to go along with "implementationName". These allow the user code to
2433 specify identification strings to be sent to servers.
2434 Add OID for the new ExtLite attribute set.
2436 Add OIDs for NACSIS-CATP, FINMARC2000 and MARC21-fin record-syntaxes,
2437 as requested/supplid by Ere Maijala <ere@atp.fi>
2439 For generic frontend server, reverse the order of
2440 "toolkit-supplied / application-supplied" strings sent as implementationId,
2441 Name and Version. Also, remove the spaces around the slash. This brings
2442 the GFS in line with the behaviour of ZOOM-C on the client side.
2444 Add function ZOOM_scanset_display_term.
2446 yaz-client shows scan displayTerm if present.
2448 Utility yaz-iconv is now installed by default along with the man page
2451 Extend configure check for OpenSSL to use pkg-config where available (such
2454 Incorporate patch by Morten Bogeskov which allows a Unix file socket
2455 server to specify uid/gid/mask for socket using the format
2456 unix:[user=uid,][group=gid,][umask=mask,]file=path
2457 If file= is omitted the existing format is assumed, e.g.
2459 in which case the mask is 0666 (rw for everybody).
2461 Major restructure of YAZ source. All source in libyaz is in src directory.
2462 Programs in client (yaz-client), ztest (yaz-ztest), zoom (zoom programs),
2463 util (utility programs such as ASN.1 compiler, yaz-marcdump).
2465 Added man page for utility yaz-marcdump (used to be called marcdump).
2466 yaz-marcdump is installed by 'make install'.
2468 Fixed a memory leak in Generic Frontend Server that occurred when decoding
2469 of incoming package failed.
2471 Fixed a potential DOS attack vulnerability in COMSTACK/ODR.
2473 Change prototype of odr_perror: add const to message string.
2475 New function yaz_log_reopen which reopens log file (for log rotate, etc.)
2477 * Blocking parameter for COMSTACK cs_create is now a bit mask rather
2478 than a blocking flag. Bit 0 is set for blocking, reset for non-blocking.
2479 Bit 1 is set if cs_addrstr should avoid DNS lookup; reset for full
2480 DNS lookup. There should not be any compatibility problems with this
2481 assuming that blocking=1 or 0 is used.
2483 Fix bad reference in UNIX comstack in function cs_addrstr.
2485 Fix for compilation on AIX.
2487 The generic front-end server (server/seshigh.c) now supports returning
2488 Init diagnostics to the client in User-information-field, in
2489 accordance with Z35.90 Implementor Agreement 5 (Returning diagnostics
2492 --- 2.0.4 2003/09/04
2494 Allow any CQL relation (not just all,any,exact,scr).
2496 Fixes for OCLC UI ASN.1 to make it work with SilverPlatter targets
2497 that features the same UI.
2499 Implemented command update0 in YAZ client which is equivalent to
2500 update but uses old of Ext Update ASN.1.
2502 Use OID 1.2.840.10003.15.1000.81.1 for privately defined charsets
2503 in charset negotiation. Added VAL_ID_CHARSET in oid.h.
2504 Previously no OID was used for this info.
2506 ZOOM uses smallSetUpperBound=1 instead of 0 for piggyback searches.
2507 It apparantely upsets EBSCO Publishing IR Z39.50 Server which
2508 returns 'malformed search term' otherwise.
2510 SortResponse member resultCount now set to NULL in sort handler of
2513 OPAC support ZOOM. ZOOM_record_get returns OPAC info (as XML) if
2516 Add three new utility functions for translating OIDs between various
2517 formats -- symbolic name such as "Usmarc", minus-1-terminated int
2518 arrays and dotted strings such as "1.2.840.10003.9.5.1":
2519 int *oid_name_to_oid(oid_class oclass, const char *name, int *oid);
2520 char *oid_to_dotstring(const int *oid, char *oidbuf);
2521 char *oid_name_to_dotstring(oid_class oclass, const char *name, char *oidbuf);
2523 Reverted modifications for ES Update definition for z_IU0Update
2524 (OID 1.2.840.10003.9.5.1 and 1.2.840.10003.9.5). The definition
2525 is back to YAZ 2.0.2.
2527 String value attributes for CCL parser.
2529 Support for OCLC's locally registered "OCLC-UserInformation" PDU,
2530 which their FirstSearch server returns in Init responses, sometimes
2531 carrying useful diagnostic information when Init fails. This has the
2532 OID 1.2.840.10003.10.1000.17.1 and is defined in the file
2533 "z39.50/oclcui.asn", where its definition is somewhat different from
2534 what OCLC document on their web-site, as required to interoperate with
2537 Support for anonymous authentication in yaz-client. Use the command
2540 * Fix the OID of the Index Data-local "admin" Extended Service from
2541 1.2.840.10003.9.81.1 to 1.2.840.10003.9.1000.81.1. The omission of
2542 the 1000, which indicates a locally-defined OID, was a mistake.
2544 --- 2.0.3 2003/06/20
2546 Fix CCL directive @case handling so that it affects string match for
2547 both CCL keywords and qualifiers.
2549 * ESFormat-Update updates. Packages with OID 1.2.840.10003.9.5.1 and
2550 1.2.840.10003.9.5 are now handled by the same decoder z_IU0Update .
2551 Decoder has been updated with ASN.1 changes as listed in
2552 http://lcweb.loc.gov/z3950/agency/defns/updateES.html
2553 Note that the "latest" DB Update, OID 1.2.840.10003.9.5.1.1 , handler
2554 z_IUUpdate, remains unchanged.
2556 ZOOM_record_get may now return a record in a specific character set.
2557 For type use "form; charset=from[,to]" where form (render, xml, ..) ,
2558 "from" is the character set of record as returned by target. "to" is
2559 the character set to be returned. If omitted, "to" is UTF-8.
2561 YAZ ASN.1 compiler renamed from yaz-comp to yaz-asncomp
2563 New ODR utility, odr_getelement, which returns name of element for
2564 which encoding/decoding failed.
2566 Fixed ODR so that it returns error code OREQUIRED rather than ONONE
2567 in cases where a required element was omitted.
2569 Bug fix: some MARC8 sequences were not converted.
2571 New ZOOM option "step" which specifies number of records to be
2572 retrieved in one chunk. Used in conjunction with "start" and "count".
2574 SRW support for yaz-client. Use scheme http: to use it, e.g.
2577 yaz-client no longer does (un)intelligent character set conversions
2578 by default. Can be enabled with charset and marc_charset commands.
2580 xmalloc trace fix for 64-bit systems such as DEC alpha.
2582 Solaris 2.6 compile fix.
2584 New function, cql_strerror() translates SRW error codes, as returned
2585 by cql_transform_error(), into human-readable English strings. Used
2586 in yaz-client diagnostics when appropriate.
2588 New CQL2RPN query-type for the command-line yaz-client, parses CQL and
2589 converts it into a type-1 query which is sent to the server. This
2590 makes CQL available for use with all Z-servers, as opposed to the tiny
2591 minority that can handle CQL queries themselves.
2593 --- 2.0.2 2003/04/28
2595 New Debian package layout similar to the Redhat Package layout.
2597 New ZOOM events ZOOM_EVENT_RECV_{RECORD,SEARCH} for receiving a record
2598 and search result respectively.
2600 --- 2.0.1 2003/04/25
2602 Redhat package is now several packages: libyaz (runtime libraries),
2603 libyaz-devel (development and documentation, and yaz (utility programs).
2604 Package spec file by Morten Bogeskov.
2606 New member 'schema' in struct bend_fetch_rr which the name of requested
2607 schema (SRW/SRU) for record (or NULL if none was given). The fetch
2608 handler MAY set this to reflect the schema of the returned record.
2610 New member 'display_term' in struct scan_entry. GFS now sets member entries
2611 and allocates scan entries to be filled by user scan handler. In previous
2612 version, entries member was allocated by the scan handler. That still works,
2613 but the GFS will ignore member display_term - assuming it was NOT set by
2614 the handler. The fact that the GFS now allocates the entries both allows
2615 for new members and makes a scan handler easier to write.
2617 Fix CQL lex buffer overflow.
2619 SRW/SRU recordPacking. For SRW default recordPacking is string. For
2620 SRU default recordPacking is string.
2622 SRU protocol support for frontend server.
2624 Fix compile bug for systems that have nl_langinfo but CODESET undefined.
2626 Added missing PQF transform rules for <= and >= . Thanks to Peter Popovics.
2628 Added scan for the ZOOM shell (zoomsh).
2632 * String Identifers for Schemas (Amendment 5).
2633 http://lcweb.loc.gov/z3950/agency/amend/am5.html
2634 Old definition for schema
2635 Odr_oid *schema; /* OPT */
2640 Z_InternationalString *uri;
2641 #define Z_Schema_oid 1
2642 #define Z_Schema_uri 2
2645 * resultCount parameter to Sort Response (Amendment 1).
2646 http://lcweb.loc.gov/z3950/agency/amend/am1.html
2648 Support for SRW 1.0 over HTTP. This is an optional feature and
2649 requires libxml2 to operate. Enable SOAP by specifying --with-xml2
2652 Generic frontend server supports HTTP/SOAP/SRW and Z39.50/BER
2653 on the same port. SRW SearchRetrieveRequests are mapped
2654 to bend_init,bend_search,bend_fetch,bend_close.
2656 Z39.50 Query Type-104 added - to facilitate CQL within Z39.50.
2658 CQL support. Source is directory 'cql'. CQL is supported in ZOOM
2659 (both SRW and Z39.50) and the YAZ client (Z39.50 only).
2661 ZOOM connections are SRW based if schem http is used for hostname
2662 in connect, e.g. z = ZOOM_connection_new("http://myserver");
2663 ZOOM_query may be of type CQL, e.g. ZOOM_query_cql(q, "dc.title=x");
2665 CCL proximity operators !n, %n converts to PQF @prox 0 n 1 2 k 2
2666 and @prox 0 n 0 1 k 2 respectively, meaning: exlusion=false,
2667 distance=n, order=true/false, relation=le, prox unit=word. If
2668 n is omitted, distance 1 is used.
2670 Fixed problem with C compiler include path in wrong order.
2672 For TCP/IP COMSTACK, set recv buffer to an appropriate "large" value
2673 on Solaris. Patch from Ko van der Sloot.
2675 New MARC decode API. All new functions operate on a yaz_marc_t
2676 handle. The most important new functions are: yaz_marc_create,
2677 yaz_marc_decode_{buf,wrbuf}, yaz_marc_destroy, .. to create handler,
2678 decode and destroy respectively. Decoder can produce formats
2679 MARC line, simple XML, OAI MARC and MARC XML (LoC). See
2680 include/yaz/marcdisp.h.
2682 YAZ Iconv utility now supports MARC8 decoding (marc8.c). Converts
2683 to UTF-8, UCS-32, wchar_t or Latin-1.
2685 * Prototypes for yaz_iconv_-functions moved to separate header
2686 include/yaz/yaz-iconv.h.
2688 Make a few private functions 'static' in unix.c. This prevents
2689 duplicate unix_close in PHP with YAZ and imap. PHP Bug 20977.
2691 For ZOOM connection, the options targetImplementation{Id,Name,Version}
2692 are set when Init Response is received.
2694 New function ZOOM_connection_error_x similar to ZOOM_connection_error
2695 but returns diagnostic set as well.
2697 New function yaz_strerror which is a portable wrapper for
2698 strerror/strerror_r/GetLastMessage.
2700 * ZOOM_record_get supports type "xml" in which case MARC XML (from LOC)
2701 is returned for MARC. If type is "oai", then OAI MARC is returned.
2703 Fix creation of lib/yaz-config so it works if srcdir != objdir. Patch
2706 --- 1.9.2 2002/11/26
2708 yaz_marc_decode uses OAI MARC as XML format for ISO2709 records.
2710 Fix bad race conditions on SIGTERM and terminate gracefully in
2713 Move retrieval (data1) module to Zebra since nobody seems to be
2716 Add GRS-1 render for ZOOM using same format as yaz-client.
2718 --- 1.9.1 2002/10/05
2720 Added man pages: yaz-client(1), yaz-ztest(8), yaz(7), zoomsh(1).
2722 Fix broken ESpec handling in data1 module.
2724 SGML reader parses comments and makes them part of the data1 tree.
2726 Added several type casts so that YAZ compiles as C++ code.
2728 ZOOM didn't handle PDU encoding failures properly.
2730 Added more Bib-1 diagnostics (approved extensions).
2732 GNU configure: better check for iconv.
2734 More portable use of accept, getpeername. Check for socklen_t. Use
2735 int/size_t if socklen_t is not defined.
2739 PQF parser rejects bad queries - including those with extra
2740 characters in them. PQF parser used to silently ignore that.
2741 Cleaner API for PQF added, which allows you to get detailed
2742 error information for bad queries (see yaz/pquery.h).
2744 Fixed bug in ZOOM_record_get for type "database".
2746 Implemented mini iconv library supporting conversions between
2747 UTF-8, UCS4, UCS4LE and ISO-8859-1. Implemented in util/siconv.c.
2749 * Removed XML reader (d1_expat.c). It's part of Zebra instead.
2751 --- 1.8.9 2002/08/20
2753 Fixed ZOOM C record cache so that preferredRecordSyntax and
2754 elementSetName is used to check for already fetched records.
2756 --- 1.8.8 2002/08/02
2758 Added three members in bend_initrequest structure to facilitate
2759 character set negotiation.
2761 Fixed a bug in frontend server that could cause indefinite
2762 loops under rare conditions.
2764 Revised character set utilities (charneg.h) so that encoding
2765 UCS-4, UCSA-4, UTF-16 and UTF-8 are encoded non-privately.
2767 For PQF, directive @term <type> sets term type for Scan/Search.
2768 Here <type> is general, string, numeric, null. The term type
2769 is inherited - just like @attr.
2771 New call odr_set_charset that sets character set conversion for
2772 international-strings on a ODR stream. Prototype is:
2773 int odr_set_charset(ODR o, const char *to, const char *from);
2774 The InternationalString is still represented as C string in YAZ
2775 so native strings of type UTF-8, ASCII, etc. will work (UTF-16
2776 won't). On the protocol level, you can use any encoding.
2778 Support for UNIX sockets in ZOOM.
2780 Solaris recv sometimes returns errno == ENOENT. It is treated as
2781 EINPROGRESS. COMSTACK patch by Ko van der Sloot.
2783 New COMSTACK of type UNIX Socket. Use "unix:/path" as address for
2784 both client and server. Code by Morten Bogeskov.
2786 --- 1.8.7 2002/05/22
2788 On Windows ZOOM functions are of type __stdcall rather than __cdecl, so
2789 that they can be used directly from Visual Basic. You must recompile
2790 your windows APP if you're using ZOOM.
2792 Character Set and Language Negotiation(3) for ZOOM API and YAZ client.
2793 Commands "lang" and "charset" sets language and character set respectively.
2794 Options "lang" and "charset" is interpreted by the ZOOM API. Note, these
2795 are not part of the official ZOOM spec) All is due to Oleg Kolobov.
2797 Attributes from multiple CCL fields may be OR'ed rather than merged
2798 using directive "@field or". Fields are still merged by default -
2799 equivalent to "@field merge".
2801 Fixed bug in ZOOM connect that occurred on OpenBSD (maybe others). Patch
2804 Fixed bug in zget for parameter ExtendedServicesResponse.
2808 --- 1.8.6 2002/03/25
2810 Added PQF feature: '@attr type=value' may be written as '@type=value'.
2812 Client displays USR.1:SearchResult-1 (hits per term).
2814 Additional Search Info for search in Generic Frontend Server.
2816 Fixed CCL parsing of "field=s".
2818 WIN32 installer - using the excellent NSIS software from nullsoft.
2820 Fixed CCL parsing of "field = - <number>".
2822 Added function yaz_marc_decode that decodes MARC for line mode
2823 display or XML (similar to that used by JZKit).
2825 Fixed BER decoding of OPTIONAL CHOICE. The bug didn't affect the
2826 Z39.50. But ISO/ILL was, however.
2828 Added patch by Rustam T. Usmanov that implements Z39.50 duplicate
2829 detection service (Z39.50-1995 Amendment 2) and Language Negotiation (3).
2831 http://lcweb.loc.gov/z3950/agency/amend/am2.html
2832 http://lcweb.loc.gov/z3950/agency/defns/charneg-3.html
2834 --- 1.8.5 2002/02/03
2836 New YAZ client features: Command completion and new commands:
2837 push_command, set_apdufile, set_marcdump, set_cclfields, register_oid.
2838 Code provided by Jacob Poulsen.
2840 New call oid_trav, that visits all registered OIDs via callback.
2842 Function ZOOM_record_get now returns const char pointer rather than
2843 void pointer. It saves a lot of type casts.
2845 For YAZ client, command "auth" now allows you to set authentication
2846 in IdPass style. It is enabled when three tokens are given - order
2847 is user, group and password.
2849 Fix memory leaks in MARC record handling for ZOOM.
2851 New option for YAZ client, -k <kilobytes> that sets
2852 maximum record size. Similar to -k option for generic frontend
2853 server and yaz-ztest.
2855 More fixes for scan. Non-zero stepSize handled. OID's fixes.
2857 Prefix query parser reports "fail" when bad attribute set is given.
2859 Fix in MARC decoder. Proximity logging. Fix for attribute set
2860 in scan handler for server. Patches by Shigeru Ishida.
2862 SSL/COMSTACK updates. cs_rcvconnect completes SSL handshake. ZOOM
2865 Configure option --with-openssl=<dir> now works when a directory is
2866 specified. Patch provided by Morten Bogeskov.
2868 New option for YAZ client, -u <auth>, that sets authentication.
2870 ZOOM fix: error information was sometimes "missing", since error
2871 was cleared/reset too when it shouldn't.
2873 ZOOM_record_get returns ISO2709 buffer when "raw" is given.
2875 --- 1.8.4 2002/01/04
2877 Scan for ZOOM API. New object ZOOM_scanset. New functions
2878 ZOOM_connection_scan, ZOOM_scanset_size, ZOOM_scanset_term and
2879 ZOOM_scanset_destroy.
2881 New ZOOM function, ZOOM_connection_last_event, that returns type
2882 of last event (such as "receive data", "send data", "apdu received",
2885 New ZOOM option, schema, that specifies schema for retrieval.
2887 New CCL feature. Qualifiers can be aliases for one or more
2888 other qualifiers (if more than one is given, OR is used).
2890 ZOOM uses named result sets if target supports it.
2892 Two new YAZ client commands: . (dot, which sources a script of YAZ
2893 client commands), and ! (to execute shell command.). Implemented
2896 Working on Debian packages.
2898 --- 1.8.3 2001/11/19
2900 YAZ client enables named result sets only if target supports it.
2902 *** ZOOM. Prefix for ZOOM definitions changed from Z3950_ to ZOOM_.
2904 * ZOOM. Removed Z3950_connection_host. Use Z3950_connection_option_get
2905 with key="host" to get same result.
2907 * ZOOM. Added Z3950_record_clone and removed Z3950_resultset_get.
2908 Function Z3950_resultset_record(s) returns references to records
2909 "owned" by resultset. To become owner use Z3950_record_clone.
2911 Function z_ext_record handles Extended Services. Thanks to
2914 --- 1.8.2 2001/11/12
2916 CCL Parser fix: ignore token comma when dealing with and-lists.
2918 Documentation updates for COMSTACK.
2920 * ZOOM changes. Query object renamed from Z3950_search to Z3950_query.
2921 Changed prototype Z3950_records. For some functions, int parameters
2922 were changed to size_t.
2924 TCP/IP COMSTACK no longer uses getprotobyname to avoid memory leak
2927 New MARC decode/display function, marc_display_exl, which properly rejects
2928 non-ISO2709 records. YAZ client uses it.
2930 --- 1.8.1 2001/10/29
2932 Fix bug: local attribute set wasn't set correctly in PQF strings.
2936 * Old Z39.50 codecs no longer supported.
2938 Added ZOOM C binding. See http://zoom.z3950.org/
2940 Renamed states for COMSTACKs to avoid confusion with events.
2942 Implemented cs_look and proper cs_rcvconnect.
2944 Fixed COMSTACK error that occurred on HPUX. Fix by Giannis Kosmas.
2946 Configure detects POSIX threads on OpenBSD.
2948 When sort flag 'i' was specified in yaz-client the caseSensitivy flag
2949 was set to a wrong value. Thanks to Robert Sanderson for reporting this.
2951 When error is returned from present handler, non-surrogate diagnostic
2952 is returned in present response (and fetch handler is no longer called).
2954 * Minor adjustments to pquery parser (PQF). Token characters may be
2955 escaped by using backslash (C-style).
2957 PQF parser allows string attribute values to be specified. For @attr,
2958 non-numeric characters after the equal-sign are treated as strings
2959 (e.g. @attr 9=title).
2961 CCL trunction character may be defined (@truncation in file)
2963 * function zget_ExtendedServicesRequest sets waitAction to
2964 waitIfPossible (was wait).
2966 Added cs_set_blocking to set change blocking mode of a COMSTACK. Thanks
2969 CCL operator names may be set in field definition files (CCL_bibset).
2970 See ccl/bib1 for an example.
2972 Fixes in ASN.1 compiler for C++ compatibility.
2974 * Renamed members "and" and "or" in struct Z_Operator to "op_and"
2975 and "op_or" to avoid conflict with C++.
2977 Fixed problem with GNU readline detection on Redhat 7.0.
2979 Added step-size for Scan backend handler.
2981 Fixed bug that made the frontend server crash when no attribute
2982 set was specified for scan.
2984 Front-end server automatically switches to original working directory
2985 when installed as an NT service. Previously -w had to be specified to
2988 Added extended attributes for retrieval module (data1), so that data1
2989 records carry d1_readXML/SGML attributes. d1_read also supports
2990 null-data rules ( <tag/>)
2992 On UNIX when POSIX threads are available, a separate library libyazthread
2993 is created. Programmers should link with that library and the yaz library
2994 when using threads. The reason for the split was that some applications
2995 on Linux, such as Apache, doesn't work well when using shared objects that
2998 Added SSL support for the COMSTACK. You start yaz-client and yaz-ztest
2999 (or any frontend server) in SSL mode by specifying ssl: followed by
3000 address. Only tested on UNIX.
3002 Added feature for CCL module. Virtual structure s=al or s=ol generates
3003 and-list and or-list respectively instead of phrase search.
3007 * Added prefix "yaz_" for the functions log_init.., log_file.. and
3008 log_mask_str. This was done to avoid name conflicts with other libraries
3009 (such as other PHP extensions).
3011 Added raw OID member for preferred record syntax (request_format_raw)
3012 and returned record syntax (output_format_raw) for backend fetch method.
3014 Config file yaz-config now accepts options so that it returns specific
3015 compile settings, etc. Thanks to Morten Bogeskov <morten@bogeskov.dk>
3017 Shared library support for UNIX using GNU libtool.
3019 * Modified backend interface. Request/Response struct's replaced by
3020 one read/write C struct. For example bend_fetchrequest and
3021 bend_fetchresult have been replaced by single bend_fetch_rr struct.
3022 Every handler - even search has to be registered in bend_init
3023 handler. This means that the YAZ library no longer refers to
3024 external functions and it makes it possible to make the whole
3025 thing a single DLL/SO.
3027 Added Segment handler for backend server.
3029 Added Zmbol/Zebra administrative functions to YAZ client.
3031 Threaded frontend server on UNIX (when POSIX Threads are available).
3032 Starting the server with option -T enables multi-threading.
3036 Added configure option --enable-comp/disable-comp to control use
3037 of YAZ ASN.1 compiler. Use --disable-comp to use the old *coders
3038 located in sub directory asn.
3040 YAZ ASN.1 compiler renamed to yaz-comp in sub directory. It's installed
3041 in ${exec_prefix}/bin along with the other programs yaz-client and
3044 GNU automake used to maintain makefiles.
3046 Added several OID's.
3048 Changed retrieval module so that we can load records with no abstract
3049 syntax defined. Tagpaths in these records are fully composed of string
3052 Implemented ISO ILL protocol. Refer to stuff in sub directory ill.
3056 On UNIX, the generated makefile now supports a proper 'make install'.
3057 The prefix can be set via GNU configure to set the install location
3058 (default is /usr/local).
3060 * YAZ programs client and ztest were renamed to yaz-client and
3061 yaz-ztest to avoid conflicts when users install YAZ in "standard"
3062 locations, such as /usr/bin,/usr/local/bin,etc.
3064 * YAZ Header files were moved from include to include/yaz. YAZ Header
3065 files are referred to as include <yaz/log.h> rather than <log.h>.
3066 The YAZ include path (-I ..) is therefore the same as before. Programmers
3067 should update their #include statements or use -Ipath/include/yaz
3068 instead. The main motivation for doing this change is that YAZ header files
3069 can be installed in "standard" locations /usr/include,/usr/local/include
3070 without introducing conflicts, since ALL YAZ header files are stored
3071 in subdirectory yaz (under /usr/include for example).
3073 Compilation of YAZ for WIN32 is now handled by an nmake-style makefile
3074 rather than project/workspace files. We switched because project files
3075 are incompatible between Visual C++ 5 and 6. Refer to windows.txt for
3078 Changed name of logging function, logf, to yaz_log, to prevent name
3079 clash with some math-log functions. The YAZ header log.h defines logf
3080 to yaz_log (#define) so there should be no incompatibilities by this
3083 Added bend_start/bend_stop handlers for server. These handler are
3084 called on start/stop of server. For windows they are called whenever
3085 a service is started/stopped.
3087 * YAZ now auto-generates decoders/encoders for the Z39.50 protocol using
3088 a fairly small ASN.1 compiler written in Tcl. The compiler is located
3089 in util/yc.tcl. The auto-generated C code structures are, in a few
3090 cases, incompatible with the old decoders. There are differences in the
3091 following C structures Z_DiagRec, Z_External, Z_SortRequest, Z_SortResponse,
3092 Z_AttributesPlusTerm, Z_ProximityOperator, Z_DefaultDiagFormat.
3093 The preprocessor variable ASN_COMPILED is defined when the compiled
3094 ASN.1 is being used. Encoder/decoder routines as well as the Z39.50
3095 protocol ASN.1 is located sub directory <tt>z39.50</tt>. If you
3096 wish to use the old encoders/decoders you can specify --disable-yc
3099 Assigned OID for old DB Update (VAL_DBUPDATE0). Updated YAZ compiled
3100 version so that it supports both new - and old version of DB Update
3102 * Added 'name' parameter to ODR encoder/decoder routines to facilitate
3103 pretty ODR print. Updated whole Z39.50 encoder/decoder to reflect the
3104 change. The name parameter can be set to 0 in which no name is specified
3105 for the construction. The macros odr_implicit and odr_explicit sets name
3106 parameter to zero for the construction involved. New macros
3107 odr_implicit_tag and odr_explicit_tag are similar to the others,
3108 except that a name parameter is added. For programmers' that don't use
3109 ODR they probably only need to change the call to z_APDU and z_External.
3111 Added access control facility by interfacing the TCP wrapper library.
3112 YAZ automatically attempts to find the TCP wrapper Library (-lwrap) and
3113 tcpd.h on Unix systems. For the server, option -d<daemon> specifies the
3114 name of the daemon and enables the access control as specified in
3115 hosts.allow/hosts.deny. Refer to man pages tcpd(8) and hosts_access(5).
3117 Fixed memory leak in ccl_find_str and ccl_qual_rm. Thanks to Hans van
3118 den Dool <H.M.vdnDool@kub.nl>.
3120 Added reference ID parameter to most functions in server API - refer
3121 to backend.h. Thanks to Hans van den Dool <H.M.vdnDool@kub.nl>.
3123 Changed name of ccl library to libccl.a (was ccl.a).
3125 Fixed bug in decoder for Explain (Category TargetInfo).
3127 Added support for GNU readline in client. Thanks to Jacob Poulsen
3128 <ja7@dbc.dk>. GNU configure attempts to detect if readline is available.
3130 * CHANGED DEFINITION OF ES: UPDATE (INCLUDING THE OID) to reflect the
3131 new definition from the ZIG. NOTE THIS IF YOU HAVE AN UPDATE
3132 IMPLEMENTATION! This change was made to the development version before
3133 the ZIG decided to retract the amendment. If any users MUST be
3134 compatible with the original Update definition, PLEASE CONTACT US, and
3135 we will include a separate definition corresponding to the old Update
3136 ES. Note that because of the change to the ASN.1 of the
3137 TaskPackageRecordStructure we cannot define a single structure that
3138 will support both versions.
3140 * Added const modifier to buffer parameter for some ODR/BER encoding
3141 routines: ber_dectag, ber_declen, odp_more_chunks, completeBER,
3142 completeWAIS, odr_dumpBER.
3144 Fixed bug in client.c which caused a crash when a scanResponse didn't
3145 contain positionOfTerm.
3147 * Fixed inconsistency in the ScanResponse/ListEntries protocol. This
3148 * will cause an error in a client if a non-YAZ target sends both a
3149 * list of Scan entries and non-surrogate diagnostics.
3151 Retrieval module enhancements. Tag sets may be typed in the reference
3152 to it. From the .abs-file the "tagset" directive takes a third optional
3153 integer type for the tag set referenced. From a .tag-file the "include"
3154 directive takes a third optional type as well. The old "type" directive
3155 in the tag set itself is still recognized but acts as the default type
3158 Backend interface change. Individual Scan terms returned from bend_scan
3159 may also be tagged as Surrogate Diagnostics. Refer to struct scan_entry
3160 in include/backend.h.
3162 Retrieval module enhancements. Multiple tag sets and attribute sets may
3163 be specified in abstract syntax specs. Revised the error/warning for
3164 logging messages reported by the retrieval module when reading the
3167 Object Identifier system (oid_..) changed. The API is backwards
3168 compatible but the oid-routines now allocates new OID's when needed.
3169 Raw OID's may be specified in oid_getvalbyname.
3171 YAZ now uses GNU configure to generate Makefile(s).
3173 * Minor changes in some of the member names of DeleteResultSetRequest and
3174 DeleteResultSetResponse. See include/proto.h.
3176 * Changed some C definitions regarding EXPLAIN record syntax (prt-exp.h)
3177 and added member 'languages' in TargetInfo (which was missing).
3179 Changed the way attribute sets are handled in the retrieval
3180 module. These are now cached, just like the abstract syntaxes
3183 Changed YAZ so that it links with compiled ASN.1.
3185 Added Explain-schema definitions and mapping routines. The following
3186 Explain categories have been implemented: AttributeDetails,
3187 AttributeSetInfo, DatabaseInfo, CategoryList and TargetInfo.
3189 Fixed minor bug in Windows version of Server Library.
3191 --- 1.4pl2+ 1998/4/17 (Released with Zebra)
3193 Added Extended Services to server (backend.h). Thanks to Charles Woodfield.
3195 Added EXTERNAL: UNIverse Resource Report (non-standard).
3197 Implemened odr_enum and odr_set_of functions to handle ASN.1 types
3198 ENUMERATED and SET OF.
3200 * Added 'const' to some of the char pointer arguments for the
3201 functions, data1_read_node, data1_getelementbytagname,
3202 data1_insert_taggeddata, data1_getesetbyname, data1_getelementbyname,
3205 Fixed bug in data1_insert_taggeddata - the last_child member of
3206 parent wasn't initialised.
3208 * Changed data1_read_record and data1_read_node so that the supplied
3209 "SGML"-buffer is read-only. In particular the resulting data1 - tree
3210 doesn't refer to any parts of the "SGML"-buffer.
3212 Fixed bug in server library (Windows version of statserv_remove).
3214 * Changed code so that it compiles as C++. The type definition
3215 of Odr_fun which is a member of Odr_arm was changed. The result is,
3216 that an explicit typecast is needed for the fun pointer when
3217 using Odr_arm - as in:
3218 {1, -1, -1, Z_IdAuthentication_idPass, (Odr_fun)z_IdPass},
3220 Updated TagSet-G and -M definitions (tagsetm.tag and tagsetg.tag).
3222 Implemented the new structured date and time definition as approved
3223 by the ZIG. Added schemaId element to the specificTag in Espec-1
3224 (also approved at the last ZIG). Thanks to RVDM.
3226 Added some Object identifiers (RVDM).
3228 Changed the Update Extended Service (RVDM).
3230 Added command "refid" to client which specifies referenceId for
3231 the following requests.
3233 Implemented extended service handling for server. See ztest.c
3234 for an example as well as backend.h. New handlers are registerd
3235 in the Init handler.
3237 * Changed interface for sort in server.
3239 Added new members to statserv_options_block. It allows a server
3240 to read options from another source than just the command line. Thanks
3241 to Charles Woodfield.
3243 * Changed definition of Z_Triple in file prt-grs.h - member boolean
3244 renamed to zboolean. Some C++ compilers complained about the name.
3246 Minor changes to gils.abs. Added index 's' (sort) on title
3247 and date/time-last-modified.
3249 --- 1.4pl2 1998/1/30
3251 Fixed bug in server library regarding inetd mode (-i). This bug
3252 was introduced by release 1.4.
3254 --- 1.4pl1 1998/1/29
3256 Added sort facility in client and backend server interface.
3258 Fixed problem with dependencies in Makefile(s).
3260 Fixed bugs for encoders/decoders of extended services and
3263 Implemented sub-tree feature for schemas. Sub-trees are
3264 referenced in *.abs-files. See explain.abs for an example
3265 of the use of this feature.
3267 Modified bib1.att; local attributes for ANY didn't include
3268 ANY itself (only affects use of the retrieval module).
3270 Fixed bug in plain SGML reader in function data1_read_node:
3271 tags with prefix "var" was incorrectly interpreted as variants.
3273 Added feature "sub-schemas" to enable references to - and definitions
3274 of - group of elements.
3276 * Removed member parent from type data1_element (in data1.h).
3278 Implemented function odr_nullval() that returns the value of
3281 * Removed member num_children from data1_node (in data1.h).
3283 Made NT service interface part of the server library. The
3284 function statserv_main uses the NT service when required and
3285 calls the statserv_start / statserv_close routines.
3287 Routine zget_SearchRequest and zget_PresentRequest fills
3288 resultSetName/Id member with "default" instead of "Default".
3290 Fixed memory leak in server. Request queue member wasn't freed.
3292 Fixed nmem_exit so that memory is freed.
3296 Revised the CCL parser utility to be thread safe.
3298 Added function, oid_ent_to_oid, to replace the function
3299 oid_getoidbyent, which is not thread safe.
3301 * Added nmem_init and nmem_exit to initialize and release
3302 NMEM resources. Function nmem_init should be called once in the
3303 initial thread before NMEM/ODR is used. statserv.c and client.c
3304 have been changed accordingly. The change was necessary to make
3305 NMEM thread safe. The NMEM memory pool is shared amongst threads
3306 in a process. Unix-based applications will still work fine without
3309 Added NT Services interface for the the Z39.50 (statserv) Server.
3310 Refer to the ztest.c source on the usage.
3312 Windows 95/NT port using MSVC5.0. Project files are included in the
3315 * Defined new 'global' handle for the retrieval (data1) system. The
3316 new handled, data1_handle, describes the state of the data1 system.
3317 This handle is passed as first argument to virtually all
3318 data1 related routines. The functions data1_create and data1_destroy
3319 creates and destroys a data1 handle respectively.
3321 Added ODR encode stream member to all backend request structures
3322 init, search, scan etc. This stream should be used to allocate all
3323 memory used for the response when thread safe operation is needed.
3325 Changed the comstack utility, cs_addstr, to be thread safe. The
3326 returned hostname string returned by the function is now part the
3329 Added comstack utility, cs_straddr, which replaces the tcpip_strtoaddr
3330 function. The cs_straddr takes a COMSTACK handle as argument, so this
3331 function must be used after cs_create and before bind/connect.
3332 This function is thread safe.
3334 Moved test server to 'ztest' directory - generic server code still
3335 in 'server' directory.
3337 Made prefix query (pquery.c) utility thread safe.
3339 Added new function modifier YAZ_EXPORT to 'export' public DLL
3340 functions when using windows (see include/yconfig.h).
3342 Added definitions to the OID database (util/oid.c) (RVDM).
3344 Added new BIB-1 diagnostic messages to the handler diagbib1_str.
3346 Added call to ccl_rpn_delete in client program.
3348 Added ODR argument to ccl_rpn_query and ccl_scan_query to provide
3349 release of RPN structure.
3351 Added support for C++, headers uses extern "C" for public definitions.
3352 With input from RVDM.
3354 In handling of SEQUENCE OF: Counter set to zero when SEQUENCE OF is absent.
3355 Thanks to Ronald van der Meer (RVDM).
3357 Added initializers (zget_ routines) for a number of PDUs. Thanks to RVDM.
3359 Added support for private extensions to the OID database
3360 (oid_setprivateoids()). Thanks to RVDM.
3362 Added optional, physical ANY (key replication)
3364 Fixed null-reference problem in GRS-1 output filter.
3366 Proximity operator added to Prefix Query Format (PQF).
3368 In test client command "base" accepts multiple databases.
3370 Fixed bug in cs_close stack that caused trouble with WINSOCK.
3374 Fixed tagging bug in ResourceReportResponse PDU encoder/decode.
3376 Smallish bug-fixes in the new encoders/decoders (explain).
3378 Bug fixed in DeleteRequest.
3380 Fixed tagging bug of type 101 query in SearchRequest-Query PDU encoder/decoder.
3382 Fixed tagging bug in ResourceReportResponse PDU encoder/decode.
3384 Added SOIF syntax (using private OID for now) to retrieval module and client.
3386 Added Update extended service.
3388 Added SearchResult-1 additional info structure.
3390 Added optional CCL (ISO8777) interpreter as separate module. Available
3393 --- 1.2 1996/6/10 (1st anniversary release)
3395 Added Summary record syntax. Lightly tested.
3397 Added OPAC record syntax. Untested.
3399 Added ResourceReport service encoders/decoders. Untested.
3401 Fixed bug in z_Unit - wrong tagging on unitSystem.
3403 Fixed bug in the DiagRecs decoder.
3405 Added options for max PDU size and session timeout to frontend-server.
3407 Added documentation of query-language parsers and other supporting utilities.
3409 [frontend-server] Added Attribute set to the bend_scanrequest API.
3411 [frontend-server] NextResultSetPosition was sometimes set incorrectly when
3412 surrogate diagnostics were generated.
3414 [retrieval] Allow multiple local values for attribute.
3416 [retrieval] Allow multiple attributes per element in .abs files. index type.
3418 [retrieval] Added Summary tagset, abstract syntax, and d1-node/ASN filter.
3420 --- 1.1pl2 1996/4/10
3422 Minor changes, mostly specific to Zebra's requirements (retrieval)
3426 Repaired bug in frontend server when running multiple listening
3427 endpoints in dynamic mode.
3429 z_External() now won't break if a known, ASN.1 value comes encapsulated
3430 in an octet-string. The value will pass through unmodified in an Odr_oct.
3432 Added a bit of code to the demo client to decode & display
3433 ASN.1-structured records represented in the octet-aligned branch of
3434 the EXTERNAL CHOICE. Thanks to CAS for prodding us to finally do this.
3436 Added z_ext_getentbyref() to the ASN module. Doc updated.
3438 * Completed the SCAN definition in the ASN module. This may break SCAN
3439 code based on older YAZ-versions at compile-time. The fix is easy -
3442 * Added 'displayTerm' and OtherInformation to the TermInfo structure
3443 under the SCAN definition. Remember to initialize this, server-people.
3445 Comstack should now support the WAIS protocol in TCP/IP mode. Note
3446 that this does not extend to ODR and ASN.
3448 Comstack allows insertion of established socket (primarily for
3449 inetd-operation of servers). Doc updated.
3451 Front-end server can now start from the inetd in TCP mode. Doc
3454 --- 1.0pl4 1996/1/24
3458 Fixed small problem in SUTRS-filter. A newline was sometimes inserted before
3459 the rank and record number.
3461 Adjustments to the frontend server.
3463 Fixed diagnostic BER dumper. It ignored the file argument.
3467 Various changes to retrieval module.
3469 Changed the union discriminators of the protocol files from enums to
3470 ints paired with #defines.
3472 *Changed oident.class to oident.oclass to avoid a reserved word in C++
3475 *Changed operator in the RPN structure to 'roperator', again to avoid a
3478 Fixed problems in Explain decoders/encoders.
3480 --- 1.0pl2 1995/12/6
3482 Memory bug in log module fixed.
3484 --- 1.0pl1 1995/12/5
3486 Occasional malloc() of 0 bytes fixed in d1_espec.c.
3488 Bug in Explain DatabaseInfo module fixed.
3490 Some '\r' snuck into one or two of the ret'l config tables. A curse on Windows.
3494 The shift to v1.0 signals that we now consider the *core* functionality
3495 of YAZ reasonably stable (the core being more or less equivalent to
3496 Z39.50-1992). Some of the really nifty v3 stuff is still not heavily
3497 tested (Explain not at all - though that will happen soonish).
3499 Minor changes to code to support Windows port.
3501 Various minor changes after we're getting to use GRS-1 & co. more.
3503 Added Espec-1 format.
3505 Added VisibleString field body type to GRS-1. It is illegal acc. to my copy
3506 of the protocol and it cannot be selected when encoding (maps into 'string'
3507 when decoding). Needed to talk to some servers.
3509 Demo client can request simple element set names.
3511 Added Diagnostic Format encoders/decoders.
3513 Added simple Close handling to frontend server (no hooks for resource
3514 reporting yet), and demonstration client.
3516 Added cs_addrstr() command to COMSTACK to retrieve peer hostname/address.
3518 --- 1.0b3 1995/08/24
3520 Fixed bug in the frontend-server. The numberOfRecordsReturned field was
3521 handled incorrectly when records were requested in the searchResponse. This
3522 will only affect you if you use the frontend-server.
3524 Added GRS-1 encoders/decoders to the service-level API. Lightly tested.
3525 Test-client will ask for and print GRS1. Ztest will return dummy records
3528 Added Explain encoders/decoders to the service-level API. Untested.
3530 Added Extended Services: Item Order encoders and decoders to the Service-
3531 level API. Untested. We could use a recent copy of the pertinent bits
3532 of the ILL protocol to add those bits.
3534 Added diagnostic format 1 encoders/decoders to the service-level API.
3537 Moved pretty-printing of structure-wrappers ({..}) from odr_seq.c to
3538 odr_cons.c, which causes a more correct output.
3540 Fixed handling of searchRequest in frontend server. NextResultSetPosition
3541 was always set to 0 when no records were requested in the searchRequest.
3543 * Added better external-handling. This shouldn't harm old code that
3544 *encodes* externals. It can break code that looks for a
3545 'single-ASN1-type' representation, since those types that are known
3546 are now decoded immediately. Look at the SUTRS sample code in
3547 seshigh.c and client.c. Documentation updated.
3549 Handling of structured records in bend_fetchresponse. Length -1 marks
3550 structured record, type is deduced from format field.
3552 --- 1.0b2 1995/06/27
3553 Fairly quick maintenance release to add SUTRS support.
3555 Fixed handling of SUTRS records in the demonstration client.
3557 * Added format field to the bend_fetchrequest and bend_fetchresponce
3558 structures of the backend API (frontend server). When the record is
3559 returned, the value of the format field is mapped to an OID. The
3560 value VAL_SUTRS will also cause a slightly different ASN.1 packaging
3561 of the record. The special value VAL_NONE in the bend_request means
3562 that no specific format was requested by the client. Documentation
3563 updated accordingly. Test server (ztest) will return a fixed dummy
3564 SUTRS record if your client requests SUTRS.
3566 Documentation updated accordingly.
3568 You can now set external libraries and RANLIB support in the top-level
3572 First public release.