.\" -*-nroff-*-
.TH gorp 1 "9 October 2003" "Straylight/Edgeware"
.SH NAME
gorp \- write a short random string
.SH SYNOPSIS
.B gorp
.RB [ \-y ]
.RB [ \-l
.IR length ]
.RB [ \-f
.IR format ]
.RI [ bits ]
.SH DESCRIPTION
Generates
.I bits
random bits (must be a multiple of 8, default is 128) and writes the
resulting string to standard output.
.PP
The following options are recognized.
.TP
.B "\-h, \-\-help"
Prints a help message to standard output and exits successfully.
.TP
.B "\-v, \-\-version"
Prints the program's version number to standard output and exits
successfully.
.TP
.B "\-u, \-\-usage"
Prints a really short usage summary to standard output and exits
successfully.
.TP
.BI "\-f, \-\-format=" format
Prints the random string using the chosen output
.IR format ,
which may be
.B base64
(standard Base64 encoding, as described in RFC2045; this is the default), 
.B file64
(Base64 encoding, with
.RB ` % '
instead of
.RB ` / ',
so the output is suitable for use as a filename),
.B hex
(plain hexadecimal encoding), or
.B raw
(raw binary output, not printable).
.TP
.BI "\-l, \-\-line=" length
Breaks textual output into lines of at most
.I length
characters, and does all encoding in a strictly conforming way.  By
default, the textual output is not line-broken, and strange terminator
characters are not printed.
.TP
.B "\-y, \-\-bytes"
The output length is bits, not bytes.  This doesn't affect the default
value of 128.
.SH BUGS
None known.
.SH AUTHOR
Mark Wooding <mdw@nsict.org>