1: .\"     $NetBSD: primes.6,v 1.2 2004/02/09 23:25:47 wiz Exp $
    2: .\"
    3: .\" Copyright (c) 1989, 1993
    4: .\"     The Regents of the University of California.  All rights reserved.
    5: .\"
    6: .\" This code is derived from software contributed to Berkeley by
    7: .\" Landon Curt Noll.
    8: .\"
    9: .\" Redistribution and use in source and binary forms, with or without
   10: .\" modification, are permitted provided that the following conditions
   11: .\" are met:
   12: .\" 1. Redistributions of source code must retain the above copyright
   13: .\"    notice, this list of conditions and the following disclaimer.
   14: .\" 2. Redistributions in binary form must reproduce the above copyright
   15: .\"    notice, this list of conditions and the following disclaimer in the
   16: .\"    documentation and/or other materials provided with the distribution.
   17: .\" 3. Neither the name of the University nor the names of its contributors
   18: .\"    may be used to endorse or promote products derived from this software
   19: .\"    without specific prior written permission.
   20: .\"
   21: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
   22: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   23: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   24: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
   25: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
   26: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
   27: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
   28: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
   29: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
   30: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   31: .\" SUCH DAMAGE.
   32: .\"
   33: .\"     @(#)factor.6        8.1 (Berkeley) 5/31/93
   34: .\"
   35: .\"
   36: .\" By: Landon Curt Noll   chongo@toad.com,   ...!{sun,tolsoft}!hoptoad!chongo
   37: .\"
   38: .\"   chongo <for a good prime call: 391581 * 2^216193 - 1> /\oo/\
   39: .\"
   40: .Dd February 8, 2004
   41: .Dt PRIMES 6
   42: .Os
   43: .Sh NAME
   44: .Nm primes
   45: .Nd generate primes
   46: .Sh SYNOPSIS
   47: .Nm primes
   48: .Op Ar start Op Ar stop
   49: .Sh DESCRIPTION
   50: The
   51: .Nm
   52: utility prints primes in ascending order, one per line, starting
   53: at or above
   54: .Ar start
   55: and continuing until, but not including
   56: .Ar stop .
   57: The
   58: .Ar start
   59: value must be at least 0 and not greater than
   60: .Ar stop .
   61: The
   62: .Ar stop
   63: value must not be greater than 4294967295.
   64: The default value of
   65: .Ar stop
   66: is 4294967295.
   67: .Pp
   68: When the
   69: .Nm
   70: utility is invoked with no arguments,
   71: .Ar start
   72: is read from standard input.
   73: .Ar stop
   74: is taken to be 4294967295.
   75: The
   76: .Ar start
   77: value may be preceded by a single
   78: .Sq \&+ .
   79: The
   80: .Ar start
   81: value is terminated by a non-digit character (such as a newline).
   82: The input line must not be longer than 255 characters.
   83: .Sh DIAGNOSTICS
   84: Out of range or invalid input results in
   85: an appropriate error message
   86: being written to standard error.
   87: .Sh BUGS
   88: .Nm
   89: won't get you a world record.