src/session.h

   1 /*
   2  * Copyright (C) 1995-2003, Index Data
   3  * See the file LICENSE for details.
   4  * Sebastian Hammer, Adam Dickmeiss
   5  *
   6  * $Id: session.h,v 1.1 2003-10-27 12:21:35 adam Exp $
   7  */
   8
   9 #ifndef SESSION_H
  10 #define SESSION_H
  11
  12 #include <sys/types.h>
  13 #include <yaz/comstack.h>
  14 #include <yaz/odr.h>
  15 #include <yaz/oid.h>
  16 #include <yaz/proto.h>
  17 #include "eventl.h"
  18
  19 typedef enum {
  20         REQUEST_IDLE,    /* the request is just sitting in the queue */
  21         REQUEST_PENDING  /* operation pending (b'end processing or network I/O*/
  22         /* this list will have more elements when acc/res control is added */
  23 } request_state;
  24
  25 typedef struct request
  26 {
  27     int len_refid;          /* length of referenceid */
  28     char *refid;            /* referenceid */
  29     request_state state;
  30
  31     Z_GDU *gdu_request;     /* Current request */
  32     Z_APDU *apdu_request;   /* Current Z39.50 request */
  33     NMEM request_mem;    /* memory handle for request */
  34
  35     int size_response;     /* size of buffer */
  36     int len_response;      /* length of encoded data */
  37     char *response;        /* encoded data waiting for transmission */
  38
  39     void *clientData;
  40     struct request *next;
  41     struct request_q *q;
  42 } request;
  43
  44 typedef struct request_q
  45 {
  46     request *head;
  47     request *tail;
  48     request *list;
  49     int num;
  50 } request_q;
  51
  52 /*
  53  * association state.
  54  */
  55 typedef enum
  56 {
  57     ASSOC_NEW,                /* not initialized yet */
  58     ASSOC_UP,                 /* normal operation */
  59     ASSOC_DEAD                /* dead. Close if input arrives */
  60 } association_state;
  61
  62 typedef struct association
  63 {
  64     IOCHAN client_chan;           /* event-loop control */
  65     COMSTACK client_link;         /* communication handle */
  66     ODR decode;                   /* decoding stream */
  67     ODR encode;                   /* encoding stream */
  68     ODR print;                    /* printing stream (for -a) */
  69     char *encode_buffer;          /* temporary buffer for encoded data */
  70     int encoded_len;              /* length of encoded data */
  71     char *input_buffer;           /* input buffer (allocated by comstack) */
  72     int input_buffer_len;         /* length (size) of buffer */
  73     int input_apdu_len;           /* length of current incoming APDU */
  74     oid_proto proto;              /* protocol (PROTO_Z3950/PROTO_SR) */
  75     void *backend;                /* backend handle */
  76     request_q incoming;           /* Q of incoming PDUs */
  77     request_q outgoing;           /* Q of outgoing data buffers (enc. PDUs) */
  78     association_state state;
  79
  80     /* session parameters */
  81     int preferredMessageSize;
  82     int maximumRecordSize;
  83     int version;                  /* highest version-bit set (2 or 3) */
  84
  85     unsigned cs_get_mask;
  86     unsigned cs_put_mask;
  87     unsigned cs_accept_mask;
  88
  89     struct bend_initrequest *init;
  90 } association;
  91
  92 association *create_association(IOCHAN channel, COMSTACK link);
  93 void destroy_association(association *h);
  94 void ir_session(IOCHAN h, int event);
  95
  96 void request_enq(request_q *q, request *r);
  97 request *request_head(request_q *q);
  98 request *request_deq(request_q *q);
  99 request *request_deq_x(request_q *q, request *r);
 100 void request_initq(request_q *q);
 101 void request_delq(request_q *q);
 102 request *request_get(request_q *q);
 103 void request_release(request *r);
 104
 105 int statserv_must_terminate(void);
 106
 107 #endif