Minor reformatting.
[yaz-moved-to-github.git] / src / session.h
1 /* This file is part of the YAZ toolkit.
2  * Copyright (C) 1995-2008 Index Data.
3  * All rights reserved.
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are met:
6  *
7  *     * Redistributions of source code must retain the above copyright
8  *       notice, this list of conditions and the following disclaimer.
9  *     * Redistributions in binary form must reproduce the above copyright
10  *       notice, this list of conditions and the following disclaimer in the
11  *       documentation and/or other materials provided with the distribution.
12  *     * Neither the name of Index Data nor the names of its contributors
13  *       may be used to endorse or promote products derived from this
14  *       software without specific prior written permission.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY
17  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
18  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
19  * DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY
20  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
21  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
22  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
23  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26  */
27 /**
28  * \file session.h
29  * \brief Internal Header for GFS.
30  */
31 #ifndef SESSION_H
32 #define SESSION_H
33
34 #include <yaz/comstack.h>
35 #include <yaz/cql.h>
36 #include <yaz/ccl.h>
37 #include <yaz/odr.h>
38 #include <yaz/proto.h>
39 #include <yaz/backend.h>
40 #include <yaz/retrieval.h>
41 #include "eventl.h"
42
43 struct gfs_server {
44     statserv_options_block cb;
45     char *host;
46     int listen_ref;
47     cql_transform_t cql_transform;
48     CCL_bibset ccl_transform;
49     void *server_node_ptr;
50     char *directory;
51     char *docpath;
52     char *stylesheet;
53     yaz_retrieval_t retrieval;
54     struct gfs_server *next;
55 };
56
57 struct gfs_listen {
58     char *id;
59     char *address;
60     struct gfs_listen *next;
61 };
62
63 typedef enum {
64     REQUEST_IDLE,    /* the request is just sitting in the queue */
65     REQUEST_PENDING  /* operation pending (b'end processing or network I/O*/
66     /* this list will have more elements when acc/res control is added */
67 } request_state;
68
69 typedef struct request
70 {
71     int len_refid;          /* length of referenceid */
72     char *refid;            /* referenceid */
73     request_state state;
74
75     Z_GDU *gdu_request;     /* Current request */
76     Z_APDU *apdu_request;   /* Current Z39.50 request */
77     NMEM request_mem;    /* memory handle for request */
78
79     int size_response;     /* size of buffer */
80     int len_response;      /* length of encoded data */
81     char *response;        /* encoded data waiting for transmission */
82
83     void *clientData;
84     struct request *next;
85     struct request_q *q; 
86 } request;
87
88 typedef struct request_q
89 {
90     request *head;
91     request *tail;
92     request *list;
93     int num;
94 } request_q;
95
96 /*
97  * association state.
98  */
99 typedef enum
100 {
101     ASSOC_NEW,                /* not initialized yet */
102     ASSOC_UP,                 /* normal operation */
103     ASSOC_DEAD                /* dead. Close if input arrives */
104 } association_state;
105
106 typedef struct association
107 {
108     IOCHAN client_chan;           /* event-loop control */
109     COMSTACK client_link;         /* communication handle */
110     ODR decode;                   /* decoding stream */
111     ODR encode;                   /* encoding stream */
112     ODR print;                    /* printing stream (for -a) */
113     char *encode_buffer;          /* temporary buffer for encoded data */
114     int encoded_len;              /* length of encoded data */
115     char *input_buffer;           /* input buffer (allocated by comstack) */
116     int input_buffer_len;         /* length (size) of buffer */
117     int input_apdu_len;           /* length of current incoming APDU */
118     oid_proto proto;              /* protocol (PROTO_Z3950/PROTO_SR) */
119     void *backend;                /* backend handle */
120     request_q incoming;           /* Q of incoming PDUs */
121     request_q outgoing;           /* Q of outgoing data buffers (enc. PDUs) */
122     association_state state;
123
124     /* session parameters */
125     int preferredMessageSize;
126     int maximumRecordSize;
127     int version;                  /* highest version-bit set (2 or 3) */
128
129     unsigned cs_get_mask;
130     unsigned cs_put_mask;
131     unsigned cs_accept_mask;
132
133     struct bend_initrequest *init;
134     statserv_options_block *last_control;
135
136     struct gfs_server *server;
137 } association;
138
139 association *create_association(IOCHAN channel, COMSTACK link,
140                                 const char *apdufile);
141 void destroy_association(association *h);
142 void ir_session(IOCHAN h, int event);
143
144 void request_enq(request_q *q, request *r);
145 request *request_head(request_q *q);
146 request *request_deq(request_q *q);
147 request *request_deq_x(request_q *q, request *r);
148 void request_initq(request_q *q);
149 void request_delq(request_q *q);
150 request *request_get(request_q *q);
151 void request_release(request *r);
152
153 int statserv_must_terminate(void);
154
155 int control_association(association *assoc, const char *host, int force);
156
157 int ir_read(IOCHAN h, int event);
158
159 #endif
160 /*
161  * Local variables:
162  * c-basic-offset: 4
163  * indent-tabs-mode: nil
164  * End:
165  * vim: shiftwidth=4 tabstop=8 expandtab
166  */
167