Add YAZ_EXPORT yaz_opac_decode_wrbuf
[yaz-moved-to-github.git] / NEWS
1 --- 2.1.16 2006/03/30 
2
3 Translation of proximity nodes from CQL into PQF now works.
4
5 Moved to automake 1.8, 1.9.
6
7 Added function yaz_log_set_handler which allows a log handler
8 to be installed. This handler will be called for all log messages.
9 Output to file is also produced; but that can be disabled by passing
10 NULL fname to yaz_log_init_file.
11
12 Fixed another problem with MARC-8 -> ISO-8859-1 conversions. Bug #537.
13
14 For SRW (including GFS), accept application/soap+xml as content-type
15 for SOAP msg.
16
17 For GFS in SRU mode, an empty stylesheet in SRU URL (&stylesheet=&)
18 produces NO stylesheet reference even if a default stylesheet is specified
19 in GFS XML config.
20
21 --- 2.1.14 2006/03/14 
22
23 Updated Windows package to include yazd.dll + yazd.lib for the
24 Development component.
25
26 If the environment variable YAZ_LOG is set, then it is used as a
27 string indicating the default level of logging to use if not
28 overridden by calls to yaz_log_init() or yaz_log_init_level().  If
29 it's not defined, then the manifest constant YLOG_DEFAULT_LEVEL is
30 used as before.  So, for example, to omit warnings from YAZ logging,
31         export YAZ_LOG=-warn
32
33 cql_transform() now map structure and other attributes before indexes,
34 so that index-specific structures and other attributes can override
35 defaults.  So now a combination of mapping specifications such as:
36         structure.* = 4=1
37         index.dc.date = 1=date-modified 4=5
38 does the right thing.
39
40 cql_transform() now also respects the "always" mapping specification,
41 which establishes an initial set of attributes to be used for all
42 terms except where overridden by more specific attributes associated
43 with the index, relation or modifier.
44
45 Added SRU-GET and SRU-POST support for ZOOM C. Option "sru" specifies
46 which mode to use; one of "post", "get" or "soap" (SRW, default).
47
48 Fixes for yaz_iconv routines: changed trie-based character set conversions
49 to use only non-negative values for bit fields due to Sun's C compiler not
50 supporting negative values.
51
52 Fixed bug in character set conversion yaz_iconv. Some three byte UTF-8
53 sequences where not read correctly. Fix by Rustam Usmanov.
54
55 Updated win/makefile to use options, settings which makes things
56 compile with VS C 2005.
57
58 --- 2.1.12 2006/02/01 
59
60 Fixed bug in yaz_oi_update which used incorrect value for categoryValue.
61
62 In ZOOM socket code, use select instead of poll on MacOSX.
63
64 ZOOM-C now support client-side compilation of CQL into RPN that is
65 sent to the server, enabling CQL to be used against all Z39.50
66 servers.  Use ZOOM_query_cql2rpn() to set the compiled CQL into a
67 ZOOM_query object, and submit it using ZOOM_connection_search().
68 The CQL-to-RPN translation uses a configuration file, the name of
69 which must be specified in the Connection's "cqlfile" option.
70
71 ZOOM-C also support CQL scanning, via the new ZOOM_connection_scan1()
72 function, which takes as its start-term parameter a ZOOM_query object
73 (which may have had either CQL or RPN set into it).
74
75
76 --- 2.1.10 2005/11/29 
77
78 Added ZiNG Update Support. New codecs are defined in srw.h. Extended the
79 GFS to support this as well. Backend handler, bend_srw_update, does the
80 update work. Code contributed by Ko van der Sloot.
81
82 Allow retrieval of Search Result-1 information in ZOOM by the use of
83 options that are attached to a result set. ZOOM documentation updated
84 accordingly.
85
86 Fixed bug #416: First/second comb characters not handled in the MARC-8 to
87 UTF-8 conversion. Patch by Raj Patel.
88
89 Added option -m to GFS to control formatting of timestamps in log file.
90
91 Added 'exit' as synonym for 'quit' in yaz-client
92
93 Added support for specifying SRW resultSetId + resultSetIdleTime in a
94 Generic Frontend Server's search handler. Refer to include/yaz/backend.h
95 for the new members. Patch by Ko van der Sloot.
96
97 Added support for SRU POST. It is supported for content-type
98 application/x-www-form-urlencoded only. Patch by Ko van der Sloot.
99
100 Do not build the separate Multi-threaded (MT) library libyazthread.la.
101 Instead make the library libyaz.la multi-threaded. Threading as a whole
102 can still be disabled by configure option --disable-threads. Previosly, 
103 with older GLIBCs there were problems with MT libs under Apache. This
104 has now been fixed a long time ago.
105
106 Fixed bugs in yaz_log that occurred on Sparc Solaris in Multi-threaded
107 applications.
108
109 CQL module modified to be case insensitive for relations/indexes/operations.
110
111 Fixed bug in CQL transform code: incorrect value relationModifieder
112 was used.
113
114 Added 'show all' command for yaz-client which retrieves all results
115 for last search.
116
117 Added new yaz-client, xmles, which takes a (private) OID and
118 a document to be sent as an extended service request.
119
120 Describe new yaz-client commands wait_response and set_auto_wait.
121
122 Increase TCP/IP listener backlog from 3 (which I am guessing was
123 copied from the SunOS manual entry way back when) so SOMAXCONN, so
124 that the socket will queue as many incoming connections as it's able
125 to handle ongoing connections.  In other words, it will never now
126 refuse a connection that it would be able to handle merely because
127 it's not got around to accepting() enough of the pending connections
128 yet.  This is the behaviour anyway under Linux, where the listen()
129 argument is ignored; but not under BSD and on systems such as
130 MS-Windows that use BSD-derived TCP/IP stacks.  The behaviour of
131 YAZ-based servers should now be uniform across operating systems in
132 this respect.
133
134 yaz-marcdump uses 64-bit file access on some systems. This is enabled 
135 on Linux and other Unix variants where _FILE_OFSET_BITS=64 is supported.
136 This allows yaz-marcdump to read large MARC batches (>2 GB).
137
138 Modified all YAZ source files - except the source which is auto-generated
139 by tools - to use spaces rather than TABS. Emacs/VIM trailer added to
140 all source files.
141
142 Add ZOOM_connection_option_getl() and ZOOM_options_getl(),
143 corresponding to the existing *_setl() function.  These allow option
144 values containing arbitrary valuues.
145
146 Add ZOOM_resultset_sort1(), which should ALWAYS be used in place of
147 ZOOM_resultset_sort() in new applications.  Its behaviour is identical
148 except that it returns an indicator of whether or not the sort
149 criterion was accepted (0 for OK, -1 for invalid).
150
151 --- 2.1.8 2005/06/07 
152
153 Fixed bug in yaz_marc_decode_buf. By mistake the routine appended
154 MARC output rather than returning "new" buffer.
155
156 yaz-client warns about unknown init options.
157
158 Fixed bug #371: "options concurrentOperations ignores concurrentOperations"
159
160 --- 2.1.6 2005/05/24 
161
162 Added support for SRW sort in Generic Frontend Server. Patch
163 by Ko van der Sloot. Member srw_sortKeys in bend_search_rr holds
164 sortKeys - or NULL if none is provided.
165
166 Fixed bug #307: It was impossible to specify indefinite/no timeout
167 for ZOOM_event. Special timeout value -1 now means indefinite timeout
168 (i.e.  no timeout).
169
170 Added support for multiple languages and charsets to be specified in
171 ZOOM. Each charset/language is separated by a blank. If negotiation is
172 in effect in init-response, Option
173 "negotiation-charset-in-effect-for-records" set to 1(true) or 0(false). 
174 Code based on patch by Vasiliy Osadchuk.
175
176 Fixed bug #306: infinite recursion that occurred when calling
177 yaz_log_level_init as the first call (before other log level or
178 nmem_init calls)
179
180 Fixed bug in scan handling in front end server: if preferred-Position-In-
181 Response was non-present, a NULL pointer referece was performed.
182
183 --- 2.1.4 2005/04/26 
184
185 Changed include/yaz/diagbib1.h and added include/yaz/diagsrw.h with
186 diagnostic messages+codes for Bib-1 and SRW. Preprocessor defines are
187 now defined for all those error codes. So instead of putting 109 in
188 your program you'd use YAZ_BIB1_DATABASE_UNAVAILABLE. The messages
189 are generated from a .csv - file. See src/bib1.csv and srw/srw.csv.
190
191 Modified the yaz-marcdump utility to skip garbage bytes between MARC
192 records in a file.
193
194 Fixed bug - uninitialized memory - due to bad code for fix of bug #272.
195
196 Program yaz-client now exits and produces an error message if multiple
197 Z39.50 servers are specified on the command line (none or one allowed
198 only).
199
200 Program yaz-marcdump skips garbage bytes between ISO2709 records rather
201 than abort.
202
203 --- 2.1.2 2005/03/16 
204
205 Fixed bug #273: Update for recent MARC-8 -> UNICODE changes. 
206
207 Fixed bug #272: Preserve spacing for CCL terms.
208
209 --- 2.1.0 2005/03/14 
210
211 Added support for virtual hosts and multiple backend servers for
212 the YAZ frontend server. The configution is XML based and
213 support specificition of CQL to RPN mappings and explain information.
214 See section "Virtual Hosts" in the YAZ manual.
215
216 Extended OPAC display utility. OPAC display utility renders
217 bibliographic (MARC) record as well. Added yaz_opac_decode_wrbuf
218 to supplement yaz_marc_decode_wrbuf.
219
220 Fixed a bug in MARC decoder that could caused it to crash for some
221 invalid MARC records. More diagnostics and warnings where added in
222 XML output (warnings, etc are stored in comments).
223
224 --- 2.0.34 2005/02/08 
225
226 Fixes for UNIX domain sockets. Bug #261.
227
228 Fixes for MARC-8 to UTF-8 conversion. Bugs #258 and #260.
229
230 Fixed bug #263: YAZ MARCXML dump shows extra spaces after control fields.
231 Added yaz_marc_subfield_str which defines subfield lead string which is
232 used in YAZ_MARC_LINE format. Default string is blank+$. Added
233 yaz_marc_endline_str which defines end of fields string used in
234 YAZ_MARC_LINE format. Default string is newline.
235
236 Experimental support for MarcXChange. This format can be produced
237 by yaz-marcdump and is implemented in yaz_marc_decode - functions.
238  http://www.bs.dk/standards/MarcXchange.xsd
239
240 Added yaz-client commands scansize that sets maximum number of
241 entries to be returned by scan.
242
243 --- 2.0.32 2005/01/11 
244
245 Added support for SRW scan in yaz-client and Generic Frontend Server.
246
247 * Added whereInList member to SRW Scan Term.
248
249 * Changed Z_SRW_scanRequest to be able to carry both CCL and PQF.
250
251 Fixed NMEM system to return aligned blocks on the smallest boundaries
252 that are suitably aligned for all possible types on the particular
253 architecture YAZ is being built for.
254
255 --- 2.0.30 2005/01/04 
256
257 Fixed numerious warnings that was issued with newer versions of GCC.
258
259 Fixed NMEM system to return aligned blocks on 8 byte boundaries rather
260 than 4 bytes, since 4 may not be enough on some systems such as GCC 3.4.3
261 on Solaris.
262
263 Make YAZ Generic Frontend Server slightly faster.
264
265 Enhance (and reduce) logging for Generic Frontend Server.
266
267 Revert YAZ log system so that it flushes every write operation
268 by default. (YAZ 2.0.26 and earlier verisons did that). Bug #240.
269
270 Modified the YAZ logging system. The LOG level defines use YLOG_ prefix
271 instead of LOG_, due to name clash with syslog(3). LOG_ are still
272 present. New applications should define YAZ_USE_NEW_LOG=1 - this
273 will effectively disable old definitions.
274
275 --- 2.0.28 2004/11/09 
276
277 Added yaz_log_time_format which specifies log format using
278 strftime(3).
279
280 Added yaz_log_module_level which returns mask for a module. Value
281 is non-zero mask a if module is enabled; zero if disabled.
282
283 * Fixed bug #148: CQL parser may leak. A few prototypes were changed
284 in include/yaz/cql.h.
285
286 Fixed bug #176: Dont throw diagnostics on empty SRU args.
287
288 Fixed bug #175: surrogate diagnostics in SRW lacking NS.
289
290 Fixed bug #172: RPM builds does not enable SSL.
291
292 Doxyfile.in part of dist. Doxyfile generated by configure.
293
294 Configure aborts if any of --with-xml2, --with-openssl, --enable-tcpd 
295 are given and the corresponding component does not exist.
296
297 Extend CCL documentation in YAZ reference. Describe r=r.
298
299 --- 2.0.26 2004/10/01
300
301 Fixed MARC->MARCXML conversion to properly deal with
302 fields, subfields, indicators having non-ASCII characters.
303
304 Fixed MARC->MARCXML conversion so that ASCII control characters
305 except TAB,CR,LF are removed from resulting XML (XML 1.0 does not
306 support these).
307
308 Added YAZ GFS support for conversion from Z39.50 surrogate
309 diagnostics to SRW surrogate diagnostics.
310
311 Bug fix: YAZ GFS did not return schema in explainResponse.
312
313 --- 2.0.25 2004/09/30
314
315 The YAZ GFS when converting SRW/SRU requests to Z39.50 structures
316 now converts recordSchema to elementSetName as well as schema URI.
317
318 Fixed bug in COMSTACK that prevented HTTP request packages from being
319 decoded properly.
320
321 --- 2.0.24 2004/09/29
322
323 Added CCL facility r=r "range" which is similar to r=o "ordered" but
324 does not require white-space before and after the dash in a range, e.g.
325 x=-1990 is equivalent to x <= 1990 iff r=r, but equivalent to x= -1980
326 iff r=o.
327
328 Fixed a few AC_TRY_LINK configure tests that did not operate properly
329 due to new GCC removing "redundant" code.
330
331 Added yaz-client commands scanpos and scanstep that sets preferred
332 position and step-size for scan.
333
334 Macro YAZ_INIT in yaz.m4: option --with-yazconfig renamed to --with-yaz.
335
336 Added CCL utility ccl_qual_buf which parses one or more CCL 
337 spec lines in a buffer.
338
339 Added CCL utility ccl_qual_line which adds CCL qualifier line consisting
340 of name and value - ignoring empty lines and comments.
341
342 On Windows, the debug DLL/import lib is now named yazd.{dll,lib}.
343
344 Added odr_get_element_path which returns current element path for an
345 ODR handle. This utility is useful in error handling or user-defined
346 ODR_PRINT stream.
347
348 Added ODR_PRINT utility odr_set_stream which is is a more generic
349 alternative to odr_setprint. odr_set_stream takes a stream handle, pointer
350 to a write function and pointer to close function. The close function - if
351 non-NULL - will be called during odr_destroy.
352
353 Fixed bug in CCL parser where truncation char was not removed from
354 right side when truncation=both was in effect.
355
356 Fixed CQL parser to use unsigned chars for isxxx from ctype.h due
357 to VS.NET.
358
359 --- 2.0.23 2004/08/11
360
361 Fix buffer overrun in CQL parser when dealing with proximity (%).
362
363 Fixes for MARC-8 in yaz_iconv character set utilies. The MARC-8
364 to UTF-8/UCS conversion is now only based on codetables.xml.
365
366 yaz_marc_decode_buf sets leader pos 9 to "a" for MARCXML output.
367
368 --- 2.0.22 2004/08/06
369
370 Add support for more "commit changes" in ZOOM (uses Extended Services).
371
372 For yaz-client, command set_marcdump <file> / -m <file> dumps SUTRS/XML/..
373 records as well.
374
375 Yet another small fix for configure of SSL.
376
377 --- 2.0.21 2004/05/14
378
379 Fix SSL libs for configure when --with-openssl=DIR is given.  
380
381 --- 2.0.20 2004/05/10
382
383 Add autoconf m4 macro YAZ_DOC for YAZ documentation setup (docbook).
384
385 SSL comstack now uses yaz.pem certificate file on server side
386 by default. Certificate filename can be configured by calling
387 comstack function cs_set_ssl_certificate_file before cs_bind is used.
388
389 Fix bug regarding multiple calls to ZOOM_connection_connect.
390
391 Implement cs_set_ssl_ctx which sets SSL_CTX for SSL comstack.
392
393 Do not create SSL_CTX in cs_create (ssl_type). Create in tcpip_bind,
394 tcpip_rcvconnect instead. This allows user to set custom SSL_CTX.
395
396 ZOOM now allows inspection of X509 peer certificate for verification.
397 The X509 buffer is retrived by reading ZOOM option "sslPeerCert".
398
399 Removed libyazssl.la. When SSL is enabled, libyaz.la has SSL support and
400 all programs have too (yaz-ztest, yaz-client, zoom..). May not be
401 as "modular" but it simplifies things.
402
403 Added cs_get_peer_certificate to that returns peer X509 PEM.
404
405 Added cs_get_ssl that returns SSL handle (SSL *) for SSL comstack; returns
406 NULL if SSL is unavailable.
407
408 Documentation about MARC decoding tools.
409
410 Fix --disable-tcpd to really disable tcpd. Patch by Robin H. Johnson.
411
412 --- 2.0.19 2004/03/30
413
414 Rename CHANGELOG to NEWS to follow GNU style packing.
415
416 Fix bug with missing initialization of member in init_diagnostics.
417 This bug affects threaded version of GFS server.
418
419 --- 2.0.18 2004/03/20
420
421 Use wrbuf_xmlputs_n instead of wrbuf_write_cdata to avoid clash with
422 Zebra symbol.
423
424 Ensure zlib.dll is packed with Windows install.
425
426 --- 2.0.17 2004/03/17
427
428 Fix encoding of xsd:string to use text instead of CDATA.
429
430 Fix endless loop in CQL parser with unbalanced ".
431
432 Use a more compact way to store MARC-8 conversion tables.
433
434 --- 2.0.16 2004/03/16 Debian only
435
436 Oleg Kolobov Fixed a bug in yaz_iconv regarding conversion to
437 UCS4 / UCS4LE.
438
439 Update CQL parser to use new CQL 1.1 modifiers for booleans and
440 relations.
441
442 Add CQL test cases.
443
444 --- 2.0.15 2004/03/01
445
446 Another fix for decoding of XML packed records.
447
448 --- 2.0.14 2004/02/25
449
450 Fixes for Chunked encoding. White space not ignored after length spec.
451
452 Update NS and use default NS for SRW diagnostic elements.
453
454 --- 2.0.13 2004/02/23
455
456 Implement ZOOM_resultset_cache_reset which resets record cache.
457
458 Implement ZOOM_resultset_sort which sorts a result set.
459
460 Implement chunked HTTP transfer.
461
462 For SSL, use -lssl -lcrypto on systems that don't have pkg-config.
463
464 --- 2.0.12 2004/02/16
465
466 Added member 'schema' to bend_explain_rr structure so that backend
467 can specify explain record identifier. Defaults to Zeerex 2.0.
468
469 Fix encoding of OID's of form 1.0.X. Bug introduced in 2.0.11.
470
471 --- 2.0.11 2004/02/16
472
473 * SRW/SRU 1.1 updates: updated diagnostic in srw.h to use uri instead
474 of code.
475
476 Added init command for yaz-client which sends "extra" init request.
477
478 Fixed two bugs in OID codec - ber_oidc. Throw error when encoding/decoding
479 bad truncated OID. Fix decoding of OID X.Y... when X=2 and Y>39.
480
481 Fixed a bug in ASN.1 compiler that caused Type-1 Operator codec to fail.
482
483 Make ZOOM error code for "invalid query".
484
485 Fixed compilation for SSL which wasn't properly enabled for all platforms.
486
487 --- 2.0.10 2004/02/05 
488
489 For yaz.m4, allow second argument for YAZ_INIT to hold minimal version of
490 YAZ required.
491
492 * SRW/SRU 1.1 updates. Diagnostic code now a URI.
493
494 Added option -p <file> to make Generic Frontend Server to write PID file.
495
496 Added option -D to put Generic Frontend Server in background on its own.
497
498 Make ZOOM C recognize option "password". If unset, "pass" is used
499 (for backwards compatibility).
500
501 Fixed a bug in Generic Frontend Server that could make it crash if a
502 client sets characterSetNegotation bit, but didn't pass negotiation stuff
503 in InitRequest.
504
505 New YAZ client command, zversion, that sets Z39.50 version (1,2,3..).
506 Must be issued before open, in order to be in effect.
507
508 --- 2.0.9-6 2004/01/12  Debian/Windows
509
510 Make the SRU server more picky WRT unknown params, etc.
511
512 Bug fix: ZOOM scan response didn't return displayTerm - when present.
513
514 New YAZ client command, options, that sets Z39.50 options.
515
516 New utility functions yaz_init_opt_{encode,decode} to encode/decode Z39.50
517 options from a string of tokens (one token for each option bit).
518
519 Update SRW diagnostic code messages.
520
521 --- 2.0.9-5 2004/01/07  Debian/Windows
522
523 Handle user defined stylesheet for SRW/SRU.
524
525 --- 2.0.9-4 2004/01/06  Debian/Windows
526
527 Fix bug in decoding of Content-Length.
528
529 --- 2.0.9-3 2004/01/06  Debian/Windows
530
531 Fix a bug with decoding of XML packed records.
532
533 --- 2.0.9-2 2004/01/05  Debian only
534
535 Allow empty ODR (NMEM=0) for odr_oiddup and odr_getoidbystr.
536
537 Fix bug in SRW/SRU diagnostics decoding.
538
539 --- 2.0.9 2004/01/05
540
541 Fixed bug in Generic Frontend Server which could drop records exceeding
542 preferred message size. Reported and fixed by Irina Dijour.
543
544 Fixed calculation of package size for structured records in Generic
545 Frontend Server. Reported and fixed by Irina Dijour.
546
547 Fixed namespace for SRW/SRU diagnostics.
548
549 Fixed SEGV in yaz-client that occured for HTTP connection errors.
550
551 --- 2.0.8 2003/12/22
552
553 * SRW/SRU 1.1. Since the Namespace has changed for SRW/SRU, it means that
554 this version is incompatible with version 1.0 and older YAZ SRW/SRU
555 implementations.
556
557 CQL changes to reflect recent changes to the specification:
558 * Documentation talks about context sets instead of index sets.
559 * Documentation talks about indexes instead of qualifiers.
560 * The CQL-to-PQF transformer's configuration file now uses
561         "index.set.name = <attributes>" instead of the old form
562         "qualifier.set.name = <attributes>".  (Both forms are still
563         understood but the latter is deprecated.)
564 * CQL terms with no explicit index specified are now interpreted as
565         cql.serverChoice instead of srw.serverChoice (which of course
566         behaves exactly the same.)
567
568 --- 2.0.7 2003/12/16
569
570 MARC conversion can now generate ISO2709 output in another
571 character set. yaz-marcdump uses this facility if you invoke it
572 with option -O.
573
574 Added missing C decl macros for include/yaz/{soap.h,srw.h,cql.h}, so that
575 functions from there can be used from C++.
576
577 --- 2.0.6 2003/12/04
578
579 Frontend server now transfers memory from decoded packages to stream
580 ODR for search.
581
582 NMEM now clears freed blocks with 'Y' (hex 59) to force bad memory
583 references to show up. 
584
585 ZOOM-C now supports standard ZOOM option names as described in v1.4 of
586 the ZOOM Abstract API.  The older names for the same options are still
587 also supported for the benefit of old applications.
588
589 ZOOM-C supports "implementationId" and "implementationVersion" options
590 to go along with "implementationName".  These allow the user code to
591 specify identification strings to be sent to servers.
592 Add OID for the new ExtLite attribute set.
593
594 Add OIDs for NACSIS-CATP, FINMARC2000 and MARC21-fin record-syntaxes,
595  as requested/supplid by Ere Maijala <ere@atp.fi>
596
597 For generic frontend server, reverse the order of
598 "toolkit-supplied / application-supplied" strings sent as implementationId,
599 Name and Version.  Also, remove the spaces around the slash.  This brings
600 the GFS in line with the behaviour of ZOOM-C on the client side.
601
602 Add function ZOOM_scanset_display_term.
603
604 yaz-client shows scan displayTerm if present.
605
606 Utility yaz-iconv is now installed by default along with the man page 
607 yaz-iconv.1.
608
609 Extend configure check for OpenSSL to use pkg-config where available (such
610 as RedHat 9).
611
612 Incorporate patch by Morten Bogeskov which allows a Unix file socket
613 server to specify uid/gid/mask for socket using the format
614  unix:[user=uid,][group=gid,][umask=mask,]file=path
615 If file= is omitted the existing format is assumed, e.g.
616  unix:path
617 in which case the mask is 0666 (rw for everybody).
618
619 Major restructure of YAZ source. All source in libyaz is in src directory.
620 Programs in client (yaz-client), ztest (yaz-ztest), zoom (zoom programs),
621 util (utility programs such as ASN.1 compiler, yaz-marcdump). 
622
623 Added man page for utility yaz-marcdump (used to be called marcdump).
624 yaz-marcdump is installed by 'make install'.
625
626 Fixed a memory leak in Generic Frontend Server that occurred when decoding
627 of incoming package failed.
628
629 Fixed a potential DOS attack vulnerability in COMSTACK/ODR.
630
631 Change prototype of odr_perror: add const to message string.
632
633 New function yaz_log_reopen which reopens log file (for log rotate, etc.)
634
635 * Blocking parameter for COMSTACK cs_create is now a bit mask rather
636 than a blocking flag. Bit 0 is set for blocking, reset for non-blocking.
637 Bit 1 is set if cs_addrstr should avoid DNS lookup; reset for full
638 DNS lookup. There should not be any compatibility problems with this
639 assuming that blocking=1 or 0 is used.
640
641 Fix bad reference in UNIX comstack in function cs_addrstr.
642
643 Fix for compilation on AIX.
644
645 The generic front-end server (server/seshigh.c) now supports returning
646 Init diagnostics to the client in User-information-field, in
647 accordance with Z35.90 Implementor Agreement 5 (Returning diagnostics
648 in an InitResponse)
649
650 --- 2.0.4 2003/09/04
651
652 Allow any CQL relation (not just all,any,exact,scr).
653
654 Fixes for OCLC UI ASN.1 to make it work with SilverPlatter targets
655 that features the same UI.
656
657 Implemented command update0 in YAZ client which is equivalent to
658 update but uses old of Ext Update ASN.1.
659
660 Use OID 1.2.840.10003.15.1000.81.1 for privately defined charsets
661 in charset negotiation. Added VAL_ID_CHARSET in oid.h.
662 Previously no OID was used for this info.
663
664 ZOOM uses smallSetUpperBound=1 instead of 0 for piggyback searches.
665 It apparantely upsets EBSCO Publishing IR Z39.50 Server which
666 returns 'malformed search term' otherwise.
667
668 SortResponse member resultCount now set to NULL in sort handler of
669 frontend server.
670
671 OPAC support ZOOM. ZOOM_record_get returns OPAC info (as XML) if
672 type is "opac".
673
674 Add three new utility functions for translating OIDs between various
675 formats -- symbolic name such as "Usmarc", minus-1-terminated int
676 arrays and dotted strings such as "1.2.840.10003.9.5.1":
677  int *oid_name_to_oid(oid_class oclass, const char *name, int *oid);
678  char *oid_to_dotstring(const int *oid, char *oidbuf);
679  char *oid_name_to_dotstring(oid_class oclass, const char *name, char *oidbuf);
680
681 Reverted modifications for ES Update definition for z_IU0Update 
682 (OID 1.2.840.10003.9.5.1 and 1.2.840.10003.9.5). The definition
683 is back to YAZ 2.0.2.
684
685 String value attributes for CCL parser.
686
687 Support for OCLC's locally registered "OCLC-UserInformation" PDU,
688 which their FirstSearch server returns in Init responses, sometimes
689 carrying useful diagnostic information when Init fails.  This has the
690 OID 1.2.840.10003.10.1000.17.1 and is defined in the file
691 "z39.50/oclcui.asn", where its definition is somewhat different from
692 what OCLC document on their web-site, as required to interoperate with
693 their servers.
694
695 Support for anonymous authentication in yaz-client.  Use the command
696 "auth -".
697
698 * Fix the OID of the Index Data-local "admin" Extended Service from 
699   1.2.840.10003.9.81.1 to 1.2.840.10003.9.1000.81.1.  The omission of
700   the 1000, which indicates a locally-defined OID, was a mistake.
701
702 --- 2.0.3 2003/06/20
703
704 Fix CCL directive @case handling so that it affects string match for
705 both CCL keywords and qualifiers.
706
707 * ESFormat-Update updates. Packages with OID 1.2.840.10003.9.5.1 and
708 1.2.840.10003.9.5 are now handled by the same decoder z_IU0Update .
709 Decoder has been updated with ASN.1 changes as listed in
710 http://lcweb.loc.gov/z3950/agency/defns/updateES.html
711 Note that the "latest" DB Update, OID 1.2.840.10003.9.5.1.1 , handler
712 z_IUUpdate, remains unchanged. 
713
714 ZOOM_record_get may now return a record in a specific character set.
715 For type use "form; charset=from[,to]" where form (render, xml, ..) ,
716 "from" is the character set of record as returned by target. "to" is
717 the character set to be returned. If omitted, "to" is UTF-8.
718
719 YAZ ASN.1 compiler renamed from yaz-comp to yaz-asncomp
720
721 New ODR utility, odr_getelement, which returns name of element for
722 which encoding/decoding failed.
723
724 Fixed ODR so that it returns error code OREQUIRED rather than ONONE
725 in cases where a required element was omitted.
726
727 Bug fix: some MARC8 sequences were not converted.
728
729 New ZOOM option "step" which specifies number of records to be
730 retrieved in one chunk. Used in conjunction with "start" and "count".
731
732 SRW support for yaz-client. Use scheme http: to use it, e.g.
733  http://host:port/db
734
735 yaz-client no longer does (un)intelligent character set conversions
736 by default. Can be enabled with charset and marc_charset commands.
737
738 xmalloc trace fix for 64-bit systems such as DEC alpha. 
739
740 Solaris 2.6 compile fix.
741
742 New function, cql_strerror() translates SRW error codes, as returned
743 by cql_transform_error(), into human-readable English strings.  Used
744 in yaz-client diagnostics when appropriate.
745
746 New CQL2RPN query-type for the command-line yaz-client, parses CQL and
747 converts it into a type-1 query which is sent to the server.  This
748 makes CQL available for use with all Z-servers, as opposed to the tiny
749 minority that can handle CQL queries themselves.
750
751 --- 2.0.2 2003/04/28
752
753 New Debian package layout similar to the Redhat Package layout.
754
755 New ZOOM events ZOOM_EVENT_RECV_{RECORD,SEARCH} for receiving a record
756 and search result respectively.
757
758 --- 2.0.1 2003/04/25
759
760 Redhat package is now several packages: libyaz (runtime libraries),
761 libyaz-devel (development and documentation, and yaz (utility programs).
762 Package spec file by Morten Bøgeskov.
763
764 New member 'schema' in struct bend_fetch_rr which the name of requested
765 schema (SRW/SRU) for record (or NULL if none was given). The fetch
766 handler MAY set this to reflect the schema of the returned record.
767
768 New member 'display_term' in struct scan_entry. GFS now sets member entries
769 and allocates scan entries to be filled by user scan handler. In previous
770 version, entries member was allocated by the scan handler. That still works,
771 but the GFS will ignore member display_term - assuming it was NOT set by
772 the handler. The fact that the GFS now allocates the entries both allows
773 for new members and makes a scan handler easier to write.
774
775 Fix CQL lex buffer overflow.
776
777 SRW/SRU recordPacking. For SRW default recordPacking is string. For
778 SRU default recordPacking is string.
779
780 SRU protocol support for frontend server.
781
782 Fix compile bug for systems that have nl_langinfo but CODESET undefined.
783
784 Added missing PQF transform rules for <= and >= . Thanks to Peter Popovics.
785
786 Added scan for the ZOOM shell (zoomsh).
787
788 --- 2.0 2003/02/23
789
790 * String Identifers for Schemas (Amendment 5).
791 http://lcweb.loc.gov/z3950/agency/amend/am5.html
792 Old definition for schema
793   Odr_oid *schema; /* OPT */
794 New:
795   int which;
796   union {
797      Odr_oid *oid;
798      Z_InternationalString *uri;
799   #define Z_Schema_oid 1
800   #define Z_Schema_uri 2
801   } schema; /* OPT */
802
803 * resultCount parameter to Sort Response (Amendment 1).
804 http://lcweb.loc.gov/z3950/agency/amend/am1.html
805
806 Support for SRW 1.0 over HTTP. This is an optional feature and
807 requires libxml2 to operate. Enable SOAP by specifying --with-xml2
808 for configure.
809
810 Generic frontend server supports HTTP/SOAP/SRW and Z39.50/BER
811 on the same port.  SRW SearchRetrieveRequests are mapped
812 to bend_init,bend_search,bend_fetch,bend_close. 
813
814 Z39.50 Query Type-104 added - to facilitate CQL within Z39.50.
815
816 CQL support. Source is directory 'cql'. CQL is supported in ZOOM
817 (both SRW and Z39.50) and the YAZ client (Z39.50 only).
818
819 ZOOM connections are SRW based if schem http is used for hostname
820 in connect, e.g.  z = ZOOM_connection_new("http://myserver");
821 ZOOM_query may be of type CQL, e.g. ZOOM_query_cql(q, "dc.title=x");
822
823 CCL proximity operators !n, %n converts to PQF @prox 0 n 1 2 k 2
824 and @prox 0 n 0 1 k 2 respectively, meaning: exlusion=false,
825 distance=n, order=true/false, relation=le, prox unit=word. If
826 n is omitted, distance 1 is used.
827
828 Fixed problem with C compiler include path in wrong order.
829
830 For TCP/IP COMSTACK, set recv buffer to an appropriate "large" value
831 on Solaris. Patch from Ko van der Sloot.
832
833 New MARC decode API. All new functions operate on a yaz_marc_t
834 handle. The most important new functions are: yaz_marc_create,
835 yaz_marc_decode_{buf,wrbuf}, yaz_marc_destroy, .. to create handler,
836 decode and destroy respectively. Decoder can produce formats
837 MARC line, simple XML, OAI MARC and MARC XML (LoC). See
838 include/yaz/marcdisp.h.
839
840 YAZ Iconv utility now supports MARC8 decoding (marc8.c). Converts
841 to UTF-8, UCS-32, wchar_t or Latin-1.
842
843 * Prototypes for yaz_iconv_-functions moved to separate header 
844 include/yaz/yaz-iconv.h.
845
846 Make a few private functions 'static' in unix.c. This prevents
847 duplicate unix_close in PHP with YAZ and imap. PHP Bug 20977.
848
849 For ZOOM connection, the options targetImplementation{Id,Name,Version}
850 are set when Init Response is received.
851
852 New function ZOOM_connection_error_x similar to ZOOM_connection_error
853 but returns diagnostic set as well.
854
855 New function yaz_strerror which is a portable wrapper for
856 strerror/strerror_r/GetLastMessage.
857
858 * ZOOM_record_get supports type "xml" in which case MARC XML (from LOC)
859 is returned for MARC. If type is "oai", then OAI MARC is returned.
860
861 Fix creation of lib/yaz-config so it works if srcdir != objdir. Patch
862 from Kang-Jin Lee.
863
864 --- 1.9.2 2002/11/26
865
866 yaz_marc_decode uses OAI MARC as XML format for ISO2709 records.
867
868 Fix bad race conditions on SIGTERM and terminate gracefully in
869 frontend server.
870
871 Move retrieval (data1) module to Zebra since nobody seems to be
872 using it.
873
874 Add GRS-1 render for ZOOM using same format as yaz-client.
875
876 --- 1.9.1 2002/10/05
877
878 Added man pages: yaz-client(1), yaz-ztest(8), yaz(7), zoomsh(1).
879
880 Fix broken ESpec handling in data1 module.
881
882 SGML reader parses comments and makes them part of the data1 tree.
883
884 Added several type casts so that YAZ compiles as C++ code.
885
886 ZOOM didn't handle PDU encoding failures properly.
887
888 Added more Bib-1 diagnostics (approved extensions).
889
890 GNU configure: better check for iconv.
891
892 More portable use of accept, getpeername. Check for socklen_t. Use
893 int/size_t if socklen_t is not defined.
894
895 --- 1.9 2002/09/06
896
897 PQF parser rejects bad queries - including those with extra
898 characters in them. PQF parser used to silently ignore that.
899 Cleaner API for PQF added, which allows you to get detailed
900 error information for bad queries (see yaz/pquery.h).
901
902 Fixed bug in ZOOM_record_get for type "database".
903
904 Implemented mini iconv library supporting conversions between
905 UTF-8, UCS4, UCS4LE and ISO-8859-1. Implemented in util/siconv.c.
906
907 * Removed XML reader (d1_expat.c). It's part of Zebra instead.
908
909 --- 1.8.9 2002/08/20
910
911 Fixed ZOOM C record cache so that preferredRecordSyntax and
912 elementSetName is used to check for already fetched records.
913
914 --- 1.8.8 2002/08/02
915
916 Added three members in bend_initrequest structure to facilitate
917 character set negotiation.
918
919 Fixed a bug in frontend server that could cause indefinite
920 loops under rare conditions. 
921
922 Revised character set utilities (charneg.h) so that encoding
923 UCS-4, UCSA-4, UTF-16 and UTF-8 are encoded non-privately.
924
925 For PQF, directive @term <type> sets term type for Scan/Search.
926 Here <type> is general, string, numeric, null. The term type
927 is inherited - just like @attr.
928
929 New call odr_set_charset that sets character set conversion for
930 international-strings on a ODR stream. Prototype is:
931  int odr_set_charset(ODR o, const char *to, const char *from);
932 The InternationalString is still represented as C string in YAZ 
933 so native strings of type UTF-8, ASCII, etc. will work (UTF-16
934 won't). On the protocol level, you can use any encoding.
935
936 Support for UNIX sockets in ZOOM.
937
938 Solaris recv sometimes returns errno == ENOENT. It is treated as
939 EINPROGRESS. COMSTACK patch by Ko van der Sloot.
940
941 New COMSTACK of type UNIX Socket. Use "unix:/path" as address for
942 both client and server. Code by Morten Bøgeskov.
943
944 --- 1.8.7 2002/05/22
945
946 On Windows ZOOM functions are of type __stdcall rather than __cdecl, so
947 that they can be used directly from Visual Basic. You must recompile
948 your windows APP if you're using ZOOM.
949
950 Character Set and Language Negotiation(3) for ZOOM API and YAZ client.
951 Commands "lang" and "charset" sets language and character set respectively.
952 Options "lang" and "charset" is interpreted by the ZOOM API. Note, these
953 are not part of the official ZOOM spec) All is due to Oleg Kolobov. 
954
955 Attributes from multiple CCL fields may be OR'ed rather than merged
956 using directive "@field or". Fields are still merged by default -
957 equivalent to "@field merge".
958
959 Fixed bug in ZOOM connect that occurred on OpenBSD (maybe others). Patch
960 by Oleg Kolobov.
961
962 Fixed bug in zget for parameter ExtendedServicesResponse.
963
964 Fix OID for ILL.
965
966 --- 1.8.6 2002/03/25
967
968 Added PQF feature: '@attr type=value' may be written as '@type=value'.
969
970 Client displays USR.1:SearchResult-1 (hits per term).
971
972 Additional Search Info for search in Generic Frontend Server.
973
974 Fixed CCL parsing of "field=s".
975
976 WIN32 installer - using the excellent NSIS software from nullsoft.
977
978 Fixed CCL parsing of "field = - <number>".
979
980 Added function yaz_marc_decode that decodes MARC for line mode
981 display or XML (similar to that used by JZKit).
982
983 Fixed BER decoding of OPTIONAL CHOICE. The bug didn't affect the
984 Z39.50. But ISO/ILL was, however.
985
986 Added patch by Rustam T. Usmanov that implements Z39.50 duplicate
987 detection service (Z39.50-1995 Amendment 2) and Language Negotiation (3).
988 See:
989  http://lcweb.loc.gov/z3950/agency/amend/am2.html
990  http://lcweb.loc.gov/z3950/agency/defns/charneg-3.html
991
992 --- 1.8.5 2002/02/03
993
994 New YAZ client features: Command completion and new commands:
995 push_command, set_apdufile, set_marcdump, set_cclfields, register_oid.
996 Code provided by Jacob Poulsen.
997
998 New call oid_trav, that visits all registered OIDs via callback.
999
1000 Function ZOOM_record_get now returns const char pointer rather than
1001 void pointer. It saves a lot of type casts.
1002
1003 For YAZ client, command "auth" now allows you to set authentication
1004 in IdPass style. It is enabled when three tokens are given - order
1005 is user, group and password.
1006
1007 Fix memory leaks in MARC record handling for ZOOM.
1008
1009 New option for YAZ client, -k <kilobytes> that sets
1010 maximum record size. Similar to -k option for generic frontend
1011 server and yaz-ztest.
1012
1013 More fixes for scan. Non-zero stepSize handled. OID's fixes.
1014
1015 Prefix query parser reports "fail" when bad attribute set is given.
1016
1017 Fix in MARC decoder. Proximity logging. Fix for attribute set
1018 in scan handler for server. Patches by Shigeru Ishida.
1019
1020 SSL/COMSTACK updates. cs_rcvconnect completes SSL handshake. ZOOM
1021 works with SSL.
1022
1023 Configure option --with-openssl=<dir> now works when a directory is
1024 specified. Patch provided by Morten Bøgeskov.
1025
1026 New option for YAZ client, -u <auth>, that sets authentication.
1027
1028 ZOOM fix: error information was sometimes "missing", since error
1029 was cleared/reset too when it shouldn't.
1030
1031 ZOOM_record_get returns ISO2709 buffer when "raw" is given.
1032
1033 --- 1.8.4 2002/01/04
1034
1035 Scan for ZOOM API. New object ZOOM_scanset. New functions
1036 ZOOM_connection_scan, ZOOM_scanset_size, ZOOM_scanset_term and
1037 ZOOM_scanset_destroy.
1038
1039 New ZOOM function, ZOOM_connection_last_event, that returns type
1040 of last event (such as "receive data", "send data", "apdu received",
1041 etc.
1042
1043 New ZOOM option, schema, that specifies schema for retrieval.
1044
1045 New CCL feature. Qualifiers can be aliases for one or more
1046 other qualifiers (if more than one is given, OR is used).
1047
1048 ZOOM uses named result sets if target supports it.
1049
1050 Two new YAZ client commands: .  (dot, which sources a script of YAZ
1051 client commands), and ! (to execute shell command.). Implemented
1052 by Jacob Poulsen.
1053
1054 Working on Debian packages.
1055
1056 --- 1.8.3 2001/11/19
1057
1058 YAZ client enables named result sets only if target supports it.
1059
1060 *** ZOOM. Prefix for ZOOM definitions changed from Z3950_ to ZOOM_.
1061
1062 * ZOOM. Removed Z3950_connection_host. Use Z3950_connection_option_get
1063 with key="host" to get same result.
1064
1065 * ZOOM. Added Z3950_record_clone and removed Z3950_resultset_get.
1066 Function Z3950_resultset_record(s) returns references to records
1067 "owned" by resultset. To become owner use Z3950_record_clone.
1068
1069 Function z_ext_record handles Extended Services. Thanks to
1070 Irina Dijour.
1071
1072 --- 1.8.2 2001/11/12
1073
1074 CCL Parser fix: ignore token comma when dealing with and-lists.
1075
1076 Documentation updates for COMSTACK.
1077
1078 * ZOOM changes. Query object renamed from Z3950_search to Z3950_query.
1079 Changed prototype Z3950_records. For some functions, int parameters
1080 were changed to size_t.
1081
1082 TCP/IP COMSTACK no longer uses getprotobyname to avoid memory leak
1083 on some Unices.
1084
1085 New MARC decode/display function, marc_display_exl, which properly rejects
1086 non-ISO2709 records. YAZ client uses it.
1087
1088 --- 1.8.1 2001/10/29
1089
1090 Fix bug: local attribute set wasn't set correctly in PQF strings.
1091
1092 --- 1.8 2001/10/25
1093
1094 * Old Z39.50 codecs no longer supported. 
1095
1096 Added ZOOM C binding. See http://zoom.z3950.org/
1097
1098 Renamed states for COMSTACKs to avoid confusion with events.
1099
1100 Implemented cs_look and proper cs_rcvconnect.
1101
1102 Fixed COMSTACK error that occurred on HPUX. Fix by Giannis Kosmas.
1103
1104 Configure detects POSIX threads on OpenBSD.
1105
1106 When sort flag 'i' was specified in yaz-client the caseSensitivy flag
1107 was set to a wrong value.  Thanks to Robert Sanderson for reporting this.
1108
1109 When error is returned from present handler, non-surrogate diagnostic
1110 is returned in present response (and fetch handler is no longer called).
1111
1112 * Minor adjustments to pquery parser (PQF). Token characters may be
1113 escaped by using backslash (C-style).
1114
1115 PQF parser allows string attribute values to be specified. For @attr,
1116 non-numeric characters after the equal-sign are treated as strings
1117 (e.g. @attr 9=title).
1118
1119 CCL trunction character may be defined (@truncation in file)
1120
1121 * function zget_ExtendedServicesRequest sets waitAction to
1122   waitIfPossible (was wait).
1123
1124 Added cs_set_blocking to set change blocking mode of a COMSTACK. Thanks
1125 to Matthew Carey.
1126
1127 CCL operator names may be set in field definition files (CCL_bibset).
1128 See ccl/bib1 for an example.
1129
1130 Fixes in ASN.1 compiler for C++ compatibility.
1131
1132 * Renamed members "and" and "or" in struct Z_Operator to "op_and"
1133 and "op_or" to avoid conflict with C++.
1134
1135 Fixed problem with GNU readline detection on Redhat 7.0.
1136
1137 Added step-size for Scan backend handler.
1138
1139 Fixed bug that made the frontend server crash when no attribute
1140 set was specified for scan.
1141
1142 Front-end server automatically switches to original working directory
1143 when installed as an NT service. Previously -w had to be specified to
1144 make it work.
1145
1146 Added extended attributes for retrieval module (data1), so that data1
1147 records carry d1_readXML/SGML attributes. d1_read also supports
1148 null-data rules ( <tag/>)
1149
1150 On UNIX when POSIX threads are available, a separate library libyazthread
1151 is created. Programmers should link with that library and the yaz library
1152 when using threads. The reason for the split was that some applications
1153 on Linux, such as Apache, doesn't work well when using shared objects that
1154 relies on threads.
1155
1156 Added SSL support for the COMSTACK. You start yaz-client and yaz-ztest
1157 (or any frontend server) in SSL mode by specifying ssl: followed by
1158 address. Only tested on UNIX.
1159
1160 Added feature for CCL module. Virtual structure s=al or s=ol generates
1161 and-list and or-list respectively instead of phrase search.
1162
1163 Added some OID's.
1164
1165 * Added prefix "yaz_" for the functions log_init.., log_file..  and
1166 log_mask_str. This was done to avoid name conflicts with other libraries
1167 (such as other PHP extensions).
1168
1169 Added raw OID member for preferred record syntax (request_format_raw)
1170 and returned record syntax (output_format_raw) for backend fetch method.
1171
1172 Config file yaz-config now accepts options so that it returns specific
1173 compile settings, etc. Thanks to Morten Bøgeskov <morten@bogeskov.dk>
1174
1175 Shared library support for UNIX using GNU libtool.
1176
1177 * Modified backend interface. Request/Response struct's replaced by
1178 one read/write C struct. For example bend_fetchrequest and
1179 bend_fetchresult have been replaced by single bend_fetch_rr struct.
1180 Every handler - even search has to be registered in bend_init
1181 handler. This means that the YAZ library no longer refers to
1182 external functions and it makes it possible to make the whole
1183 thing a single DLL/SO.
1184
1185 Added Segment handler for backend server.
1186
1187 Added Zmbol/Zebra administrative functions to YAZ client.
1188
1189 Threaded frontend server on UNIX (when POSIX Threads are available).
1190 Starting the server with option -T enables multi-threading.
1191
1192 --- 1.6 2000/03/03
1193
1194 Added configure option --enable-comp/disable-comp to control use
1195 of YAZ ASN.1 compiler. Use --disable-comp to use the old *coders
1196 located in sub directory asn.
1197
1198 YAZ ASN.1 compiler renamed to yaz-comp in sub directory. It's installed
1199 in ${exec_prefix}/bin along with the other programs yaz-client and
1200 yaz-ztest.
1201
1202 GNU automake used to maintain makefiles.
1203
1204 Added several OID's.
1205
1206 Changed retrieval module so that we can load records with no abstract
1207 syntax defined. Tagpaths in these records are fully composed of string
1208 tags.
1209
1210 Implemented ISO ILL protocol. Refer to stuff in sub directory ill.
1211
1212 --- 1.5 1999/12/10
1213
1214 On UNIX, the generated makefile now supports a proper 'make install'.
1215 The prefix can be set via GNU configure to set the install location
1216 (default is /usr/local).
1217
1218 * YAZ programs client and ztest were renamed to yaz-client and
1219 yaz-ztest to avoid conflicts when users install YAZ in "standard"
1220 locations, such as /usr/bin,/usr/local/bin,etc.
1221
1222 * YAZ Header files were moved from include to include/yaz. YAZ Header
1223 files are referred to as include <yaz/log.h> rather than <log.h>.
1224 The YAZ include path (-I ..) is therefore the same as before. Programmers
1225 should update their #include statements or use -Ipath/include/yaz
1226 instead. The main motivation for doing this change is that YAZ header files
1227 can be installed in "standard" locations /usr/include,/usr/local/include 
1228 without introducing conflicts, since ALL YAZ header files are stored
1229 in subdirectory yaz (under /usr/include for example).
1230
1231 Compilation of YAZ for WIN32 is now handled by an nmake-style makefile 
1232 rather than project/workspace files. We switched because project files
1233 are incompatible between Visual C++ 5 and 6. Refer to windows.txt for
1234 details.
1235
1236 Changed name of logging function, logf, to yaz_log, to prevent name
1237 clash with some math-log functions. The YAZ header log.h defines logf
1238 to yaz_log (#define) so there should be no incompatibilities by this
1239 modification.
1240
1241 Added bend_start/bend_stop handlers for server. These handler are
1242 called on start/stop of server. For windows they are called whenever
1243 a service is started/stopped.
1244
1245 * YAZ now auto-generates decoders/encoders for the Z39.50 protocol using
1246 a fairly small ASN.1 compiler written in Tcl. The compiler is located
1247 in util/yc.tcl. The auto-generated C code structures are, in a few
1248 cases, incompatible with the old decoders. There are differences in the
1249 following C structures Z_DiagRec, Z_External, Z_SortRequest, Z_SortResponse,
1250 Z_AttributesPlusTerm, Z_ProximityOperator, Z_DefaultDiagFormat.
1251 The preprocessor variable ASN_COMPILED is defined when the compiled
1252 ASN.1 is being used. Encoder/decoder routines as well as the Z39.50
1253 protocol ASN.1 is located sub directory <tt>z39.50</tt>. If you
1254 wish to use the old encoders/decoders you can specify --disable-yc
1255 for configure.
1256
1257 Assigned OID for old DB Update (VAL_DBUPDATE0). Updated YAZ compiled
1258 version so that it supports both new - and old version of DB Update
1259
1260 * Added 'name' parameter to ODR encoder/decoder routines to facilitate
1261 pretty ODR print. Updated whole Z39.50 encoder/decoder to reflect the
1262 change. The name parameter can be set to 0 in which no name is specified
1263 for the construction. The macros odr_implicit and odr_explicit sets name
1264 parameter to zero for the construction involved. New macros
1265 odr_implicit_tag and odr_explicit_tag are similar to the others,
1266 except that a name parameter is added. For programmers' that don't use
1267 ODR they probably only need to change the call to z_APDU and z_External.
1268
1269 Added access control facility by interfacing the TCP wrapper library.
1270 YAZ automatically attempts to find the TCP wrapper Library (-lwrap) and
1271 tcpd.h on Unix systems. For the server, option -d<daemon> specifies the
1272 name of the daemon and enables the access control as specified in
1273 hosts.allow/hosts.deny. Refer to man pages tcpd(8) and hosts_access(5).
1274
1275 Fixed memory leak in ccl_find_str and ccl_qual_rm. Thanks to Hans van
1276 den Dool <H.M.vdnDool@kub.nl>.
1277
1278 Added reference ID parameter to most functions in server API - refer
1279 to backend.h. Thanks to Hans van den Dool <H.M.vdnDool@kub.nl>.
1280
1281 Changed name of ccl library to libccl.a (was ccl.a).
1282
1283 Fixed bug in decoder for Explain (Category TargetInfo).
1284
1285 Added support for GNU readline in client. Thanks to Jacob Poulsen
1286 <ja7@dbc.dk>. GNU configure attempts to detect if readline is available.
1287
1288 * CHANGED DEFINITION OF ES: UPDATE (INCLUDING THE OID) to reflect the
1289 new definition from the ZIG. NOTE THIS IF YOU HAVE AN UPDATE
1290 IMPLEMENTATION! This change was made to the development version before
1291 the ZIG decided to retract the amendment. If any users MUST be
1292 compatible with the original Update definition, PLEASE CONTACT US, and
1293 we will include a separate definition corresponding to the old Update
1294 ES. Note that because of the change to the ASN.1 of the
1295 TaskPackageRecordStructure we cannot define a single structure that
1296 will support both versions.
1297
1298 * Added const modifier to buffer parameter for some ODR/BER encoding
1299 routines: ber_dectag, ber_declen, odp_more_chunks, completeBER,
1300 completeWAIS, odr_dumpBER.
1301
1302 Fixed bug in client.c which caused a crash when a scanResponse didn't
1303 contain positionOfTerm.
1304
1305 * Fixed inconsistency in the ScanResponse/ListEntries protocol. This
1306 * will cause an error in a client if a non-YAZ target sends both a
1307 * list of Scan entries and non-surrogate diagnostics.
1308
1309 Retrieval module enhancements. Tag sets may be typed in the reference
1310 to it. From the .abs-file the "tagset" directive takes a third optional
1311 integer type for the tag set referenced. From a .tag-file the "include"
1312 directive takes a third optional type as well. The old "type" directive
1313 in the tag set itself is still recognized but acts as the default type
1314 for the tag set.
1315
1316 Backend interface change. Individual Scan terms returned from bend_scan
1317 may also be tagged as Surrogate Diagnostics. Refer to struct scan_entry
1318 in include/backend.h.
1319
1320 Retrieval module enhancements. Multiple tag sets and attribute sets may
1321 be specified in abstract syntax specs. Revised the error/warning for
1322 logging messages reported by the retrieval module when reading the
1323 various spec files.
1324
1325 Object Identifier system (oid_..) changed. The API is backwards
1326 compatible but the oid-routines now allocates new OID's when needed.
1327 Raw OID's may be specified in oid_getvalbyname.
1328
1329 YAZ now uses GNU configure to generate Makefile(s).
1330
1331 * Minor changes in some of the member names of DeleteResultSetRequest and
1332 DeleteResultSetResponse. See include/proto.h.
1333
1334 * Changed some C definitions regarding EXPLAIN record syntax (prt-exp.h)
1335 and added member 'languages' in TargetInfo (which was missing).
1336
1337 Changed the way attribute sets are handled in the retrieval
1338 module. These are now cached, just like the abstract syntaxes
1339 (schemas).
1340
1341 Changed YAZ so that it links with compiled ASN.1.
1342
1343 Added Explain-schema definitions and mapping routines. The following
1344 Explain categories have been implemented: AttributeDetails,
1345 AttributeSetInfo, DatabaseInfo, CategoryList and TargetInfo.
1346
1347 Fixed minor bug in Windows version of Server Library.
1348
1349 --- 1.4pl2+ 1998/4/17 (Released with Zebra)
1350
1351 Added Extended Services to server (backend.h). Thanks to Charles Woodfield.
1352
1353 Added EXTERNAL: UNIverse Resource Report (non-standard).
1354
1355 Implemened odr_enum and odr_set_of functions to handle ASN.1 types
1356 ENUMERATED and SET OF.
1357
1358 * Added 'const' to some of the char pointer arguments for the
1359 functions, data1_read_node, data1_getelementbytagname,
1360 data1_insert_taggeddata, data1_getesetbyname, data1_getelementbyname,
1361 data1_get_absyn.
1362
1363 Fixed bug in data1_insert_taggeddata - the last_child member of
1364 parent wasn't initialised.
1365
1366 * Changed data1_read_record and data1_read_node so that the supplied
1367 "SGML"-buffer is read-only. In particular the resulting data1 - tree
1368 doesn't refer to any parts of the "SGML"-buffer.
1369
1370 Fixed bug in server library (Windows version of statserv_remove).
1371
1372 * Changed code so that it compiles as C++. The type definition
1373 of Odr_fun which is a member of Odr_arm was changed. The result is,
1374 that an explicit typecast is needed for the fun pointer when
1375 using Odr_arm - as in:
1376     {1, -1, -1, Z_IdAuthentication_idPass, (Odr_fun)z_IdPass},
1377
1378 Updated TagSet-G and -M definitions (tagsetm.tag and tagsetg.tag).
1379
1380 Implemented the new structured date and time definition as approved
1381 by the ZIG. Added schemaId element to the specificTag in Espec-1
1382 (also approved at the last ZIG). Thanks to RVDM.
1383
1384 Added some Object identifiers (RVDM).
1385
1386 Changed the Update Extended Service (RVDM).
1387
1388 Added command "refid" to client which specifies referenceId for
1389 the following requests.
1390
1391 Implemented extended service handling for server. See ztest.c
1392 for an example as well as backend.h. New handlers are registerd
1393 in the Init handler.
1394
1395 * Changed interface for sort in server.
1396
1397 Added new members to statserv_options_block. It allows a server
1398 to read options from another source than just the command line. Thanks
1399 to Charles Woodfield.
1400
1401 * Changed definition of Z_Triple in file prt-grs.h - member boolean
1402 renamed to zboolean. Some C++ compilers complained about the name.
1403
1404 Minor changes to gils.abs. Added index 's' (sort) on title
1405 and date/time-last-modified.
1406
1407 --- 1.4pl2 1998/1/30
1408
1409 Fixed bug in server library regarding inetd mode (-i). This bug
1410 was introduced by release 1.4.
1411
1412 --- 1.4pl1 1998/1/29
1413
1414 Added sort facility in client and backend server interface.
1415
1416 Fixed problem with dependencies in Makefile(s).
1417
1418 Fixed bugs for encoders/decoders of extended services and 
1419 SearchInfoReport.
1420
1421 Implemented sub-tree feature for schemas. Sub-trees are
1422 referenced in *.abs-files. See explain.abs for an example
1423 of the use of this feature.
1424
1425 Modified bib1.att; local attributes for ANY didn't include
1426 ANY itself (only affects use of the retrieval module).
1427
1428 Fixed bug in plain SGML reader in function data1_read_node:
1429 tags with prefix "var" was incorrectly interpreted as variants.
1430
1431 Added feature "sub-schemas" to enable references to - and definitions
1432 of - group of elements.
1433
1434 * Removed member parent from type data1_element (in data1.h).
1435
1436 Implemented function odr_nullval() that returns the value of
1437 ODR_NULLVAL.
1438
1439 * Removed member num_children from data1_node (in data1.h).
1440
1441 Made NT service interface part of the server library. The
1442 function statserv_main uses the NT service when required and
1443 calls the statserv_start / statserv_close routines.
1444
1445 Routine zget_SearchRequest and zget_PresentRequest fills
1446 resultSetName/Id member with "default" instead of "Default".
1447
1448 Fixed memory leak in server. Request queue member wasn't freed.
1449
1450 Fixed nmem_exit so that memory is freed.
1451
1452 --- 1.4 1997/10/2
1453
1454 Revised the CCL parser utility to be thread safe.
1455
1456 Added function, oid_ent_to_oid, to replace the function 
1457 oid_getoidbyent, which is not thread safe.
1458
1459 * Added nmem_init and nmem_exit to initialize and release
1460 NMEM resources. Function nmem_init should be called once in the
1461 initial thread before NMEM/ODR is used. statserv.c and client.c
1462 have been changed accordingly. The change was necessary to make
1463 NMEM thread safe. The NMEM memory pool is shared amongst threads
1464 in a process. Unix-based applications will still work fine without
1465 calling this.
1466
1467 Added NT Services interface for the the Z39.50 (statserv) Server. 
1468 Refer to the ztest.c source on the usage.
1469
1470 Windows 95/NT port using MSVC5.0. Project files are included in the
1471 distribution.
1472
1473 * Defined new 'global' handle for the retrieval (data1) system. The
1474 new handled, data1_handle, describes the state of the data1 system.
1475 This handle is passed as first argument to virtually all
1476 data1 related routines. The functions data1_create and data1_destroy
1477 creates and destroys a data1 handle respectively.
1478
1479 Added ODR encode stream member to all backend request structures
1480 init, search, scan etc. This stream should be used to allocate all
1481 memory used for the response when thread safe operation is needed.
1482
1483 Changed the comstack utility, cs_addstr, to be thread safe. The
1484 returned hostname string returned by the function is now part the
1485 COMSTACK instance.
1486
1487 Added comstack utility, cs_straddr, which replaces the tcpip_strtoaddr
1488 function. The cs_straddr takes a COMSTACK handle as argument, so this
1489 function must be used after cs_create and before bind/connect.
1490 This function is thread safe.
1491
1492 Moved test server to 'ztest' directory - generic server code still
1493 in 'server' directory.
1494
1495 Made prefix query (pquery.c) utility thread safe.
1496
1497 Added new function modifier YAZ_EXPORT to 'export' public DLL
1498 functions when using windows (see include/yconfig.h).
1499
1500 Added definitions to the OID database (util/oid.c) (RVDM).
1501
1502 Added new BIB-1 diagnostic messages to the handler diagbib1_str.
1503
1504 Added call to ccl_rpn_delete in client program.
1505
1506 Added ODR argument to ccl_rpn_query and ccl_scan_query to provide
1507 release of RPN structure.
1508
1509 Added support for C++, headers uses extern "C" for public definitions.
1510 With input from RVDM.
1511
1512 In handling of SEQUENCE OF: Counter set to zero when SEQUENCE OF is absent.
1513 Thanks to Ronald van der Meer (RVDM).
1514
1515 Added initializers (zget_ routines) for a number of PDUs. Thanks to RVDM.
1516
1517 Added support for private extensions to the OID database
1518 (oid_setprivateoids()). Thanks to RVDM.
1519     
1520 Added optional, physical ANY (key replication)
1521
1522 Fixed null-reference problem in GRS-1 output filter.
1523
1524 Proximity operator added to Prefix Query Format (PQF).
1525
1526 In test client command "base" accepts multiple databases.
1527
1528 Fixed bug in cs_close stack that caused trouble with WINSOCK.
1529
1530 --- 1.3 1996/10/11
1531
1532 Fixed tagging bug in ResourceReportResponse PDU encoder/decode.
1533
1534 Smallish bug-fixes in the new encoders/decoders (explain).
1535
1536 Bug fixed in DeleteRequest.
1537
1538 Fixed tagging bug of type 101 query in SearchRequest-Query PDU encoder/decoder.
1539
1540 Fixed tagging bug in ResourceReportResponse PDU encoder/decode.
1541
1542 Added SOIF syntax (using private OID for now) to retrieval module and client.
1543
1544 Added Update extended service.
1545
1546 Added SearchResult-1 additional info structure.
1547
1548 Added optional CCL (ISO8777) interpreter as separate module. Available
1549 in linemode client.
1550
1551 --- 1.2 1996/6/10 (1st anniversary release)
1552
1553 Added Summary record syntax. Lightly tested.
1554
1555 Added OPAC record syntax. Untested.
1556
1557 Added ResourceReport service encoders/decoders. Untested.
1558
1559 Fixed bug in z_Unit - wrong tagging on unitSystem.
1560
1561 Fixed bug in the DiagRecs decoder.
1562
1563 Added options for max PDU size and session timeout to frontend-server.
1564
1565 Added documentation of query-language parsers and other supporting utilities.
1566
1567 [frontend-server] Added Attribute set to the bend_scanrequest API.
1568
1569 [frontend-server] NextResultSetPosition was sometimes set incorrectly when
1570 surrogate diagnostics were generated.
1571
1572 [retrieval] Allow multiple local values for attribute.
1573
1574 [retrieval] Allow multiple attributes per element in .abs files. index type.
1575
1576 [retrieval] Added Summary tagset, abstract syntax, and d1-node/ASN filter.
1577
1578 --- 1.1pl2  1996/4/10
1579
1580 Minor changes, mostly specific to Zebra's requirements (retrieval)
1581
1582 --- 1.1  1996/2/20
1583
1584 Repaired bug in frontend server when running multiple listening
1585 endpoints in dynamic mode.
1586
1587 z_External() now won't break if a known, ASN.1 value comes encapsulated
1588 in an octet-string. The value will pass through unmodified in an Odr_oct.
1589
1590 Added a bit of code to the demo client to decode & display
1591 ASN.1-structured records represented in the octet-aligned branch of
1592 the EXTERNAL CHOICE. Thanks to CAS for prodding us to finally do this.
1593
1594 Added z_ext_getentbyref() to the ASN module. Doc updated.
1595
1596 * Completed the SCAN definition in the ASN module. This may break SCAN
1597 code based on older YAZ-versions at compile-time. The fix is easy -
1598 look in proto.h.
1599
1600 * Added 'displayTerm' and OtherInformation to the TermInfo structure
1601 under the SCAN definition. Remember to initialize this, server-people.
1602
1603 Comstack should now support the WAIS protocol in TCP/IP mode. Note
1604 that this does not extend to ODR and ASN.
1605
1606 Comstack allows insertion of established socket (primarily for
1607 inetd-operation of servers). Doc updated.
1608
1609 Front-end server can now start from the inetd in TCP mode. Doc
1610 updated.
1611
1612 --- 1.0pl4 1996/1/24
1613
1614 Added Sort PDU.
1615
1616 Fixed small problem in SUTRS-filter. A newline was sometimes inserted before
1617 the rank and record number.
1618
1619 Adjustments to the frontend server.
1620
1621 Fixed diagnostic BER dumper. It ignored the file argument.
1622
1623 --- 1.0pl3 1996/1/2
1624
1625 Various changes to retrieval module.
1626
1627 Changed the union discriminators of the protocol files from enums to
1628 ints paired with #defines.
1629
1630 *Changed oident.class to oident.oclass to avoid a reserved word in C++
1631  compilers.
1632
1633 *Changed operator in the RPN structure to 'roperator', again to avoid a
1634  conflict with C++.
1635
1636 Fixed problems in Explain decoders/encoders.
1637
1638 --- 1.0pl2 1995/12/6
1639
1640 Memory bug in log module fixed.
1641
1642 --- 1.0pl1 1995/12/5
1643
1644 Occasional malloc() of 0 bytes fixed in d1_espec.c.
1645
1646 Bug in Explain DatabaseInfo module fixed.
1647
1648 Some '\r' snuck into one or two of the ret'l config tables. A curse on Windows.
1649
1650 --- 1.0 1995/11/28
1651
1652 The shift to v1.0 signals that we now consider the *core* functionality
1653 of YAZ reasonably stable (the core being more or less equivalent to
1654 Z39.50-1992). Some of the really nifty v3 stuff is still not heavily
1655 tested (Explain not at all - though that will happen soonish).
1656
1657 Minor changes to code to support Windows port.
1658
1659 Various minor changes after we're getting to use GRS-1 & co. more.
1660
1661 Added Espec-1 format.
1662
1663 Added VisibleString field body type to GRS-1. It is illegal acc. to my copy
1664 of the protocol and it cannot be selected when encoding (maps into 'string'
1665 when decoding). Needed to talk to some servers.
1666
1667 Demo client can request simple element set names.
1668
1669 Added Diagnostic Format encoders/decoders.
1670
1671 Added simple Close handling to frontend server (no hooks for resource
1672 reporting yet), and demonstration client.
1673
1674 Added cs_addrstr() command to COMSTACK to retrieve peer hostname/address.
1675
1676 --- 1.0b3 1995/08/24
1677
1678 Fixed bug in the frontend-server. The numberOfRecordsReturned field was
1679 handled incorrectly when records were requested in the searchResponse. This
1680 will only affect you if you use the frontend-server.
1681
1682 Added GRS-1 encoders/decoders to the service-level API. Lightly tested.
1683 Test-client will ask for and print GRS1. Ztest will return dummy records
1684 on request.
1685
1686 Added Explain encoders/decoders to the service-level API. Untested.
1687
1688 Added Extended Services: Item Order encoders and decoders to the Service-
1689 level API. Untested. We could use a recent copy of the pertinent bits
1690 of the ILL protocol to add those bits.
1691
1692 Added diagnostic format 1 encoders/decoders to the service-level API.
1693 Untested.
1694
1695 Moved pretty-printing of structure-wrappers ({..}) from odr_seq.c to
1696 odr_cons.c, which causes a more correct output.
1697
1698 Fixed handling of searchRequest in frontend server. NextResultSetPosition
1699 was always set to 0 when no records were requested in the searchRequest.
1700
1701 * Added better external-handling. This shouldn't harm old code that
1702 *encodes* externals. It can break code that looks for a
1703 'single-ASN1-type' representation, since those types that are known
1704 are now decoded immediately. Look at the SUTRS sample code in
1705 seshigh.c and client.c. Documentation updated.
1706
1707 Handling of structured records in bend_fetchresponse. Length -1 marks
1708 structured record, type is deduced from format field.
1709
1710 --- 1.0b2 1995/06/27
1711 Fairly quick maintenance release to add SUTRS support.
1712
1713 Fixed handling of SUTRS records in the demonstration client.
1714
1715 * Added format field to the bend_fetchrequest and bend_fetchresponce
1716 structures of the backend API (frontend server). When the record is
1717 returned, the value of the format field is mapped to an OID. The
1718 value VAL_SUTRS will also cause a slightly different ASN.1 packaging
1719 of the record. The special value VAL_NONE in the bend_request means
1720 that no specific format was requested by the client. Documentation
1721 updated accordingly. Test server (ztest) will return a fixed dummy
1722 SUTRS record if your client requests SUTRS.
1723
1724 Documentation updated accordingly.
1725
1726 You can now set external libraries and RANLIB support in the top-level
1727 Makefile.
1728
1729 --- 1.0b 1995/06/19
1730 First public release.