src/session.h

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