SimpleServer.xs

   1 /* This file is part of simpleserver.
   2  * Copyright (C) 2000-2013 Index Data.
   3  * All rights reserved.
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions are met:
   6  *
   7  *     * Redistributions of source code must retain the above copyright
   8  *       notice, this list of conditions and the following disclaimer.
   9  *     * Redistributions in binary form must reproduce the above copyright
  10  *       notice, this list of conditions and the following disclaimer in the
  11  *       documentation and/or other materials provided with the distribution.
  12  *     * Neither the name of Index Data nor the names of its contributors
  13  *       may be used to endorse or promote products derived from this
  14  *       software without specific prior written permission.
  15  *
  16  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY
  17  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  18  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  19  * DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY
  20  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  21  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  22  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  23  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  25  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  26  */
  27
  28 #include "EXTERN.h"
  29 #include "perl.h"
  30 #include "proto.h"
  31 #include "embed.h"
  32 #include "XSUB.h"
  33 #include <assert.h>
  34 #include <yaz/backend.h>
  35 #include <yaz/facet.h>
  36 #include <yaz/log.h>
  37 #include <yaz/wrbuf.h>
  38 #include <yaz/pquery.h>
  39 #include <yaz/querytowrbuf.h>
  40 #include <stdio.h>
  41 #include <yaz/mutex.h>
  42 #include <yaz/oid_db.h>
  43 #include <yaz/yaz-version.h>
  44 #ifdef WIN32
  45 #else
  46 #include <unistd.h>
  47 #endif
  48 #include <stdlib.h>
  49 #include <ctype.h>
  50 #define GRS_MAX_FIELDS 500
  51 #ifdef ASN_COMPILED
  52 #include <yaz/ill.h>
  53 #endif
  54 #ifndef sv_undef                /* To fix the problem with Perl 5.6.0 */
  55 #define sv_undef PL_sv_undef
  56 #endif
  57
  58 YAZ_MUTEX simpleserver_mutex;
  59
  60 typedef struct {
  61         SV *ghandle;    /* Global handle specified at creation */
  62         SV *handle;     /* Per-connection handle set at Init */
  63         NMEM nmem;
  64         int stop_flag;  /* is used to stop server prematurely .. */
  65 } Zfront_handle;
  66
  67 #define ENABLE_STOP_SERVER 0
  68
  69 SV *_global_ghandle = NULL; /* To be copied into zhandle then ignored */
  70 SV *init_ref = NULL;
  71 SV *close_ref = NULL;
  72 SV *sort_ref = NULL;
  73 SV *search_ref = NULL;
  74 SV *fetch_ref = NULL;
  75 SV *present_ref = NULL;
  76 SV *esrequest_ref = NULL;
  77 SV *delete_ref = NULL;
  78 SV *scan_ref = NULL;
  79 SV *explain_ref = NULL;
  80 SV *start_ref = NULL;
  81 PerlInterpreter *root_perl_context;
  82
  83 #define GRS_BUF_SIZE 8192
  84
  85
  86 /*
  87  * Inspects the SV indicated by svp, and returns a null pointer if
  88  * it's an undefined value, or a string allocation from `stream'
  89  * otherwise.  Using this when filling in addinfo avoids those
  90  * irritating "Use of uninitialized value in subroutine entry"
  91  * warnings from Perl.
  92  */
  93 char *string_or_undef(SV **svp, ODR stream) {
  94         STRLEN len;
  95         char *ptr;
  96
  97         if (!SvOK(*svp))
  98                 return 0;
  99
 100         ptr = SvPV(*svp, len);
 101         return odr_strdupn(stream, ptr, len);
 102 }
 103
 104
 105 CV * simpleserver_sv2cv(SV *handler) {
 106     STRLEN len;
 107     char *buf;
 108
 109     if (SvPOK(handler)) {
 110         CV *ret;
 111         buf = SvPV( handler, len);
 112         if ( !( ret = perl_get_cv(buf, FALSE ) ) ) {
 113             fprintf( stderr, "simpleserver_sv2cv: No such handler '%s'\n\n", buf );
 114             exit(1);
 115         }
 116
 117         return ret;
 118     } else {
 119         return (CV *) handler;
 120     }
 121 }
 122
 123 /* debugging routine to check for destruction of Perl interpreters */
 124 #ifdef USE_ITHREADS
 125 void tst_clones(void)
 126 {
 127     int i;
 128     PerlInterpreter *parent = PERL_GET_CONTEXT;
 129     for (i = 0; i<5000; i++)
 130     {
 131         PerlInterpreter *perl_interp;
 132
 133         PERL_SET_CONTEXT(parent);
 134         PL_perl_destruct_level = 2;
 135         perl_interp = perl_clone(parent, CLONEf_CLONE_HOST);
 136         PL_perl_destruct_level = 2;
 137         PERL_SET_CONTEXT(perl_interp);
 138         perl_destruct(perl_interp);
 139         perl_free(perl_interp);
 140     }
 141     exit (0);
 142 }
 143 #endif
 144
 145 int simpleserver_clone(void) {
 146 #ifdef USE_ITHREADS
 147      yaz_mutex_enter(simpleserver_mutex);
 148      if (1)
 149      {
 150          PerlInterpreter *current = PERL_GET_CONTEXT;
 151
 152          /* if current is unset, then we're in a new thread with
 153           * no Perl interpreter for it. So we must create one .
 154           * This will only happen when threaded is used..
 155           */
 156          if (!current) {
 157              PerlInterpreter *perl_interp;
 158              PERL_SET_CONTEXT( root_perl_context );
 159              perl_interp = perl_clone(root_perl_context, CLONEf_CLONE_HOST);
 160              PERL_SET_CONTEXT( perl_interp );
 161          }
 162      }
 163      yaz_mutex_leave(simpleserver_mutex);
 164 #endif
 165      return 0;
 166 }
 167
 168
 169 void simpleserver_free(void) {
 170     yaz_mutex_enter(simpleserver_mutex);
 171     if (1)
 172     {
 173         PerlInterpreter *current_interp = PERL_GET_CONTEXT;
 174
 175         /* If current Perl Interp is different from root interp, then
 176          * we're in threaded mode and we must destroy..
 177          */
 178         if (current_interp != root_perl_context) {
 179             PL_perl_destruct_level = 2;
 180             PERL_SET_CONTEXT(current_interp);
 181             perl_destruct(current_interp);
 182             perl_free(current_interp);
 183         }
 184     }
 185     yaz_mutex_leave(simpleserver_mutex);
 186 }
 187
 188
 189 Z_GenericRecord *read_grs1(char *str, ODR o)
 190 {
 191         int type, ivalue;
 192         char line[GRS_BUF_SIZE+1], *buf, *ptr, *original;
 193         char value[GRS_BUF_SIZE+1];
 194         Z_GenericRecord *r = 0;
 195
 196         original = str;
 197         r = (Z_GenericRecord *)odr_malloc(o, sizeof(*r));
 198         r->elements = (Z_TaggedElement **)
 199                 odr_malloc(o, sizeof(Z_TaggedElement*) * GRS_MAX_FIELDS);
 200         r->num_elements = 0;
 201
 202         for (;;)
 203         {
 204                 Z_TaggedElement *t;
 205                 Z_ElementData *c;
 206                 int len;
 207
 208                 ptr = strchr(str, '\n');
 209                 if (!ptr) {
 210                         return r;
 211                 }
 212                 len = ptr - str;
 213                 if (len > GRS_BUF_SIZE) {
 214                     yaz_log(YLOG_WARN, "GRS string too long - truncating (%d > %d)", len, GRS_BUF_SIZE);
 215                     len = GRS_BUF_SIZE;
 216                 }
 217                 strncpy(line, str, len);
 218                 line[len] = 0;
 219                 buf = line;
 220                 str = ptr + 1;
 221                 while (*buf && isspace(*buf))
 222                         buf++;
 223                 if (*buf == '}') {
 224                         memmove(original, str, strlen(str));
 225                         return r;
 226                 }
 227                 if (sscanf(buf, "(%d,%[^)])", &type, value) != 2)
 228                 {
 229                         yaz_log(YLOG_WARN, "Bad data in '%s'", buf);
 230                         return r;
 231                 }
 232                 if (!type && *value == '0')
 233                         return r;
 234                 if (!(buf = strchr(buf, ')')))
 235                         return r;
 236                 buf++;
 237                 while (*buf && isspace(*buf))
 238                         buf++;
 239                 if (r->num_elements >= GRS_MAX_FIELDS)
 240                 {
 241                         yaz_log(YLOG_WARN, "Max number of GRS-1 elements exceeded [GRS_MAX_FIELDS=%d]", GRS_MAX_FIELDS);
 242                         exit(0);
 243                 }
 244                 r->elements[r->num_elements] = t = (Z_TaggedElement *)
 245                         odr_malloc(o, sizeof(Z_TaggedElement));
 246                 t->tagType = odr_intdup(o, type);
 247                 t->tagValue = (Z_StringOrNumeric *)
 248                         odr_malloc(o, sizeof(Z_StringOrNumeric));
 249                 if ((ivalue = atoi(value)))
 250                 {
 251                         t->tagValue->which = Z_StringOrNumeric_numeric;
 252                         t->tagValue->u.numeric = odr_intdup(o, ivalue);
 253                 }
 254                 else
 255                 {
 256                         t->tagValue->which = Z_StringOrNumeric_string;
 257                         t->tagValue->u.string = odr_strdup(o, value);
 258                 }
 259                 t->tagOccurrence = 0;
 260                 t->metaData = 0;
 261                 t->appliedVariant = 0;
 262                 t->content = c = (Z_ElementData *)
 263                         odr_malloc(o, sizeof(Z_ElementData));
 264                 if (*buf == '{')
 265                 {
 266                         c->which = Z_ElementData_subtree;
 267                         c->u.subtree = read_grs1(str, o);
 268                 }
 269                 else
 270                 {
 271                         c->which = Z_ElementData_string;
 272                         c->u.string = odr_strdup(o, buf);
 273                 }
 274                 r->num_elements++;
 275         }
 276 }
 277
 278
 279
 280 static void oid2str(Odr_oid *o, WRBUF buf)
 281 {
 282     for (; *o >= 0; o++) {
 283         char ibuf[16];
 284         sprintf(ibuf, "%d", *o);
 285         wrbuf_puts(buf, ibuf);
 286         if (o[1] > 0)
 287             wrbuf_putc(buf, '.');
 288     }
 289 }
 290
 291 WRBUF oid2dotted(Odr_oid *oid)
 292 {
 293     WRBUF buf = wrbuf_alloc();
 294     oid2str(oid, buf);
 295     return buf;
 296 }
 297
 298
 299 WRBUF zquery2pquery(Z_Query *q)
 300 {
 301     WRBUF buf = wrbuf_alloc();
 302
 303     if (q->which != Z_Query_type_1 && q->which != Z_Query_type_101)
 304         return 0;
 305     yaz_rpnquery_to_wrbuf(buf, q->u.type_1);
 306     return buf;
 307 }
 308
 309
 310 /* Lifted verbatim from Net::Z3950 yazwrap/util.c */
 311 #include <stdarg.h>
 312 void fatal(char *fmt, ...)
 313 {
 314     va_list ap;
 315
 316     fprintf(stderr, "FATAL (SimpleServer): ");
 317     va_start(ap, fmt);
 318     vfprintf(stderr, fmt, ap);
 319     va_end(ap);
 320     fprintf(stderr, "\n");
 321     abort();
 322 }
 323
 324
 325 /* Lifted verbatim from Net::Z3950 yazwrap/receive.c */
 326 /*
 327  * Creates a new Perl object of type `class'; the newly-created scalar
 328  * that is a reference to the blessed thingy `referent' is returned.
 329  */
 330 static SV *newObject(char *class, SV *referent)
 331 {
 332     HV *stash;
 333     SV *sv;
 334
 335     sv = newRV_noinc((SV*) referent);
 336     stash = gv_stashpv(class, 0);
 337     if (stash == 0)
 338         fatal("attempt to create object of undefined class '%s'", class);
 339     /*assert(stash != 0);*/
 340     sv_bless(sv, stash);
 341     return sv;
 342 }
 343
 344
 345 /* Lifted verbatim from Net::Z3950 yazwrap/receive.c */
 346 static void setMember(HV *hv, char *name, SV *val)
 347 {
 348     /* We don't increment `val's reference count -- I think this is
 349      * right because it's created with a refcount of 1, and in fact
 350      * the reference via this hash is the only reference to it in
 351      * general.
 352      */
 353     if (!hv_store(hv, name, (U32) strlen(name), val, (U32) 0))
 354         fatal("couldn't store member in hash");
 355 }
 356
 357
 358 /* Lifted verbatim from Net::Z3950 yazwrap/receive.c */
 359 static SV *translateOID(Odr_oid *x)
 360 {
 361     /* Yaz represents an OID by an int array terminated by a negative
 362      * value, typically -1; we represent it as a reference to a
 363      * blessed scalar string of "."-separated elements.
 364      */
 365     char buf[1000];
 366     int i;
 367
 368     *buf = '\0';
 369     for (i = 0; x[i] >= 0; i++) {
 370         sprintf(buf + strlen(buf), "%d", (int) x[i]);
 371         if (x[i+1] >- 0)
 372             strcat(buf, ".");
 373     }
 374
 375     /*
 376      * ### We'd like to return a blessed scalar (string) here, but of
 377      *  course you can't do that in Perl: only references can be
 378      *  blessed, so we'd have to return a _reference_ to a string, and
 379      *  bless _that_.  Better to do without the blessing, I think.
 380      */
 381     if (1) {
 382         return newSVpv(buf, 0);
 383     } else {
 384         return newObject("Net::Z3950::APDU::OID", newSVpv(buf, 0));
 385     }
 386 }
 387
 388 static SV *attributes2perl(Z_AttributeList *list)
 389 {
 390     AV *av;
 391         int i;
 392         SV *attrs = newObject("Net::Z3950::RPN::Attributes",
 393                               (SV*) (av = newAV()));
 394         for (i = 0; i < list->num_attributes; i++) {
 395             Z_AttributeElement *elem = list->attributes[i];
 396             HV *hv2;
 397             SV *tmp = newObject("Net::Z3950::RPN::Attribute",
 398                                 (SV*) (hv2 = newHV()));
 399             if (elem->attributeSet)
 400                 setMember(hv2, "attributeSet",
 401                           translateOID(elem->attributeSet));
 402             setMember(hv2, "attributeType",
 403                       newSViv(*elem->attributeType));
 404             if (elem->which == Z_AttributeValue_numeric) {
 405                 setMember(hv2, "attributeValue",
 406                           newSViv(*elem->value.numeric));
 407             } else {
 408                 Z_ComplexAttribute *c;
 409                 Z_StringOrNumeric *son;
 410                 assert(elem->which == Z_AttributeValue_complex);
 411                 c = elem->value.complex;
 412                 /* We ignore semantic actions and multiple values */
 413                 assert(c->num_list > 0);
 414                 son = c->list[0];
 415                 if (son->which == Z_StringOrNumeric_numeric) {
 416                     setMember(hv2, "attributeValue",
 417                               newSViv(*son->u.numeric));
 418                 } else { /*Z_StringOrNumeric_string*/
 419                     setMember(hv2, "attributeValue",
 420                               newSVpv(son->u.string, 0));
 421                 }
 422             }
 423             av_push(av, tmp);
 424         }
 425         return attrs;
 426 }
 427
 428 static SV *f_Term_to_SV(Z_Term *term, Z_AttributeList *attributes)
 429 {
 430         HV *hv;
 431         SV *sv = newObject("Net::Z3950::RPN::Term", (SV*) (hv = newHV()));
 432
 433         if (term->which != Z_Term_general)
 434                 fatal("can't handle RPN terms other than general");
 435
 436         setMember(hv, "term", newSVpv((char*) term->u.general->buf,
 437                                   term->u.general->len));
 438
 439         if (attributes) {
 440                 setMember(hv, "attributes", attributes2perl(attributes));
 441         }
 442         return sv;
 443 }
 444
 445 static SV *rpn2perl(Z_RPNStructure *s)
 446 {
 447     SV *sv;
 448     HV *hv;
 449     AV *av;
 450     Z_Operand *o;
 451
 452     switch (s->which) {
 453     case Z_RPNStructure_simple:
 454         o = s->u.simple;
 455         switch (o->which) {
 456         case Z_Operand_resultSetId: {
 457             /* This code causes a SIGBUS on my machine, and I have no
 458                idea why.  It seems as clear as day to me */
 459             SV *sv2;
 460             char *rsid = (char*) o->u.resultSetId;
 461             /*printf("Encoding resultSetId '%s'\n", rsid);*/
 462             sv = newObject("Net::Z3950::RPN::RSID", (SV*) (hv = newHV()));
 463             /*printf("Made sv=0x%lx, hv=0x%lx\n", (unsigned long) sv ,(unsigned long) hv);*/
 464             sv2 = newSVpv(rsid, strlen(rsid));
 465             setMember(hv, "id", sv2);
 466             /*printf("Set hv{id} to 0x%lx\n", (unsigned long) sv2);*/
 467             return sv;
 468         }
 469
 470         case  Z_Operand_APT:
 471             return f_Term_to_SV(o->u.attributesPlusTerm->term,
 472                         o->u.attributesPlusTerm->attributes);
 473         default:
 474             fatal("unknown RPN simple type %d", (int) o->which);
 475         }
 476
 477     case Z_RPNStructure_complex: {
 478         SV *tmp;
 479         Z_Complex *c = s->u.complex;
 480         char *type = 0;         /* vacuous assignment satisfies gcc -Wall */
 481         switch (c->roperator->which) {
 482         case Z_Operator_and:     type = "Net::Z3950::RPN::And";    break;
 483         case Z_Operator_or:      type = "Net::Z3950::RPN::Or";     break;
 484         case Z_Operator_and_not: type = "Net::Z3950::RPN::AndNot"; break;
 485         case Z_Operator_prox:    fatal("proximity not yet supported");
 486         default: fatal("unknown RPN operator %d", (int) c->roperator->which);
 487         }
 488         sv = newObject(type, (SV*) (av = newAV()));
 489         if ((tmp = rpn2perl(c->s1)) == 0)
 490             return 0;
 491         av_push(av, tmp);
 492         if ((tmp = rpn2perl(c->s2)) == 0)
 493             return 0;
 494         av_push(av, tmp);
 495         return sv;
 496     }
 497
 498     default:
 499         fatal("unknown RPN node type %d", (int) s->which);
 500     }
 501
 502     return 0;
 503 }
 504
 505
 506 /* Decode the Z_SortAttributes struct and store the whole thing into the
 507  * hash by reference
 508  */
 509 int simpleserver_ExpandSortAttributes (HV *sort_spec, Z_SortAttributes *sattr)
 510 {
 511     WRBUF attrset_wr = wrbuf_alloc();
 512     AV *list = newAV();
 513     Z_AttributeList *attr_list = sattr->list;
 514     int i;
 515
 516     oid2str(sattr->id, attrset_wr);
 517     hv_store(sort_spec, "ATTRSET", 7,
 518              newSVpv(attrset_wr->buf, attrset_wr->pos), 0);
 519     wrbuf_destroy(attrset_wr);
 520
 521     hv_store(sort_spec, "SORT_ATTR", 9, newRV( sv_2mortal( (SV*) list ) ), 0);
 522
 523     for (i = 0; i < attr_list->num_attributes; i++)
 524     {
 525         Z_AttributeElement *attr = *attr_list->attributes++;
 526         HV *attr_spec = newHV();
 527
 528         av_push(list, newRV( sv_2mortal( (SV*) attr_spec ) ));
 529         hv_store(attr_spec, "ATTR_TYPE", 9, newSViv(*attr->attributeType), 0);
 530
 531         if (attr->which == Z_AttributeValue_numeric)
 532         {
 533             hv_store(attr_spec, "ATTR_VALUE", 10,
 534                      newSViv(*attr->value.numeric), 0);
 535         } else {
 536             return 0;
 537         }
 538     }
 539
 540     return 1;
 541 }
 542
 543
 544 /* Decode the Z_SortKeySpec struct and store the whole thing in a perl hash */
 545 int simpleserver_SortKeySpecToHash (HV *sort_spec, Z_SortKeySpec *spec)
 546 {
 547     Z_SortElement *element = spec->sortElement;
 548
 549     hv_store(sort_spec, "RELATION", 8, newSViv(*spec->sortRelation), 0);
 550     hv_store(sort_spec, "CASE", 4, newSViv(*spec->caseSensitivity), 0);
 551     hv_store(sort_spec, "MISSING", 7, newSViv(spec->which), 0);
 552
 553     if (element->which == Z_SortElement_generic)
 554     {
 555         Z_SortKey *key = element->u.generic;
 556
 557         if (key->which == Z_SortKey_sortField)
 558         {
 559             hv_store(sort_spec, "SORTFIELD", 9,
 560                      newSVpv((char *) key->u.sortField, 0), 0);
 561         }
 562         else if (key->which == Z_SortKey_elementSpec)
 563         {
 564             Z_Specification *zspec = key->u.elementSpec;
 565
 566             hv_store(sort_spec, "ELEMENTSPEC_TYPE", 16,
 567                      newSViv(zspec->which), 0);
 568
 569             if (zspec->which == Z_Schema_oid)
 570             {
 571                 WRBUF elementSpec = wrbuf_alloc();
 572
 573                 oid2str(zspec->schema.oid, elementSpec);
 574                 hv_store(sort_spec, "ELEMENTSPEC_VALUE", 17,
 575                          newSVpv(elementSpec->buf, elementSpec->pos), 0);
 576                 wrbuf_destroy(elementSpec);
 577             }
 578             else if (zspec->which == Z_Schema_uri)
 579             {
 580                 hv_store(sort_spec, "ELEMENTSPEC_VALUE", 17,
 581                          newSVpv((char *) zspec->schema.uri, 0), 0);
 582             }
 583         }
 584         else if (key->which == Z_SortKey_sortAttributes)
 585         {
 586             return simpleserver_ExpandSortAttributes(sort_spec,
 587                                                      key->u.sortAttributes);
 588         }
 589         else
 590         {
 591             return 0;
 592         }
 593     }
 594     else
 595     {
 596         return 0;
 597     }
 598
 599     return 1;
 600 }
 601
 602
 603 static SV *zquery2perl(Z_Query *q)
 604 {
 605     SV *sv;
 606     HV *hv;
 607
 608     if (q->which != Z_Query_type_1 && q->which != Z_Query_type_101)
 609         return 0;
 610     sv = newObject("Net::Z3950::APDU::Query", (SV*) (hv = newHV()));
 611     if (q->u.type_1->attributeSetId)
 612         setMember(hv, "attributeSet",
 613                   translateOID(q->u.type_1->attributeSetId));
 614     setMember(hv, "query", rpn2perl(q->u.type_1->RPNStructure));
 615     return sv;
 616 }
 617
 618
 619 int bend_sort(void *handle, bend_sort_rr *rr)
 620 {
 621         HV *href;
 622         AV *aref;
 623         AV *sort_seq;
 624         SV **temp;
 625         SV *err_code;
 626         SV *err_str;
 627         SV *status;
 628         SV *point;
 629         STRLEN len;
 630         char *ptr;
 631         char **input_setnames;
 632         Zfront_handle *zhandle = (Zfront_handle *)handle;
 633         Z_SortKeySpecList *sort_spec = rr->sort_sequence;
 634         int i;
 635
 636         dSP;
 637         ENTER;
 638         SAVETMPS;
 639
 640         aref = newAV();
 641         input_setnames = rr->input_setnames;
 642         for (i = 0; i < rr->num_input_setnames; i++)
 643         {
 644             av_push(aref, newSVpv(*input_setnames++, 0));
 645         }
 646
 647         sort_seq = newAV();
 648         for (i = 0; i < sort_spec->num_specs; i++)
 649         {
 650             Z_SortKeySpec *spec = *sort_spec->specs++;
 651             HV *sort_spec = newHV();
 652
 653             if ( simpleserver_SortKeySpecToHash(sort_spec, spec) )
 654                 av_push(sort_seq, newRV( sv_2mortal( (SV*) sort_spec ) ));
 655             else
 656             {
 657                 rr->errcode = 207;
 658                 return 0;
 659             }
 660         }
 661
 662         href = newHV();
 663         hv_store(href, "INPUT", 5, newRV( (SV*) aref), 0);
 664         hv_store(href, "OUTPUT", 6, newSVpv(rr->output_setname, 0), 0);
 665         hv_store(href, "SEQUENCE", 8, newRV( (SV*) sort_seq), 0);
 666         hv_store(href, "GHANDLE", 7, newSVsv(zhandle->ghandle), 0);
 667         hv_store(href, "HANDLE", 6, zhandle->handle, 0);
 668         hv_store(href, "STATUS", 6, newSViv(0), 0);
 669         hv_store(href, "ERR_CODE", 8, newSViv(0), 0);
 670         hv_store(href, "ERR_STR", 7, newSVpv("", 0), 0);
 671
 672         PUSHMARK(sp);
 673
 674         XPUSHs(sv_2mortal(newRV( (SV*) href)));
 675
 676         PUTBACK;
 677
 678         perl_call_sv(sort_ref, G_SCALAR | G_DISCARD);
 679
 680         SPAGAIN;
 681
 682         temp = hv_fetch(href, "ERR_CODE", 8, 1);
 683         err_code = newSVsv(*temp);
 684
 685         temp = hv_fetch(href, "ERR_STR", 7, 1);
 686         err_str = newSVsv(*temp);
 687
 688         temp = hv_fetch(href, "STATUS", 6, 1);
 689         status = newSVsv(*temp);
 690
 691         temp = hv_fetch(href, "HANDLE", 6, 1);
 692         point = newSVsv(*temp);
 693
 694         hv_undef(href);
 695         av_undef(aref);
 696         av_undef(sort_seq);
 697
 698         sv_free( (SV*) aref);
 699         sv_free( (SV*) href);
 700         sv_free( (SV*) sort_seq);
 701
 702         rr->errcode = SvIV(err_code);
 703         rr->sort_status = SvIV(status);
 704
 705         ptr = SvPV(err_str, len);
 706         rr->errstring = odr_strdupn(rr->stream, ptr, len);
 707         zhandle->handle = point;
 708
 709         sv_free(err_code);
 710         sv_free(err_str);
 711         sv_free(status);
 712
 713         PUTBACK;
 714         FREETMPS;
 715         LEAVE;
 716
 717         return 0;
 718 }
 719
 720 static SV *f_FacetField_to_SV(Z_FacetField *facet_field)
 721 {
 722         HV *hv;
 723         AV *av;
 724         SV *terms;
 725         int i;
 726         SV *sv = newObject("Net::Z3950::FacetField", (SV *) (hv = newHV()));
 727         if (facet_field->attributes) {
 728                 setMember(hv, "attributes",
 729                      attributes2perl(facet_field->attributes));
 730         }
 731         terms = newObject("Net::Z3950::FacetTerms", (SV *) (av = newAV()));
 732
 733         for (i = 0; i < facet_field->num_terms; i++) {
 734             Z_Term *z_term = facet_field->terms[i]->term;
 735             HV *hv;
 736             SV *sv_count = newSViv(*facet_field->terms[i]->count);
 737             SV *sv_term;
 738             SV *tmp;
 739             if (z_term->which == Z_Term_general) {
 740                 sv_term = newSVpv((char*) z_term->u.general->buf,
 741                                    z_term->u.general->len);
 742             } else if (z_term->which == Z_Term_characterString) {
 743                 sv_term = newSVpv(z_term->u.characterString,
 744                                   strlen(z_term->u.characterString));
 745             }
 746             tmp = newObject("Net::Z3950::FacetTerm", (SV *) (hv = newHV()));
 747
 748             setMember(hv, "count", sv_count);
 749             setMember(hv, "term", sv_term);
 750
 751             av_push(av, tmp);
 752         }
 753         setMember(hv, "terms", terms);
 754         return sv;
 755 }
 756
 757 static SV *f_FacetList_to_SV(Z_FacetList *facet_list)
 758 {
 759         SV *sv = 0;
 760         if (facet_list) {
 761                 AV *av;
 762                 int i;
 763                 sv = newObject("Net::Z3950::FacetList", (SV *) (av = newAV()));
 764
 765                 for (i = 0; i < facet_list->num; i++) {
 766                        SV *sv = f_FacetField_to_SV(facet_list->elements[i]);
 767                        av_push(av, sv);
 768                 }
 769         }
 770         return sv;
 771 }
 772
 773
 774 static void f_SV_to_FacetField(HV *facet_field_hv, Z_FacetField **fl, ODR odr)
 775 {
 776         int i;
 777         int num_terms, num_attributes;
 778         SV **temp;
 779         Z_AttributeList *attributes = odr_malloc(odr, sizeof(*attributes));
 780
 781         AV *sv_terms, *sv_attributes;
 782
 783         temp = hv_fetch(facet_field_hv, "attributes", 10, 1);
 784         sv_attributes = (AV *) SvRV(*temp);
 785         num_attributes = av_len(sv_attributes) + 1;
 786         attributes->num_attributes = num_attributes;
 787         attributes->attributes = (Z_AttributeElement **)
 788              odr_malloc(odr, sizeof(*attributes->attributes) * num_attributes);
 789
 790         for (i = 0; i < num_attributes; i++) {
 791             HV *hv_elem = (HV*) SvRV(sv_2mortal(av_shift(sv_attributes)));
 792             Z_AttributeElement *elem;
 793             elem = (Z_AttributeElement *) odr_malloc(odr, sizeof(*elem));
 794             attributes->attributes[i] = elem;
 795
 796             elem->attributeSet = 0;
 797
 798             temp = hv_fetch(hv_elem, "attributeType", 13, 1);
 799             elem->attributeType = odr_intdup(odr, SvIV(*temp));
 800
 801             temp = hv_fetch(hv_elem, "attributeValue", 14, 1);
 802
 803             if (SvIOK(*temp)) {
 804                     elem->which = Z_AttributeValue_numeric;
 805                     elem->value.numeric = odr_intdup(odr, SvIV(*temp));
 806             } else {
 807                     STRLEN s_len;
 808                     char *s_buf = SvPV(*temp, s_len);
 809                     Z_ComplexAttribute *c = odr_malloc(odr, sizeof *c);
 810                     elem->which = Z_AttributeValue_complex;
 811                     elem->value.complex = c;
 812
 813                     c->num_list = 1;
 814                     c->list = (Z_StringOrNumeric **) odr_malloc(odr,
 815                           sizeof(*c->list));
 816                     c->list[0] = (Z_StringOrNumeric *) odr_malloc(odr,
 817                           sizeof(**c->list));
 818                     c->list[0]->which = Z_StringOrNumeric_string;
 819                     c->list[0]->u.string = odr_strdupn(odr, s_buf, s_len);
 820                     c->num_semanticAction = 0;
 821                     c->semanticAction = 0;
 822             }
 823             hv_undef(hv_elem);
 824         }
 825
 826         temp = hv_fetch(facet_field_hv, "terms", 5, 1);
 827
 828         sv_terms = (AV *) SvRV(*temp);
 829         if (SvTYPE(sv_terms) == SVt_PVAV) {
 830             num_terms = av_len(sv_terms) + 1;
 831         } else {
 832             num_terms = 0;
 833         }
 834         *fl = facet_field_create(odr, attributes, num_terms);
 835         for (i = 0; i < num_terms; i++) {
 836             STRLEN s_len;
 837             char *s_buf;
 838             HV *hv_elem = (HV*) SvRV(sv_2mortal(av_shift(sv_terms)));
 839
 840             Z_FacetTerm *facet_term =
 841              (Z_FacetTerm *) odr_malloc(odr, sizeof(*facet_term));
 842             (*fl)->terms[i] = facet_term;
 843
 844             temp = hv_fetch(hv_elem, "count", 5, 1);
 845             facet_term->count = odr_intdup(odr, SvIV(*temp));
 846
 847             temp = hv_fetch(hv_elem, "term", 4, 1);
 848
 849             s_buf = SvPV(*temp, s_len);
 850             facet_term->term = z_Term_create(odr, Z_Term_general, s_buf, s_len);
 851             hv_undef(hv_elem);
 852         }
 853 }
 854
 855 static void f_SV_to_FacetList(SV *sv, Z_OtherInformation **oip, ODR odr)
 856 {
 857         AV *entries = (AV *) SvRV(sv);
 858         int num_facets;
 859         if (entries && SvTYPE(entries) == SVt_PVAV &&
 860                 (num_facets = av_len(entries) + 1) > 0)
 861         {
 862             Z_OtherInformation *oi;
 863             Z_OtherInformationUnit *oiu;
 864             Z_FacetList *facet_list = facet_list_create(odr, num_facets);
 865             int i;
 866             for (i = 0; i < num_facets; i++) {
 867                 HV *facet_field = (HV*) SvRV(sv_2mortal(av_shift(entries)));
 868                 f_SV_to_FacetField(facet_field, &facet_list->elements[i], odr);
 869                 hv_undef(facet_field);
 870             }
 871             oi = odr_malloc(odr, sizeof(*oi));
 872             oiu = odr_malloc(odr, sizeof(*oiu));
 873             oi->num_elements = 1;
 874             oi->list = odr_malloc(odr, oi->num_elements * sizeof(*oi->list));
 875             oiu->category = 0;
 876             oiu->which = Z_OtherInfo_externallyDefinedInfo;
 877             oiu->information.externallyDefinedInfo = odr_malloc(odr, sizeof(*oiu->information.externallyDefinedInfo));
 878             oiu->information.externallyDefinedInfo->direct_reference = odr_oiddup(odr, yaz_oid_userinfo_facet_1);
 879             oiu->information.externallyDefinedInfo->descriptor = 0;
 880             oiu->information.externallyDefinedInfo->indirect_reference = 0;
 881             oiu->information.externallyDefinedInfo->which = Z_External_userFacets;
 882             oiu->information.externallyDefinedInfo->u.facetList = facet_list;
 883             oi->list[0] = oiu;
 884             *oip = oi;
 885         }
 886 }
 887
 888 static HV *parse_extra_args(Z_SRW_extra_arg *args)
 889 {
 890         HV *href = newHV();
 891
 892         for (; args; args = args->next)
 893         {
 894                 hv_store(href, args->name, strlen(args->name),
 895                         newSVpv(args->value, 0), 0);
 896         }
 897         return href;
 898 }
 899
 900 int bend_search(void *handle, bend_search_rr *rr)
 901 {
 902         HV *href;
 903         AV *aref;
 904         SV **temp;
 905         int i;
 906         char **basenames;
 907         WRBUF query;
 908         SV *point;
 909         Zfront_handle *zhandle = (Zfront_handle *)handle;
 910         CV* handler_cv = 0;
 911         SV *rpnSV;
 912         SV *facetSV;
 913         char *ptr;
 914         STRLEN len;
 915
 916         dSP;
 917         ENTER;
 918         SAVETMPS;
 919
 920         aref = newAV();
 921         basenames = rr->basenames;
 922         for (i = 0; i < rr->num_bases; i++)
 923         {
 924                 av_push(aref, newSVpv(*basenames++, 0));
 925         }
 926 #if ENABLE_STOP_SERVER
 927         if (rr->num_bases == 1 && !strcmp(rr->basenames[0], "XXstop"))
 928         {
 929                 zhandle->stop_flag = 1;
 930         }
 931 #endif
 932         href = newHV();
 933
 934         hv_store(href, "SETNAME", 7, newSVpv(rr->setname, 0), 0);
 935         if (rr->srw_sortKeys && *rr->srw_sortKeys)
 936             hv_store(href, "SRW_SORTKEYS", 12, newSVpv(rr->srw_sortKeys, 0), 0);
 937         hv_store(href, "REPL_SET", 8, newSViv(rr->replace_set), 0);
 938         hv_store(href, "ERR_CODE", 8, newSViv(0), 0);
 939         hv_store(href, "ERR_STR", 7, newSVpv("", 0), 0);
 940         hv_store(href, "HITS", 4, newSViv(0), 0);
 941         hv_store(href, "DATABASES", 9, newRV( (SV*) aref), 0);
 942         hv_store(href, "GHANDLE", 7, newSVsv(zhandle->ghandle), 0);
 943         hv_store(href, "HANDLE", 6, zhandle->handle, 0);
 944         hv_store(href, "PID", 3, newSViv(getpid()), 0);
 945         hv_store(href, "PRESENT_NUMBER", 14, newSViv(rr->present_number), 0);
 946         hv_store(href, "EXTRA_ARGS", 10,
 947                 newRV( (SV*) parse_extra_args(rr->extra_args)), 0);
 948         if ((rpnSV = zquery2perl(rr->query)) != 0) {
 949             hv_store(href, "RPN", 3, rpnSV, 0);
 950         }
 951         facetSV = f_FacetList_to_SV(yaz_oi_get_facetlist(&rr->search_input));
 952         if (facetSV) {
 953             hv_store(href, "INPUTFACETS", 11, facetSV, 0);
 954         }
 955
 956         query = zquery2pquery(rr->query);
 957         if (query)
 958         {
 959                 hv_store(href, "QUERY", 5, newSVpv((char *)query->buf, query->pos), 0);
 960         }
 961         else if (rr->query->which == Z_Query_type_104 &&
 962                  rr->query->u.type_104->which == Z_External_CQL) {
 963             hv_store(href, "CQL", 3,
 964                      newSVpv(rr->query->u.type_104->u.cql, 0), 0);
 965         }
 966         else
 967         {
 968                 rr->errcode = 108;
 969                 return 0;
 970         }
 971         PUSHMARK(sp);
 972
 973         XPUSHs(sv_2mortal(newRV( (SV*) href)));
 974
 975         PUTBACK;
 976
 977         handler_cv = simpleserver_sv2cv( search_ref );
 978         perl_call_sv( (SV *) handler_cv, G_SCALAR | G_DISCARD);
 979
 980         SPAGAIN;
 981
 982         temp = hv_fetch(href, "HITS", 4, 1);
 983         rr->hits = SvIV(*temp);
 984
 985         temp = hv_fetch(href, "ERR_CODE", 8, 1);
 986         rr->errcode = SvIV(*temp);
 987
 988         temp = hv_fetch(href, "ERR_STR", 7, 1);
 989         rr->errstring = string_or_undef(temp, rr->stream);
 990
 991         temp = hv_fetch(href, "HANDLE", 6, 1);
 992         point = newSVsv(*temp);
 993
 994         temp = hv_fetch(href, "OUTPUTFACETS", 12, 1);
 995         if (SvTYPE(*temp) != SVt_NULL)
 996             f_SV_to_FacetList(*temp, &rr->search_info, rr->stream);
 997
 998         temp = hv_fetch(href, "EXTRA_RESPONSE_DATA", 19, 0);
 999         if (temp)
1000         {
1001                 ptr = SvPV(*temp, len);
1002                 rr->extra_response_data = odr_strdupn(rr->stream, ptr, len);
1003         }
1004
1005         temp = hv_fetch(href, "ESTIMATED" "_HIT_" "COUNT", 19, 0);
1006         if (temp)
1007         {
1008                 rr->estimated_hit_count = SvIV(*temp);
1009         }
1010         hv_undef(href);
1011         av_undef(aref);
1012
1013         zhandle->handle = point;
1014         sv_free( (SV*) aref);
1015         sv_free( (SV*) href);
1016         if (query)
1017             wrbuf_destroy(query);
1018         PUTBACK;
1019         FREETMPS;
1020         LEAVE;
1021         return 0;
1022 }
1023
1024
1025 /* ### I am not 100% about the memory management in this handler */
1026 int bend_delete(void *handle, bend_delete_rr *rr)
1027 {
1028         Zfront_handle *zhandle = (Zfront_handle *)handle;
1029         HV *href;
1030         CV* handler_cv;
1031         int i;
1032         SV **temp;
1033         SV *point;
1034
1035         dSP;
1036         ENTER;
1037         SAVETMPS;
1038
1039         href = newHV();
1040         hv_store(href, "GHANDLE", 7, newSVsv(zhandle->ghandle), 0);
1041         hv_store(href, "HANDLE", 6, zhandle->handle, 0);
1042         hv_store(href, "STATUS", 6, newSViv(0), 0);
1043
1044         PUSHMARK(sp);
1045         XPUSHs(sv_2mortal(newRV( (SV*) href)));
1046         PUTBACK;
1047
1048         handler_cv = simpleserver_sv2cv(delete_ref);
1049
1050         if (rr->function == 1) {
1051             /* Delete all result sets in the session */
1052             perl_call_sv( (SV *) handler_cv, G_SCALAR | G_DISCARD);
1053             temp = hv_fetch(href, "STATUS", 6, 1);
1054             rr->delete_status = SvIV(*temp);
1055         } else {
1056             rr->delete_status = 0;
1057             /*
1058              * For some reason, deleting two or more result-sets in
1059              * one operation goes horribly wrong, and ### I don't have
1060              * time to debug it right now.
1061              */
1062             if (rr->num_setnames > 1) {
1063                 rr->delete_status = 3; /* "System problem at target" */
1064                 /* There's no way to sent delete-msg using the GFS */
1065                 return 0;
1066             }
1067
1068             for (i = 0; i < rr->num_setnames; i++) {
1069                 hv_store(href, "SETNAME", 7, newSVpv(rr->setnames[i], 0), 0);
1070                 perl_call_sv( (SV *) handler_cv, G_SCALAR | G_DISCARD);
1071                 temp = hv_fetch(href, "STATUS", 6, 1);
1072                 rr->statuses[i] = SvIV(*temp);
1073                 if (rr->statuses[i] != 0)
1074                     rr->delete_status = rr->statuses[i];
1075             }
1076         }
1077
1078         SPAGAIN;
1079
1080         temp = hv_fetch(href, "HANDLE", 6, 1);
1081         point = newSVsv(*temp);
1082
1083         hv_undef(href);
1084
1085         zhandle->handle = point;
1086
1087         sv_free( (SV*) href);
1088
1089         PUTBACK;
1090         FREETMPS;
1091         LEAVE;
1092
1093         return 0;
1094 }
1095
1096
1097 int bend_fetch(void *handle, bend_fetch_rr *rr)
1098 {
1099         HV *href;
1100         SV **temp;
1101         SV *basename;
1102         SV *last;
1103         SV *err_code;
1104         SV *err_string;
1105         SV *sur_flag;
1106         SV *point;
1107         SV *rep_form;
1108         SV *schema = 0;
1109         char *ptr;
1110         WRBUF oid_dotted;
1111         Zfront_handle *zhandle = (Zfront_handle *)handle;
1112         CV* handler_cv = 0;
1113
1114         Z_RecordComposition *composition;
1115         Z_ElementSetNames *simple;
1116         Z_CompSpec *complex;
1117         STRLEN length;
1118
1119         dSP;
1120         ENTER;
1121         SAVETMPS;
1122
1123         rr->errcode = 0;
1124         href = newHV();
1125         hv_store(href, "SETNAME", 7, newSVpv(rr->setname, 0), 0);
1126         if (rr->schema)
1127                 hv_store(href, "SCHEMA", 6, newSVpv(rr->schema, 0), 0);
1128         else
1129                 hv_store(href, "SCHEMA", 6, newSVpv("", 0), 0);
1130
1131         temp = hv_store(href, "OFFSET", 6, newSViv(rr->number), 0);
1132         if (rr->request_format != 0) {
1133             oid_dotted = oid2dotted(rr->request_format);
1134         } else {
1135             /* Probably an SRU request: assume XML is required */
1136             oid_dotted = wrbuf_alloc();
1137             wrbuf_puts(oid_dotted, "1.2.840.10003.5.109.10");
1138         }
1139         hv_store(href, "REQ_FORM", 8, newSVpv((char *)oid_dotted->buf, oid_dotted->pos), 0);
1140         hv_store(href, "REP_FORM", 8, newSVpv((char *)oid_dotted->buf, oid_dotted->pos), 0);
1141         hv_store(href, "BASENAME", 8, newSVpv("", 0), 0);
1142         hv_store(href, "LAST", 4, newSViv(0), 0);
1143         hv_store(href, "ERR_CODE", 8, newSViv(0), 0);
1144         hv_store(href, "ERR_STR", 7, newSVpv("", 0), 0);
1145         hv_store(href, "SUR_FLAG", 8, newSViv(0), 0);
1146         hv_store(href, "GHANDLE", 7, newSVsv(zhandle->ghandle), 0);
1147         hv_store(href, "HANDLE", 6, zhandle->handle, 0);
1148         hv_store(href, "PID", 3, newSViv(getpid()), 0);
1149         if (rr->comp)
1150         {
1151                 composition = rr->comp;
1152                 if (composition->which == Z_RecordComp_simple)
1153                 {
1154                         simple = composition->u.simple;
1155                         if (simple->which == Z_ElementSetNames_generic)
1156                         {
1157                                 hv_store(href, "COMP", 4, newSVpv(simple->u.generic, 0), 0);
1158                         }
1159                         else
1160                         {
1161                                 rr->errcode = 26;
1162                                 rr->errstring = odr_strdup(rr->stream, "non-generic 'simple' composition");
1163                                 return 0;
1164                         }
1165                 }
1166                 else if (composition->which == Z_RecordComp_complex)
1167                 {
1168                         if (composition->u.complex->generic &&
1169
1170                                         composition->u.complex->generic &&
1171                                         composition->u.complex->generic->elementSpec &&
1172                                         composition->u.complex->generic->elementSpec->which ==
1173                                         Z_ElementSpec_elementSetName)
1174                         {
1175                                 complex = composition->u.complex;
1176                                 hv_store(href, "COMP", 4,
1177                                         newSVpv(complex->generic->elementSpec->u.elementSetName, 0), 0);
1178                         }
1179                         else
1180                         {
1181 #if 0   /* For now ignore this error, which is ubiquitous in SRU */
1182                                 rr->errcode = 26;
1183                                 rr->errstring = odr_strdup(rr->stream, "'complex' composition is not generic ESN");
1184                                 return 0;
1185 #endif /*0*/
1186                         }
1187                 }
1188                 else
1189                 {
1190                         rr->errcode = 26;
1191                         rr->errstring = odr_strdup(rr->stream, "composition neither simple nor complex");
1192                         return 0;
1193                 }
1194         }
1195
1196         PUSHMARK(sp);
1197
1198         XPUSHs(sv_2mortal(newRV( (SV*) href)));
1199
1200         PUTBACK;
1201
1202         handler_cv = simpleserver_sv2cv( fetch_ref );
1203         perl_call_sv( (SV *) handler_cv, G_SCALAR | G_DISCARD);
1204
1205         SPAGAIN;
1206
1207         temp = hv_fetch(href, "BASENAME", 8, 1);
1208         basename = newSVsv(*temp);
1209
1210
1211         temp = hv_fetch(href, "LAST", 4, 1);
1212         last = newSVsv(*temp);
1213
1214         temp = hv_fetch(href, "ERR_CODE", 8, 1);
1215         err_code = newSVsv(*temp);
1216
1217         temp = hv_fetch(href, "ERR_STR", 7, 1),
1218         err_string = newSVsv(*temp);
1219
1220         temp = hv_fetch(href, "SUR_FLAG", 8, 1);
1221         sur_flag = newSVsv(*temp);
1222
1223         temp = hv_fetch(href, "REP_FORM", 8, 1);
1224         rep_form = newSVsv(*temp);
1225
1226         temp = hv_fetch(href, "SCHEMA", 6, 0);
1227         if (temp != 0)
1228         {
1229                 schema = newSVsv(*temp);
1230                 ptr = SvPV(schema, length);
1231                 if (length > 0)
1232                         rr->schema = odr_strdupn(rr->stream, ptr, length);
1233         }
1234
1235         temp = hv_fetch(href, "HANDLE", 6, 1);
1236         point = newSVsv(*temp);
1237
1238         ptr = SvPV(basename, length);
1239         rr->basename = odr_strdupn(rr->stream, ptr, length);
1240
1241         ptr = SvPV(rep_form, length);
1242
1243         rr->output_format = yaz_string_to_oid_odr(yaz_oid_std(),
1244                                         CLASS_RECSYN, ptr, rr->stream);
1245         if (!rr->output_format)
1246         {
1247                 printf("Net::Z3950::SimpleServer: WARNING: Bad OID %s\n", ptr);
1248                 rr->output_format =
1249                         odr_oiddup(rr->stream, yaz_oid_recsyn_sutrs);
1250         }
1251         temp = hv_fetch(href, "RECORD", 6, 0);
1252         if (temp)
1253         {
1254                 SV *record = newSVsv(*temp);
1255                 ptr = SvPV(record, length);
1256                 /* Treat GRS-1 records separately */
1257                 if (!oid_oidcmp(rr->output_format, yaz_oid_recsyn_grs_1))
1258                 {
1259                         rr->record = (char *) read_grs1(ptr, rr->stream);
1260                         rr->len = -1;
1261                 }
1262                 else
1263                 {
1264                         rr->record = odr_strdupn(rr->stream, ptr, length);
1265                         rr->len = length;
1266                 }
1267                 sv_free(record);
1268         }
1269         hv_undef(href);
1270
1271         zhandle->handle = point;
1272         handle = zhandle;
1273         rr->last_in_set = SvIV(last);
1274
1275         if (!(rr->errcode))
1276         {
1277                 rr->errcode = SvIV(err_code);
1278                 ptr = SvPV(err_string, length);
1279                 rr->errstring = odr_strdupn(rr->stream, ptr, length);
1280         }
1281         rr->surrogate_flag = SvIV(sur_flag);
1282
1283         wrbuf_destroy(oid_dotted);
1284         sv_free((SV*) href);
1285         sv_free(basename);
1286         sv_free(last);
1287         sv_free(err_string);
1288         sv_free(err_code),
1289         sv_free(sur_flag);
1290         sv_free(rep_form);
1291
1292         if (schema)
1293                 sv_free(schema);
1294
1295         PUTBACK;
1296         FREETMPS;
1297         LEAVE;
1298
1299         return 0;
1300 }
1301
1302
1303 int bend_present(void *handle, bend_present_rr *rr)
1304 {
1305         HV *href;
1306         SV **temp;
1307         SV *err_code;
1308         SV *err_string;
1309         SV *point;
1310         STRLEN len;
1311         Z_RecordComposition *composition;
1312         Z_ElementSetNames *simple;
1313         Z_CompSpec *complex;
1314         char *ptr;
1315         Zfront_handle *zhandle = (Zfront_handle *)handle;
1316         CV* handler_cv = 0;
1317
1318 /*      WRBUF oid_dotted; */
1319
1320         dSP;
1321         ENTER;
1322         SAVETMPS;
1323
1324         href = newHV();
1325         hv_store(href, "GHANDLE", 7, newSVsv(zhandle->ghandle), 0);
1326         hv_store(href, "HANDLE", 6, zhandle->handle, 0);
1327         hv_store(href, "ERR_CODE", 8, newSViv(0), 0);
1328         hv_store(href, "ERR_STR", 7, newSVpv("", 0), 0);
1329         hv_store(href, "START", 5, newSViv(rr->start), 0);
1330         hv_store(href, "SETNAME", 7, newSVpv(rr->setname, 0), 0);
1331         hv_store(href, "NUMBER", 6, newSViv(rr->number), 0);
1332         /*oid_dotted = oid2dotted(rr->request_format_raw);
1333         hv_store(href, "REQ_FORM", 8, newSVpv((char *)oid_dotted->buf, oid_dotted->pos), 0);*/
1334         hv_store(href, "PID", 3, newSViv(getpid()), 0);
1335         if (rr->comp)
1336         {
1337                 composition = rr->comp;
1338                 if (composition->which == Z_RecordComp_simple)
1339                 {
1340                         simple = composition->u.simple;
1341                         if (simple->which == Z_ElementSetNames_generic)
1342                         {
1343                                 hv_store(href, "COMP", 4, newSVpv(simple->u.generic, 0), 0);
1344                         }
1345                         else
1346                         {
1347                                 rr->errcode = 26;
1348                                 rr->errstring = odr_strdup(rr->stream, "non-generic 'simple' composition");
1349                                 return 0;
1350                         }
1351                 }
1352                 else if (composition->which == Z_RecordComp_complex)
1353                 {
1354                         if (composition->u.complex->generic &&
1355
1356                                         composition->u.complex->generic &&
1357                                         composition->u.complex->generic->elementSpec &&
1358                                         composition->u.complex->generic->elementSpec->which ==
1359                                         Z_ElementSpec_elementSetName)
1360                         {
1361                                 complex = composition->u.complex;
1362                                 hv_store(href, "COMP", 4,
1363                                         newSVpv(complex->generic->elementSpec->u.elementSetName, 0), 0);
1364                         }
1365                         else
1366                         {
1367                                 rr->errcode = 26;
1368                                 rr->errstring = odr_strdup(rr->stream, "'complex' composition is not generic ESN");
1369                                 return 0;
1370                         }
1371                 }
1372                 else
1373                 {
1374                         rr->errcode = 26;
1375                         rr->errstring = odr_strdup(rr->stream, "composition neither simple nor complex");
1376                         return 0;
1377                 }
1378         }
1379
1380         PUSHMARK(sp);
1381
1382         XPUSHs(sv_2mortal(newRV( (SV*) href)));
1383
1384         PUTBACK;
1385
1386         handler_cv = simpleserver_sv2cv( present_ref );
1387         perl_call_sv( (SV *) handler_cv, G_SCALAR | G_DISCARD);
1388
1389         SPAGAIN;
1390
1391         temp = hv_fetch(href, "ERR_CODE", 8, 1);
1392         err_code = newSVsv(*temp);
1393
1394         temp = hv_fetch(href, "ERR_STR", 7, 1);
1395         err_string = newSVsv(*temp);
1396
1397         temp = hv_fetch(href, "HANDLE", 6, 1);
1398         point = newSVsv(*temp);
1399
1400         PUTBACK;
1401         FREETMPS;
1402         LEAVE;
1403
1404         hv_undef(href);
1405         rr->errcode = SvIV(err_code);
1406
1407         ptr = SvPV(err_string, len);
1408         rr->errstring = odr_strdupn(rr->stream, ptr, len);
1409 /*      wrbuf_free(oid_dotted, 1);*/
1410         zhandle->handle = point;
1411         handle = zhandle;
1412         sv_free(err_code);
1413         sv_free(err_string);
1414         sv_free( (SV*) href);
1415
1416         return 0;
1417 }
1418
1419
1420 int bend_esrequest(void *handle, bend_esrequest_rr *rr)
1421 {
1422         perl_call_sv(esrequest_ref, G_VOID | G_DISCARD | G_NOARGS);
1423         return 0;
1424 }
1425
1426
1427 int bend_scan(void *handle, bend_scan_rr *rr)
1428 {
1429         HV *href;
1430         AV *aref;
1431         AV *list;
1432         AV *entries;
1433         HV *scan_item;
1434         struct scan_entry *buffer;
1435         int *step_size = rr->step_size;
1436         int scan_list_size = rr->num_entries;
1437         int i;
1438         char **basenames;
1439         SV **temp;
1440         SV *err_code = sv_newmortal();
1441         SV *err_str = sv_newmortal();
1442         SV *point = sv_newmortal();
1443         SV *status = sv_newmortal();
1444         SV *number = sv_newmortal();
1445         char *ptr;
1446         STRLEN len;
1447         SV *entries_ref;
1448         Zfront_handle *zhandle = (Zfront_handle *)handle;
1449         CV* handler_cv = 0;
1450         SV *rpnSV;
1451
1452         dSP;
1453         ENTER;
1454         SAVETMPS;
1455         href = newHV();
1456         list = newAV();
1457
1458         /* RPN is better than TERM since it includes attributes */
1459         if ((rpnSV = f_Term_to_SV(rr->term->term, rr->term->attributes)) != 0) {
1460             setMember(href, "RPN", rpnSV);
1461         }
1462
1463         if (rr->term->term->which == Z_Term_general)
1464         {
1465                 Odr_oct *oterm = rr->term->term->u.general;
1466                 hv_store(href, "TERM", 4, newSVpv((char*) oterm->buf,
1467                         oterm->len), 0);
1468         } else {
1469                 rr->errcode = 229;      /* Unsupported term type */
1470                 return 0;
1471         }
1472         hv_store(href, "STEP", 4, newSViv(*step_size), 0);
1473         hv_store(href, "NUMBER", 6, newSViv(rr->num_entries), 0);
1474         hv_store(href, "POS", 3, newSViv(rr->term_position), 0);
1475         hv_store(href, "ERR_CODE", 8, newSViv(0), 0);
1476         hv_store(href, "ERR_STR", 7, newSVpv("", 0), 0);
1477         hv_store(href, "GHANDLE", 7, newSVsv(zhandle->ghandle), 0);
1478         hv_store(href, "HANDLE", 6, zhandle->handle, 0);
1479         hv_store(href, "STATUS", 6, newSViv(BEND_SCAN_SUCCESS), 0);
1480         hv_store(href, "ENTRIES", 7, newRV((SV *) list), 0);
1481         hv_store(href, "EXTRA_ARGS", 10,
1482                 newRV( (SV*) parse_extra_args(rr->extra_args)), 0);
1483         aref = newAV();
1484         basenames = rr->basenames;
1485         for (i = 0; i < rr->num_bases; i++)
1486         {
1487                 av_push(aref, newSVpv(*basenames++, 0));
1488         }
1489         hv_store(href, "DATABASES", 9, newRV( (SV*) aref), 0);
1490
1491         PUSHMARK(sp);
1492
1493         XPUSHs(sv_2mortal(newRV( (SV*) href)));
1494
1495         PUTBACK;
1496
1497         handler_cv = simpleserver_sv2cv( scan_ref );
1498         perl_call_sv( (SV *) handler_cv, G_SCALAR | G_DISCARD);
1499
1500         SPAGAIN;
1501
1502         temp = hv_fetch(href, "ERR_CODE", 8, 1);
1503         err_code = newSVsv(*temp);
1504
1505         temp = hv_fetch(href, "ERR_STR", 7, 1);
1506         err_str = newSVsv(*temp);
1507
1508         temp = hv_fetch(href, "HANDLE", 6, 1);
1509         point = newSVsv(*temp);
1510
1511         temp = hv_fetch(href, "STATUS", 6, 1);
1512         status = newSVsv(*temp);
1513
1514         temp = hv_fetch(href, "NUMBER", 6, 1);
1515         number = newSVsv(*temp);
1516
1517         temp = hv_fetch(href, "ENTRIES", 7, 1);
1518         entries_ref = newSVsv(*temp);
1519
1520         temp = hv_fetch(href, "EXTRA_RESPONSE_DATA", 19, 0);
1521         if (temp)
1522         {
1523                 ptr = SvPV(*temp, len);
1524                 rr->extra_response_data = odr_strdupn(rr->stream, ptr, len);
1525         }
1526
1527         PUTBACK;
1528         FREETMPS;
1529         LEAVE;
1530
1531         ptr = SvPV(err_str, len);
1532         rr->errstring = odr_strdupn(rr->stream, ptr, len);
1533         rr->errcode = SvIV(err_code);
1534         rr->num_entries = SvIV(number);
1535         rr->status = SvIV(status);
1536         buffer = rr->entries;
1537         entries = (AV *)SvRV(entries_ref);
1538         if (rr->errcode == 0) for (i = 0; i < rr->num_entries; i++)
1539         {
1540                 scan_item = (HV *)SvRV(sv_2mortal(av_shift(entries)));
1541                 temp = hv_fetch(scan_item, "TERM", 4, 1);
1542                 ptr = SvPV(*temp, len);
1543                 buffer->term = odr_strdupn(rr->stream, ptr, len);
1544                 temp = hv_fetch(scan_item, "OCCURRENCE", 10, 1);
1545                 buffer->occurrences = SvIV(*temp);
1546                 temp = hv_fetch(scan_item, "DISPLAY_TERM", 12, 0);
1547                 if (temp)
1548                 {
1549                         ptr = SvPV(*temp, len);
1550                         buffer->display_term = odr_strdupn(rr->stream, ptr,len);
1551                 }
1552                 buffer++;
1553                 hv_undef(scan_item);
1554         }
1555
1556         zhandle->handle = point;
1557         handle = zhandle;
1558         sv_free(err_code);
1559         sv_free(err_str);
1560         sv_free(status);
1561         sv_free(number);
1562         hv_undef(href);
1563         sv_free((SV *)href);
1564         av_undef(aref);
1565         sv_free((SV *)aref);
1566         av_undef(list);
1567         sv_free((SV *)list);
1568         av_undef(entries);
1569         /*sv_free((SV *)entries);*/
1570         sv_free(entries_ref);
1571
1572         return 0;
1573 }
1574
1575 int bend_explain(void *handle, bend_explain_rr *q)
1576 {
1577         HV *href;
1578         CV *handler_cv = 0;
1579         SV **temp;
1580         char *explain;
1581         SV *explainsv;
1582         STRLEN len;
1583         Zfront_handle *zhandle = (Zfront_handle *)handle;
1584
1585         dSP;
1586         ENTER;
1587         SAVETMPS;
1588
1589         href = newHV();
1590         hv_store(href, "EXPLAIN", 7, newSVpv("", 0), 0);
1591         hv_store(href, "DATABASE", 8, newSVpv(q->database, 0), 0);
1592         hv_store(href, "GHANDLE", 7, newSVsv(zhandle->ghandle), 0);
1593         hv_store(href, "HANDLE", 6, zhandle->handle, 0);
1594
1595         PUSHMARK(sp);
1596         XPUSHs(sv_2mortal(newRV((SV*) href)));
1597         PUTBACK;
1598
1599         handler_cv = simpleserver_sv2cv(explain_ref);
1600         perl_call_sv((SV*) handler_cv, G_SCALAR | G_DISCARD);
1601
1602         SPAGAIN;
1603
1604         temp = hv_fetch(href, "EXPLAIN", 7, 1);
1605         explainsv = newSVsv(*temp);
1606
1607         PUTBACK;
1608         FREETMPS;
1609         LEAVE;
1610
1611         explain = SvPV(explainsv, len);
1612         q->explain_buf = odr_strdupn(q->stream, explain, len);
1613
1614         return 0;
1615 }
1616
1617
1618 /*
1619  * You'll laugh when I tell you this ...  Astonishingly, it turns out
1620  * that ActivePerl (which is widely used on Windows) has, in the
1621  * header file Perl\lib\CORE\XSUB.h, the following heinous crime:
1622  *          #    define open            PerlLIO_open
1623  * This of course screws up the use of the "open" member of the
1624  * Z_IdAuthentication structure below, so we have to undo this
1625  * brain-damage.
1626  */
1627 #ifdef open
1628 #undef open
1629 #endif
1630
1631
1632 bend_initresult *bend_init(bend_initrequest *q)
1633 {
1634         int dummy = simpleserver_clone();
1635         bend_initresult *r = (bend_initresult *)
1636                 odr_malloc (q->stream, sizeof(*r));
1637         char *ptr;
1638         CV* handler_cv = 0;
1639         dSP;
1640         STRLEN len;
1641         NMEM nmem = nmem_create();
1642         Zfront_handle *zhandle = (Zfront_handle *)
1643                 nmem_malloc(nmem, sizeof(*zhandle));
1644         SV *handle;
1645         HV *href;
1646         SV **temp;
1647
1648         ENTER;
1649         SAVETMPS;
1650
1651         zhandle->ghandle = _global_ghandle;
1652         zhandle->nmem = nmem;
1653         zhandle->stop_flag = 0;
1654
1655         if (sort_ref)
1656         {
1657                 q->bend_sort = bend_sort;
1658         }
1659         if (search_ref)
1660         {
1661                 q->bend_search = bend_search;
1662         }
1663         if (present_ref)
1664         {
1665                 q->bend_present = bend_present;
1666         }
1667         /*q->bend_esrequest = bend_esrequest;*/
1668         if (delete_ref)
1669         {
1670                 q->bend_delete = bend_delete;
1671         }
1672         if (fetch_ref)
1673         {
1674                 q->bend_fetch = bend_fetch;
1675         }
1676         if (scan_ref)
1677         {
1678                 q->bend_scan = bend_scan;
1679         }
1680         if (explain_ref)
1681         {
1682                 q->bend_explain = bend_explain;
1683         }
1684
1685         href = newHV();
1686
1687         /* ### These should be given initial values from the client */
1688         hv_store(href, "IMP_ID", 6, newSVpv("", 0), 0);
1689         hv_store(href, "IMP_NAME", 8, newSVpv("", 0), 0);
1690         hv_store(href, "IMP_VER", 7, newSVpv("", 0), 0);
1691
1692         hv_store(href, "ERR_CODE", 8, newSViv(0), 0);
1693         hv_store(href, "ERR_STR", 7, newSViv(0), 0);
1694         hv_store(href, "PEER_NAME", 9, newSVpv(q->peer_name, 0), 0);
1695         hv_store(href, "GHANDLE", 7, newSVsv(zhandle->ghandle), 0);
1696         hv_store(href, "HANDLE", 6, newSVsv(&sv_undef), 0);
1697         hv_store(href, "PID", 3, newSViv(getpid()), 0);
1698         if (q->auth) {
1699             char *user = NULL;
1700             char *passwd = NULL;
1701             if (q->auth->which == Z_IdAuthentication_open) {
1702                 char *cp;
1703                 user = nmem_strdup (odr_getmem (q->stream), q->auth->u.open);
1704                 cp = strchr (user, '/');
1705                 if (cp) {
1706                     /* password after / given */
1707                     *cp = '\0';
1708                     passwd = cp+1;
1709                 }
1710             } else if (q->auth->which == Z_IdAuthentication_idPass) {
1711                 user = q->auth->u.idPass->userId;
1712                 passwd = q->auth->u.idPass->password;
1713             }
1714             /* ### some code paths have user/password unassigned here */
1715             if (user)
1716                 hv_store(href, "USER", 4, newSVpv(user, 0), 0);
1717             if (passwd)
1718                 hv_store(href, "PASS", 4, newSVpv(passwd, 0), 0);
1719         }
1720
1721         PUSHMARK(sp);
1722
1723         XPUSHs(sv_2mortal(newRV((SV*) href)));
1724
1725         PUTBACK;
1726
1727         if (init_ref != NULL)
1728         {
1729              handler_cv = simpleserver_sv2cv( init_ref );
1730              perl_call_sv( (SV *) handler_cv, G_SCALAR | G_DISCARD);
1731         }
1732
1733         SPAGAIN;
1734
1735         temp = hv_fetch(href, "IMP_ID", 6, 1);
1736         ptr = SvPV(*temp, len);
1737         q->implementation_id = nmem_strdup(nmem, ptr);
1738
1739         temp = hv_fetch(href, "IMP_NAME", 8, 1);
1740         ptr = SvPV(*temp, len);
1741         q->implementation_name = nmem_strdup(nmem, ptr);
1742
1743         temp = hv_fetch(href, "IMP_VER", 7, 1);
1744         ptr = SvPV(*temp, len);
1745         q->implementation_version = nmem_strdup(nmem, ptr);
1746
1747         temp = hv_fetch(href, "ERR_CODE", 8, 1);
1748         r->errcode = SvIV(*temp);
1749
1750         temp = hv_fetch(href, "ERR_STR", 7, 1);
1751         ptr = SvPV(*temp, len);
1752         r->errstring = odr_strdupn(q->stream, ptr, len);
1753
1754         temp = hv_fetch(href, "HANDLE", 6, 1);
1755         handle= newSVsv(*temp);
1756         zhandle->handle = handle;
1757
1758         r->handle = zhandle;
1759
1760         hv_undef(href);
1761         sv_free((SV*) href);
1762
1763         PUTBACK;
1764         FREETMPS;
1765         LEAVE;
1766
1767         return r;
1768 }
1769
1770 void bend_close(void *handle)
1771 {
1772         HV *href;
1773         Zfront_handle *zhandle = (Zfront_handle *)handle;
1774         CV* handler_cv = 0;
1775         int stop_flag = 0;
1776         dSP;
1777         ENTER;
1778         SAVETMPS;
1779
1780         if (close_ref)
1781         {
1782                 href = newHV();
1783                 hv_store(href, "GHANDLE", 7, newSVsv(zhandle->ghandle), 0);
1784                 hv_store(href, "HANDLE", 6, zhandle->handle, 0);
1785
1786                 PUSHMARK(sp);
1787
1788                 XPUSHs(sv_2mortal(newRV((SV *)href)));
1789
1790                 PUTBACK;
1791
1792                 handler_cv = simpleserver_sv2cv( close_ref );
1793                 perl_call_sv( (SV *) handler_cv, G_SCALAR | G_DISCARD);
1794
1795                 SPAGAIN;
1796
1797                 sv_free((SV*) href);
1798         }
1799         else
1800                 sv_free(zhandle->handle);
1801         PUTBACK;
1802         FREETMPS;
1803         LEAVE;
1804         stop_flag = zhandle->stop_flag;
1805         nmem_destroy(zhandle->nmem);
1806         simpleserver_free();
1807
1808         if (stop_flag)
1809                 exit(0);
1810         return;
1811 }
1812
1813 static void start_stop(struct statserv_options_block *sob, SV *handler_ref)
1814 {
1815         HV *href;
1816         dSP;
1817         ENTER;
1818         SAVETMPS;
1819
1820         href = newHV();
1821         hv_store(href, "CONFIG", 6, newSVpv(sob->configname, 0), 0);
1822
1823         PUSHMARK(sp);
1824
1825         XPUSHs(sv_2mortal(newRV((SV*) href)));
1826
1827         PUTBACK;
1828
1829         if (handler_ref != NULL)
1830         {
1831                 CV* handler_cv = simpleserver_sv2cv( handler_ref );
1832                 perl_call_sv( (SV *) handler_cv, G_SCALAR | G_DISCARD);
1833         }
1834
1835         SPAGAIN;
1836
1837         PUTBACK;
1838         FREETMPS;
1839         LEAVE;
1840
1841
1842 }
1843
1844 void bend_start(struct statserv_options_block *sob)
1845 {
1846         start_stop(sob, start_ref);
1847 }
1848
1849 MODULE = Net::Z3950::SimpleServer       PACKAGE = Net::Z3950::SimpleServer
1850
1851 PROTOTYPES: DISABLE
1852
1853
1854 void
1855 set_ghandle(arg)
1856                 SV *arg
1857         CODE:
1858                 _global_ghandle = newSVsv(arg);
1859
1860
1861 void
1862 set_init_handler(arg)
1863                 SV *arg
1864         CODE:
1865                 init_ref = newSVsv(arg);
1866
1867
1868 void
1869 set_close_handler(arg)
1870                 SV *arg
1871         CODE:
1872                 close_ref = newSVsv(arg);
1873
1874
1875 void
1876 set_sort_handler(arg)
1877                 SV *arg
1878         CODE:
1879                 sort_ref = newSVsv(arg);
1880
1881 void
1882 set_search_handler(arg)
1883                 SV *arg
1884         CODE:
1885                 search_ref = newSVsv(arg);
1886
1887
1888 void
1889 set_fetch_handler(arg)
1890                 SV *arg
1891         CODE:
1892                 fetch_ref = newSVsv(arg);
1893
1894
1895 void
1896 set_present_handler(arg)
1897                 SV *arg
1898         CODE:
1899                 present_ref = newSVsv(arg);
1900
1901
1902 void
1903 set_esrequest_handler(arg)
1904                 SV *arg
1905         CODE:
1906                 esrequest_ref = newSVsv(arg);
1907
1908
1909 void
1910 set_delete_handler(arg)
1911                 SV *arg
1912         CODE:
1913                 delete_ref = newSVsv(arg);
1914
1915
1916 void
1917 set_scan_handler(arg)
1918                 SV *arg
1919         CODE:
1920                 scan_ref = newSVsv(arg);
1921
1922 void
1923 set_explain_handler(arg)
1924                 SV *arg
1925         CODE:
1926                 explain_ref = newSVsv(arg);
1927
1928 void
1929 set_start_handler(arg)
1930                 SV *arg
1931         CODE:
1932                 start_ref = newSVsv(arg);
1933
1934 int
1935 start_server(...)
1936         PREINIT:
1937                 char **argv;
1938                 char **argv_buf;
1939                 char *ptr;
1940                 int i;
1941                 STRLEN len;
1942                 struct statserv_options_block *sob;
1943         CODE:
1944                 argv_buf = (char **)xmalloc((items + 1) * sizeof(char *));
1945                 argv = argv_buf;
1946                 for (i = 0; i < items; i++)
1947                 {
1948                         ptr = SvPV(ST(i), len);
1949                         *argv_buf = (char *)xmalloc(len + 1);
1950                         strcpy(*argv_buf++, ptr);
1951                 }
1952                 *argv_buf = NULL;
1953
1954                 sob = statserv_getcontrol();
1955                 sob->bend_start = bend_start;
1956                 statserv_setcontrol(sob);
1957
1958                 root_perl_context = PERL_GET_CONTEXT;
1959                 yaz_mutex_create(&simpleserver_mutex);
1960 #if 0
1961                 /* only for debugging perl_clone .. */
1962                 tst_clones();
1963 #endif
1964
1965                 RETVAL = statserv_main(items, argv, bend_init, bend_close);
1966         OUTPUT:
1967                 RETVAL
1968
1969
1970 int
1971 ScanSuccess()
1972         CODE:
1973                 RETVAL = BEND_SCAN_SUCCESS;
1974         OUTPUT:
1975                 RETVAL
1976
1977 int
1978 ScanPartial()
1979         CODE:
1980                 RETVAL = BEND_SCAN_PARTIAL;
1981         OUTPUT:
1982                 RETVAL
1983
1984
1985 void
1986 yazlog(arg)
1987                 SV *arg
1988         CODE:
1989                 STRLEN len;
1990                 char *ptr;
1991                 ptr = SvPV(arg, len);
1992                 yaz_log(YLOG_LOG, "%.*s", (int) len, ptr);
1993
1994 int
1995 yaz_diag_srw_to_bib1(srw_code)
1996         int srw_code
1997
1998 int
1999 yaz_diag_bib1_to_srw(bib1_code)
2000         int bib1_code
2001