aboutsummaryrefslogtreecommitdiff
path: root/man/man1/rndi.1df
diff options
context:
space:
mode:
Diffstat (limited to 'man/man1/rndi.1df')
-rw-r--r--man/man1/rndi.1df25
1 files changed, 25 insertions, 0 deletions
diff --git a/man/man1/rndi.1df b/man/man1/rndi.1df
new file mode 100644
index 00000000..767ad148
--- /dev/null
+++ b/man/man1/rndi.1df
@@ -0,0 +1,25 @@
+.TH RNDI 1df "August 2016" "Manual page for rndi"
+.SH NAME
+.B rndi
+\- return a low-quality random integer
+.SH SYNOPSIS
+.B rndi
+0 10
+.br
+.B rndi
+0 10 "$(rnds)"
+.SH DESCRIPTION
+.B rndi
+returns a random integer ranging from the first argument to the second argument
+in a POSIX-compliant way (using awk), using the optional third argument as a
+seed.
+.P
+The answer returned is low-quality; given some implementations of awk and no
+properly random seed, it may even return the same result if run within the same
+second. This should not be used in any sort of security or statistical context.
+The author wrote it to support scripts to choose a random background image from
+a directory.
+.SH SEE ALSO
+rnda(1df), rndf(1df), rndl(1df), rnds(1df), rndn(6df)
+.SH AUTHOR
+Tom Ryder <tom@sanctum.geek.nz>