1: .\"     $NetBSD: random.6,v 1.6 2003/08/07 09:37:35 agc Exp $
    2: .\"
    3: .\" Copyright (c) 1994
    4: .\"     The Regents of the University of California.  All rights reserved.
    5: .\"
    6: .\" Redistribution and use in source and binary forms, with or without
    7: .\" modification, are permitted provided that the following conditions
    8: .\" are met:
    9: .\" 1. Redistributions of source code must retain the above copyright
   10: .\"    notice, this list of conditions and the following disclaimer.
   11: .\" 2. Redistributions in binary form must reproduce the above copyright
   12: .\"    notice, this list of conditions and the following disclaimer in the
   13: .\"    documentation and/or other materials provided with the distribution.
   14: .\" 3. Neither the name of the University nor the names of its contributors
   15: .\"    may be used to endorse or promote products derived from this software
   16: .\"    without specific prior written permission.
   17: .\"
   18: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
   19: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   20: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   21: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
   22: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
   23: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
   24: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
   25: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
   26: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
   27: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   28: .\" SUCH DAMAGE.
   29: .\"
   30: .\"     @(#)random.6    8.2 (Berkeley) 3/31/94
   31: .\"
   32: .Dd March 31, 1994
   33: .Dt RANDOM 6
   34: .Os
   35: .Sh NAME
   36: .Nm random
   37: .Nd random lines from a file or random numbers
   38: .Sh SYNOPSIS
   39: .Nm
   40: .Op Fl er
   41: .Op Ar denominator
   42: .Sh DESCRIPTION
   43: .Nm
   44: reads lines from the standard input and copies them to the standard
   45: output with a probability of 1/denominator.
   46: The default value for
   47: .Ar denominator
   48: is 2.
   49: .Pp
   50: The options are as follows:
   51: .Bl -tag -width Ds
   52: .It Fl e
   53: If the
   54: .Fl e
   55: option is specified,
   56: .Nm
   57: does not read or write anything, and simply exits with a random
   58: exit value of 0 to
   59: .Ar denominator Ns -1 ,
   60: inclusive.
   61: .It Fl r
   62: The
   63: .Fl r
   64: option guarantees that the output is unbuffered.
   65: .El
   66: .Sh SEE ALSO
   67: .Xr fortune 6