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