def0a6506d834b1e4e0cda987e3b2a504b9f8bae
[gnupg.git] / common / iobuf.h
1 /* iobuf.h - I/O buffer
2  * Copyright (C) 1998, 1999, 2000, 2001, 2003 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 GNUPG_COMMON_IOBUF_H
22 #define GNUPG_COMMON_IOBUF_H
23
24 #include "../include/types.h" /* fixme: should be moved elsewhere. */
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_CANCEL    6
36 #define IOBUFCTRL_USER      16
37
38 typedef struct iobuf_struct *iobuf_t;
39 typedef struct iobuf_struct *IOBUF;  /* Compatibility with gpg 1.4. */
40
41 /* fixme: we should hide most of this stuff */
42 struct iobuf_struct
43 {
44   int use;                      /* 1 input , 2 output, 3 temp */
45   off_t nlimit;
46   off_t nbytes;                 /* used together with nlimit */
47   off_t ntotal;                 /* total bytes read (position of stream) */
48   int nofast;                   /* used by the iobuf_get() */
49   void *directfp;
50   struct
51   {
52     size_t size;                /* allocated size */
53     size_t start;               /* number of invalid bytes at the begin of the buffer */
54     size_t len;                 /* currently filled to this size */
55     byte *buf;
56   }
57   d;
58   int filter_eof;
59   int error;
60   int (*filter) (void *opaque, int control,
61                  iobuf_t chain, byte * buf, size_t * len);
62   void *filter_ov;              /* value for opaque */
63   int filter_ov_owner;
64   char *real_fname;
65   iobuf_t chain;                        /* next iobuf used for i/o if any
66                                    (passed to filter) */
67   int no, subno;
68   const char *desc;
69   void *opaque;                 /* can be used to hold any information
70                                    this value is copied to all
71                                    instances */
72   struct
73   {
74     size_t size;                /* allocated size */
75     size_t start;               /* number of invalid bytes at the
76                                    begin of the buffer */
77     size_t len;                 /* currently filled to this size */
78     byte *buf;
79   }
80   unget;
81 };
82
83 #ifndef EXTERN_UNLESS_MAIN_MODULE
84 #if defined (__riscos__) && !defined (INCLUDED_BY_MAIN_MODULE)
85 #define EXTERN_UNLESS_MAIN_MODULE extern
86 #else
87 #define EXTERN_UNLESS_MAIN_MODULE
88 #endif
89 #endif
90 EXTERN_UNLESS_MAIN_MODULE int iobuf_debug_mode;
91
92 void iobuf_enable_special_filenames (int yes);
93 iobuf_t iobuf_alloc (int use, size_t bufsize);
94 iobuf_t iobuf_temp (void);
95 iobuf_t iobuf_temp_with_content (const char *buffer, size_t length);
96 iobuf_t iobuf_open (const char *fname);
97 iobuf_t iobuf_fdopen (int fd, const char *mode);
98 iobuf_t iobuf_sockopen (int fd, const char *mode);
99 iobuf_t iobuf_create (const char *fname);
100 iobuf_t iobuf_append (const char *fname);
101 iobuf_t iobuf_openrw (const char *fname);
102 int iobuf_ioctl (iobuf_t a, int cmd, int intval, void *ptrval);
103 int iobuf_close (iobuf_t iobuf);
104 int iobuf_cancel (iobuf_t iobuf);
105
106 int iobuf_push_filter (iobuf_t a, int (*f) (void *opaque, int control,
107                                           iobuf_t chain, byte * buf,
108                                           size_t * len), void *ov);
109 int iobuf_push_filter2 (iobuf_t a,
110                         int (*f) (void *opaque, int control, iobuf_t chain,
111                                   byte * buf, size_t * len), void *ov,
112                         int rel_ov);
113 int iobuf_flush (iobuf_t a);
114 void iobuf_clear_eof (iobuf_t a);
115 #define iobuf_set_error(a)    do { (a)->error = 1; } while(0)
116 #define iobuf_error(a)        ((a)->error)
117
118 void iobuf_set_limit (iobuf_t a, off_t nlimit);
119
120 off_t iobuf_tell (iobuf_t a);
121 int iobuf_seek (iobuf_t a, off_t newpos);
122
123 int iobuf_readbyte (iobuf_t a);
124 int iobuf_read (iobuf_t a, void *buf, unsigned buflen);
125 unsigned iobuf_read_line (iobuf_t a, byte ** addr_of_buffer,
126                           unsigned *length_of_buffer, unsigned *max_length);
127 int iobuf_peek (iobuf_t a, byte * buf, unsigned buflen);
128 int iobuf_writebyte (iobuf_t a, unsigned c);
129 int iobuf_write (iobuf_t a, const void *buf, unsigned buflen);
130 int iobuf_writestr (iobuf_t a, const char *buf);
131
132 void iobuf_flush_temp (iobuf_t temp);
133 int iobuf_write_temp (iobuf_t a, iobuf_t temp);
134 size_t iobuf_temp_to_buffer (iobuf_t a, byte * buffer, size_t buflen);
135 void iobuf_unget_and_close_temp (iobuf_t a, iobuf_t temp);
136
137 off_t iobuf_get_filelength (iobuf_t a);
138 #define IOBUF_FILELENGTH_LIMIT 0xffffffff
139 const char *iobuf_get_real_fname (iobuf_t a);
140 const char *iobuf_get_fname (iobuf_t a);
141
142 void iobuf_set_block_mode (iobuf_t a, size_t n);
143 void iobuf_set_partial_block_mode (iobuf_t a, size_t len);
144 int iobuf_in_block_mode (iobuf_t a);
145
146 int iobuf_translate_file_handle (int fd, int for_write);
147
148
149 /* get a byte form the iobuf; must check for eof prior to this function
150  * this function returns values in the range 0 .. 255 or -1 to indicate EOF
151  * iobuf_get_noeof() does not return -1 to indicate EOF, but masks the
152  * returned value to be in the range 0 ..255.
153  */
154 #define iobuf_get(a)  \
155      (  ((a)->nofast || (a)->d.start >= (a)->d.len )?  \
156         iobuf_readbyte((a)) : ( (a)->nbytes++, (a)->d.buf[(a)->d.start++] ) )
157 #define iobuf_get_noeof(a)    (iobuf_get((a))&0xff)
158
159 /* write a byte to the iobuf and return true on write error
160  * This macro does only write the low order byte
161  */
162 #define iobuf_put(a,c)  iobuf_writebyte(a,c)
163
164 #define iobuf_where(a)  "[don't know]"
165 #define iobuf_id(a)     ((a)->no)
166
167 #define iobuf_get_temp_buffer(a) ( (a)->d.buf )
168 #define iobuf_get_temp_length(a) ( (a)->d.len )
169 #define iobuf_is_temp(a)         ( (a)->use == 3 )
170
171 #endif /*GNUPG_COMMON_IOBUF_H*/