Smallish
[yaz-moved-to-github.git] / include / comstack.h
1 /*
2  * Copyright (C) 1994, Index Data I/S 
3  * All rights reserved.
4  * Sebastian Hammer, Adam Dickmeiss
5  *
6  * $Log: comstack.h,v $
7  * Revision 1.2  1995-04-17 11:28:17  quinn
8  * Smallish
9  *
10  * Revision 1.1  1995/03/30  09:39:40  quinn
11  * Moved .h files to include directory
12  *
13  * Revision 1.11  1995/03/27  08:36:05  quinn
14  * Some work on nonblocking operation in xmosi.c and rfct.c.
15  * Added protocol parameter to cs_create()
16  *
17  * Revision 1.10  1995/03/20  09:47:12  quinn
18  * Added server-side support to xmosi.c
19  * Fixed possible problems in rfct
20  * Other little mods
21  *
22  * Revision 1.9  1995/03/15  15:36:27  quinn
23  * Mods to support nonblocking I/O
24  *
25  * Revision 1.8  1995/03/14  17:00:07  quinn
26  * Bug-fixes - added tracing info to tcpip.c
27  *
28  * Revision 1.7  1995/03/14  10:28:35  quinn
29  * Adding server-side support to tcpip.c and fixing bugs in nonblocking I/O
30  *
31  * Revision 1.6  1995/03/07  16:29:45  quinn
32  * Various fixes.
33  *
34  * Revision 1.5  1995/03/07  10:39:31  quinn
35  * Added cs_fileno
36  *
37  * Revision 1.4  1995/03/06  16:49:29  adam
38  * COMSTACK type inspection possible with cs_type.
39  *
40  * Revision 1.3  1995/02/14  11:54:48  quinn
41  * Beginning to add full CCL.
42  *
43  * Revision 1.2  1995/02/10  18:58:10  quinn
44  * Fixed tcpip_get (formerly tcpip_read).
45  * Turned tst (cli) into a proper, event-driven thing.
46  *
47  * Revision 1.1  1995/02/09  15:51:51  quinn
48  * Works better now.
49  *
50  */
51
52 #ifndef COMSTACK_H
53 #define COMSTACK_H
54
55 #include <dmalloc.h>
56
57 #define COMSTACK_DEFAULT_TIMEOUT -1
58
59 struct comstack;
60 typedef struct comstack *COMSTACK;
61
62 typedef COMSTACK (*CS_TYPE)(int blocking, int protocol);
63
64 struct comstack
65 {
66     CS_TYPE type;
67     int errno;     /* current error code of this stack */
68     char *stackerr;/* current lower-layer error string, or null if none */
69     int iofile;    /* UNIX file descriptor for iochannel */
70     int timeout;   /* how long to wait for trailing blocks */          
71     void *private; /* state info for lower stack */
72     int more;      /* connection has extra data in buffer */
73     int state;     /* current state */
74 #define CS_UNBND      0
75 #define CS_IDLE       1
76 #define CS_INCON      2
77 #define CS_OUTCON     3
78 #define CS_DATAXFER   4
79     int newfd;     /* storing new descriptor between listen and accept */
80     int blocking;  /* is this link (supposed to be) blocking? */
81     int event;     /* current event */
82 #define CS_NONE       0
83 #define CS_CONNECT    1
84 #define CS_DISCON     2
85 #define CS_LISTEN     3
86 #define CS_DATA       4
87     int protocol;  /* what application protocol are we talking? */
88 #define CS_Z3950      0
89 #define CS_SR         1
90     int (*f_look)(COMSTACK handle);
91     int (*f_put)(COMSTACK handle, char *buf, int size);
92     int (*f_get)(COMSTACK handle, char **buf, int *bufsize);
93     int (*f_more)(COMSTACK handle);
94     int (*f_connect)(COMSTACK handle, void *address);
95     int (*f_rcvconnect)(COMSTACK handle);
96     int (*f_bind)(COMSTACK handle, void *address, int mode);
97 #define CS_CLIENT 0
98 #define CS_SERVER 1
99     int (*f_listen)(COMSTACK handle, char *addrp, int *addrlen);
100     COMSTACK (*f_accept)(COMSTACK handle);
101     int (*f_close)(COMSTACK handle);
102 };
103
104 #define cs_put(handle, buf, size) ((*(handle)->f_put)(handle, buf, size))
105 #define cs_get(handle, buf, size) ((*(handle)->f_get)(handle, buf, size))
106 #define cs_more(handle) ((*(handle)->f_more)(handle))
107 #define cs_connect(handle, address) ((*(handle)->f_connect)(handle, address))
108 #define cs_rcvconnect(handle) ((*(handle)->f_rcvconnect)(handle))
109 #define cs_bind(handle, ad, mo) ((*(handle)->f_bind)(handle, ad, mo))
110 #define cs_listen(handle, ap, al) ((*(handle)->f_listen)(handle, ap, al))
111 #define cs_accept(handle) ((*(handle)->f_accept)(handle))
112 #define cs_close(handle) ((*(handle)->f_close)(handle))
113 #define cs_create(type, blocking, proto) ((*type)(blocking, proto))
114 #define cs_type(handle) ((handle)->type)
115 #define cs_fileno(handle) ((handle)->iofile)
116 #define cs_stackerr(handle) ((handle)->stackerr)
117 #define cs_getstate(handle) ((handle)->getstate)
118 #define cs_errno(handle) ((handle)->errno)
119 #define cs_getproto(handle) ((handle)->protocol)
120
121 const char *cs_strerror(COMSTACK h);
122
123 /*
124  * error management.
125  */
126
127 #define CSNONE     0
128 #define CSYSERR    1
129 #define CSOUTSTATE 2
130 #define CSNODATA   3
131 #define CSWRONGBUF 4
132
133 extern char *cs_errlist[];
134
135 #endif