gpg: New card function agent_scd_keypairinfo.
[gnupg.git] / g10 / filter.h
1 /* filter.h
2  * Copyright (C) 1998, 1999, 2000, 2001, 2003,
3  *               2005 Free Software Foundation, Inc.
4  *
5  * This file is part of GnuPG.
6  *
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.
11  *
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.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program; if not, see <https://www.gnu.org/licenses/>.
19  */
20 #ifndef G10_FILTER_H
21 #define G10_FILTER_H
22
23 #include "../common/types.h"
24 #include "dek.h"
25
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;
31
32 typedef struct {
33     int  refcount;          /* Initialized to 1.  */
34
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 */
39
40     /* these fields must be initialized to zero */
41     int no_openpgp_data;    /* output flag: "No valid OpenPGP data found" */
42
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     byte eol[3];            /* The end of line characters as a
53                                zero-terminated string.  Defaults
54                                (eol[0]=='\0') to whatever the local
55                                platform uses. */
56
57     byte *buffer;           /* malloced buffer */
58     unsigned buffer_size;   /* and size of this buffer */
59     unsigned buffer_len;    /* used length of the buffer */
60     unsigned buffer_pos;    /* read position */
61
62     byte radbuf[4];
63     int idx, idx2;
64     gcry_md_hd_t crc_md;
65
66     int status;             /* an internal state flag */
67     int cancel;
68     int any_data;           /* any valid armored data seen */
69     int pending_lf;         /* used together with faked */
70 } armor_filter_context_t;
71
72
73
74 struct compress_filter_context_s {
75     int status;
76     void *opaque;   /* (used for z_stream) */
77     byte *inbuf;
78     unsigned inbufsize;
79     byte *outbuf;
80     unsigned outbufsize;
81     int algo;    /* compress algo */
82     int algo1hack;
83     int new_ctb;
84     void (*release)(struct compress_filter_context_s*);
85 };
86 typedef struct compress_filter_context_s compress_filter_context_t;
87
88
89 typedef struct
90 {
91   /* Object with the key and algo */
92   DEK *dek;
93
94   /* Length of the data to encrypt if known - 32 bit because OpenPGP
95    * requires partial encoding for a larger data size.  */
96   u32 datalen;
97
98   /* The current cipher handle.  */
99   gcry_cipher_hd_t cipher_hd;
100
101   /* Various processing flags.  */
102   unsigned int wrote_header : 1;
103   unsigned int short_blklen_warn : 1;
104   unsigned long short_blklen_count;
105
106   /* The encoded chunk byte for AEAD.  */
107   byte chunkbyte;
108
109   /* The decoded CHUNKBYTE.  */
110   uint64_t chunksize;
111
112   /* The chunk index for AEAD.  */
113   uint64_t chunkindex;
114
115   /* The number of bytes in the current chunk.  */
116   uint64_t chunklen;
117
118   /* The total count of encrypted plaintext octets.  Note that we
119    * don't care about encrypting more than 16 Exabyte. */
120   uint64_t total;
121
122   /* The hash context and a buffer used for MDC.  */
123   gcry_md_hd_t mdc_hash;
124   byte enchash[20];
125
126   /* The start IV for AEAD encryption.   */
127   byte startiv[16];
128
129   /* Using a large buffer for encryption makes processing easier and
130    * also makes sure the data is well aligned.  */
131   char *buffer;
132   size_t bufsize;  /* Allocated length.  */
133   size_t buflen;   /* Used length.       */
134
135 } cipher_filter_context_t;
136
137
138
139 typedef struct {
140     byte *buffer;           /* malloced buffer */
141     unsigned buffer_size;   /* and size of this buffer */
142     unsigned buffer_len;    /* used length of the buffer */
143     unsigned buffer_pos;    /* read position */
144     int truncated;          /* number of truncated lines */
145     int not_dash_escaped;
146     int escape_from;
147     gcry_md_hd_t md;
148     int pending_lf;
149     int pending_esc;
150 } text_filter_context_t;
151
152
153 typedef struct {
154     char *what;                 /* description */
155     u32 last_time;              /* last time reported */
156     unsigned long last;         /* last amount reported */
157     unsigned long offset;       /* current amount */
158     unsigned long total;        /* total amount */
159     int  refcount;
160 } progress_filter_context_t;
161
162 /* encrypt_filter_context_t defined in main.h */
163
164 /*-- mdfilter.c --*/
165 int md_filter( void *opaque, int control, iobuf_t a, byte *buf, size_t *ret_len);
166 void free_md_filter_context( md_filter_context_t *mfx );
167
168 /*-- armor.c --*/
169 armor_filter_context_t *new_armor_context (void);
170 void release_armor_context (armor_filter_context_t *afx);
171 int push_armor_filter (armor_filter_context_t *afx, iobuf_t iobuf);
172 int use_armor_filter( iobuf_t a );
173
174 /*-- compress.c --*/
175 gpg_error_t push_compress_filter (iobuf_t out, compress_filter_context_t *zfx,
176                                   int algo);
177 gpg_error_t push_compress_filter2 (iobuf_t out,compress_filter_context_t *zfx,
178                                    int algo, int rel);
179
180 /*-- cipher.c --*/
181 int cipher_filter_cfb (void *opaque, int control,
182                        iobuf_t chain, byte *buf, size_t *ret_len);
183
184 /*-- cipher-aead.c --*/
185 int cipher_filter_aead (void *opaque, int control,
186                         iobuf_t chain, byte *buf, size_t *ret_len);
187
188 /*-- textfilter.c --*/
189 int text_filter( void *opaque, int control,
190                  iobuf_t chain, byte *buf, size_t *ret_len);
191 int copy_clearsig_text (iobuf_t out, iobuf_t inp, gcry_md_hd_t md,
192                         int escape_dash, int escape_from);
193
194 /*-- progress.c --*/
195 progress_filter_context_t *new_progress_context (void);
196 void release_progress_context (progress_filter_context_t *pfx);
197 void handle_progress (progress_filter_context_t *pfx,
198                       iobuf_t inp, const char *name);
199
200 #endif /*G10_FILTER_H*/