.TH RAND 1 2022-03-06 "OMKOV coreutils" "General Commands Manual"
.SH NAME
rand \(em generate random string
.SH SYNOPSYS
\fBrand\fR [-aAns] [\fIlength\fR]
.SH DESCRIPTION
Generate a random string of \fIlength\fR characters long. The string will
contain the character types specified by the -a, -A, -n, and -s options, those
being lowercase letters, uppercase letters, numbers and symbols respectively. If
no \fIlength\fR is specified, a default of 8 will be used. If no character type
options are specified, \fIrand\fR will generate a random string containing
uppercase letters and numbers.
.SH OPTIONS
The following options are supported:
.TP
.B -a
Enable lowercase letters in the string output.
.TP
.B -A
Enable uppercase letters in the string output.
.TP
.B -n
Enable numbers in the string output.
.TP
.B -s
Enable symbols '!@#$%^&*' in the string output.
.TP
.B --help
Display help information.
.TP
.B --version
Display version information.
.SH OPERANDS
The following operand is supported:
.TP
.I length
The length of the string output.
.SH EXIT STATUS
The following exit values will be returned:
.TP
\ 0
Successful completion.
.TP
>0
An error occurred.
.SH COPYRIGHT
.nf
Copyright (C) 2020, Jakob Wakeling
MIT Licence (https://opensource.org/licenses/MIT)
.fi