src/zoom-z3950.c

   1 /* This file is part of the YAZ toolkit.
   2  * Copyright (C) 1995-2012 Index Data
   3  * See the file LICENSE for details.
   4  */
   5 /**
   6  * \file zoom-z3950.c
   7  * \brief Implements ZOOM Z39.50 handling
   8  */
   9 #if HAVE_CONFIG_H
  10 #include <config.h>
  11 #endif
  12
  13 #include <assert.h>
  14 #include <string.h>
  15 #include <errno.h>
  16 #include "zoom-p.h"
  17
  18 #include <yaz/yaz-util.h>
  19 #include <yaz/xmalloc.h>
  20 #include <yaz/otherinfo.h>
  21 #include <yaz/log.h>
  22 #include <yaz/pquery.h>
  23 #include <yaz/marcdisp.h>
  24 #include <yaz/diagbib1.h>
  25 #include <yaz/charneg.h>
  26 #include <yaz/ill.h>
  27 #include <yaz/query-charset.h>
  28 #include <yaz/copy_types.h>
  29 #include <yaz/snprintf.h>
  30 #include <yaz/facet.h>
  31
  32 #include <yaz/shptr.h>
  33
  34 /*
  35  * This wrapper is just for logging failed lookups.  It would be nicer
  36  * if it could cause failure when a lookup fails, but that's hard.
  37  */
  38 static Odr_oid *zoom_yaz_str_to_z3950oid(ZOOM_connection c,
  39                                      oid_class oid_class, const char *str) {
  40     Odr_oid *res = yaz_string_to_oid_odr(yaz_oid_std(), oid_class, str,
  41                                      c->odr_out);
  42     if (res == 0)
  43         yaz_log(YLOG_WARN, "%p OID lookup (%d, '%s') failed",
  44                 c, (int) oid_class, str);
  45     return res;
  46 }
  47
  48 static Z_APDU *create_es_package(ZOOM_package p, const Odr_oid *oid)
  49 {
  50     const char *str;
  51     Z_APDU *apdu = zget_APDU(p->odr_out, Z_APDU_extendedServicesRequest);
  52     Z_ExtendedServicesRequest *req = apdu->u.extendedServicesRequest;
  53
  54     str = ZOOM_options_get(p->options, "package-name");
  55     if (str && *str)
  56         req->packageName = odr_strdup(p->odr_out, str);
  57
  58     str = ZOOM_options_get(p->options, "user-id");
  59     if (str)
  60         req->userId = odr_strdup_null(p->odr_out, str);
  61
  62     req->packageType = odr_oiddup(p->odr_out, oid);
  63
  64     str = ZOOM_options_get(p->options, "function");
  65     if (str)
  66     {
  67         if (!strcmp (str, "create"))
  68             *req->function = Z_ExtendedServicesRequest_create;
  69         if (!strcmp (str, "delete"))
  70             *req->function = Z_ExtendedServicesRequest_delete;
  71         if (!strcmp (str, "modify"))
  72             *req->function = Z_ExtendedServicesRequest_modify;
  73     }
  74
  75     str = ZOOM_options_get(p->options, "waitAction");
  76     if (str)
  77     {
  78         if (!strcmp (str, "wait"))
  79             *req->waitAction = Z_ExtendedServicesRequest_wait;
  80         if (!strcmp (str, "waitIfPossible"))
  81             *req->waitAction = Z_ExtendedServicesRequest_waitIfPossible;
  82         if (!strcmp (str, "dontWait"))
  83             *req->waitAction = Z_ExtendedServicesRequest_dontWait;
  84         if (!strcmp (str, "dontReturnPackage"))
  85             *req->waitAction = Z_ExtendedServicesRequest_dontReturnPackage;
  86     }
  87     return apdu;
  88 }
  89
  90 static const char *ill_array_lookup(void *clientData, const char *idx)
  91 {
  92     ZOOM_package p = (ZOOM_package) clientData;
  93     return ZOOM_options_get(p->options, idx+4);
  94 }
  95
  96 static Z_External *encode_ill_request(ZOOM_package p)
  97 {
  98     ODR out = p->odr_out;
  99     ILL_Request *req;
 100     Z_External *r = 0;
 101     struct ill_get_ctl ctl;
 102
 103     ctl.odr = p->odr_out;
 104     ctl.clientData = p;
 105     ctl.f = ill_array_lookup;
 106
 107     req = ill_get_ILLRequest(&ctl, "ill", 0);
 108
 109     if (!ill_Request(out, &req, 0, 0))
 110     {
 111         int ill_request_size;
 112         char *ill_request_buf = odr_getbuf(out, &ill_request_size, 0);
 113         if (ill_request_buf)
 114             odr_setbuf(out, ill_request_buf, ill_request_size, 1);
 115         return 0;
 116     }
 117     else
 118     {
 119         int illRequest_size = 0;
 120         char *illRequest_buf = odr_getbuf(out, &illRequest_size, 0);
 121
 122         r = (Z_External *) odr_malloc(out, sizeof(*r));
 123         r->direct_reference = odr_oiddup(out, yaz_oid_general_isoill_1);
 124         r->indirect_reference = 0;
 125         r->descriptor = 0;
 126         r->which = Z_External_single;
 127
 128         r->u.single_ASN1_type =
 129             odr_create_Odr_oct(out,
 130                                (unsigned char *)illRequest_buf,
 131                                illRequest_size);
 132     }
 133     return r;
 134 }
 135
 136 static Z_ItemOrder *encode_item_order(ZOOM_package p)
 137 {
 138     Z_ItemOrder *req = (Z_ItemOrder *) odr_malloc(p->odr_out, sizeof(*req));
 139     const char *str;
 140     int len;
 141
 142     req->which = Z_IOItemOrder_esRequest;
 143     req->u.esRequest = (Z_IORequest *)
 144         odr_malloc(p->odr_out,sizeof(Z_IORequest));
 145
 146     /* to keep part ... */
 147     req->u.esRequest->toKeep = (Z_IOOriginPartToKeep *)
 148         odr_malloc(p->odr_out,sizeof(Z_IOOriginPartToKeep));
 149     req->u.esRequest->toKeep->supplDescription = 0;
 150     req->u.esRequest->toKeep->contact = (Z_IOContact *)
 151         odr_malloc(p->odr_out, sizeof(*req->u.esRequest->toKeep->contact));
 152
 153     str = ZOOM_options_get(p->options, "contact-name");
 154     req->u.esRequest->toKeep->contact->name =
 155         odr_strdup_null(p->odr_out, str);
 156
 157     str = ZOOM_options_get(p->options, "contact-phone");
 158     req->u.esRequest->toKeep->contact->phone =
 159         odr_strdup_null(p->odr_out, str);
 160
 161     str = ZOOM_options_get(p->options, "contact-email");
 162     req->u.esRequest->toKeep->contact->email =
 163         odr_strdup_null(p->odr_out, str);
 164
 165     req->u.esRequest->toKeep->addlBilling = 0;
 166
 167     /* not to keep part ... */
 168     req->u.esRequest->notToKeep = (Z_IOOriginPartNotToKeep *)
 169         odr_malloc(p->odr_out,sizeof(Z_IOOriginPartNotToKeep));
 170
 171     str = ZOOM_options_get(p->options, "itemorder-setname");
 172     if (!str)
 173         str = "default";
 174
 175     if (!*str)
 176         req->u.esRequest->notToKeep->resultSetItem = 0;
 177     else
 178     {
 179         req->u.esRequest->notToKeep->resultSetItem = (Z_IOResultSetItem *)
 180             odr_malloc(p->odr_out, sizeof(Z_IOResultSetItem));
 181
 182         req->u.esRequest->notToKeep->resultSetItem->resultSetId =
 183             odr_strdup(p->odr_out, str);
 184         req->u.esRequest->notToKeep->resultSetItem->item =
 185             odr_intdup(p->odr_out, 0);
 186
 187         str = ZOOM_options_get(p->options, "itemorder-item");
 188         *req->u.esRequest->notToKeep->resultSetItem->item =
 189             (str ? atoi(str) : 1);
 190     }
 191
 192     str = ZOOM_options_getl(p->options, "doc", &len);
 193     if (str)
 194     {
 195         req->u.esRequest->notToKeep->itemRequest =
 196             z_ext_record_xml(p->odr_out, str, len);
 197     }
 198     else
 199         req->u.esRequest->notToKeep->itemRequest = encode_ill_request(p);
 200
 201     return req;
 202 }
 203
 204 Z_APDU *create_admin_package(ZOOM_package p, int type,
 205                              Z_ESAdminOriginPartToKeep **toKeepP,
 206                              Z_ESAdminOriginPartNotToKeep **notToKeepP)
 207 {
 208     Z_APDU *apdu = create_es_package(p, yaz_oid_extserv_admin);
 209     if (apdu)
 210     {
 211         Z_ESAdminOriginPartToKeep  *toKeep;
 212         Z_ESAdminOriginPartNotToKeep  *notToKeep;
 213         Z_External *r = (Z_External *) odr_malloc(p->odr_out, sizeof(*r));
 214         const char *first_db = "Default";
 215         int num_db;
 216         char **db = ZOOM_connection_get_databases(p->connection,
 217                                                   p->options, &num_db,
 218                                                   p->odr_out);
 219         if (num_db > 0)
 220             first_db = db[0];
 221
 222         r->direct_reference = odr_oiddup(p->odr_out, yaz_oid_extserv_admin);
 223         r->descriptor = 0;
 224         r->indirect_reference = 0;
 225         r->which = Z_External_ESAdmin;
 226
 227         r->u.adminService = (Z_Admin *)
 228             odr_malloc(p->odr_out, sizeof(*r->u.adminService));
 229         r->u.adminService->which = Z_Admin_esRequest;
 230         r->u.adminService->u.esRequest = (Z_AdminEsRequest *)
 231             odr_malloc(p->odr_out, sizeof(*r->u.adminService->u.esRequest));
 232
 233         toKeep = r->u.adminService->u.esRequest->toKeep =
 234             (Z_ESAdminOriginPartToKeep *)
 235             odr_malloc(p->odr_out, sizeof(*r->u.adminService->u.esRequest->toKeep));
 236         toKeep->which = type;
 237         toKeep->databaseName = odr_strdup(p->odr_out, first_db);
 238         toKeep->u.create = odr_nullval();
 239         apdu->u.extendedServicesRequest->taskSpecificParameters = r;
 240
 241         r->u.adminService->u.esRequest->notToKeep = notToKeep =
 242             (Z_ESAdminOriginPartNotToKeep *)
 243             odr_malloc(p->odr_out,
 244                        sizeof(*r->u.adminService->u.esRequest->notToKeep));
 245         notToKeep->which = Z_ESAdminOriginPartNotToKeep_recordsWillFollow;
 246         notToKeep->u.recordsWillFollow = odr_nullval();
 247         if (toKeepP)
 248             *toKeepP = toKeep;
 249         if (notToKeepP)
 250             *notToKeepP = notToKeep;
 251     }
 252     return apdu;
 253 }
 254
 255 static Z_APDU *create_xmlupdate_package(ZOOM_package p)
 256 {
 257     Z_APDU *apdu = create_es_package(p, yaz_oid_extserv_xml_es);
 258     Z_ExtendedServicesRequest *req = apdu->u.extendedServicesRequest;
 259     Z_External *ext = (Z_External *) odr_malloc(p->odr_out, sizeof(*ext));
 260     int len;
 261     const char *doc = ZOOM_options_getl(p->options, "doc", &len);
 262
 263     if (!doc)
 264     {
 265         doc = "";
 266         len = 0;
 267     }
 268
 269     req->taskSpecificParameters = ext;
 270     ext->direct_reference = req->packageType;
 271     ext->descriptor = 0;
 272     ext->indirect_reference = 0;
 273
 274     ext->which = Z_External_octet;
 275     ext->u.single_ASN1_type =
 276         odr_create_Odr_oct(p->odr_out, (const unsigned char *) doc, len);
 277     return apdu;
 278 }
 279
 280 static Z_APDU *create_update_package(ZOOM_package p)
 281 {
 282     Z_APDU *apdu = 0;
 283     const char *first_db = "Default";
 284     int num_db;
 285     char **db = ZOOM_connection_get_databases(p->connection, p->options,
 286                                               &num_db, p->odr_out);
 287     const char *action = ZOOM_options_get(p->options, "action");
 288     int recordIdOpaque_len;
 289     const char *recordIdOpaque = ZOOM_options_getl(p->options, "recordIdOpaque",
 290         &recordIdOpaque_len);
 291     const char *recordIdNumber = ZOOM_options_get(p->options, "recordIdNumber");
 292     int record_len;
 293     const char *record_buf = ZOOM_options_getl(p->options, "record",
 294         &record_len);
 295     int recordOpaque_len;
 296     const char *recordOpaque_buf = ZOOM_options_getl(p->options, "recordOpaque",
 297         &recordOpaque_len);
 298     const char *syntax_str = ZOOM_options_get(p->options, "syntax");
 299     const char *version = ZOOM_options_get(p->options, "updateVersion");
 300
 301     const char *correlationInfo_note =
 302         ZOOM_options_get(p->options, "correlationInfo.note");
 303     const char *correlationInfo_id =
 304         ZOOM_options_get(p->options, "correlationInfo.id");
 305     int action_no = -1;
 306     Odr_oid *syntax_oid = 0;
 307     const Odr_oid *package_oid = yaz_oid_extserv_database_update;
 308
 309     if (!version)
 310         version = "3";
 311     if (!syntax_str)
 312         syntax_str = "xml";
 313     if (!record_buf && !recordOpaque_buf)
 314     {
 315         record_buf = "void";
 316         record_len = 4;
 317         syntax_str = "SUTRS";
 318     }
 319
 320     if (syntax_str)
 321     {
 322         syntax_oid = yaz_string_to_oid_odr(yaz_oid_std(),
 323                                            CLASS_RECSYN, syntax_str,
 324                                            p->odr_out);
 325     }
 326     if (!syntax_oid)
 327     {
 328         ZOOM_set_error(p->connection, ZOOM_ERROR_ES_INVALID_SYNTAX, syntax_str);
 329         return 0;
 330     }
 331
 332     if (num_db > 0)
 333         first_db = db[0];
 334
 335     switch (*version)
 336     {
 337     case '1':
 338         package_oid = yaz_oid_extserv_database_update_first_version;
 339         /* old update does not support specialUpdate */
 340         if (!action)
 341             action = "recordInsert";
 342         break;
 343     case '2':
 344         if (!action)
 345             action = "specialUpdate";
 346         package_oid = yaz_oid_extserv_database_update_second_version;
 347         break;
 348     case '3':
 349         if (!action)
 350             action = "specialUpdate";
 351         package_oid = yaz_oid_extserv_database_update;
 352         break;
 353     default:
 354         ZOOM_set_error(p->connection, ZOOM_ERROR_ES_INVALID_VERSION, version);
 355         return 0;
 356     }
 357
 358     if (!strcmp(action, "recordInsert"))
 359         action_no = Z_IUOriginPartToKeep_recordInsert;
 360     else if (!strcmp(action, "recordReplace"))
 361         action_no = Z_IUOriginPartToKeep_recordReplace;
 362     else if (!strcmp(action, "recordDelete"))
 363         action_no = Z_IUOriginPartToKeep_recordDelete;
 364     else if (!strcmp(action, "elementUpdate"))
 365         action_no = Z_IUOriginPartToKeep_elementUpdate;
 366     else if (!strcmp(action, "specialUpdate"))
 367         action_no = Z_IUOriginPartToKeep_specialUpdate;
 368     else
 369     {
 370         ZOOM_set_error(p->connection, ZOOM_ERROR_ES_INVALID_ACTION, action);
 371         return 0;
 372     }
 373
 374     apdu = create_es_package(p, package_oid);
 375     if (apdu)
 376     {
 377         Z_IUOriginPartToKeep *toKeep;
 378         Z_IUSuppliedRecords *notToKeep;
 379         Z_External *r = (Z_External *)
 380             odr_malloc(p->odr_out, sizeof(*r));
 381         const char *elementSetName =
 382             ZOOM_options_get(p->options, "elementSetName");
 383
 384         apdu->u.extendedServicesRequest->taskSpecificParameters = r;
 385
 386         r->direct_reference = odr_oiddup(p->odr_out, package_oid);
 387         r->descriptor = 0;
 388         r->which = Z_External_update;
 389         r->indirect_reference = 0;
 390         r->u.update = (Z_IUUpdate *)
 391             odr_malloc(p->odr_out, sizeof(*r->u.update));
 392
 393         r->u.update->which = Z_IUUpdate_esRequest;
 394         r->u.update->u.esRequest = (Z_IUUpdateEsRequest *)
 395             odr_malloc(p->odr_out, sizeof(*r->u.update->u.esRequest));
 396         toKeep = r->u.update->u.esRequest->toKeep =
 397             (Z_IUOriginPartToKeep *)
 398             odr_malloc(p->odr_out, sizeof(*toKeep));
 399
 400         toKeep->databaseName = odr_strdup(p->odr_out, first_db);
 401         toKeep->schema = 0;
 402
 403         toKeep->elementSetName = odr_strdup_null(p->odr_out, elementSetName);
 404
 405         toKeep->actionQualifier = 0;
 406         toKeep->action = odr_intdup(p->odr_out, action_no);
 407
 408         notToKeep = r->u.update->u.esRequest->notToKeep =
 409             (Z_IUSuppliedRecords *)
 410             odr_malloc(p->odr_out, sizeof(*notToKeep));
 411         notToKeep->num = 1;
 412         notToKeep->elements = (Z_IUSuppliedRecords_elem **)
 413             odr_malloc(p->odr_out, sizeof(*notToKeep->elements));
 414         notToKeep->elements[0] = (Z_IUSuppliedRecords_elem *)
 415             odr_malloc(p->odr_out, sizeof(**notToKeep->elements));
 416         notToKeep->elements[0]->which = Z_IUSuppliedRecords_elem_opaque;
 417         if (recordIdOpaque)
 418         {
 419             notToKeep->elements[0]->u.opaque =
 420                 odr_create_Odr_oct(p->odr_out,
 421                                    (const unsigned char *) recordIdOpaque,
 422                                    recordIdOpaque_len);
 423         }
 424         else if (recordIdNumber)
 425         {
 426             notToKeep->elements[0]->which = Z_IUSuppliedRecords_elem_number;
 427
 428             notToKeep->elements[0]->u.number =
 429                 odr_intdup(p->odr_out, atoi(recordIdNumber));
 430         }
 431         else
 432             notToKeep->elements[0]->u.opaque = 0;
 433         notToKeep->elements[0]->supplementalId = 0;
 434         if (correlationInfo_note || correlationInfo_id)
 435         {
 436             Z_IUCorrelationInfo *ci;
 437             ci = notToKeep->elements[0]->correlationInfo =
 438                 (Z_IUCorrelationInfo *) odr_malloc(p->odr_out, sizeof(*ci));
 439             ci->note = odr_strdup_null(p->odr_out, correlationInfo_note);
 440             ci->id = correlationInfo_id ?
 441                 odr_intdup(p->odr_out, atoi(correlationInfo_id)) : 0;
 442         }
 443         else
 444             notToKeep->elements[0]->correlationInfo = 0;
 445         if (recordOpaque_buf)
 446         {
 447             notToKeep->elements[0]->record =
 448                 z_ext_record_oid_any(p->odr_out, syntax_oid,
 449                                  recordOpaque_buf, recordOpaque_len);
 450         }
 451         else
 452         {
 453             notToKeep->elements[0]->record =
 454                 z_ext_record_oid(p->odr_out, syntax_oid,
 455                                  record_buf, record_len);
 456         }
 457     }
 458     if (0 && apdu)
 459     {
 460         ODR print = odr_createmem(ODR_PRINT);
 461
 462         z_APDU(print, &apdu, 0, 0);
 463         odr_destroy(print);
 464     }
 465     return apdu;
 466 }
 467
 468
 469 static void otherInfo_attach(ZOOM_connection c, Z_APDU *a, ODR out)
 470 {
 471     int i;
 472     for (i = 0; i<200; i++)
 473     {
 474         size_t len;
 475         Odr_oid *oid;
 476         Z_OtherInformation **oi;
 477         char buf[80];
 478         const char *val;
 479         const char *cp;
 480
 481         sprintf(buf, "otherInfo%d", i);
 482         val = ZOOM_options_get(c->options, buf);
 483         if (!val)
 484             break;
 485         cp = strchr(val, ':');
 486         if (!cp)
 487             continue;
 488         len = cp - val;
 489         if (len >= sizeof(buf))
 490             len = sizeof(buf)-1;
 491         memcpy(buf, val, len);
 492         buf[len] = '\0';
 493
 494         oid = yaz_string_to_oid_odr(yaz_oid_std(), CLASS_USERINFO,
 495                                     buf, out);
 496         if (!oid)
 497             continue;
 498
 499         yaz_oi_APDU(a, &oi);
 500         yaz_oi_set_string_oid(oi, out, oid, 1, cp+1);
 501     }
 502 }
 503
 504
 505
 506 static int encode_APDU(ZOOM_connection c, Z_APDU *a, ODR out)
 507 {
 508     assert(a);
 509     if (c->cookie_out)
 510     {
 511         Z_OtherInformation **oi;
 512         yaz_oi_APDU(a, &oi);
 513         yaz_oi_set_string_oid(oi, out, yaz_oid_userinfo_cookie,
 514                               1, c->cookie_out);
 515     }
 516     if (c->client_IP)
 517     {
 518         Z_OtherInformation **oi;
 519         yaz_oi_APDU(a, &oi);
 520         yaz_oi_set_string_oid(oi, out, yaz_oid_userinfo_client_ip,
 521                               1, c->client_IP);
 522     }
 523     otherInfo_attach(c, a, out);
 524     if (!z_APDU(out, &a, 0, 0))
 525     {
 526         FILE *outf = fopen("/tmp/apdu.txt", "a");
 527         if (a && outf)
 528         {
 529             ODR odr_pr = odr_createmem(ODR_PRINT);
 530             fprintf(outf, "a=%p\n", a);
 531             odr_setprint(odr_pr, outf);
 532             z_APDU(odr_pr, &a, 0, 0);
 533             odr_destroy(odr_pr);
 534         }
 535         yaz_log(c->log_api, "%p encoding_APDU: encoding failed", c);
 536         ZOOM_set_error(c, ZOOM_ERROR_ENCODE, 0);
 537         odr_reset(out);
 538         return -1;
 539     }
 540     if (c->odr_print)
 541         z_APDU(c->odr_print, &a, 0, 0);
 542     if (c->odr_save)
 543         z_APDU(c->odr_save, &a, 0, 0);
 544     yaz_log(c->log_details, "%p encoding_APDU encoding OK", c);
 545     return 0;
 546 }
 547
 548 static zoom_ret send_APDU(ZOOM_connection c, Z_APDU *a)
 549 {
 550     ZOOM_Event event;
 551     assert(a);
 552     if (encode_APDU(c, a, c->odr_out))
 553         return zoom_complete;
 554     yaz_log(c->log_details, "%p send APDU type=%d", c, a->which);
 555     c->buf_out = odr_getbuf(c->odr_out, &c->len_out, 0);
 556     event = ZOOM_Event_create(ZOOM_EVENT_SEND_APDU);
 557     ZOOM_connection_put_event(c, event);
 558     odr_reset(c->odr_out);
 559     return ZOOM_send_buf(c);
 560 }
 561
 562 zoom_ret ZOOM_connection_Z3950_send_init(ZOOM_connection c)
 563 {
 564     Z_APDU *apdu = zget_APDU(c->odr_out, Z_APDU_initRequest);
 565     Z_InitRequest *ireq = apdu->u.initRequest;
 566     Z_IdAuthentication *auth = (Z_IdAuthentication *)
 567         odr_malloc(c->odr_out, sizeof(*auth));
 568
 569     ODR_MASK_SET(ireq->options, Z_Options_search);
 570     ODR_MASK_SET(ireq->options, Z_Options_present);
 571     ODR_MASK_SET(ireq->options, Z_Options_scan);
 572     ODR_MASK_SET(ireq->options, Z_Options_sort);
 573     ODR_MASK_SET(ireq->options, Z_Options_extendedServices);
 574     ODR_MASK_SET(ireq->options, Z_Options_namedResultSets);
 575
 576     ODR_MASK_SET(ireq->protocolVersion, Z_ProtocolVersion_1);
 577     ODR_MASK_SET(ireq->protocolVersion, Z_ProtocolVersion_2);
 578     ODR_MASK_SET(ireq->protocolVersion, Z_ProtocolVersion_3);
 579
 580     ireq->implementationId =
 581         odr_prepend(c->odr_out,
 582                     ZOOM_options_get(c->options, "implementationId"),
 583                     ireq->implementationId);
 584
 585     ireq->implementationName =
 586         odr_prepend(c->odr_out,
 587                     ZOOM_options_get(c->options, "implementationName"),
 588                     odr_prepend(c->odr_out, "ZOOM-C",
 589                                 ireq->implementationName));
 590
 591     ireq->implementationVersion =
 592         odr_prepend(c->odr_out,
 593                     ZOOM_options_get(c->options, "implementationVersion"),
 594                                 ireq->implementationVersion);
 595
 596     *ireq->maximumRecordSize = c->maximum_record_size;
 597     *ireq->preferredMessageSize = c->preferred_message_size;
 598
 599     if (c->group || c->password)
 600     {
 601         Z_IdPass *pass = (Z_IdPass *) odr_malloc(c->odr_out, sizeof(*pass));
 602         pass->groupId = odr_strdup_null(c->odr_out, c->group);
 603         pass->userId = odr_strdup_null(c->odr_out, c->user);
 604         pass->password = odr_strdup_null(c->odr_out, c->password);
 605         auth->which = Z_IdAuthentication_idPass;
 606         auth->u.idPass = pass;
 607         ireq->idAuthentication = auth;
 608     }
 609     else if (c->user)
 610     {
 611         auth->which = Z_IdAuthentication_open;
 612         auth->u.open = odr_strdup(c->odr_out, c->user);
 613         ireq->idAuthentication = auth;
 614     }
 615     if (c->proxy)
 616     {
 617         yaz_oi_set_string_oid(&ireq->otherInfo, c->odr_out,
 618                               yaz_oid_userinfo_proxy, 1, c->host_port);
 619     }
 620     if (c->charset || c->lang)
 621     {
 622         Z_OtherInformation **oi;
 623         Z_OtherInformationUnit *oi_unit;
 624
 625         yaz_oi_APDU(apdu, &oi);
 626
 627         if ((oi_unit = yaz_oi_update(oi, c->odr_out, NULL, 0, 0)))
 628         {
 629             ODR_MASK_SET(ireq->options, Z_Options_negotiationModel);
 630             oi_unit->which = Z_OtherInfo_externallyDefinedInfo;
 631             oi_unit->information.externallyDefinedInfo =
 632                 yaz_set_proposal_charneg_list(c->odr_out, " ",
 633                                               c->charset, c->lang, 1);
 634         }
 635     }
 636     assert(apdu);
 637     return send_APDU(c, apdu);
 638 }
 639
 640 zoom_ret ZOOM_connection_Z3950_send_search(ZOOM_connection c)
 641 {
 642     ZOOM_resultset r;
 643     int lslb, ssub, mspn;
 644     const char *syntax;
 645     Z_APDU *apdu = zget_APDU(c->odr_out, Z_APDU_searchRequest);
 646     Z_SearchRequest *search_req = apdu->u.searchRequest;
 647     const char *elementSetName;
 648     const char *smallSetElementSetName;
 649     const char *mediumSetElementSetName;
 650     const char *facets;
 651
 652     assert(c->tasks);
 653     assert(c->tasks->which == ZOOM_TASK_SEARCH);
 654
 655     r = c->tasks->u.search.resultset;
 656
 657     yaz_log(c->log_details, "%p ZOOM_connection_send_search set=%p", c, r);
 658
 659     elementSetName =
 660         ZOOM_options_get(r->options, "elementSetName");
 661     smallSetElementSetName  =
 662         ZOOM_options_get(r->options, "smallSetElementSetName");
 663     mediumSetElementSetName =
 664         ZOOM_options_get(r->options, "mediumSetElementSetName");
 665
 666     if (!smallSetElementSetName)
 667         smallSetElementSetName = elementSetName;
 668
 669     if (!mediumSetElementSetName)
 670         mediumSetElementSetName = elementSetName;
 671
 672     facets = ZOOM_options_get(r->options, "facets");
 673     if (facets) {
 674         Z_FacetList *facet_list = yaz_pqf_parse_facet_list(c->odr_out, facets);
 675         if (facet_list) {
 676             Z_OtherInformation **oi;
 677             yaz_oi_APDU(apdu, &oi);
 678             yaz_oi_set_facetlist(oi, c->odr_out, facet_list);
 679         }
 680         else
 681             yaz_log(YLOG_WARN, "Unable to parse facets: %s", facets);
 682     }
 683
 684     assert(r);
 685     assert(r->query);
 686
 687     /* prepare query for the search request */
 688     search_req->query = ZOOM_query_get_Z_Query(r->query);
 689     if (!search_req->query)
 690     {
 691         ZOOM_set_error(c, ZOOM_ERROR_INVALID_QUERY, 0);
 692         return zoom_complete;
 693     }
 694     if (search_req->query->which == Z_Query_type_1 ||
 695         search_req->query->which == Z_Query_type_101)
 696     {
 697         const char *cp = ZOOM_options_get(r->options, "rpnCharset");
 698         if (cp)
 699         {
 700             yaz_iconv_t cd = yaz_iconv_open(cp, "UTF-8");
 701             if (cd)
 702             {
 703                 int r;
 704                 search_req->query = yaz_copy_Z_Query(search_req->query,
 705                                                      c->odr_out);
 706
 707                 r = yaz_query_charset_convert_rpnquery_check(
 708                     search_req->query->u.type_1,
 709                     c->odr_out, cd);
 710                 yaz_iconv_close(cd);
 711                 if (r)
 712                 {  /* query could not be char converted */
 713                     ZOOM_set_error(c, ZOOM_ERROR_INVALID_QUERY, 0);
 714                     return zoom_complete;
 715                 }
 716             }
 717         }
 718     }
 719     search_req->databaseNames = r->databaseNames;
 720     search_req->num_databaseNames = r->num_databaseNames;
 721
 722     /* get syntax (no need to provide unless piggyback is in effect) */
 723     syntax = c->tasks->u.search.syntax;
 724
 725     lslb = ZOOM_options_get_int(r->options, "largeSetLowerBound", -1);
 726     ssub = ZOOM_options_get_int(r->options, "smallSetUpperBound", -1);
 727     mspn = ZOOM_options_get_int(r->options, "mediumSetPresentNumber", -1);
 728     if (lslb != -1 && ssub != -1 && mspn != -1)
 729     {
 730         /* So're a Z39.50 expert? Let's hope you don't do sort */
 731         *search_req->largeSetLowerBound = lslb;
 732         *search_req->smallSetUpperBound = ssub;
 733         *search_req->mediumSetPresentNumber = mspn;
 734     }
 735     else if (c->tasks->u.search.start == 0 && c->tasks->u.search.count > 0
 736              && r->piggyback && !r->r_sort_spec && !r->schema)
 737     {
 738         /* Regular piggyback - do it unless we're going to do sort */
 739         *search_req->largeSetLowerBound = 2000000000;
 740         *search_req->smallSetUpperBound = 1;
 741         *search_req->mediumSetPresentNumber =
 742             r->step>0 ? r->step : c->tasks->u.search.count;
 743     }
 744     else
 745     {
 746         /* non-piggyback. Need not provide elementsets or syntaxes .. */
 747         smallSetElementSetName = 0;
 748         mediumSetElementSetName = 0;
 749         syntax = 0;
 750     }
 751     if (smallSetElementSetName && *smallSetElementSetName)
 752     {
 753         Z_ElementSetNames *esn = (Z_ElementSetNames *)
 754             odr_malloc(c->odr_out, sizeof(*esn));
 755
 756         esn->which = Z_ElementSetNames_generic;
 757         esn->u.generic = odr_strdup(c->odr_out, smallSetElementSetName);
 758         search_req->smallSetElementSetNames = esn;
 759     }
 760     if (mediumSetElementSetName && *mediumSetElementSetName)
 761     {
 762         Z_ElementSetNames *esn =(Z_ElementSetNames *)
 763             odr_malloc(c->odr_out, sizeof(*esn));
 764
 765         esn->which = Z_ElementSetNames_generic;
 766         esn->u.generic = odr_strdup(c->odr_out, mediumSetElementSetName);
 767         search_req->mediumSetElementSetNames = esn;
 768     }
 769     if (syntax)
 770         search_req->preferredRecordSyntax =
 771             zoom_yaz_str_to_z3950oid(c, CLASS_RECSYN, syntax);
 772
 773     if (!r->setname)
 774     {
 775         if (c->support_named_resultsets)
 776         {
 777             char setname[14];
 778             int ord;
 779             /* find the lowest unused ordinal so that we re-use
 780                result sets on the server. */
 781             for (ord = 1; ; ord++)
 782             {
 783 #if ZOOM_RESULT_LISTS
 784                 ZOOM_resultsets rsp;
 785                 sprintf(setname, "%d", ord);
 786                 for (rsp = c->resultsets; rsp; rsp = rsp->next)
 787                     if (rsp->resultset->setname && !strcmp(rsp->resultset->setname, setname))
 788                         break;
 789                 if (!rsp)
 790                     break;
 791 #else
 792                 ZOOM_resultset rp;
 793                 sprintf(setname, "%d", ord);
 794                 for (rp = c->resultsets; rp; rp = rp->next)
 795                     if (rp->setname && !strcmp(rp->setname, setname))
 796                         break;
 797                 if (!rp)
 798                     break;
 799 #endif
 800
 801             }
 802             r->setname = xstrdup(setname);
 803             yaz_log(c->log_details, "%p ZOOM_connection_send_search: "
 804                     "allocating set %s", c, r->setname);
 805         }
 806         else
 807         {
 808             yaz_log(c->log_details, "%p ZOOM_connection_send_search: using "
 809                     "default set", c);
 810             r->setname = xstrdup("default");
 811         }
 812         ZOOM_options_set(r->options, "setname", r->setname);
 813     }
 814     search_req->resultSetName = odr_strdup(c->odr_out, r->setname);
 815     return send_APDU(c, apdu);
 816 }
 817
 818 zoom_ret ZOOM_connection_Z3950_send_scan(ZOOM_connection c)
 819 {
 820     ZOOM_scanset scan;
 821     Z_APDU *apdu = zget_APDU(c->odr_out, Z_APDU_scanRequest);
 822     Z_ScanRequest *req = apdu->u.scanRequest;
 823     Z_Query *z_query;
 824
 825     yaz_log(c->log_details, "%p send_scan", c);
 826     if (!c->tasks)
 827         return zoom_complete;
 828     assert (c->tasks->which == ZOOM_TASK_SCAN);
 829     scan = c->tasks->u.scan.scan;
 830
 831     z_query = ZOOM_query_get_Z_Query(scan->query);
 832
 833     /* Z39.50 scan can only carry RPN */
 834     if (z_query->which == Z_Query_type_1 ||
 835         z_query->which == Z_Query_type_101)
 836     {
 837         Z_RPNQuery *rpn = z_query->u.type_1;
 838         const char *cp = ZOOM_options_get(scan->options, "rpnCharset");
 839         if (cp)
 840         {
 841             yaz_iconv_t cd = yaz_iconv_open(cp, "UTF-8");
 842             if (cd)
 843             {
 844                 rpn = yaz_copy_z_RPNQuery(rpn, c->odr_out);
 845
 846                 yaz_query_charset_convert_rpnquery(
 847                     rpn, c->odr_out, cd);
 848                 yaz_iconv_close(cd);
 849             }
 850         }
 851         req->attributeSet = rpn->attributeSetId;
 852         if (!req->attributeSet)
 853             req->attributeSet = odr_oiddup(c->odr_out, yaz_oid_attset_bib_1);
 854         if (rpn->RPNStructure->which == Z_RPNStructure_simple &&
 855             rpn->RPNStructure->u.simple->which == Z_Operand_APT)
 856         {
 857             req->termListAndStartPoint =
 858                 rpn->RPNStructure->u.simple->u.attributesPlusTerm;
 859         }
 860         else
 861         {
 862             ZOOM_set_error(c, ZOOM_ERROR_INVALID_QUERY, 0);
 863             return zoom_complete;
 864         }
 865     }
 866     else
 867     {
 868         ZOOM_set_error(c, ZOOM_ERROR_UNSUPPORTED_QUERY, 0);
 869         return zoom_complete;
 870     }
 871
 872     *req->numberOfTermsRequested =
 873         ZOOM_options_get_int(scan->options, "number", 20);
 874
 875     req->preferredPositionInResponse =
 876         odr_intdup(c->odr_out,
 877                    ZOOM_options_get_int(scan->options, "position", 1));
 878
 879     req->stepSize =
 880         odr_intdup(c->odr_out,
 881                    ZOOM_options_get_int(scan->options, "stepSize", 0));
 882
 883     req->databaseNames = scan->databaseNames;
 884     req->num_databaseNames = scan->num_databaseNames;
 885
 886     return send_APDU(c, apdu);
 887 }
 888
 889 ZOOM_API(void)
 890     ZOOM_package_send(ZOOM_package p, const char *type)
 891 {
 892     Z_APDU *apdu = 0;
 893     ZOOM_connection c;
 894     if (!p)
 895         return;
 896     c = p->connection;
 897     odr_reset(p->odr_out);
 898     xfree(p->buf_out);
 899     p->buf_out = 0;
 900     if (!strcmp(type, "itemorder"))
 901     {
 902         apdu = create_es_package(p, yaz_oid_extserv_item_order);
 903         if (apdu)
 904         {
 905             Z_External *r = (Z_External *) odr_malloc(p->odr_out, sizeof(*r));
 906
 907             r->direct_reference =
 908                 odr_oiddup(p->odr_out, yaz_oid_extserv_item_order);
 909             r->descriptor = 0;
 910             r->which = Z_External_itemOrder;
 911             r->indirect_reference = 0;
 912             r->u.itemOrder = encode_item_order(p);
 913
 914             apdu->u.extendedServicesRequest->taskSpecificParameters = r;
 915         }
 916     }
 917     else if (!strcmp(type, "create"))  /* create database */
 918     {
 919         apdu = create_admin_package(p, Z_ESAdminOriginPartToKeep_create,
 920                                     0, 0);
 921     }
 922     else if (!strcmp(type, "drop"))  /* drop database */
 923     {
 924         apdu = create_admin_package(p, Z_ESAdminOriginPartToKeep_drop,
 925                                     0, 0);
 926     }
 927     else if (!strcmp(type, "commit"))  /* commit changes */
 928     {
 929         apdu = create_admin_package(p, Z_ESAdminOriginPartToKeep_commit,
 930                                     0, 0);
 931     }
 932     else if (!strcmp(type, "update")) /* update record(s) */
 933     {
 934         apdu = create_update_package(p);
 935     }
 936     else if (!strcmp(type, "xmlupdate"))
 937     {
 938         apdu = create_xmlupdate_package(p);
 939     }
 940     if (apdu)
 941     {
 942         if (encode_APDU(p->connection, apdu, p->odr_out) == 0)
 943         {
 944             char *buf;
 945
 946             ZOOM_task task = ZOOM_connection_add_task(c, ZOOM_TASK_PACKAGE);
 947             task->u.package = p;
 948             buf = odr_getbuf(p->odr_out, &p->len_out, 0);
 949             p->buf_out = (char *) xmalloc(p->len_out);
 950             memcpy(p->buf_out, buf, p->len_out);
 951
 952             (p->refcount)++;
 953             if (!c->async)
 954             {
 955                 while (ZOOM_event(1, &c))
 956                     ;
 957             }
 958         }
 959     }
 960 }
 961
 962
 963 static void handle_Z3950_records(ZOOM_connection c, Z_Records *sr,
 964                                  int present_phase);
 965
 966 static void response_default_diag(ZOOM_connection c, Z_DefaultDiagFormat *r)
 967 {
 968     char oid_name_buf[OID_STR_MAX];
 969     const char *oid_name;
 970     char *addinfo = 0;
 971
 972     oid_name = yaz_oid_to_string_buf(r->diagnosticSetId, 0, oid_name_buf);
 973     switch (r->which)
 974     {
 975     case Z_DefaultDiagFormat_v2Addinfo:
 976         addinfo = r->u.v2Addinfo;
 977         break;
 978     case Z_DefaultDiagFormat_v3Addinfo:
 979         addinfo = r->u.v3Addinfo;
 980         break;
 981     }
 982     xfree(c->addinfo);
 983     c->addinfo = 0;
 984     ZOOM_set_dset_error(c, *r->condition, oid_name, addinfo, 0);
 985 }
 986
 987 static void response_diag(ZOOM_connection c, Z_DiagRec *p)
 988 {
 989     if (p->which != Z_DiagRec_defaultFormat)
 990         ZOOM_set_error(c, ZOOM_ERROR_DECODE, 0);
 991     else
 992         response_default_diag(c, p->u.defaultFormat);
 993 }
 994
 995 static int es_response_taskpackage_update(ZOOM_connection c,
 996                                           Z_IUUpdateTaskPackage *utp)
 997 {
 998     if (utp && utp->targetPart)
 999     {
1000         Z_IUTargetPart *targetPart = utp->targetPart;
1001         switch ( *targetPart->updateStatus ) {
1002         case Z_IUTargetPart_success:
1003             ZOOM_options_set(c->tasks->u.package->options,"updateStatus", "success");
1004             break;
1005         case Z_IUTargetPart_partial:
1006             ZOOM_options_set(c->tasks->u.package->options,"updateStatus", "partial");
1007             break;
1008         case Z_IUTargetPart_failure:
1009             ZOOM_options_set(c->tasks->u.package->options,"updateStatus", "failure");
1010             if (targetPart->globalDiagnostics && targetPart->num_globalDiagnostics > 0)
1011                 response_diag(c, targetPart->globalDiagnostics[0]);
1012             break;
1013         }
1014         /* NOTE: Individual record status, surrogate diagnostics, and supplemental diagnostics ARE NOT REPORTED. */
1015     }
1016     return 1;
1017 }
1018
1019 static int es_response_taskpackage(ZOOM_connection c,
1020                                    Z_TaskPackage *taskPackage)
1021 {
1022     Odr_oct *id = taskPackage->targetReference;
1023     if (id)
1024         ZOOM_options_setl(c->tasks->u.package->options,
1025                           "targetReference", (char*) id->buf, id->len);
1026
1027     switch ( *taskPackage->taskStatus ) {
1028     case Z_TaskPackage_pending:
1029         ZOOM_options_set(c->tasks->u.package->options,"taskStatus", "pending");
1030         break;
1031     case Z_TaskPackage_active:
1032         ZOOM_options_set(c->tasks->u.package->options,"taskStatus", "active");
1033         break;
1034     case Z_TaskPackage_complete:
1035         ZOOM_options_set(c->tasks->u.package->options,"taskStatus", "complete");
1036         break;
1037     case Z_TaskPackage_aborted:
1038         ZOOM_options_set(c->tasks->u.package->options,"taskStatus", "aborted");
1039         if ( taskPackage->num_packageDiagnostics && taskPackage->packageDiagnostics )
1040             response_diag(c, taskPackage->packageDiagnostics[0]);
1041         break;
1042     }
1043     /* NOTE: Only Update implemented, no others. */
1044     if ( taskPackage->taskSpecificParameters->which == Z_External_update )
1045     {
1046         Z_IUUpdateTaskPackage *utp = taskPackage->taskSpecificParameters->u.update->u.taskPackage;
1047         es_response_taskpackage_update(c, utp);
1048     }
1049     return 1;
1050 }
1051
1052
1053 static int handle_Z3950_es_response(ZOOM_connection c,
1054                                     Z_ExtendedServicesResponse *res)
1055 {
1056     if (!c->tasks || c->tasks->which != ZOOM_TASK_PACKAGE)
1057         return 0;
1058     switch (*res->operationStatus)
1059     {
1060     case Z_ExtendedServicesResponse_done:
1061         ZOOM_options_set(c->tasks->u.package->options,"operationStatus", "done");
1062         break;
1063     case Z_ExtendedServicesResponse_accepted:
1064         ZOOM_options_set(c->tasks->u.package->options,"operationStatus", "accepted");
1065         break;
1066     case Z_ExtendedServicesResponse_failure:
1067         ZOOM_options_set(c->tasks->u.package->options,"operationStatus", "failure");
1068         if (res->diagnostics && res->num_diagnostics > 0)
1069             response_diag(c, res->diagnostics[0]);
1070         break;
1071     }
1072     if (res->taskPackage &&
1073         res->taskPackage->which == Z_External_extendedService)
1074     {
1075         Z_TaskPackage *taskPackage = res->taskPackage->u.extendedService;
1076         es_response_taskpackage(c, taskPackage);
1077     }
1078     if (res->taskPackage &&
1079         res->taskPackage->which == Z_External_octet)
1080     {
1081         Odr_oct *doc = res->taskPackage->u.octet_aligned;
1082         ZOOM_options_setl(c->tasks->u.package->options,
1083                           "xmlUpdateDoc", (char*) doc->buf, doc->len);
1084     }
1085     return 1;
1086 }
1087
1088 static void interpret_init_diag(ZOOM_connection c,
1089                                 Z_DiagnosticFormat *diag)
1090 {
1091     if (diag->num > 0)
1092     {
1093         Z_DiagnosticFormat_s *ds = diag->elements[0];
1094         if (ds->which == Z_DiagnosticFormat_s_defaultDiagRec)
1095             response_default_diag(c, ds->u.defaultDiagRec);
1096     }
1097 }
1098
1099
1100 static void interpret_otherinformation_field(ZOOM_connection c,
1101                                              Z_OtherInformation *ui)
1102 {
1103     int i;
1104     for (i = 0; i < ui->num_elements; i++)
1105     {
1106         Z_OtherInformationUnit *unit = ui->list[i];
1107         if (unit->which == Z_OtherInfo_externallyDefinedInfo &&
1108             unit->information.externallyDefinedInfo &&
1109             unit->information.externallyDefinedInfo->which ==
1110             Z_External_diag1)
1111         {
1112             interpret_init_diag(c, unit->information.externallyDefinedInfo->u.diag1);
1113         }
1114     }
1115 }
1116
1117 static char *get_term_cstr(ODR odr, Z_Term *term) {
1118
1119     switch (term->which) {
1120     case Z_Term_general:
1121             return odr_strdupn(odr, (const char *) term->u.general->buf, (size_t) term->u.general->len);
1122         break;
1123     case Z_Term_characterString:
1124         return odr_strdup(odr, term->u.characterString);
1125     }
1126     return 0;
1127 }
1128
1129 static ZOOM_facet_field get_zoom_facet_field(ODR odr, Z_FacetField *facet) {
1130     int term_index;
1131     struct yaz_facet_attr attr_values;
1132     ZOOM_facet_field facet_field = odr_malloc(odr, sizeof(*facet_field));
1133     yaz_facet_attr_init(&attr_values);
1134     yaz_facet_attr_get_z_attributes(facet->attributes, &attr_values);
1135     facet_field->facet_name = odr_strdup(odr, attr_values.useattr);
1136     facet_field->num_terms = facet->num_terms;
1137     yaz_log(YLOG_DEBUG, "ZOOM_facet_field %s %d terms %d", attr_values.useattr, attr_values.limit, facet->num_terms);
1138     facet_field->facet_terms = odr_malloc(odr, facet_field->num_terms * sizeof(*facet_field->facet_terms));
1139     for (term_index = 0 ; term_index < facet->num_terms; term_index++) {
1140         Z_FacetTerm *facetTerm = facet->terms[term_index];
1141         facet_field->facet_terms[term_index].frequency = *facetTerm->count;
1142         facet_field->facet_terms[term_index].term = get_term_cstr(odr, facetTerm->term);
1143         yaz_log(YLOG_DEBUG, "    term[%d] %s %d",
1144                 term_index, facet_field->facet_terms[term_index].term, facet_field->facet_terms[term_index].frequency);
1145     }
1146     return facet_field;
1147 }
1148
1149 /* Can be share with SOLR/SRU/SRW requests */
1150 void handle_facet_list(ZOOM_resultset r, Z_FacetList *fl) {
1151     int j;
1152     r->num_facets   = fl->num;
1153     yaz_log(YLOG_DEBUG, "Facets found: %d", fl->num);
1154     r->facets       =  odr_malloc(r->odr, r->num_facets * sizeof(*r->facets));
1155     r->facets_names =  odr_malloc(r->odr, r->num_facets * sizeof(*r->facets_names));
1156     for (j = 0; j < fl->num; j++)
1157     {
1158         r->facets[j] = get_zoom_facet_field(r->odr, fl->elements[j]);
1159         if (!r->facets[j])
1160             yaz_log(YLOG_DEBUG, "Facet field missing on index %d !", j);
1161         r->facets_names[j] = (char *) ZOOM_facet_field_name(r->facets[j]);
1162     }
1163 }
1164
1165 static void handle_facet_result(ZOOM_connection c, ZOOM_resultset r,
1166                                 Z_OtherInformation *o)
1167 {
1168     int i;
1169     for (i = 0; o && i < o->num_elements; i++)
1170     {
1171         if (o->list[i]->which == Z_OtherInfo_externallyDefinedInfo)
1172         {
1173             Z_External *ext = o->list[i]->information.externallyDefinedInfo;
1174             if (ext->which == Z_External_userFacets)
1175             {
1176                 handle_facet_list(r, ext->u.facetList);
1177             }
1178         }
1179     }
1180 }
1181
1182 static void handle_queryExpressionTerm(ZOOM_options opt, const char *name,
1183                                        Z_Term *term)
1184 {
1185     switch (term->which)
1186     {
1187     case Z_Term_general:
1188         ZOOM_options_setl(opt, name,
1189                           (const char *)(term->u.general->buf),
1190                           term->u.general->len);
1191         break;
1192     case Z_Term_characterString:
1193         ZOOM_options_set(opt, name, term->u.characterString);
1194         break;
1195     case Z_Term_numeric:
1196         ZOOM_options_set_int(opt, name, *term->u.numeric);
1197         break;
1198     }
1199 }
1200
1201 static void handle_queryExpression(ZOOM_options opt, const char *name,
1202                                    Z_QueryExpression *exp)
1203 {
1204     char opt_name[80];
1205
1206     switch (exp->which)
1207     {
1208     case Z_QueryExpression_term:
1209         if (exp->u.term && exp->u.term->queryTerm)
1210         {
1211             sprintf(opt_name, "%s.term", name);
1212             handle_queryExpressionTerm(opt, opt_name, exp->u.term->queryTerm);
1213         }
1214         break;
1215     case Z_QueryExpression_query:
1216         break;
1217     }
1218 }
1219
1220
1221 static void handle_search_result(ZOOM_connection c, ZOOM_resultset resultset,
1222                                 Z_OtherInformation *o)
1223 {
1224     int i;
1225     for (i = 0; o && i < o->num_elements; i++)
1226     {
1227         if (o->list[i]->which == Z_OtherInfo_externallyDefinedInfo)
1228         {
1229             Z_External *ext = o->list[i]->information.externallyDefinedInfo;
1230
1231             if (ext->which == Z_External_searchResult1)
1232             {
1233                 int j;
1234                 Z_SearchInfoReport *sr = ext->u.searchResult1;
1235
1236                 if (sr->num)
1237                     ZOOM_options_set_int(
1238                         resultset->options, "searchresult.size", sr->num);
1239
1240                 for (j = 0; j < sr->num; j++)
1241                 {
1242                     Z_SearchInfoReport_s *ent =
1243                         ext->u.searchResult1->elements[j];
1244                     char pref[80];
1245
1246                     sprintf(pref, "searchresult.%d", j);
1247
1248                     if (ent->subqueryId)
1249                     {
1250                         char opt_name[80];
1251                         sprintf(opt_name, "%s.id", pref);
1252                         ZOOM_options_set(resultset->options, opt_name,
1253                                          ent->subqueryId);
1254                     }
1255                     if (ent->subqueryExpression)
1256                     {
1257                         char opt_name[80];
1258                         sprintf(opt_name, "%s.subquery", pref);
1259                         handle_queryExpression(resultset->options, opt_name,
1260                                                ent->subqueryExpression);
1261                     }
1262                     if (ent->subqueryInterpretation)
1263                     {
1264                         char opt_name[80];
1265                         sprintf(opt_name, "%s.interpretation", pref);
1266                         handle_queryExpression(resultset->options, opt_name,
1267                                                ent->subqueryInterpretation);
1268                     }
1269                     if (ent->subqueryRecommendation)
1270                     {
1271                         char opt_name[80];
1272                         sprintf(opt_name, "%s.recommendation", pref);
1273                         handle_queryExpression(resultset->options, opt_name,
1274                                                ent->subqueryRecommendation);
1275                     }
1276                     if (ent->subqueryCount)
1277                     {
1278                         char opt_name[80];
1279                         sprintf(opt_name, "%s.count", pref);
1280                         ZOOM_options_set_int(resultset->options, opt_name,
1281                                              *ent->subqueryCount);
1282                     }
1283                 }
1284             }
1285         }
1286     }
1287 }
1288
1289 static void handle_Z3950_search_response(ZOOM_connection c,
1290                                          Z_SearchResponse *sr)
1291 {
1292     ZOOM_resultset resultset;
1293     ZOOM_Event event;
1294
1295     if (!c->tasks || c->tasks->which != ZOOM_TASK_SEARCH)
1296         return ;
1297
1298     event = ZOOM_Event_create(ZOOM_EVENT_RECV_SEARCH);
1299     ZOOM_connection_put_event(c, event);
1300
1301     resultset = c->tasks->u.search.resultset;
1302
1303     if (sr->resultSetStatus)
1304     {
1305         ZOOM_options_set_int(resultset->options, "resultSetStatus",
1306                              *sr->resultSetStatus);
1307     }
1308     if (sr->presentStatus)
1309     {
1310         ZOOM_options_set_int(resultset->options, "presentStatus",
1311                              *sr->presentStatus);
1312     }
1313     handle_search_result(c, resultset, sr->additionalSearchInfo);
1314
1315     handle_facet_result(c, resultset, sr->additionalSearchInfo);
1316
1317     resultset->size = *sr->resultCount;
1318     handle_Z3950_records(c, sr->records, 0);
1319 }
1320
1321 static void handle_Z3950_sort_response(ZOOM_connection c, Z_SortResponse *res)
1322 {
1323     if (res->diagnostics && res->num_diagnostics > 0)
1324         response_diag(c, res->diagnostics[0]);
1325 }
1326
1327 static int handle_Z3950_scan_response(ZOOM_connection c, Z_ScanResponse *res)
1328 {
1329     NMEM nmem = odr_extract_mem(c->odr_in);
1330     ZOOM_scanset scan;
1331
1332     if (!c->tasks || c->tasks->which != ZOOM_TASK_SCAN)
1333         return 0;
1334     scan = c->tasks->u.scan.scan;
1335
1336     if (res->entries && res->entries->nonsurrogateDiagnostics)
1337         response_diag(c, res->entries->nonsurrogateDiagnostics[0]);
1338     scan->scan_response = res;
1339     scan->srw_scan_response = 0;
1340     nmem_transfer(odr_getmem(scan->odr), nmem);
1341     if (res->stepSize)
1342         ZOOM_options_set_int(scan->options, "stepSize", *res->stepSize);
1343     if (res->positionOfTerm)
1344         ZOOM_options_set_int(scan->options, "position", *res->positionOfTerm);
1345     if (res->scanStatus)
1346         ZOOM_options_set_int(scan->options, "scanStatus", *res->scanStatus);
1347     if (res->numberOfEntriesReturned)
1348         ZOOM_options_set_int(scan->options, "number",
1349                              *res->numberOfEntriesReturned);
1350     nmem_destroy(nmem);
1351     return 1;
1352 }
1353
1354 static void handle_Z3950_records(ZOOM_connection c, Z_Records *sr,
1355                                  int present_phase)
1356 {
1357     ZOOM_resultset resultset;
1358     int *start, *count;
1359     const char *syntax = 0, *elementSetName = 0;
1360
1361     if (!c->tasks)
1362         return ;
1363     switch (c->tasks->which)
1364     {
1365     case ZOOM_TASK_SEARCH:
1366         resultset = c->tasks->u.search.resultset;
1367         start = &c->tasks->u.search.start;
1368         count = &c->tasks->u.search.count;
1369         syntax = c->tasks->u.search.syntax;
1370         elementSetName = c->tasks->u.search.elementSetName;
1371         break;
1372     case ZOOM_TASK_RETRIEVE:
1373         resultset = c->tasks->u.retrieve.resultset;
1374         start = &c->tasks->u.retrieve.start;
1375         count = &c->tasks->u.retrieve.count;
1376         syntax = c->tasks->u.retrieve.syntax;
1377         elementSetName = c->tasks->u.retrieve.elementSetName;
1378         break;
1379     default:
1380         return;
1381     }
1382     if (sr && sr->which == Z_Records_NSD)
1383         response_default_diag(c, sr->u.nonSurrogateDiagnostic);
1384     else if (sr && sr->which == Z_Records_multipleNSD)
1385     {
1386         if (sr->u.multipleNonSurDiagnostics->num_diagRecs >= 1)
1387             response_diag(c, sr->u.multipleNonSurDiagnostics->diagRecs[0]);
1388         else
1389             ZOOM_set_error(c, ZOOM_ERROR_DECODE, 0);
1390     }
1391     else
1392     {
1393         if (*count + *start > resultset->size)
1394             *count = resultset->size - *start;
1395         if (*count < 0)
1396             *count = 0;
1397         if (sr && sr->which == Z_Records_DBOSD)
1398         {
1399             int i;
1400             NMEM nmem = odr_extract_mem(c->odr_in);
1401             Z_NamePlusRecordList *p =
1402                 sr->u.databaseOrSurDiagnostics;
1403             for (i = 0; i<p->num_records; i++)
1404             {
1405                 ZOOM_record_cache_add(resultset, p->records[i], i + *start,
1406                                       syntax, elementSetName,
1407                                       elementSetName, 0);
1408             }
1409             *count -= i;
1410             if (*count < 0)
1411                 *count = 0;
1412             *start += i;
1413             yaz_log(c->log_details,
1414                     "handle_records resultset=%p start=%d count=%d",
1415                     resultset, *start, *count);
1416
1417             /* transfer our response to search_nmem .. we need it later */
1418             nmem_transfer(odr_getmem(resultset->odr), nmem);
1419             nmem_destroy(nmem);
1420             if (present_phase && p->num_records == 0)
1421             {
1422                 /* present response and we didn't get any records! */
1423                 Z_NamePlusRecord *myrec =
1424                     zget_surrogateDiagRec(
1425                         resultset->odr, 0,
1426                         YAZ_BIB1_SYSTEM_ERROR_IN_PRESENTING_RECORDS,
1427                         "ZOOM C generated. Present phase and no records");
1428                 ZOOM_record_cache_add(resultset, myrec, *start,
1429                                       syntax, elementSetName, 0, 0);
1430             }
1431         }
1432         else if (present_phase)
1433         {
1434             /* present response and we didn't get any records! */
1435             Z_NamePlusRecord *myrec =
1436                 zget_surrogateDiagRec(
1437                     resultset->odr, 0,
1438                     YAZ_BIB1_SYSTEM_ERROR_IN_PRESENTING_RECORDS,
1439                     "ZOOM C generated: Present response and no records");
1440             ZOOM_record_cache_add(resultset, myrec, *start,
1441                                   syntax, elementSetName, 0, 0);
1442         }
1443     }
1444 }
1445
1446 static void handle_Z3950_present_response(ZOOM_connection c,
1447                                           Z_PresentResponse *pr)
1448 {
1449     handle_Z3950_records(c, pr->records, 1);
1450 }
1451
1452 static void set_init_option(const char *name, void *clientData)
1453 {
1454     ZOOM_connection c = (ZOOM_connection) clientData;
1455     char buf[80];
1456
1457     sprintf(buf, "init_opt_%.70s", name);
1458     ZOOM_connection_option_set(c, buf, "1");
1459 }
1460
1461
1462 zoom_ret send_Z3950_sort(ZOOM_connection c, ZOOM_resultset resultset)
1463 {
1464     if (c->error)
1465         resultset->r_sort_spec = 0;
1466     if (resultset->r_sort_spec)
1467     {
1468         Z_APDU *apdu = zget_APDU(c->odr_out, Z_APDU_sortRequest);
1469         Z_SortRequest *req = apdu->u.sortRequest;
1470
1471         req->num_inputResultSetNames = 1;
1472         req->inputResultSetNames = (Z_InternationalString **)
1473             odr_malloc(c->odr_out, sizeof(*req->inputResultSetNames));
1474         req->inputResultSetNames[0] =
1475             odr_strdup(c->odr_out, resultset->setname);
1476         req->sortedResultSetName = odr_strdup(c->odr_out, resultset->setname);
1477         req->sortSequence = resultset->r_sort_spec;
1478         resultset->r_sort_spec = 0;
1479         return send_APDU(c, apdu);
1480     }
1481     return zoom_complete;
1482 }
1483
1484 zoom_ret send_Z3950_present(ZOOM_connection c)
1485 {
1486     Z_APDU *apdu = 0;
1487     Z_PresentRequest *req = 0;
1488     int i = 0;
1489     const char *syntax = 0;
1490     const char *elementSetName = 0;
1491     ZOOM_resultset  resultset;
1492     int *start, *count;
1493
1494     if (!c->tasks)
1495     {
1496         yaz_log(c->log_details, "%p send_present no tasks", c);
1497         return zoom_complete;
1498     }
1499
1500     switch (c->tasks->which)
1501     {
1502     case ZOOM_TASK_SEARCH:
1503         resultset = c->tasks->u.search.resultset;
1504         start = &c->tasks->u.search.start;
1505         count = &c->tasks->u.search.count;
1506         syntax = c->tasks->u.search.syntax;
1507         elementSetName = c->tasks->u.search.elementSetName;
1508         break;
1509     case ZOOM_TASK_RETRIEVE:
1510         resultset = c->tasks->u.retrieve.resultset;
1511         start = &c->tasks->u.retrieve.start;
1512         count = &c->tasks->u.retrieve.count;
1513         syntax = c->tasks->u.retrieve.syntax;
1514         elementSetName = c->tasks->u.retrieve.elementSetName;
1515         break;
1516     default:
1517         return zoom_complete;
1518     }
1519     yaz_log(c->log_details, "%p send_present start=%d count=%d",
1520             c, *start, *count);
1521
1522     if (*start < 0 || *count < 0 || *start + *count > resultset->size)
1523     {
1524         ZOOM_set_dset_error(c, YAZ_BIB1_PRESENT_REQUEST_OUT_OF_RANGE, "Bib-1",
1525                        "", 0);
1526     }
1527     if (c->error)                  /* don't continue on error */
1528         return zoom_complete;
1529     yaz_log(c->log_details, "send_present resultset=%p start=%d count=%d",
1530             resultset, *start, *count);
1531
1532     for (i = 0; i < *count; i++)
1533     {
1534         ZOOM_record rec =
1535             ZOOM_record_cache_lookup(resultset, i + *start,
1536                                      syntax, elementSetName);
1537         if (!rec)
1538             break;
1539         else
1540         {
1541             ZOOM_Event event = ZOOM_Event_create(ZOOM_EVENT_RECV_RECORD);
1542             ZOOM_connection_put_event(c, event);
1543         }
1544     }
1545     *start += i;
1546     *count -= i;
1547
1548     if (*count == 0)
1549     {
1550         yaz_log(c->log_details, "%p send_present skip=%d no more to fetch", c, i);
1551         return zoom_complete;
1552     }
1553
1554     apdu = zget_APDU(c->odr_out, Z_APDU_presentRequest);
1555     req = apdu->u.presentRequest;
1556
1557     if (i)
1558         yaz_log(c->log_details, "%p send_present skip=%d", c, i);
1559
1560     *req->resultSetStartPoint = *start + 1;
1561
1562     if (resultset->step > 0 && resultset->step < *count)
1563         *req->numberOfRecordsRequested = resultset->step;
1564     else
1565         *req->numberOfRecordsRequested = *count;
1566
1567     if (*req->numberOfRecordsRequested + *start > resultset->size)
1568         *req->numberOfRecordsRequested = resultset->size - *start;
1569     assert(*req->numberOfRecordsRequested > 0);
1570
1571     if (syntax && *syntax)
1572         req->preferredRecordSyntax =
1573             zoom_yaz_str_to_z3950oid(c, CLASS_RECSYN, syntax);
1574
1575     if (resultset->schema && *resultset->schema)
1576     {
1577         Z_RecordComposition *compo = (Z_RecordComposition *)
1578             odr_malloc(c->odr_out, sizeof(*compo));
1579
1580         req->recordComposition = compo;
1581         compo->which = Z_RecordComp_complex;
1582         compo->u.complex = (Z_CompSpec *)
1583             odr_malloc(c->odr_out, sizeof(*compo->u.complex));
1584         compo->u.complex->selectAlternativeSyntax = (bool_t *)
1585             odr_malloc(c->odr_out, sizeof(bool_t));
1586         *compo->u.complex->selectAlternativeSyntax = 0;
1587
1588         compo->u.complex->generic = (Z_Specification *)
1589             odr_malloc(c->odr_out, sizeof(*compo->u.complex->generic));
1590
1591         compo->u.complex->generic->which = Z_Schema_oid;
1592         compo->u.complex->generic->schema.oid = (Odr_oid *)
1593             zoom_yaz_str_to_z3950oid (c, CLASS_SCHEMA, resultset->schema);
1594
1595         if (!compo->u.complex->generic->schema.oid)
1596         {
1597             /* OID wasn't a schema! Try record syntax instead. */
1598
1599             compo->u.complex->generic->schema.oid = (Odr_oid *)
1600                 zoom_yaz_str_to_z3950oid (c, CLASS_RECSYN, resultset->schema);
1601         }
1602         if (elementSetName && *elementSetName)
1603         {
1604             compo->u.complex->generic->elementSpec = (Z_ElementSpec *)
1605                 odr_malloc(c->odr_out, sizeof(Z_ElementSpec));
1606             compo->u.complex->generic->elementSpec->which =
1607                 Z_ElementSpec_elementSetName;
1608             compo->u.complex->generic->elementSpec->u.elementSetName =
1609                 odr_strdup(c->odr_out, elementSetName);
1610         }
1611         else
1612             compo->u.complex->generic->elementSpec = 0;
1613         compo->u.complex->num_dbSpecific = 0;
1614         compo->u.complex->dbSpecific = 0;
1615         compo->u.complex->num_recordSyntax = 0;
1616         compo->u.complex->recordSyntax = 0;
1617     }
1618     else if (elementSetName && *elementSetName)
1619     {
1620         Z_ElementSetNames *esn = (Z_ElementSetNames *)
1621             odr_malloc(c->odr_out, sizeof(*esn));
1622         Z_RecordComposition *compo = (Z_RecordComposition *)
1623             odr_malloc(c->odr_out, sizeof(*compo));
1624
1625         esn->which = Z_ElementSetNames_generic;
1626         esn->u.generic = odr_strdup(c->odr_out, elementSetName);
1627         compo->which = Z_RecordComp_simple;
1628         compo->u.simple = esn;
1629         req->recordComposition = compo;
1630     }
1631     req->resultSetId = odr_strdup(c->odr_out, resultset->setname);
1632     return send_APDU(c, apdu);
1633 }
1634
1635 static zoom_ret send_Z3950_sort_present(ZOOM_connection c)
1636 {
1637     zoom_ret r = zoom_complete;
1638
1639     if (c->tasks && c->tasks->which == ZOOM_TASK_SEARCH)
1640         r = send_Z3950_sort(c, c->tasks->u.search.resultset);
1641     if (r == zoom_complete)
1642         r = send_Z3950_present(c);
1643     return r;
1644 }
1645
1646 void ZOOM_handle_Z3950_apdu(ZOOM_connection c, Z_APDU *apdu)
1647 {
1648     Z_InitResponse *initrs;
1649
1650     ZOOM_connection_set_mask(c, 0);
1651     yaz_log(c->log_details, "%p handle_Z3950_apdu apdu->which=%d",
1652             c, apdu->which);
1653     switch (apdu->which)
1654     {
1655     case Z_APDU_initResponse:
1656         yaz_log(c->log_api, "%p handle_Z3950_apdu: Received Init response", c);
1657         initrs = apdu->u.initResponse;
1658         ZOOM_connection_option_set(c, "serverImplementationId",
1659                                    initrs->implementationId ?
1660                                    initrs->implementationId : "");
1661         ZOOM_connection_option_set(c, "serverImplementationName",
1662                                    initrs->implementationName ?
1663                                    initrs->implementationName : "");
1664         ZOOM_connection_option_set(c, "serverImplementationVersion",
1665                                    initrs->implementationVersion ?
1666                                    initrs->implementationVersion : "");
1667         /* Set the three old options too, for old applications */
1668         ZOOM_connection_option_set(c, "targetImplementationId",
1669                                    initrs->implementationId ?
1670                                    initrs->implementationId : "");
1671         ZOOM_connection_option_set(c, "targetImplementationName",
1672                                    initrs->implementationName ?
1673                                    initrs->implementationName : "");
1674         ZOOM_connection_option_set(c, "targetImplementationVersion",
1675                                    initrs->implementationVersion ?
1676                                    initrs->implementationVersion : "");
1677
1678         /* Make initrs->options available as ZOOM-level options */
1679         yaz_init_opt_decode(initrs->options, set_init_option, (void*) c);
1680
1681         if (!*initrs->result)
1682         {
1683             Z_External *uif = initrs->userInformationField;
1684
1685             ZOOM_set_error(c, ZOOM_ERROR_INIT, 0); /* default error */
1686
1687             if (uif && uif->which == Z_External_userInfo1)
1688                 interpret_otherinformation_field(c, uif->u.userInfo1);
1689         }
1690         else
1691         {
1692             char *cookie =
1693                 yaz_oi_get_string_oid(&apdu->u.initResponse->otherInfo,
1694                                       yaz_oid_userinfo_cookie, 1, 0);
1695             xfree(c->cookie_in);
1696             c->cookie_in = 0;
1697             if (cookie)
1698                 c->cookie_in = xstrdup(cookie);
1699             if (ODR_MASK_GET(initrs->options, Z_Options_namedResultSets) &&
1700                 ODR_MASK_GET(initrs->protocolVersion, Z_ProtocolVersion_3))
1701                 c->support_named_resultsets = 1;
1702             if (c->tasks)
1703             {
1704                 assert(c->tasks->which == ZOOM_TASK_CONNECT);
1705                 ZOOM_connection_remove_task(c);
1706             }
1707             ZOOM_connection_exec_task(c);
1708         }
1709         if (ODR_MASK_GET(initrs->options, Z_Options_negotiationModel))
1710         {
1711             NMEM tmpmem = nmem_create();
1712             Z_CharSetandLanguageNegotiation *p =
1713                 yaz_get_charneg_record(initrs->otherInfo);
1714
1715             if (p)
1716             {
1717                 char *charset = NULL, *lang = NULL;
1718                 int sel;
1719
1720                 yaz_get_response_charneg(tmpmem, p, &charset, &lang, &sel);
1721                 yaz_log(c->log_details, "%p handle_Z3950_apdu target accepted: "
1722                         "charset %s, language %s, select %d",
1723                         c,
1724                         charset ? charset : "none", lang ? lang : "none", sel);
1725                 if (charset)
1726                     ZOOM_connection_option_set(c, "negotiation-charset",
1727                                                charset);
1728                 if (lang)
1729                     ZOOM_connection_option_set(c, "negotiation-lang",
1730                                                lang);
1731
1732                 ZOOM_connection_option_set(
1733                     c,  "negotiation-charset-in-effect-for-records",
1734                     (sel != 0) ? "1" : "0");
1735                 nmem_destroy(tmpmem);
1736             }
1737         }
1738         break;
1739     case Z_APDU_searchResponse:
1740         yaz_log(c->log_api, "%p handle_Z3950_apdu Search response", c);
1741         handle_Z3950_search_response(c, apdu->u.searchResponse);
1742         if (send_Z3950_sort_present(c) == zoom_complete)
1743             ZOOM_connection_remove_task(c);
1744         break;
1745     case Z_APDU_presentResponse:
1746         yaz_log(c->log_api, "%p handle_Z3950_apdu Present response", c);
1747         handle_Z3950_present_response(c, apdu->u.presentResponse);
1748         if (send_Z3950_present(c) == zoom_complete)
1749             ZOOM_connection_remove_task(c);
1750         break;
1751     case Z_APDU_sortResponse:
1752         yaz_log(c->log_api, "%p handle_Z3950_apdu Sort response", c);
1753         handle_Z3950_sort_response(c, apdu->u.sortResponse);
1754         if (send_Z3950_present(c) == zoom_complete)
1755             ZOOM_connection_remove_task(c);
1756         break;
1757     case Z_APDU_scanResponse:
1758         yaz_log(c->log_api, "%p handle_Z3950_apdu Scan response", c);
1759         handle_Z3950_scan_response(c, apdu->u.scanResponse);
1760         ZOOM_connection_remove_task(c);
1761         break;
1762     case Z_APDU_extendedServicesResponse:
1763         yaz_log(c->log_api, "%p handle_Z3950_apdu Extended Services response", c);
1764         handle_Z3950_es_response(c, apdu->u.extendedServicesResponse);
1765         ZOOM_connection_remove_task(c);
1766         break;
1767     case Z_APDU_close:
1768         yaz_log(c->log_api, "%p handle_Z3950_apdu Close PDU", c);
1769         if (!ZOOM_test_reconnect(c))
1770         {
1771             ZOOM_set_dset_error(c, ZOOM_ERROR_CONNECTION_LOST, "ZOOM", c->host_port, apdu->u.close->diagnosticInformation);
1772             ZOOM_connection_close(c);
1773         }
1774         break;
1775     default:
1776         yaz_log(c->log_api, "%p Received unknown PDU", c);
1777         ZOOM_set_error(c, ZOOM_ERROR_DECODE, 0);
1778         ZOOM_connection_close(c);
1779     }
1780 }
1781
1782 /*
1783  * Local variables:
1784  * c-basic-offset: 4
1785  * c-file-style: "Stroustrup"
1786  * indent-tabs-mode: nil
1787  * End:
1788  * vim: shiftwidth=4 tabstop=8 expandtab
1789  */
1790