intermediate release
[gnupg.git] / include / iobuf.h
1 /* iobuf.h - I/O buffer
2  *      Copyright (C) 1998 Free Software Foundation, Inc.
3  *
4  * This file is part of GNUPG.
5  *
6  * GNUPG is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * GNUPG is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
19  */
20
21 #ifndef G10_IOBUF_H
22 #define G10_IOBUF_H
23
24 #include "types.h"
25
26
27 #define DBG_IOBUF   iobuf_debug_mode
28
29
30 #define IOBUFCTRL_INIT      1
31 #define IOBUFCTRL_FREE      2
32 #define IOBUFCTRL_UNDERFLOW 3
33 #define IOBUFCTRL_FLUSH     4
34 #define IOBUFCTRL_DESC      5
35 #define IOBUFCTRL_USER      16
36
37 typedef struct iobuf_struct *IOBUF;
38
39 struct iobuf_struct {
40     int usage;           /* 1 input , 2 output, 3 temp */
41     unsigned long nlimit;
42     unsigned long nbytes; /* used together with nlimit */
43     unsigned long ntotal; /* total bytes read (position of stream) */
44     struct {
45         size_t size;   /* allocated size */
46         size_t start;  /* number of invalid bytes at the begin of the buffer */
47         size_t len;    /* currently filled to this size */
48         byte *buf;
49     } d;
50     int filter_eof;
51     int error;
52     int (*filter)( void *opaque, int control,
53                    IOBUF chain, byte *buf, size_t *len);
54     void *filter_ov;    /* value for opaque */
55     IOBUF chain;        /* next iobuf used for i/o if any (passed to filter) */
56     int no, subno;
57     const char *desc;
58     void *opaque;      /* can be used to hold any information    */
59                        /* this value is copied to all instances */
60     struct {
61         size_t size;   /* allocated size */
62         size_t start;  /* number of invalid bytes at the begin of the buffer */
63         size_t len;    /* currently filled to this size */
64         byte *buf;
65     } unget;
66 };
67
68 int iobuf_debug_mode;
69
70 IOBUF iobuf_alloc(int usage, size_t bufsize);
71 IOBUF iobuf_temp(void);
72 IOBUF iobuf_open( const char *fname );
73 IOBUF iobuf_create( const char *fname );
74 IOBUF iobuf_append( const char *fname );
75 IOBUF iobuf_openrw( const char *fname );
76 int   iobuf_close( IOBUF iobuf );
77 int   iobuf_cancel( IOBUF iobuf );
78
79 int iobuf_push_filter( IOBUF a, int (*f)(void *opaque, int control,
80                        IOBUF chain, byte *buf, size_t *len), void *ov );
81 int iobuf_pop_filter( IOBUF a, int (*f)(void *opaque, int control,
82                       IOBUF chain, byte *buf, size_t *len), void *ov );
83 int iobuf_flush(IOBUF a);
84 void iobuf_clear_eof(IOBUF a);
85 #define iobuf_set_error(a)    do { (a)->error = 1; } while(0)
86 #define iobuf_error(a)        ((a)->error)
87
88 void iobuf_set_limit( IOBUF a, unsigned long nlimit );
89
90 ulong iobuf_tell( IOBUF a );
91 int   iobuf_seek( IOBUF a, ulong newpos );
92
93 int  iobuf_readbyte(IOBUF a);
94 int  iobuf_read(IOBUF a, byte *buf, unsigned buflen );
95 int  iobuf_peek(IOBUF a, byte *buf, unsigned buflen );
96 int  iobuf_writebyte(IOBUF a, unsigned c);
97 int  iobuf_write(IOBUF a, byte *buf, unsigned buflen );
98 int  iobuf_writestr(IOBUF a, const char *buf );
99
100 int  iobuf_write_temp( IOBUF a, IOBUF temp );
101 size_t iobuf_temp_to_buffer( IOBUF a, byte *buffer, size_t buflen );
102 void iobuf_unget_and_close_temp( IOBUF a, IOBUF temp );
103
104 u32 iobuf_get_filelength( IOBUF a );
105 const char *iobuf_get_fname( IOBUF a );
106
107 void iobuf_set_block_mode( IOBUF a, size_t n );
108 void iobuf_set_partial_block_mode( IOBUF a, size_t len );
109 int  iobuf_in_block_mode( IOBUF a );
110
111 /* get a byte form the iobuf; must check for eof prior to this function
112  * this function returns values in the range 0 .. 255 or -1 to indicate EOF
113  * iobuf_get_noeof() does not return -1 to indicate EOF, but masks the
114  * returned value to be in the range 0 ..255.
115  */
116 #define iobuf_get(a)  \
117      (  ((a)->nlimit || (a)->d.start >= (a)->d.len )?  \
118         iobuf_readbyte((a)) : ( (a)->nbytes++, (a)->d.buf[(a)->d.start++] ) )
119 #define iobuf_get_noeof(a)    (iobuf_get((a))&0xff)
120
121 /* use this if you have ungetted stuff */
122 #define iobuf_get2(a)  \
123      (  ( (a)->unget.buf || (a)->nlimit || (a)->d.start >= (a)->d.len )?  \
124         iobuf_readbyte((a)) : ( (a)->nbytes++, (a)->d.buf[(a)->d.start++] ) )
125
126 /* write a byte to the iobuf and return true on write error
127  * This macro does only write the low order byte
128  */
129 #define iobuf_put(a,c)  iobuf_writebyte(a,c)
130
131 #define iobuf_where(a)  "[don't know]"
132 #define iobuf_id(a)     ((a)->no)
133
134 #define iobuf_get_temp_length(a) ( (a)->d.len )
135 #define iobuf_is_temp(a)         ( (a)->usage == 3 )
136
137 #endif /*G10_IOBUF_H*/