From: Kurt Zeilenga <kurt@openldap.org>
Date: Wed, 27 Oct 1999 22:00:29 +0000 (+0000)
Subject: Fix up comments.
X-Git-Tag: UCDATA_2_4~306
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=554f5b7aead72be1aff462b3cf5febff50b41d46;p=openldap

Fix up comments.
---

diff --git a/libraries/liblutil/entropy.c b/libraries/liblutil/entropy.c
index b47749f3d6..4e0b2ec17f 100644
--- a/libraries/liblutil/entropy.c
+++ b/libraries/liblutil/entropy.c
@@ -81,8 +81,9 @@ int lutil_entropy( char *buf, int nbytes )
 		 */
 
 		/*
-		 * the caller may be provide external synchronization OR
-		 * provide entropy (in buf) to ensure quality results.
+		 * the caller may need to provide external synchronization OR
+		 * provide entropy (in buf) to ensure quality results as
+		 * access to this counter may not be atomic.
 		 */
 		static int counter = 0;
 		int n;
@@ -100,7 +101,8 @@ int lutil_entropy( char *buf, int nbytes )
 #else
 			time_t	time;
 #endif
-			unsigned long	junk;
+
+			unsigned long	junk;	/* purposely not initialized */
 		} rdata;
 
 		/* make sure rdata differs for each process */
@@ -114,7 +116,7 @@ int lutil_entropy( char *buf, int nbytes )
 			struct lutil_MD5Context ctx;
 			char digest[16];
 
-			/* hopefully has good resolution */
+			/* poor resolution */
 #ifdef HAVE_GETTIMEOFDAY
 			(void) gettimeofday( &rdata.tv, NULL );
 #else
@@ -129,7 +131,7 @@ int lutil_entropy( char *buf, int nbytes )
 			lutil_MD5Init( &ctx );
 			lutil_MD5Update( &ctx, (char *) &rdata, sizeof( rdata ) );
 
-			/* use caller to provided information */
+			/* allow caller to provided additional entropy */
 			lutil_MD5Update( &ctx, (char *) &buf, nbytes );
 
 			lutil_MD5Final( digest, &ctx );