MD5File(3) FreeBSDドキュメントJMan

MD5(3) FreeBSD ライブラリ関数マニュアル MD5(3)

名称

MD5Init, MD5Update, MD5Pad, MD5Final, MD5End, MD5File, MD5Data − RSA Data Security 社の ‘‘MD5’’ メッセージダイジェストを計算する

書式

#include <sys/types.h>
#include <md5.h>

void

MD5Init(MD5_CTX *context);

void

MD5Update(MD5_CTX *context, const unsigned char *data, unsigned int len);

void

MD5Pad(MD5_CTX *context);

void

MD5Final(unsigned char digest[16], MD5_CTX *context);

char *

MD5End(MD5_CTX *context, char *buf);

char *

MD5File(const char *filename, char *buf);

char *

MD5Data(const unsigned char *data, unsigned int len, char *buf);

解説

MD5 関数群は、任意の数の入力バイトについて 128 ビット暗号チェックサム ( ダイジェスト ) を計算します。暗号チェックサムは一方向ハッシュ関数なので特定出力に対応する入力を ( 徹底的な検索を除いて) 見つけることはできません。結果的には入力データの「指紋」しか見つからず、実際の入力が明らかになることはありません。

MD2 は最も遅く、 MD4 は最も高速で、 MD5 はその中間です。 MD2 は、プライバシが重要なメールのみで使用できます。 MD4 は弱すぎると酷評されたため、「安全ベルトを付けた MD4」として MD5 が開発されました。疑わしいときは MD5 を使用してください。

MD5Init(), MD5Update(), MD5Final() 関数は中心的な関数群です。 MD5_CTX を割り当て、 MD5Init() で初期化し、 MD5Update() でデータを処理し、最後に MD5Final() で結果を取り出してください。

MD5Pad() は、計算を終了しないで MD5Final() と同じ方法でメッセージデータをつめることができます。

MD5End() は MD5Final() のラッパで、 16 進 128 ビットを表現する 33 文字 ( 最後の「 \0 」を含む ) の ASCII 文字列に戻り値を変換します。

MD5File() はファイルのダイジェストを計算し、 MD5End() を使用して結果を返します。ファイルを開けない場合はヌルポインタを返します。 MD5Data() はメモリに存在するデータのダイジェストを計算し、 MD5End() を使用して結果を返します。

MD5End(), MD5File(), MD5Data() の使用にあたっては buf を NULL ポインタとすることができます。この場合は malloc(3) で割り当てられた文字列が返されるので、使用後は free(3) で割り当てを解除しなければなりません。 buf が NULL でない時は、少なくとも 33 文字分のバッファを指していなければなりません。

関連項目

md2(3), md4(3), md5(3)

       B. Kaliski,                     The MD2 Message-Digest Algorithm,                                                         RFC 1319.
       R. Rivest,                    The MD4 Message-Digest Algorithm,                                                        RFC 1186.
       R. Rivest,                    The MD5 Message-Digest Algorithm,                                                        RFC 1321.
       RSA Laboratories,                           Frequently Asked Questions About today’sCryptography.

作者

オリジナルの MD5 ルーチンは、 RSA Data Security 社によって開発され、上記のリファレンスで公開されました。このコードは、 Poul-Henning Kamp ⟨phk@login.dkuug.dk⟩ により、この実装から直接引き出されています。

Phk ristede runen.

歴史

この関数は、 FreeBSD 2.0 で現れました。

バグ

同じハッシュ値を持つような 2 つのファイルを見つける方法、または特定のハッシュ値を持つようなファイルを見つける方法は知られていません。一方、そのような方法が存在しないという保証もありません。

MD2 は、プライバシが重要なメールに使用する場合のみライセンス供与されます。その他の場合は MD4 か MD5 を使用してください。

COPYRIGHT

このソフトウェアの複製や使用のためのライセンスは、このソフトウェアやこの関数について言及したり参照したりするすべての資料で「 RSA Data Security 社の MD2 メッセージダイジェストアルゴリズム」であることが明示されていれば、プライバシが重要となる非営利インターネットメールに供与されます。

RSA Data Security 社は、このソフトウェアの商業性、またはこの特定の目的に対するこのソフトウェアの適合性について表明しません。このソフトウェアは、いかなる種類の、明示的または暗黙的な保証もなく、「現状のまま」で提供されます。

この警告は、この文書かソフトウェア、またはその両方のすべてのコピーに掲載しなければなりません。

FreeBSD October 9, 1996 FreeBSD