Fix up comments.

diff --git a/libraries/liblutil/entropy.c b/libraries/liblutil/entropy.c
index b47749f3d64bf9bf418c8a5e04471b7359f41974..4e0b2ec17f759ee3bd1bb93eb439190a34993d9c 100644 (file)
--- 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 );