Avoid catch-22 with README.main not being distributed but having the
[gnupg.git] / g10 / filter.h
blob923cfdadf7ad7d21907eb6a1bbb303108162c4da
1 /* filter.h
2 * Copyright (C) 1998, 1999, 2000, 2001, 2003,
3 * 2005 Free Software Foundation, Inc.
5 * This file is part of GnuPG.
7 * GnuPG is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 3 of the License, or
10 * (at your option) any later version.
12 * GnuPG is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, see <http://www.gnu.org/licenses/>.
20 #ifndef G10_FILTER_H
21 #define G10_FILTER_H
23 #include "types.h"
24 #include "cipher.h"
26 typedef struct {
27 gcry_md_hd_t md; /* catch all */
28 gcry_md_hd_t md2; /* if we want to calculate an alternate hash */
29 size_t maxbuf_size;
30 } md_filter_context_t;
32 typedef struct {
33 int refcount; /* Initialized to 1. */
35 /* these fields may be initialized */
36 int what; /* what kind of armor headers to write */
37 int only_keyblocks; /* skip all headers but ".... key block" */
38 const char *hdrlines; /* write these headerlines */
40 /* these fields must be initialized to zero */
41 int no_openpgp_data; /* output flag: "No valid OpenPGP data found" */
43 /* the following fields must be initialized to zero */
44 int inp_checked; /* set if the input has been checked */
45 int inp_bypass; /* set if the input is not armored */
46 int in_cleartext; /* clear text message */
47 int not_dash_escaped; /* clear text is not dash escaped */
48 int hashes; /* detected hash algorithms */
49 int faked; /* we are faking a literal data packet */
50 int truncated; /* number of truncated lines */
51 int qp_detected;
52 int pgp2mode;
53 byte eol[3]; /* The end of line characters as a
54 zero-terminated string. Defaults
55 (eol[0]=='\0') to whatever the local
56 platform uses. */
58 byte *buffer; /* malloced buffer */
59 unsigned buffer_size; /* and size of this buffer */
60 unsigned buffer_len; /* used length of the buffer */
61 unsigned buffer_pos; /* read position */
63 byte radbuf[4];
64 int idx, idx2;
65 u32 crc;
67 int status; /* an internal state flag */
68 int cancel;
69 int any_data; /* any valid armored data seen */
70 int pending_lf; /* used together with faked */
71 } armor_filter_context_t;
73 struct unarmor_pump_s;
74 typedef struct unarmor_pump_s *UnarmorPump;
77 struct compress_filter_context_s {
78 int status;
79 void *opaque; /* (used for z_stream) */
80 byte *inbuf;
81 unsigned inbufsize;
82 byte *outbuf;
83 unsigned outbufsize;
84 int algo; /* compress algo */
85 int algo1hack;
86 int new_ctb;
87 void (*release)(struct compress_filter_context_s*);
89 typedef struct compress_filter_context_s compress_filter_context_t;
92 typedef struct {
93 DEK *dek;
94 u32 datalen;
95 gcry_cipher_hd_t cipher_hd;
96 int header;
97 gcry_md_hd_t mdc_hash;
98 byte enchash[20];
99 int create_mdc; /* flag will be set by the cipher filter */
100 } cipher_filter_context_t;
104 typedef struct {
105 byte *buffer; /* malloced buffer */
106 unsigned buffer_size; /* and size of this buffer */
107 unsigned buffer_len; /* used length of the buffer */
108 unsigned buffer_pos; /* read position */
109 int truncated; /* number of truncated lines */
110 int not_dash_escaped;
111 int escape_from;
112 gcry_md_hd_t md;
113 int pending_lf;
114 int pending_esc;
115 } text_filter_context_t;
118 typedef struct {
119 char *what; /* description */
120 u32 last_time; /* last time reported */
121 unsigned long last; /* last amount reported */
122 unsigned long offset; /* current amount */
123 unsigned long total; /* total amount */
124 int refcount;
125 } progress_filter_context_t;
127 /* encrypt_filter_context_t defined in main.h */
129 /*-- mdfilter.c --*/
130 int md_filter( void *opaque, int control, iobuf_t a, byte *buf, size_t *ret_len);
131 void free_md_filter_context( md_filter_context_t *mfx );
133 /*-- armor.c --*/
134 armor_filter_context_t *new_armor_context (void);
135 void release_armor_context (armor_filter_context_t *afx);
136 int push_armor_filter (armor_filter_context_t *afx, iobuf_t iobuf);
137 int use_armor_filter( iobuf_t a );
138 UnarmorPump unarmor_pump_new (void);
139 void unarmor_pump_release (UnarmorPump x);
140 int unarmor_pump (UnarmorPump x, int c);
142 /*-- compress.c --*/
143 void push_compress_filter(iobuf_t out,compress_filter_context_t *zfx,int algo);
144 void push_compress_filter2(iobuf_t out,compress_filter_context_t *zfx,
145 int algo,int rel);
147 /*-- cipher.c --*/
148 int cipher_filter( void *opaque, int control,
149 iobuf_t chain, byte *buf, size_t *ret_len);
151 /*-- textfilter.c --*/
152 int text_filter( void *opaque, int control,
153 iobuf_t chain, byte *buf, size_t *ret_len);
154 int copy_clearsig_text (iobuf_t out, iobuf_t inp, gcry_md_hd_t md,
155 int escape_dash, int escape_from, int pgp2mode);
157 /*-- progress.c --*/
158 progress_filter_context_t *new_progress_context (void);
159 void release_progress_context (progress_filter_context_t *pfx);
160 void handle_progress (progress_filter_context_t *pfx,
161 iobuf_t inp, const char *name);
163 #endif /*G10_FILTER_H*/