Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 1 | /*********************************************************** |
Guido van Rossum | fd71b9e | 2000-06-30 23:50:40 +0000 | [diff] [blame] | 2 | Copyright (c) 2000, BeOpen.com. |
| 3 | Copyright (c) 1995-2000, Corporation for National Research Initiatives. |
| 4 | Copyright (c) 1990-1995, Stichting Mathematisch Centrum. |
| 5 | All rights reserved. |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 6 | |
Guido van Rossum | fd71b9e | 2000-06-30 23:50:40 +0000 | [diff] [blame] | 7 | See the file "Misc/COPYRIGHT" for information on usage and |
| 8 | redistribution of this file, and for a DISCLAIMER OF ALL WARRANTIES. |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 9 | ******************************************************************/ |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 10 | |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 11 | /* MD5 module */ |
| 12 | |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 13 | /* This module provides an interface to the RSA Data Security, |
| 14 | Inc. MD5 Message-Digest Algorithm, described in RFC 1321. |
| 15 | It requires the files md5c.c and md5.h (which are slightly changed |
| 16 | from the versions in the RFC to avoid the "global.h" file.) */ |
| 17 | |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 18 | |
| 19 | /* MD5 objects */ |
| 20 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 21 | #include "Python.h" |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 22 | #include "md5.h" |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 23 | |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 24 | typedef struct { |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 25 | PyObject_HEAD |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 26 | MD5_CTX md5; /* the context holder */ |
| 27 | } md5object; |
| 28 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 29 | staticforward PyTypeObject MD5type; |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 30 | |
| 31 | #define is_md5object(v) ((v)->ob_type == &MD5type) |
| 32 | |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 33 | static md5object * |
| 34 | newmd5object() |
| 35 | { |
| 36 | md5object *md5p; |
| 37 | |
Guido van Rossum | b18618d | 2000-05-03 23:44:39 +0000 | [diff] [blame] | 38 | md5p = PyObject_New(md5object, &MD5type); |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 39 | if (md5p == NULL) |
| 40 | return NULL; |
| 41 | |
| 42 | MD5Init(&md5p->md5); /* actual initialisation */ |
| 43 | return md5p; |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 44 | } |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 45 | |
| 46 | |
| 47 | /* MD5 methods */ |
| 48 | |
| 49 | static void |
| 50 | md5_dealloc(md5p) |
| 51 | md5object *md5p; |
| 52 | { |
Guido van Rossum | b18618d | 2000-05-03 23:44:39 +0000 | [diff] [blame] | 53 | PyObject_Del(md5p); |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 54 | } |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 55 | |
| 56 | |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 57 | /* MD5 methods-as-attributes */ |
| 58 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 59 | static PyObject * |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 60 | md5_update(self, args) |
| 61 | md5object *self; |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 62 | PyObject *args; |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 63 | { |
| 64 | unsigned char *cp; |
| 65 | int len; |
| 66 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 67 | if (!PyArg_Parse(args, "s#", &cp, &len)) |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 68 | return NULL; |
| 69 | |
| 70 | MD5Update(&self->md5, cp, len); |
| 71 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 72 | Py_INCREF(Py_None); |
| 73 | return Py_None; |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 74 | } |
| 75 | |
Guido van Rossum | d3a6a14 | 1998-10-14 13:46:57 +0000 | [diff] [blame] | 76 | static char update_doc [] = |
| 77 | "update (arg)\n\ |
| 78 | \n\ |
| 79 | Update the md5 object with the string arg. Repeated calls are\n\ |
| 80 | equivalent to a single call with the concatenation of all the\n\ |
| 81 | arguments."; |
| 82 | |
| 83 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 84 | static PyObject * |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 85 | md5_digest(self, args) |
| 86 | md5object *self; |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 87 | PyObject *args; |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 88 | { |
| 89 | |
| 90 | MD5_CTX mdContext; |
| 91 | unsigned char aDigest[16]; |
| 92 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 93 | if (!PyArg_NoArgs(args)) |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 94 | return NULL; |
| 95 | |
| 96 | /* make a temporary copy, and perform the final */ |
| 97 | mdContext = self->md5; |
| 98 | MD5Final(aDigest, &mdContext); |
| 99 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 100 | return PyString_FromStringAndSize((char *)aDigest, 16); |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 101 | } |
| 102 | |
Guido van Rossum | d3a6a14 | 1998-10-14 13:46:57 +0000 | [diff] [blame] | 103 | static char digest_doc [] = |
| 104 | "digest() -> string\n\ |
| 105 | \n\ |
| 106 | Return the digest of the strings passed to the update() method so\n\ |
| 107 | far. This is an 16-byte string which may contain non-ASCII characters,\n\ |
| 108 | including null bytes."; |
| 109 | |
| 110 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 111 | static PyObject * |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 112 | md5_copy(self, args) |
| 113 | md5object *self; |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 114 | PyObject *args; |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 115 | { |
| 116 | md5object *md5p; |
| 117 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 118 | if (!PyArg_NoArgs(args)) |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 119 | return NULL; |
| 120 | |
| 121 | if ((md5p = newmd5object()) == NULL) |
| 122 | return NULL; |
| 123 | |
| 124 | md5p->md5 = self->md5; |
| 125 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 126 | return (PyObject *)md5p; |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 127 | } |
| 128 | |
Guido van Rossum | d3a6a14 | 1998-10-14 13:46:57 +0000 | [diff] [blame] | 129 | static char copy_doc [] = |
| 130 | "copy() -> md5 object\n\ |
| 131 | \n\ |
| 132 | Return a copy (``clone'') of the md5 object."; |
| 133 | |
| 134 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 135 | static PyMethodDef md5_methods[] = { |
Guido van Rossum | d3a6a14 | 1998-10-14 13:46:57 +0000 | [diff] [blame] | 136 | {"update", (PyCFunction)md5_update, 0, update_doc}, |
| 137 | {"digest", (PyCFunction)md5_digest, 0, digest_doc}, |
| 138 | {"copy", (PyCFunction)md5_copy, 0, copy_doc}, |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 139 | {NULL, NULL} /* sentinel */ |
| 140 | }; |
| 141 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 142 | static PyObject * |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 143 | md5_getattr(self, name) |
| 144 | md5object *self; |
| 145 | char *name; |
| 146 | { |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 147 | return Py_FindMethod(md5_methods, (PyObject *)self, name); |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 148 | } |
| 149 | |
Guido van Rossum | d3a6a14 | 1998-10-14 13:46:57 +0000 | [diff] [blame] | 150 | static char module_doc [] = |
| 151 | |
| 152 | "This module implements the interface to RSA's MD5 message digest\n\ |
| 153 | algorithm (see also Internet RFC 1321). Its use is quite\n\ |
| 154 | straightforward: use the new() to create an md5 object. You can now\n\ |
| 155 | feed this object with arbitrary strings using the update() method, and\n\ |
| 156 | at any point you can ask it for the digest (a strong kind of 128-bit\n\ |
| 157 | checksum, a.k.a. ``fingerprint'') of the contatenation of the strings\n\ |
| 158 | fed to it so far using the digest() method.\n\ |
| 159 | \n\ |
| 160 | Functions:\n\ |
| 161 | \n\ |
| 162 | new([arg]) -- return a new md5 object, initialized with arg if provided\n\ |
| 163 | md5([arg]) -- DEPRECATED, same as new, but for compatibility\n\ |
| 164 | \n\ |
| 165 | Special Objects:\n\ |
| 166 | \n\ |
| 167 | MD5Type -- type object for md5 objects\n\ |
| 168 | "; |
| 169 | |
| 170 | static char md5type_doc [] = |
| 171 | "An md5 represents the object used to calculate the MD5 checksum of a\n\ |
| 172 | string of information.\n\ |
| 173 | \n\ |
| 174 | Methods:\n\ |
| 175 | \n\ |
| 176 | update() -- updates the current digest with an additional string\n\ |
| 177 | digest() -- return the current digest value\n\ |
| 178 | copy() -- return a copy of the current md5 object\n\ |
| 179 | "; |
| 180 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 181 | statichere PyTypeObject MD5type = { |
Fred Drake | 0d40ba4 | 2000-02-04 20:33:49 +0000 | [diff] [blame] | 182 | PyObject_HEAD_INIT(NULL) |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 183 | 0, /*ob_size*/ |
| 184 | "md5", /*tp_name*/ |
| 185 | sizeof(md5object), /*tp_size*/ |
| 186 | 0, /*tp_itemsize*/ |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 187 | /* methods */ |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 188 | (destructor)md5_dealloc, /*tp_dealloc*/ |
| 189 | 0, /*tp_print*/ |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 190 | (getattrfunc)md5_getattr, /*tp_getattr*/ |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 191 | 0, /*tp_setattr*/ |
| 192 | 0, /*tp_compare*/ |
| 193 | 0, /*tp_repr*/ |
| 194 | 0, /*tp_as_number*/ |
Guido van Rossum | d3a6a14 | 1998-10-14 13:46:57 +0000 | [diff] [blame] | 195 | 0, /*tp_as_sequence*/ |
| 196 | 0, /*tp_as_mapping*/ |
| 197 | 0, /*tp_hash*/ |
| 198 | 0, /*tp_call*/ |
| 199 | 0, /*tp_str*/ |
| 200 | 0, /*tp_getattro*/ |
| 201 | 0, /*tp_setattro*/ |
| 202 | 0, /*tp_as_buffer*/ |
| 203 | 0, /*tp_xxx4*/ |
| 204 | md5type_doc, /*tp_doc*/ |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 205 | }; |
| 206 | |
| 207 | |
| 208 | /* MD5 functions */ |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 209 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 210 | static PyObject * |
Guido van Rossum | 3bbc62e | 1995-01-02 19:30:30 +0000 | [diff] [blame] | 211 | MD5_new(self, args) |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 212 | PyObject *self; |
| 213 | PyObject *args; |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 214 | { |
| 215 | md5object *md5p; |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 216 | unsigned char *cp = NULL; |
Guido van Rossum | ef38b78 | 1995-07-26 17:33:10 +0000 | [diff] [blame] | 217 | int len = 0; |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 218 | |
Guido van Rossum | 43713e5 | 2000-02-29 13:59:29 +0000 | [diff] [blame] | 219 | if (!PyArg_ParseTuple(args, "|s#:new", &cp, &len)) |
Guido van Rossum | ef38b78 | 1995-07-26 17:33:10 +0000 | [diff] [blame] | 220 | return NULL; |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 221 | |
| 222 | if ((md5p = newmd5object()) == NULL) |
| 223 | return NULL; |
| 224 | |
| 225 | if (cp) |
| 226 | MD5Update(&md5p->md5, cp, len); |
| 227 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 228 | return (PyObject *)md5p; |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 229 | } |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 230 | |
Guido van Rossum | d3a6a14 | 1998-10-14 13:46:57 +0000 | [diff] [blame] | 231 | static char new_doc [] = |
| 232 | "new([arg]) -> md5 object\n\ |
| 233 | \n\ |
| 234 | Return a new md5 object. If arg is present, the method call update(arg)\n\ |
| 235 | is made."; |
| 236 | |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 237 | |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 238 | /* List of functions exported by this module */ |
| 239 | |
Barry Warsaw | 8b43b19 | 1996-12-09 22:32:36 +0000 | [diff] [blame] | 240 | static PyMethodDef md5_functions[] = { |
Guido van Rossum | d3a6a14 | 1998-10-14 13:46:57 +0000 | [diff] [blame] | 241 | {"new", (PyCFunction)MD5_new, 1, new_doc}, |
| 242 | {"md5", (PyCFunction)MD5_new, 1, new_doc}, /* Backward compatibility */ |
Guido van Rossum | ef38b78 | 1995-07-26 17:33:10 +0000 | [diff] [blame] | 243 | {NULL, NULL} /* Sentinel */ |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 244 | }; |
| 245 | |
| 246 | |
| 247 | /* Initialize this module. */ |
| 248 | |
Guido van Rossum | 3886bb6 | 1998-12-04 18:50:17 +0000 | [diff] [blame] | 249 | DL_EXPORT(void) |
Guido van Rossum | 5f59d60 | 1992-12-14 16:59:51 +0000 | [diff] [blame] | 250 | initmd5() |
| 251 | { |
Guido van Rossum | d3a6a14 | 1998-10-14 13:46:57 +0000 | [diff] [blame] | 252 | PyObject *m, *d; |
Fred Drake | 0d40ba4 | 2000-02-04 20:33:49 +0000 | [diff] [blame] | 253 | |
| 254 | MD5type.ob_type = &PyType_Type; |
Guido van Rossum | d3a6a14 | 1998-10-14 13:46:57 +0000 | [diff] [blame] | 255 | m = Py_InitModule3("md5", md5_functions, module_doc); |
| 256 | d = PyModule_GetDict(m); |
| 257 | PyDict_SetItemString(d, "MD5Type", (PyObject *)&MD5type); |
| 258 | /* No need to check the error here, the caller will do that */ |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 259 | } |