kernel/kernel.h

   1 /*
   2  * Copyright (c) 1995, the EUROPAGATE consortium (see below).
   3  *
   4  * The EUROPAGATE consortium members are:
   5  *
   6  *    University College Dublin
   7  *    Danmarks Teknologiske Videnscenter
   8  *    An Chomhairle Leabharlanna
   9  *    Consejo Superior de Investigaciones Cientificas
  10  *
  11  * Permission to use, copy, modify, distribute, and sell this software and
  12  * its documentation, in whole or in part, for any purpose, is hereby granted,
  13  * provided that:
  14  *
  15  * 1. This copyright and permission notice appear in all copies of the
  16  * software and its documentation. Notices of copyright or attribution
  17  * which appear at the beginning of any file must remain unchanged.
  18  *
  19  * 2. The names of EUROPAGATE or the project partners may not be used to
  20  * endorse or promote products derived from this software without specific
  21  * prior written permission.
  22  *
  23  * 3. Users of this software (implementors and gateway operators) agree to
  24  * inform the EUROPAGATE consortium of their use of the software. This
  25  * information will be used to evaluate the EUROPAGATE project and the
  26  * software, and to plan further developments. The consortium may use
  27  * the information in later publications.
  28  *
  29  * 4. Users of this software agree to make their best efforts, when
  30  * documenting their use of the software, to acknowledge the EUROPAGATE
  31  * consortium, and the role played by the software in their work.
  32  *
  33  * THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTY OF ANY KIND,
  34  * EXPRESS, IMPLIED, OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
  35  * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  36  * IN NO EVENT SHALL THE EUROPAGATE CONSORTIUM OR ITS MEMBERS BE LIABLE
  37  * FOR ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF
  38  * ANY KIND, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA
  39  * OR PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND
  40  * ON ANY THEORY OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE
  41  * USE OR PERFORMANCE OF THIS SOFTWARE.
  42  *
  43  */
  44 /* Gateway kernel
  45  * Europagate, 1995
  46  *
  47  * $Log: kernel.h,v $
  48  * Revision 1.20  1995/07/28 10:51:08  adam
  49  * Bug fix: account from previous session had effect when new target command
  50  * was executed.
  51  *
  52  * Revision 1.19  1995/07/11  11:49:12  adam
  53  * LINE_MAX renamed to STR_LINE_MAX.
  54  *
  55  * Revision 1.18  1995/05/16  09:40:42  adam
  56  * LICENSE. Setting of CCL token names (and/or/not/set) in read_kernel_res.
  57  *
  58  * Revision 1.17  1995/05/03  16:34:18  adam
  59  * CCL def command, i.e. user definitions - saved as resource files.
  60  *
  61  * Revision 1.16  1995/05/03  07:37:37  adam
  62  * CCL commands stop/continue implemented. New functions gw_res_{int,bool}
  63  * are used when possible.
  64  *
  65  * Revision 1.15  1995/04/19  13:19:08  adam
  66  * New command: account - for authentication.
  67  *
  68  * Revision 1.14  1995/04/19  10:46:18  adam
  69  * Persistency works much better now. New command: status - history-like
  70  *
  71  * Revision 1.13  1995/04/19  07:31:04  adam
  72  * First work on Z39.50 persistence.
  73  *
  74  * Revision 1.12  1995/04/17  09:34:29  adam
  75  * Timeout (idletime) adjustable. Minor changes in kernel.
  76  *
  77  * Revision 1.11  1995/03/28  11:42:34  adam
  78  * First use of string-queue utility.
  79  *
  80  * Revision 1.10  1995/03/27  08:24:01  adam
  81  * First use of gip interface and gw-db.
  82  * First work on eti program.
  83  *
  84  * Revision 1.9  1995/03/03  17:19:13  adam
  85  * Smarter presentation. Bug fix in email header interpretation.
  86  *
  87  * Revision 1.8  1995/03/01  14:32:24  adam
  88  * Better diagnostics. Default is, that only one database selected when
  89  * several are known.
  90  *
  91  * Revision 1.7  1995/02/23  08:32:16  adam
  92  * Changed header.
  93  *
  94  * Revision 1.5  1995/02/22  15:22:32  adam
  95  * Much more checking of run-time state. Show command never retrieves
  96  * more records than indicated by the previous search request. Help
  97  * command available. The maximum number of records retrieved can be
  98  * controlled now.
  99  *
 100  * Revision 1.4  1995/02/20  21:16:18  adam
 101  * FML support. Bug fixes. Profile for drewdb.
 102  *
 103  * Revision 1.3  1995/02/16  18:35:08  adam
 104  * First use of Zdist library. Search requests are supported.
 105  * Present requests are not supported yet.
 106  *
 107  * Revision 1.2  1995/02/16  13:20:59  adam
 108  * Organization of resource files for targets and conversion
 109  * language implemented.
 110  *
 111  * Revision 1.1  1995/02/15  17:45:29  adam
 112  * First version of email gateway kernel. Email requests are read
 113  * from stdin. The output is transferred to an MTA if 'From' is
 114  * found in the header - or stdout if absent. No Z39.50 client is used.
 115  *
 116  */
 117
 118 #include <gw-res.h>
 119 #include <gw-log.h>
 120 #include <ccl.h>
 121 #include <zaccess.h>
 122
 123 #include <iso2709.h>
 124 #if USE_FML
 125 #include <fmlmarc.h>
 126 #endif
 127 #include <strqueue.h>
 128
 129 #define STR_LINE_MAX 1024
 130
 131 struct gw_user_set {
 132     char   *name;               /* name of result set */
 133     int    hits;                /* -1 on error */
 134     char   *database;           /* database(s) in which we search */
 135     struct ccl_rpn_node *rpn;   /* rpn request */
 136     int    present_flag;        /* present in target (presistency) */
 137     char   *search_str;         /* find request string */
 138     struct gw_user_set *prev;
 139 };
 140
 141 struct gw_kernel_info {
 142     CCL_bibset bibset;
 143     GwRes kernel_res;
 144     const char *default_res;
 145     const char *override_res;
 146     char target[128];
 147     char hostname[128];
 148     char account[128];
 149     int  account_in_session;
 150     int  port;
 151     const char *lang;
 152     const char *override_portno;
 153     const char *override_hostname;
 154     char *databases;
 155     char *database;
 156     ZASS  zass;
 157     int command_no;
 158     char  from_str[STR_LINE_MAX+1];
 159     const char *reply_fname;
 160     int setno;
 161     int next_position;
 162     int userid;
 163 #if USE_FML
 164     Fml   fml;
 165 #endif
 166     struct gw_user_set *sets;
 167 };
 168
 169 extern struct gw_kernel_info info;
 170
 171 extern FILE *reply_fd;
 172
 173 int  urp_start   (int continuation, struct str_queue *queue);
 174 int  urp_command (struct str_queue *queue);
 175 void urp_end     (void);
 176
 177 void read_kernel_res (void);
 178
 179 struct gw_user_set *user_set_add (const char *name, int hits,
 180                                   const char *database,
 181                                   struct ccl_rpn_node *rpn,
 182                                   int present_flag,
 183                                   const char *search_str);
 184 struct gw_user_set *user_set_search (const char *name);
 185 void user_set_init (void);
 186
 187 int lgets (char *buf, int max, int fd);
 188
 189 const struct zass_searchent *zass_p_search (ZASS zass,
 190                                       struct ccl_rpn_node *rpn,
 191                                       const char *result_set,
 192                                       const char *database,
 193                                       struct gw_user_set *sets);
 194 const struct zass_presentent *zass_p_present (ZASS zass,
 195                                       const char *result_set,
 196                                       int offset, int number);
 197
 198 int load_p_state (int userid);
 199 int save_p_state (int userid);
 200 void del_p_state (int userid);
 201 int reopen_target (void);
 202
 203 #define KERNEL_LOG "kernel"