Improve commenting/exit handling in binscripts

1 files changed, 13 insertions, 2 deletions

diff --git a/bin/rnds b/bin/rnds
index 98851208..c5ffabe4 100755
--- a/bin/rnds
+++ b/bin/rnds
@@ -1,11 +1,22 @@
 #!/bin/sh
 # Try to get a low-quality random seed from a random device if possible
-[ "$#" -le 1 ] || exit 2
+
+# Sole optional argument is the bytes to read; 32 is the default
+count=${1:-32}
+
+# Try and find a random device to use; none of these are specified by POSIX
 for dev in /dev/urandom /dev/arandom /dev/random '' ; do
     [ -e "$dev" ] && break
 done
+
+# Bail if we couldn't find a random device
 [ -n "$dev" ] || exit 1
-count=${1:-32}
+
+# Read the bytes from the device
 dd if="$dev" bs=1 count="$count" 2>/dev/null |
+
+# Run cksum(1) over the read random bytes
 cksum |
+
+# cut(1) the cksum(1) output to only the first field, and print that to stdout
 cut -d' ' -f1