1ddb351dbec246cf1fab5ec20d2d5520909041de1Kristian Monsen// Copyright (c) 2011 The Chromium Authors. All rights reserved. 2c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// Use of this source code is governed by a BSD-style license that can be 3c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// found in the LICENSE file. 4c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 5c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#ifndef BASE_MD5_H_ 6c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#define BASE_MD5_H_ 73345a6884c488ff3a535c2c9acdd33d74b37e311Iain Merrick#pragma once 8c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 9c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#include <string> 10c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 11ddb351dbec246cf1fab5ec20d2d5520909041de1Kristian Monsen#include "base/base_api.h" 12ddb351dbec246cf1fab5ec20d2d5520909041de1Kristian Monsen 13c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// MD5 stands for Message Digest algorithm 5. 14c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// MD5 is a robust hash function, designed for cyptography, but often used 15c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// for file checksums. The code is complex and slow, but has few 16c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// collisions. 17c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// See Also: 18c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// http://en.wikipedia.org/wiki/MD5 19c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 20c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// These functions perform MD5 operations. The simplest call is MD5Sum() to 21c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// generate the MD5 sum of the given data. 22c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// 23c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// You can also compute the MD5 sum of data incrementally by making multiple 24c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// calls to MD5Update(): 25c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// MD5Context ctx; // intermediate MD5 data: do not use 26c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// MD5Init(&ctx); 27c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// MD5Update(&ctx, data1, length1); 28c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// MD5Update(&ctx, data2, length2); 29c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// ... 30c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// 31c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// MD5Digest digest; // the result of the computation 32c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// MD5Final(&digest, &ctx); 33c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// 34c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// You can call MD5DigestToBase16() to generate a string of the digest. 35c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 36c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// The output of an MD5 operation 37c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scotttypedef struct MD5Digest_struct { 38c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott unsigned char a[16]; 39c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott} MD5Digest; 40c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 41c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// Used for storing intermediate data during an MD5 computation. Callers 42c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// should not access the data. 43c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scotttypedef char MD5Context[88]; 44c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 45c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// Computes the MD5 sum of the given data buffer with the given length. 46c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// The given 'digest' structure will be filled with the result data. 47ddb351dbec246cf1fab5ec20d2d5520909041de1Kristian MonsenBASE_API void MD5Sum(const void* data, size_t length, MD5Digest* digest); 48c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 49c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// Initializes the given MD5 context structure for subsequent calls to 50c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// MD5Update(). 51ddb351dbec246cf1fab5ec20d2d5520909041de1Kristian MonsenBASE_API void MD5Init(MD5Context* context); 52c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 53c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// For the given buffer of data, updates the given MD5 context with the sum of 54c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// the data. You can call this any number of times during the computation, 55c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// except that MD5Init() must have been called first. 56ddb351dbec246cf1fab5ec20d2d5520909041de1Kristian MonsenBASE_API void MD5Update(MD5Context* context, const void* buf, size_t len); 57c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 58c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// Finalizes the MD5 operation and fills the buffer with the digest. 59ddb351dbec246cf1fab5ec20d2d5520909041de1Kristian MonsenBASE_API void MD5Final(MD5Digest* digest, MD5Context* pCtx); 60c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 61c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// Converts a digest into human-readable hexadecimal. 62ddb351dbec246cf1fab5ec20d2d5520909041de1Kristian MonsenBASE_API std::string MD5DigestToBase16(const MD5Digest& digest); 63c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 64c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// Returns the MD5 (in hexadecimal) of a string. 65ddb351dbec246cf1fab5ec20d2d5520909041de1Kristian MonsenBASE_API std::string MD5String(const std::string& str); 66c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 67c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#endif // BASE_MD5_H_ 68c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 69