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