d/freebsd-nq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
27e79ba285
freebsd-nq/lib/libmd/mdX.3

189 lines
4.9 KiB
Groff
Raw Normal View History

Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.\"
.\" ----------------------------------------------------------------------------
.\" "THE BEER-WARE LICENSE" (Revision 42):
.\" <phk@login.dkuug.dk> wrote this file. As long as you retain this notice you
.\" can do whatever you want with this stuff. If we meet some day, and you think
.\" this stuff is worth it, you can buy me a beer in return. Poul-Henning Kamp
.\" ----------------------------------------------------------------------------
.\"
$Id$ -> $FreeBSD$
1999-08-28 00:22:10 +00:00
.\" $FreeBSD$
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.\"
Add a note about the insecurity of MD4 and potential vulnerability of MD5 to similar attacks.
1999-02-11 20:31:49 +00:00
.Dd February 11, 1999
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Dt MDX 3
mdoc(7) police: removed HISTORY info from the .Os call.
2001-07-10 13:41:46 +00:00
.Os
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Sh NAME
.Nm MDXInit ,
.Nm MDXUpdate ,
Split the padding out into a separate function. Synchronize the kernel and libmd versions of md5c.c PR: misc/6127 Reviewed by: phk Submitted by: Ari Suutari <ari@suutari.iki.fi>
1998-03-27 10:23:00 +00:00
.Nm MDXPad ,
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Nm MDXFinal ,
.Nm MDXEnd ,
.Nm MDXFile ,
Add a new entrypoint to the hashes in libmd: char * FooFileChunk(const char *filename, char *buf, off_t offset, off_t length) Which only hashes part of a file. Implement FooFile() in terms of this function. Submitted by: roam
2001-03-17 10:00:50 +00:00
.Nm MDXFileChunk ,
Added some missing MLINKS for section 3 man pages. Also corrected a few minor formatting errors, file location and cross references in some of the section 3 man pages. This shuts up a lot of the output from "manck" for section 3.
1996-02-09 00:45:45 +00:00
.Nm MDXData
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
.Nd calculate the RSA Data Security, Inc., ``MDX'' message digest
Introduce .Lb macro to libmd manpages
2000-04-22 16:11:30 +00:00
.Sh LIBRARY
.Lb libmd
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Sh SYNOPSIS
Add #include <sys/types>
1996-10-22 16:28:56 +00:00
.Fd #include <sys/types.h>
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Fd #include <mdX.h>
.Ft void
.Fn MDXInit "MDX_CTX *context"
.Ft void
FIxed arg types (mostly missing consts) in synopsis.
1997-03-19 00:52:58 +00:00
.Fn MDXUpdate "MDX_CTX *context" "const unsigned char *data" "unsigned int len"
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Ft void
Split the padding out into a separate function. Synchronize the kernel and libmd versions of md5c.c PR: misc/6127 Reviewed by: phk Submitted by: Ari Suutari <ari@suutari.iki.fi>
1998-03-27 10:23:00 +00:00
.Fn MDXPad "MDX_CTX *context"
.Ft void
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Fn MDXFinal "unsigned char digest[16]" "MDX_CTX *context"
.Ft "char *"
Change this to do what it should have done from the start. Add argument for buffer for output. Fix manuals.
1995-07-12 09:13:49 +00:00
.Fn MDXEnd "MDX_CTX *context" "char *buf"
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Ft "char *"
Make the MD* header files C++-aware. Also, string arguments are supposed to be of type `const char *'. PR: 3291 Submitted by: dima@tejblum.dnttm.rssi.ru (Dmitrij Tejblum)
1997-08-25 05:24:31 +00:00
.Fn MDXFile "const char *filename" "char *buf"
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Ft "char *"
Add a new entrypoint to the hashes in libmd: char * FooFileChunk(const char *filename, char *buf, off_t offset, off_t length) Which only hashes part of a file. Implement FooFile() in terms of this function. Submitted by: roam
2001-03-17 10:00:50 +00:00
.Fn MDXFileChunk "const char *filename" "char *buf" "off_t offset" "off_t length"
.Ft "char *"
FIxed arg types (mostly missing consts) in synopsis.
1997-03-19 00:52:58 +00:00
.Fn MDXData "const unsigned char *data" "unsigned int len" "char *buf"
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Sh DESCRIPTION
The MDX functions calculate a 128-bit cryptographic checksum (digest)
for any number of input bytes. A cryptographic checksum is a one-way
hash-function, that is, you cannot find (except by exhaustive search)
Remove whitespace at EOL.
2001-07-15 07:53:42 +00:00
the input corresponding to a particular output. This net result is
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
a ``fingerprint'' of the input-data, which doesn't disclose the actual
input.
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
.Pp
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
MD2 is the slowest, MD4 is the fastest and MD5 is somewhere in the middle.
MD2 can only be used for Privacy-Enhanced Mail.
Add a note about the insecurity of MD4 and potential vulnerability of MD5 to similar attacks.
1999-02-11 20:31:49 +00:00
MD4 has now been broken; it should only be used where necessary for
backward compatibility.
MD5 has not yet (1999-02-11) been broken, but sufficient attacks have been
made that its security is in some doubt. The attacks on both MD4 and MD5
are both in the nature of finding ``collisions'' \- that is, multiple
inputs which hash to the same value; it is still unlikely for an attacker
to be able to determine the exact original input given a hash value.
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
.Pp
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
The
.Fn MDXInit ,
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
.Fn MDXUpdate ,
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
and
.Fn MDXFinal
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
functions are the core functions. Allocate an MDX_CTX, initialize it with
.Fn MDXInit ,
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
run over the data with
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
.Fn MDXUpdate ,
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
and finally extract the result using
.Fn MDXFinal .
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
.Pp
Split the padding out into a separate function. Synchronize the kernel and libmd versions of md5c.c PR: misc/6127 Reviewed by: phk Submitted by: Ari Suutari <ari@suutari.iki.fi>
1998-03-27 10:23:00 +00:00
.Fn MDXPad
can be used to pad message data in same way
as done by
.Fn MDXFinal
without terminating calculation.
.Pp
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Fn MDXEnd
Change this to do what it should have done from the start. Add argument for buffer for output. Fix manuals.
1995-07-12 09:13:49 +00:00
is a wrapper for
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
.Fn MDXFinal
which converts the return value to a 33-character
(including the terminating '\e0')
.Tn ASCII
string which represents the 128 bits in hexadecimal.
.Pp
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Fn MDXFile
Remove whitespace at EOL.
2001-07-15 07:53:42 +00:00
calculates the digest of a file, and uses
Correct two errors in the manual page.
1996-05-28 18:57:31 +00:00
.Fn MDXEnd
Change this to do what it should have done from the start. Add argument for buffer for output. Fix manuals.
1995-07-12 09:13:49 +00:00
to return the result.
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
If the file cannot be opened, a null pointer is returned.
Add a new entrypoint to the hashes in libmd: char * FooFileChunk(const char *filename, char *buf, off_t offset, off_t length) Which only hashes part of a file. Implement FooFile() in terms of this function. Submitted by: roam
2001-03-17 10:00:50 +00:00
.Fn MDXFileChunk
is similar to
.Fn MDXFile ,
but it only calculates the digest over a byte-range of the file specified,
starting at
mdoc(7) police: use proper markup for function arguments.
2001-04-04 10:23:27 +00:00
.Fa offset
Add a new entrypoint to the hashes in libmd: char * FooFileChunk(const char *filename, char *buf, off_t offset, off_t length) Which only hashes part of a file. Implement FooFile() in terms of this function. Submitted by: roam
2001-03-17 10:00:50 +00:00
and spanning
mdoc(7) police: use proper markup for function arguments.
2001-04-04 10:23:27 +00:00
.Fa length
Add a new entrypoint to the hashes in libmd: char * FooFileChunk(const char *filename, char *buf, off_t offset, off_t length) Which only hashes part of a file. Implement FooFile() in terms of this function. Submitted by: roam
2001-03-17 10:00:50 +00:00
bytes.
If the
mdoc(7) police: use proper markup for function arguments.
2001-04-04 10:23:27 +00:00
.Fa length
Add a new entrypoint to the hashes in libmd: char * FooFileChunk(const char *filename, char *buf, off_t offset, off_t length) Which only hashes part of a file. Implement FooFile() in terms of this function. Submitted by: roam
2001-03-17 10:00:50 +00:00
parameter is specified as 0, or more than the length of the remaining part
of the file,
.Fn MDXFileChunk
calculates the digest from
mdoc(7) police: use proper markup for function arguments.
2001-04-04 10:23:27 +00:00
.Fa offset
Add a new entrypoint to the hashes in libmd: char * FooFileChunk(const char *filename, char *buf, off_t offset, off_t length) Which only hashes part of a file. Implement FooFile() in terms of this function. Submitted by: roam
2001-03-17 10:00:50 +00:00
to the end of file.
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Fn MDXData
Change this to do what it should have done from the start. Add argument for buffer for output. Fix manuals.
1995-07-12 09:13:49 +00:00
calculates the digest of a chunk of data in memory, and uses
Correct two errors in the manual page.
1996-05-28 18:57:31 +00:00
.Fn MDXEnd
Change this to do what it should have done from the start. Add argument for buffer for output. Fix manuals.
1995-07-12 09:13:49 +00:00
to return the result.
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
.Pp
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
When using
.Fn MDXEnd ,
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
.Fn MDXFile ,
Change this to do what it should have done from the start. Add argument for buffer for output. Fix manuals.
1995-07-12 09:13:49 +00:00
or
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Fn MDXData ,
Remove whitespace at EOL.
2001-07-15 07:53:42 +00:00
the
mdoc(7) police: use proper markup for function arguments.
2001-04-04 10:23:27 +00:00
.Fa buf
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
argument can be a null pointer, in which case the returned string
is allocated with
Change this to do what it should have done from the start. Add argument for buffer for output. Fix manuals.
1995-07-12 09:13:49 +00:00
.Xr malloc 3
and subsequently must be explicitly deallocated using
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Xr free 3
after use.
Remove whitespace at EOL.
2001-07-15 07:53:42 +00:00
If the
mdoc(7) police: use proper markup for function arguments.
2001-04-04 10:23:27 +00:00
.Fa buf
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
argument is non-null it must point to at least 33 characters of buffer space.
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Sh SEE ALSO
.Xr md2 3 ,
.Xr md4 3 ,
Fix bug in MDx test suite. Add Eric Young's SHA-[01] implementations.
1999-02-26 04:25:01 +00:00
.Xr md5 3 ,
.Xr sha 3
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
.Rs
.%A B. Kaliski
.%T The MD2 Message-Digest Algorithm
.%O RFC 1319
.Re
.Rs
.%A R. Rivest
.%T The MD4 Message-Digest Algorithm
.%O RFC 1186
.Re
.Rs
.%A R. Rivest
.%T The MD5 Message-Digest Algorithm
.%O RFC 1321
.Re
.Rs
Remove whitespace at EOL.
2001-07-15 07:53:42 +00:00
.%A RSA Laboratories
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
.%T Frequently Asked Questions About today's Cryptography
Add a note about the insecurity of MD4 and potential vulnerability of MD5 to similar attacks.
1999-02-11 20:31:49 +00:00
.%O \&<http://www.rsa.com/rsalabs/faq/>
.Re
.Rs
.%A H. Dobbertin
.%T Alf Swindles Ann
.%J CryptoBytes
.%N 1(3):5
.%D 1995
.Re
.Rs
.%A MJ. B. Robshaw
.%T On Recent Results for MD2, MD4 and MD5
.%J RSA Laboratories Bulletin
.%N 4
.%D November 12, 1996
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
.Re
.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq
1998-03-19 07:34:22 +00:00
.Sh AUTHORS
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
The original MDX routines were developed by
.Tn RSA
Data Security, Inc., and published in the above references.
.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq
1998-03-19 07:34:22 +00:00
This code is derived directly from these implementations by
.An Poul-Henning Kamp Aq phk@login.dkuug.dk
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
.Pp
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
Phk ristede runen.
.Sh HISTORY
These functions appeared in
Some minor man page cleanup.
1996-08-23 20:52:53 +00:00
.Fx 2.0 .
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
.Sh BUGS
No method is known to exist which finds two files having the same hash value,
nor to find a file with a specific hash value.
There is on the other hand no guarantee that such a method doesn't exist.
Use -mdoc macros properly. Translate from Danglish into English. Refer to the alogrithms as ``RSA Data Security MDX message digest'' as required by the license.
1996-10-09 21:00:48 +00:00
.Pp
MD2 has only been licensed for use in Privacy Enhanced Mail.
Reviewed by: phk Imported libmd. This library contains MD2, MD4 and MD5. These three boggers pop up all over the place all of the time, so I decided we needed a library with them. In general they are used for security checks, so if you use them you want to link them static.
1994-07-24 03:29:56 +00:00
Use MD4 or MD5 if that isn't what you're doing.
Reference in New Issue Copy Permalink