include/yaz/prt-ext.h

   1 /*
   2  * Copyright (c) 1995-2004, Index Data.
   3  *
   4  * Permission to use, copy, modify, distribute, and sell this software and
   5  * its documentation, in whole or in part, for any purpose, is hereby granted,
   6  * provided that:
   7  *
   8  * 1. This copyright and permission notice appear in all copies of the
   9  * software and its documentation. Notices of copyright or attribution
  10  * which appear at the beginning of any file must remain unchanged.
  11  *
  12  * 2. The names of Index Data or the individual authors may not be used to
  13  * endorse or promote products derived from this software without specific
  14  * prior written permission.
  15  *
  16  * THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTY OF ANY KIND,
  17  * EXPRESS, IMPLIED, OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
  18  * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  19  * IN NO EVENT SHALL INDEX DATA BE LIABLE FOR ANY SPECIAL, INCIDENTAL,
  20  * INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES
  21  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER OR
  22  * NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
  23  * LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
  24  * OF THIS SOFTWARE.
  25  *
  26  * $Id: prt-ext.h,v 1.10 2004-10-15 00:18:59 adam Exp $
  27  */
  28
  29 /**
  30  * \file prt-ext.h
  31  * \brief Header for Z39.50 External utilities
  32  */
  33
  34 /*
  35  * Biased-choice External for Z39.50.
  36  */
  37
  38 #ifndef PRT_EXT_H
  39 #define PRT_EXT_H
  40
  41 #include <yaz/yconfig.h>
  42 #include <yaz/oid.h>
  43
  44
  45 YAZ_BEGIN_CDECL
  46
  47 /**
  48  * Used to keep track of known External definitions (a loose approach
  49  * to DEFINED_BY).
  50  */
  51 typedef struct Z_ext_typeent
  52 {
  53     oid_value dref;    /* the direct-reference OID value. */
  54     int what;          /* discriminator value for the external CHOICE */
  55     Odr_fun fun;       /* decoder function */
  56 } Z_ext_typeent;
  57
  58 struct Z_External
  59 {
  60     Odr_oid *direct_reference;
  61     int *indirect_reference;
  62     char *descriptor;
  63     int which;
  64 /* Generic types */
  65 #define Z_External_single 0
  66 #define Z_External_octet 1
  67 #define Z_External_arbitrary 2
  68 /* Specific types */
  69 #define Z_External_sutrs 3
  70 #define Z_External_explainRecord 4
  71 #define Z_External_resourceReport1 5
  72 #define Z_External_resourceReport2 6
  73 #define Z_External_promptObject1 7
  74 #define Z_External_grs1 8
  75 #define Z_External_extendedService 9
  76 #define Z_External_itemOrder 10
  77 #define Z_External_diag1 11
  78 #define Z_External_espec1 12
  79 #define Z_External_summary 13
  80 #define Z_External_OPAC 14
  81 #define Z_External_searchResult1 15
  82 #define Z_External_update 16
  83 #define Z_External_dateTime 17
  84 #define Z_External_universeReport 18
  85 #define Z_External_ESAdmin 19
  86 #define Z_External_update0 20
  87 #define Z_External_userInfo1 21
  88 #define Z_External_charSetandLanguageNegotiation 22
  89 #define Z_External_acfPrompt1 23
  90 #define Z_External_acfDes1 24
  91 #define Z_External_acfKrb1 25
  92 #define Z_External_multisrch2 26
  93 #define Z_External_CQL 27
  94 #define Z_External_OCLCUserInfo 28
  95     union
  96     {
  97         /* Generic types */
  98         Odr_any *single_ASN1_type;
  99         Odr_oct *octet_aligned;
 100         Odr_bitmask *arbitrary;
 101
 102         /* Specific types */
 103         Z_SUTRS *sutrs;
 104         Z_ExplainRecord *explainRecord;
 105
 106         Z_ResourceReport1 *resourceReport1;
 107         Z_ResourceReport2 *resourceReport2;
 108         Z_PromptObject1 *promptObject1;
 109         Z_GenericRecord *grs1;
 110         Z_TaskPackage *extendedService;
 111
 112         Z_ItemOrder *itemOrder;
 113         Z_DiagnosticFormat *diag1;
 114         Z_Espec1 *espec1;
 115         Z_BriefBib *summary;
 116         Z_OPACRecord *opac;
 117
 118         Z_SearchInfoReport *searchResult1;
 119         Z_IUUpdate *update;
 120         Z_DateTime *dateTime;
 121         Z_UniverseReport *universeReport;
 122         Z_Admin *adminService;
 123
 124         Z_IU0Update *update0;
 125         Z_OtherInformation *userInfo1;
 126         Z_CharSetandLanguageNegotiation *charNeg3;
 127         Z_PromptObject1 *acfPrompt1;
 128         Z_DES_RN_Object *acfDes1;
 129
 130         Z_KRBObject *acfKrb1;
 131         Z_MultipleSearchTerms_2 *multipleSearchTerms_2;
 132         Z_InternationalString *cql;
 133         Z_OCLC_UserInformation *oclc;
 134     } u;
 135 };
 136
 137
 138 YAZ_EXPORT int z_External(ODR o, Z_External **p, int opt, const char *name);
 139 YAZ_EXPORT Z_ext_typeent *z_ext_getentbyref(oid_value val);
 140 YAZ_EXPORT Z_External *z_ext_record(ODR o, int format, const char *buf,
 141                                     int len);
 142
 143 YAZ_END_CDECL
 144
 145 #endif