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