mp.c: Export `implicitmp' and `implicitgf'.
[catacomb-python] / catacomb-python.h
CommitLineData
d7ab1bab 1/* -*-c-*-
2 *
d7ab1bab 3 * Definitions for Catacomb bindings
4 *
5 * (c) 2004 Straylight/Edgeware
6 */
7
b2687a0a 8/*----- Licensing notice --------------------------------------------------*
d7ab1bab 9 *
10 * This file is part of the Python interface to Catacomb.
11 *
12 * Catacomb/Python is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 of the License, or
15 * (at your option) any later version.
b2687a0a 16 *
d7ab1bab 17 * Catacomb/Python is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
b2687a0a 21 *
d7ab1bab 22 * You should have received a copy of the GNU General Public License
23 * along with Catacomb/Python; if not, write to the Free Software Foundation,
24 * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
25 */
26
27#ifndef CATACOMB_PYTHON_H
28#define CATACOMB_PYTHON_H
29
30#ifdef __cplusplus
31 extern "C" {
32#endif
33
34/*----- Header files ------------------------------------------------------*/
35
10e6f88a 36#include "pyke/pyke-mLib.h"
6b54260d 37
10e6f88a 38PUBLIC_SYMBOLS;
d7ab1bab 39#include <longintrepr.h>
d7ab1bab 40
d7ab1bab 41#include <mLib/dstr.h>
42#include <mLib/macros.h>
46e6ad89 43#include <mLib/quis.h>
6d481bc6 44#include <mLib/unihash.h>
d7ab1bab 45
46#include <catacomb/buf.h>
bfb450cc 47#include <catacomb/ct.h>
d7ab1bab 48
49#include <catacomb/grand.h>
50#include <catacomb/rand.h>
51#include <catacomb/noise.h>
52#include <catacomb/bbs.h>
53#include <catacomb/mprand.h>
54#include <catacomb/lcrand.h>
55#include <catacomb/fibrand.h>
56#include <catacomb/dsarand.h>
57#include <catacomb/sslprf.h>
58#include <catacomb/tlsprf.h>
03ed9abb 59#include <catacomb/blkc.h>
d7ab1bab 60
61#include <catacomb/gcipher.h>
bebf03ab 62#include <catacomb/gaead.h>
d7ab1bab 63#include <catacomb/ghash.h>
64#include <catacomb/gmac.h>
65#include <catacomb/md5.h>
66#include <catacomb/md5-hmac.h>
204d480b 67#include <catacomb/poly1305.h>
d7ab1bab 68#include <catacomb/sha.h>
69#include <catacomb/sha-mgf.h>
70#include <catacomb/sha-hmac.h>
b35fdbe6 71#include <catacomb/keccak1600.h>
6bd22b53 72#include <catacomb/sha3.h>
d7ab1bab 73
74#include <catacomb/mp.h>
75#include <catacomb/mpint.h>
76#include <catacomb/mpmul.h>
77#include <catacomb/mpcrt.h>
78#include <catacomb/mpmont.h>
79#include <catacomb/mpbarrett.h>
80#include <catacomb/mpreduce.h>
6313f40e 81#include <catacomb/mp-fibonacci.h>
d7ab1bab 82
83#include <catacomb/pgen.h>
84#include <catacomb/pfilt.h>
85#include <catacomb/strongprime.h>
86#include <catacomb/limlee.h>
87#include <catacomb/dh.h>
88#include <catacomb/ptab.h>
89#include <catacomb/bintab.h>
90#include <catacomb/dsa.h>
848ba392 91#include <catacomb/x25519.h>
eb8aa4ec 92#include <catacomb/x448.h>
dafb2da4 93#include <catacomb/ed25519.h>
eee202c3 94#include <catacomb/ed448.h>
d7ab1bab 95
96#include <catacomb/gf.h>
97#include <catacomb/gfreduce.h>
98#include <catacomb/gfn.h>
99
100#include <catacomb/field.h>
101#include <catacomb/field-guts.h>
102
103#include <catacomb/ec.h>
104#include <catacomb/ec-raw.h>
105#include <catacomb/ectab.h>
106
107#include <catacomb/group.h>
108#include <catacomb/group-guts.h>
109
110#include <catacomb/gdsa.h>
111#include <catacomb/gkcdsa.h>
112#include <catacomb/rsa.h>
113
114#include <catacomb/key.h>
115#include <catacomb/passphrase.h>
116#include <catacomb/pixie.h>
117
46e6ad89 118#include <catacomb/share.h>
119#include <catacomb/gfshare.h>
6640e060
MW
120PRIVATE_SYMBOLS;
121
10e6f88a 122/*----- Miscellaneous preliminaries ---------------------------------------*/
d7ab1bab 123
10e6f88a 124/* Submodules. */
46e6ad89 125#define MODULES(_) \
10e6f88a 126 _(pyke_core) _(pyke_gmap) \
46e6ad89 127 _(bytestring) _(buffer) \
128 _(rand) _(algorithms) _(pubkey) _(pgen) \
129 _(mp) _(field) _(ec) _(group) \
0b1b92bd 130 _(passphrase) _(share) _(key)
4e191783 131MODULES(DECLARE_MODINIT)
d7ab1bab 132
10e6f88a
MW
133/* Exceptions. */
134#define PGENERR(err) do { pgenerr(err); goto end; } while (0)
135
136/* Conversions. */
137extern int convmpw(PyObject *, void *);
3aa33042 138
a539ffb8
MW
139/* Building tables of things. */
140extern PyObject *make_algtab(const void *tab, size_t esz,
141 const char *(*namefn)(const void *),
142 PyObject *(*valfn)(const void *));
143extern PyObject *make_grouptab(const void *tab, size_t esz,
144 const char *(*namefn)(const void *),
145 int (*ixfn)(const void *),
146 PyObject *(*valfn)(int));
11cb3d97 147
10e6f88a 148/* Common handling for simultaneous exponentiation. */
11cb3d97
MW
149extern PyObject *mexp_common(PyObject *, PyObject *, size_t,
150 PyObject *(*id)(PyObject *),
151 int (*fill)(void *, PyObject *,
152 PyObject *, PyObject *),
153 PyObject *(*exp)(PyObject *, void *, int),
154 void (*drop)(void *));
155
d7ab1bab 156/*----- Bytestrings -------------------------------------------------------*/
157
d7ab1bab 158PyObject *bytestring_pywrap(const void *, size_t);
159PyObject *bytestring_pywrapbuf(buf *);
160
dc088b4d
MW
161/*----- Buffers -----------------------------------------------------------*/
162
163typedef struct buf_pyobj {
164 PyObject_HEAD
165 buf b;
166 PyObject *sub;
167 unsigned lk;
168} buf_pyobj;
169
170extern PyTypeObject *rbuf_pytype, *wbuf_pytype;
171#define RBUF_PYCHECK(o) PyObject_TypeCheck((o), rbuf_pytype)
172#define WBUF_PYCHECK(o) PyObject_TypeCheck((o), wbuf_pytype)
173#define BUF_B(o) (&((buf_pyobj *)(o))->b)
174#define BUF_SUB(o) (((buf_pyobj *)(o))->sub)
175#define BUF_LK(o) (((buf_pyobj *)(o))->lk)
176
177extern PyObject *buferr;
178#define BUFERR(str) do { PyErr_SetString(buferr, str); goto end; } while (0)
179
180extern int ensurebuf(PyObject *, size_t);
181
d7ab1bab 182/*----- Multiprecision arithmetic -----------------------------------------*/
183
184typedef struct mp_pyobj {
185 PyObject_HEAD
186 mp *x;
187} mp_pyobj;
188
189extern PyTypeObject *mp_pytype;
190extern PyTypeObject *gf_pytype;
191#define MP_X(o) (((mp_pyobj *)(o))->x)
192#define MP_PYCHECK(o) PyObject_TypeCheck((o), mp_pytype)
193#define GF_PYCHECK(o) PyObject_TypeCheck((o), gf_pytype)
194
f368b46e
MW
195extern mp *mp_frompylong(PyObject *);
196extern PyObject *mp_topylong(mp *);
d7ab1bab 197extern mp *tomp(PyObject *);
5b29dfaf 198extern mp *implicitmp(PyObject *);
d7ab1bab 199extern mp *getmp(PyObject *);
200extern int convmp(PyObject *, void *);
5b29dfaf 201extern mp *implicitgf(PyObject *);
d7ab1bab 202extern mp *getgf(PyObject *);
203extern int convgf(PyObject *, void *);
204extern PyObject *mp_pywrap(mp *);
205extern PyObject *gf_pywrap(mp *);
d6d78edc 206extern Py_hash_t mphash(mp *);
d7ab1bab 207extern mp *mp_frompyobject(PyObject *, int);
208extern PyObject *mp_topystring(mp *, int,
209 const char *, const char *, const char *);
bc243788 210extern int mp_tolong_checked(mp *, long *, int);
d7ab1bab 211
212/*----- Abstract fields ---------------------------------------------------*/
213
214typedef struct field_pyobj {
df9f8366 215 PyHeapTypeObject ty;
d7ab1bab 216 field *f;
217} field_pyobj;
218
d7ab1bab 219extern PyTypeObject *field_pytype;
220extern PyTypeObject *primefield_pytype;
221extern PyTypeObject *niceprimefield_pytype;
222extern PyTypeObject *binfield_pytype;
223extern PyTypeObject *binpolyfield_pytype;
224extern PyTypeObject *binnormfield_pytype;
225#define FIELD_PYCHECK(o) PyObject_TypeCheck((o), field_pytype)
226#define FIELD_F(o) (((field_pyobj *)(o))->f)
227extern PyObject *field_pywrap(field *);
228extern field *field_copy(field *);
229
c6e89d48
MW
230typedef struct fe_pyobj {
231 PyObject_HEAD
232 field *f;
233 mp *x;
234} fe_pyobj;
235
236extern PyTypeObject *fe_pytype;
237#define FE_PYCHECK(o) PyObject_TypeCheck((o), fe_pytype)
238#define FE_F(o) (((fe_pyobj *)(o))->f)
2a448f86 239#define FE_FOBJ(o) ((PyObject *)Py_TYPE(o))
c6e89d48
MW
240#define FE_X(o) (((fe_pyobj *)(o))->x)
241extern PyObject *fe_pywrap(PyObject *, mp *);
242
d7ab1bab 243/*----- Elliptic curves ---------------------------------------------------*/
244
c6e89d48
MW
245typedef struct eccurve_pyobj {
246 PyHeapTypeObject ty;
247 ec_curve *c;
248 PyObject *fobj;
249} eccurve_pyobj;
250
251extern PyTypeObject *eccurve_pytype;
252extern PyTypeObject *ecprimecurve_pytype;
253extern PyTypeObject *ecprimeprojcurve_pytype;
254extern PyTypeObject *ecbincurve_pytype;
255extern PyTypeObject *ecbinprojcurve_pytype;
256#define ECCURVE_PYCHECK(o) PyObject_TypeCheck((o), eccurve_pytype)
257#define ECCURVE_C(o) (((eccurve_pyobj *)(o))->c)
258#define ECCURVE_FOBJ(o) (((eccurve_pyobj *)(o))->fobj)
259extern PyObject *eccurve_pywrap(PyObject *, ec_curve *);
260extern ec_curve *eccurve_copy(ec_curve *);
261
d7ab1bab 262typedef struct ecpt_pyobj {
263 PyObject_HEAD
264 ec_curve *c;
265 ec p;
266} ecpt_pyobj;
267
268extern PyTypeObject *ecpt_pytype, *ecptcurve_pytype;
269#define ECPT_PYCHECK(o) PyObject_TypeCheck((o), ecpt_pytype)
270#define ECPTCURVE_PYCHECK(o) PyObject_TypeCheck((o), ecptcurve_pytype)
271#define ECPT_C(o) (((ecpt_pyobj *)(o))->c)
2a448f86 272#define ECPT_COBJ(o) ((PyObject *)Py_TYPE(o))
d7ab1bab 273#define ECPT_FOBJ(o) ECCURVE_FOBJ(ECPT_COBJ((o)))
274#define ECPT_P(o) (&((ecpt_pyobj *)(o))->p)
275extern PyObject *ecpt_pywrap(PyObject *, ec *);
276extern PyObject *ecpt_pywrapout(void *, ec *);
277extern int toecpt(ec_curve *, ec *, PyObject *);
278extern int getecpt(ec_curve *, ec *, PyObject *);
279extern void getecptout(ec *, PyObject *);
46e6ad89 280extern int convecpt(PyObject *, void *);
d7ab1bab 281
d7ab1bab 282typedef struct ecinfo_pyobj {
283 PyObject_HEAD
284 ec_info ei;
285 PyObject *cobj;
286} ecinfo_pyobj;
b2687a0a 287
d7ab1bab 288extern PyTypeObject *ecinfo_pytype;
289#define ECINFO_PYCHECK(o) PyObject_TypeCheck((o), ecinfo_pytype)
290#define ECINFO_EI(o) (&((ecinfo_pyobj *)(o))->ei)
291#define ECINFO_COBJ(o) (((ecinfo_pyobj *)(o))->cobj)
292extern void ecinfo_copy(ec_info *, const ec_info *);
293extern PyObject *ecinfo_pywrap(ec_info *);
294
295/*----- Cyclic groups -----------------------------------------------------*/
296
d7ab1bab 297typedef struct ge_pyobj {
298 PyObject_HEAD
299 ge *x;
300 group *g;
301} ge_pyobj;
302
303extern PyTypeObject *ge_pytype;
304#define GE_PYCHECK(o) PyObject_TypeCheck((o), ge_pytype)
305#define GE_X(o) (((ge_pyobj *)(o))->x)
306#define GE_G(o) (((ge_pyobj *)(o))->g)
2a448f86 307#define GE_GOBJ(o) (PyObject *)(Py_TYPE(o))
d7ab1bab 308extern PyObject *ge_pywrap(PyObject *, ge *);
309
310typedef struct group_pyobj {
df9f8366 311 PyHeapTypeObject ty;
d7ab1bab 312 group *g;
313} group_pyobj;
314
315extern PyTypeObject *group_pytype;
d7ab1bab 316#define GROUP_G(o) (((group_pyobj *)(o))->g)
317extern PyObject *group_pywrap(group *);
318extern group *group_copy(group *);
319
320/*----- Random number generators ------------------------------------------*/
321
322#define f_freeme 1u
323
324typedef struct grand_pyobj {
325 PyObject_HEAD
326 unsigned f;
327 grand *r;
328} grand_pyobj;
329
c6e89d48 330extern PyTypeObject *grand_pytype;
d7ab1bab 331extern PyObject *rand_pyobj;
332#define GRAND_PYCHECK(o) PyObject_TypeCheck((o), grand_pytype)
333#define GRAND_F(o) (((grand_pyobj *)(o))->f)
334#define GRAND_R(o) (((grand_pyobj *)(o))->r)
335extern PyObject *grand_pywrap(grand *, unsigned);
336extern int convgrand(PyObject *, void *);
337
d7ab1bab 338/*----- Symmetric cryptography --------------------------------------------*/
339
c6e89d48 340extern PyObject *keysz_pywrap(const octet *);
d7ab1bab 341
d7ab1bab 342extern int convgccipher(PyObject *, void *);
c6e89d48 343extern PyObject *gccipher_pywrap(gccipher *);
bebf03ab 344
d7ab1bab 345typedef struct gchash_pyobj {
df9f8366 346 PyHeapTypeObject ty;
d7ab1bab 347 gchash *ch;
348} gchash_pyobj;
349
350extern PyTypeObject *gchash_pytype;
c6e89d48 351extern PyObject *sha_pyobj, *has160_pyobj;
d7ab1bab 352#define GCHASH_PYCHECK(o) PyObject_TypeCheck((o), gchash_pytype)
353#define GCHASH_CH(o) (((gchash_pyobj *)(o))->ch)
c41d0371 354extern PyObject *ghash_pywrap(PyObject *, ghash *);
c6e89d48 355extern int convgchash(PyObject *, void *);
d7ab1bab 356extern int convghash(PyObject *, void *);
d7ab1bab 357
d7ab1bab 358extern int convgcmac(PyObject *, void *);
359
d7ab1bab 360/*----- Key generation ----------------------------------------------------*/
b2687a0a 361
d7ab1bab 362typedef struct pfilt_pyobj {
363 PyObject_HEAD
364 pfilt f;
365 int st;
366} pfilt_pyobj;
367
368extern PyTypeObject *pfilt_pytype;
369#define PFILT_PYCHECK(o) PyObject_TypeCheck(o, pfilt_pytype)
370#define PFILT_F(o) (&((pfilt_pyobj *)(o))->f)
371#define PFILT_ST(o) (((pfilt_pyobj *)(o))->st)
372
373typedef struct { pgen_proc *proc; void *ctx; } pgev;
374#define PGEV_HEAD PyObject_HEAD pgev pg;
375
376typedef struct pgev_pyobj {
377 PGEV_HEAD
378} pgev_pyobj;
379
380extern PyTypeObject *pgev_pytype;
381#define PGEV_PYCHECK(o) PyObject_TypeCheck(o, pgev_pytype)
382#define PGEV_PG(o) (&((pgev_pyobj *)(o))->pg)
383
930d78e3
MW
384typedef struct pypgev {
385 pgev ev;
386 PyObject *obj;
387 struct excinfo *exc;
388} pypgev;
389
d7ab1bab 390extern int convpgev(PyObject *, void *);
930d78e3
MW
391extern void droppgev(pypgev *);
392extern void pgenerr(struct excinfo *exc);
d7ab1bab 393
d7ab1bab 394/*----- That's all, folks -------------------------------------------------*/
395
396#ifdef __cplusplus
397 }
398#endif
399
400#endif