server/session.h

   1 /*
   2  * Copyright (C) 1995-1998, Index Data I/S
   3  * See the file LICENSE for details.
   4  * Sebastian Hammer, Adam Dickmeiss
   5  *
   6  * $Log: session.h,v $
   7  * Revision 1.13  1998-01-29 13:30:23  adam
   8  * Better event handle system for NT/Unix.
   9  *
  10  * Revision 1.12  1997/09/01 08:53:01  adam
  11  * New windows NT/95 port using MSV5.0. The test server 'ztest' was
  12  * moved a separate directory. MSV5.0 project server.dsp created.
  13  * As an option, the server can now operate as an NT service.
  14  *
  15  * Revision 1.11  1995/11/08 17:41:40  quinn
  16  * Smallish.
  17  *
  18  * Revision 1.10  1995/08/29  11:18:01  quinn
  19  * Added code to receive close
  20  *
  21  * Revision 1.9  1995/06/16  10:31:38  quinn
  22  * Added session timeout.
  23  *
  24  * Revision 1.8  1995/05/17  08:42:28  quinn
  25  * Transfer auth info to backend. Allow backend to reject init gracefully.
  26  *
  27  * Revision 1.7  1995/05/16  08:51:08  quinn
  28  * License, documentation, and memory fixes
  29  *
  30  * Revision 1.6  1995/05/15  11:56:41  quinn
  31  * Asynchronous facilities. Restructuring of seshigh code.
  32  *
  33  * Revision 1.5  1995/04/20  15:13:01  quinn
  34  * Cosmetic
  35  *
  36  * Revision 1.4  1995/04/10  10:23:39  quinn
  37  * Some work to add scan and other things.
  38  *
  39  * Revision 1.3  1995/03/30  09:09:27  quinn
  40  * Added state-handle and some support for asynchronous activities.
  41  *
  42  * Revision 1.2  1995/03/27  08:34:29  quinn
  43  * Added dynamic server functionality.
  44  * Released bindings to session.c (is now redundant)
  45  *
  46  * Revision 1.1  1995/03/14  10:28:02  quinn
  47  * More work on demo server.
  48  *
  49  *
  50  */
  51
  52 #ifndef SESSION_H
  53 #define SESSION_H
  54
  55 #include <comstack.h>
  56 #include <odr.h>
  57 #include <oid.h>
  58 #include <proto.h>
  59 #include <sys/types.h>
  60 #include "eventl.h"
  61
  62 typedef struct request
  63 {
  64     int len_refid;          /* length of referenceid */
  65     char *refid;            /* referenceid */
  66     enum {
  67         REQUEST_IDLE,    /* the request is just sitting in the queue */
  68         REQUEST_PENDING  /* operation pending (b'end processing or network I/O*/
  69         /* this list will have more elements when acc/res control is added */
  70     } state;
  71
  72     Z_APDU *request;        /* Current request */
  73     NMEM request_mem;    /* memory handle for request */
  74
  75     int size_response;     /* size of buffer */
  76     int len_response;      /* length of encoded data */
  77     char *response;        /* encoded data waiting for transmission */
  78
  79     struct request *next;
  80     struct request_q *q;
  81 } request;
  82
  83 typedef struct request_q
  84 {
  85     request *head;
  86     request *tail;
  87     request *list;
  88     int num;
  89 } request_q;
  90
  91 /*
  92  * association state.
  93  */
  94 typedef struct association
  95 {
  96     IOCHAN client_chan;           /* event-loop control */
  97     COMSTACK client_link;         /* communication handle */
  98     ODR decode;                   /* decoding stream */
  99     ODR encode;                   /* encoding stream */
 100     ODR print;                    /* printing stream (for -a) */
 101     char *encode_buffer;          /* temporary buffer for encoded data */
 102     int encoded_len;              /* length of encoded data */
 103     char *input_buffer;           /* input buffer (allocated by comstack) */
 104     int input_buffer_len;         /* length (size) of buffer */
 105     int input_apdu_len;           /* length of current incoming APDU */
 106     oid_proto proto;              /* protocol (PROTO_Z3950/PROTO_SR) */
 107     void *backend;                /* backend handle */
 108     request_q incoming;           /* Q of incoming PDUs */
 109     request_q outgoing;           /* Q of outgoing data buffers (enc. PDUs) */
 110     enum
 111     {
 112         ASSOC_NEW,                /* not initialized yet */
 113         ASSOC_UP,                 /* normal operation */
 114         ASSOC_DEAD                /* dead. Close if input arrives */
 115     } state;
 116
 117     /* session parameters */
 118     int preferredMessageSize;
 119     int maximumRecordSize;
 120     int version;                  /* highest version-bit set (2 or 3) */
 121
 122     int (*bend_sort) ();
 123 } association;
 124
 125 association *create_association(IOCHAN channel, COMSTACK link);
 126 void destroy_association(association *h);
 127 void ir_session(IOCHAN h, int event);
 128
 129 void request_enq(request_q *q, request *r);
 130 request *request_head(request_q *q);
 131 request *request_deq(request_q *q);
 132 void request_initq(request_q *q);
 133 void request_delq(request_q *q);
 134 request *request_get(request_q *q);
 135 void request_release(request *r);
 136
 137 #endif