Sample usage of libcalc.a
-------------------------

This directory contains a few examples of how to use libcalc.a.

For more details on how to use libcalc.a, see the file
/usr/share/doc/calc-dev/LIBRARY.gz.

=-=


test_random
-----------

    Generate random bits using the Blum-Blum-Shub generator that
    is used by the random() and srandom() builtin functions.

    This prog uses the 10th compiled in Blum modulus.

    This routine makes use of some of the lib_util.c routines.

    usage:

        test_random [bitlen [seed_string]]

        bitlen          number of random bits to generate (default: 128 bits)
        seed_string     seed using this ASCII string (default: use default seed)


many_random
-----------

    Generate many (100000) sets random bits using the Blum-Blum-Shub
    generator that is used by the random() and srandom() builtin functions.

    Output is one set per line.  Unlike test_random, the seed is not
    printed.  There is no leading 0x on numbers and there is no prefix
    strings.  The only thing printed (normally) is ASCII hex chars and
    newlines.

    Unlike test_random, this prog will execute for a while.  It is
    useful to watch the process size in order to determine of there
    is a memory leak.

    This prog uses the 1st compiled in Blum modulus.

    This routine makes use of some of the lib_util.c routines.

    usage:

        many_random [bitlen [seed_string]]

        bitlen          number of random bits per line set (default: 128 bits)
        seed_string     seed using this ASCII string (default: use default seed)

## Copyright (C) 1999-2007  Landon Curt Noll
##
## Calc is open software; you can redistribute it and/or modify it under
## the terms of the version 2.1 of the GNU Lesser General Public License
## as published by the Free Software Foundation.
##
## Calc is distributed in the hope that it will be useful, but WITHOUT
## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
## Public License for more details.
##
## A copy of version 2.1 of the GNU Lesser General Public License is
## distributed with calc under the filename COPYING-LGPL.  You should have
## received a copy with calc; if not, write to Free Software Foundation, Inc.
## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
##
## Under source code control:   1997/04/19 23:15:42
## File existed as early as:    1997
##
## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/
