1: .\"     $NetBSD: factor.6,v 1.9 2004/02/08 13:16:25 jsm 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 FACTOR 6
   42: .Os
   43: .Sh NAME
   44: .Nm factor
   45: .Nd factor a number
   46: .Sh SYNOPSIS
   47: .Nm
   48: .Op Ar number ...
   49: .Sh DESCRIPTION
   50: The
   51: .Nm
   52: utility will factor integers between \-2147483648 and 2147483647 inclusive.
   53: When a number is factored, it is printed, followed by a
   54: .Dq \&: ,
   55: and the list of factors on a single line.
   56: Factors are listed in ascending order, and are preceded by a space.
   57: If a factor divides a value more than once, it will be printed more than once.
   58: .Pp
   59: When
   60: .Nm
   61: is invoked with one or more arguments, each argument will be factored.
   62: .Pp
   63: When
   64: .Nm
   65: is invoked with no arguments,
   66: .Nm
   67: reads numbers, one per line, from standard input, until end of file or error.
   68: Leading white-space and empty lines are ignored.
   69: Numbers may be preceded by a single - or +.
   70: Numbers are terminated by a non-digit character (such as a newline).
   71: After a number is read, it is factored.
   72: Input lines must not be longer than 255 characters.
   73: .Sh DIAGNOSTICS
   74: Out of range or invalid input results in
   75: an appropriate error message
   76: being written to standard error.
   77: .Sh BUGS
   78: .Nm
   79: cannot handle the
   80: .Dq 10 most wanted
   81: factor list.