Module Name: othersrc
Committed By: wiz
Date: Thu Jun 2 23:35:00 UTC 2011
Modified Files:
othersrc/external/bsd/tiger/dist: tiger.3
Log Message:
Fix some xrefs and formatting, use more markup.
To generate a diff of this commit:
cvs rdiff -u -r1.1.1.1 -r1.2 othersrc/external/bsd/tiger/dist/tiger.3
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: othersrc/external/bsd/tiger/dist/tiger.3
diff -u othersrc/external/bsd/tiger/dist/tiger.3:1.1.1.1 othersrc/external/bsd/tiger/dist/tiger.3:1.2
--- othersrc/external/bsd/tiger/dist/tiger.3:1.1.1.1 Thu Jun 2 15:10:51 2011
+++ othersrc/external/bsd/tiger/dist/tiger.3 Thu Jun 2 23:35:00 2011
@@ -1,4 +1,4 @@
-.\" $NetBSD: tiger.3,v 1.1.1.1 2011/06/02 15:10:51 agc Exp $
+.\" $NetBSD: tiger.3,v 1.2 2011/06/02 23:35:00 wiz Exp $
.\"
.\" Copyright (c) 2011 Alistair Crooks <[email protected]>
.\" All rights reserved.
@@ -72,9 +72,9 @@
no attacks or pre-imaging have been discovered against the
.Nm
message digests, whilst the same cannot be said of
-.Xr MD5 3
+.Xr md5 3
or
-.Xr SHA1 3 .
+.Xr sha1 3 .
.Pp
The
.Fn TIGER_Init
@@ -98,17 +98,19 @@
and stores a message digest in the
.Ar digest
parameter.
-When a null pointer is passed to
+When a
+.Dv NULL
+pointer is passed to
.Fn TIGER_Final
as first argument only the final padding will be applied and the
current context can still be used with
.Fn TIGER_Update .
.Pp
-The core of theTIGER message digest is performed by
-.Fn TIGER_Update
+The core of the TIGER message digest is performed by
+.Fn TIGER_Update .
Most programs should use the interface provided by
.Fn TIGER_Init ,
-.Fn TIGER_Update
+.Fn TIGER_Update ,
and
.Fn TIGER_Final .
.Pp
@@ -126,7 +128,9 @@
.Fn TIGER_End .
If
.Fn TIGER_File
-is unable to open the file a NULL pointer is returned.
+is unable to open the file a
+.Dv NULL
+pointer is returned.
.Pp
The
.Fn TIGER_Data
@@ -142,19 +146,19 @@
functions the
.Ar buf
parameter should either be a string of at least 41 characters in
-size or a NULL pointer.
-In the latter case, space will be dynamically
-allocated via
+size or a
+.Dv NULL
+pointer.
+In the latter case, space will be dynamically allocated via
.Xr malloc 3
and should be freed using
.Xr free 3
when it is no longer needed.
.Sh EXAMPLES
-The follow code fragment will calculate the digest for
-the string
+The follow code fragment will calculate the digest for the string
"The quick brown fox jumps over the lazy dog"
which is
-``6d12a41e72e644f017b6f0e2f7b44c6285f06dd5d2c5b075''.
+.Dq 6d12a41e72e644f017b6f0e2f7b44c6285f06dd5d2c5b075 .
.Bd -literal -offset indent
TIGER_CTX tiger;
uint8_t results[24];
@@ -190,7 +194,8 @@
.%A Ross Anderson
.%A Eli Biham
.%T "Tiger - A Fast New Hash Function"
-.%O Proceedings of Fast Software Encryption 3, Cambridge, 1996.
+.%B Proceedings of Fast Software Encryption 3, Cambridge
+.%D 1996
.Re
.Sh HISTORY
The TIGER functions appeared in
@@ -208,7 +213,6 @@
.Fn TIGER_Data
helper functions are derived from code written by Poul-Henning Kamp.
.Sh BUGS
-.Pp
All attempts have bene made to optimise for the underlying hardware,
as well as to format the digest properly in an endian-neutral manner.
The author has no VAX hardware on which to test, and so it is not known
