summaryrefslogtreecommitdiff
path: root/static/netbsd/man3/md2.3
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 19:55:15 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 19:55:15 -0400
commit253e67c8b3a72b3a4757fdbc5845297628db0a4a (patch)
treeadf53b66087aa30dfbf8bf391a1dadb044c3bf4d /static/netbsd/man3/md2.3
parenta9157ce950dfe2fc30795d43b9d79b9d1bffc48b (diff)
docs: Added All NetBSD Manuals
Diffstat (limited to 'static/netbsd/man3/md2.3')
-rw-r--r--static/netbsd/man3/md2.3128
1 files changed, 128 insertions, 0 deletions
diff --git a/static/netbsd/man3/md2.3 b/static/netbsd/man3/md2.3
new file mode 100644
index 00000000..11a71f4a
--- /dev/null
+++ b/static/netbsd/man3/md2.3
@@ -0,0 +1,128 @@
+.\" $NetBSD: md2.3,v 1.3 2018/12/17 08:18:06 wiz Exp $
+.\"
+.\" ----------------------------------------------------------------------------
+.\" "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
+.\" ----------------------------------------------------------------------------
+.\"
+.\" from FreeBSD Id: mdX.3,v 1.7 1996/10/22 16:28:56 phk Exp
+.\"
+.Dd September 24, 2005
+.Dt MD2 3
+.Os
+.Sh NAME
+.Nm MD2Init ,
+.Nm MD2Update ,
+.Nm MD2Final ,
+.Nm MD2End ,
+.Nm MD2File ,
+.Nm MD2Data
+.Nd calculate the RSA Data Security, Inc.,
+.Dq MD2
+message digest
+.Sh LIBRARY
+.Lb libc
+.Sh SYNOPSIS
+.In sys/types.h
+.In mdX.h
+.Ft void
+.Fn MD2Init "MD2_CTX *context"
+.Ft void
+.Fn MD2Update "MD2_CTX *context" "const unsigned char *data" "unsigned int len"
+.Ft void
+.Fn MD2Final "unsigned char digest[16]" "MD2_CTX *context"
+.Ft "char *"
+.Fn MD2End "MD2_CTX *context" "char *buf"
+.Ft "char *"
+.Fn MD2File "const char *filename" "char *buf"
+.Ft "char *"
+.Fn MD2Data "const unsigned char *data" "unsigned int len" "char *buf"
+.Sh DESCRIPTION
+The MD2 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)
+the input corresponding to a particular output.
+This net result is
+a ``fingerprint'' of the input-data, which doesn't disclose the actual
+input.
+.Pp
+The MD2 routines should not be used for any security-related purpose.
+.Pp
+The
+.Fn MD2Init ,
+.Fn MD2Update ,
+and
+.Fn MD2Final
+functions are the core functions.
+Allocate an MD2_CTX, initialize it with
+.Fn MD2Init ,
+run over the data with
+.Fn MD2Update ,
+and finally extract the result using
+.Fn MD2Final .
+.Pp
+.Fn MD2End
+is a wrapper for
+.Fn MD2Final
+which converts the return value to a 33-character
+(including the terminating '\e0') ASCII
+string which represents the 128 bits in hexadecimal.
+.Pp
+.Fn MD2File
+calculates the digest of a file, and uses
+.Fn MD2End
+to return the result.
+If the file cannot be opened, a null pointer is returned.
+.Fn MD2Data
+calculates the digest of a chunk of data in memory, and uses
+.Fn MD2End
+to return the result.
+.Pp
+When using
+.Fn MD2End ,
+.Fn MD2File ,
+or
+.Fn MD2Data ,
+the
+.Ar buf
+argument can be a null pointer, in which case the returned string
+is allocated with
+.Xr malloc 3
+and subsequently must be explicitly deallocated using
+.Xr free 3
+after use.
+If the
+.Ar buf
+argument is non-null it must point to at least 33 characters of buffer space.
+.Sh SEE ALSO
+.Xr md4 3 ,
+.Xr md5 3 ,
+.Xr openssl_MD2 3 ,
+.Xr openssl_MD4 3 ,
+.Xr openssl_MD5 3 ,
+.Rs
+.%A B. Kaliski
+.%T The MD2 Message-Digest Algorithm
+.%O RFC 1319
+.Re
+.Rs
+.%A RSA Laboratories
+.%T Frequently Asked Questions About today's Cryptography
+.Re
+.Sh HISTORY
+These functions appeared in
+.Nx 1.3 .
+.Sh AUTHORS
+.An -nosplit
+The original MD2 routines were developed by
+.An RSA Data Security, Inc. ,
+and published in the above references.
+This code is a public domain implementation by
+.An Andrew Brown .
+.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.