danaj / Math-Prime-Util-GMP

Perl prime number module using XS/GMP
Other
17 stars 9 forks source link

Math::Prime::Util::GMP version 0.53

A module for number theory in Perl using GMP. This includes primality tests, getting primes in a range, factoring, and more.

These use GMP directly, so should be quite fast for bignums. This module is mainly intended to be used within Math::Prime::Util, but most functions can be easily used in independent C programs. Some, like factoring and primality proving, have explicit ways of compiling as standalone programs.

SYNOPSIS

use bigint; use Math::Prime::Util::GMP qw/is_prime/;

my $bignum = 27188762623694447842124996538064039444034480940561898523069471141322552613142248049662205275973369340310432664971214620312500867999795559094898390220747143052478910604268911012707898393728029267456459638286456542290811906119936040794792836567800517712998324001798156031927248728220625109007338679765933511619979774789836912923556217410691909195918721300495567162524824116421834972571058278049256235507898646245768556946276949788343519575161621940362646866507884693948582445313246609982609803440514973664475699712739781845803535392293307648102481184237357244142946254918813030632212409545324607906367812717102049454943;

say "$bignum is ", is_prime($bignum) ? "prime" : "not prime";

See the POD module documentation for examples and more information on all the methods included.

INSTALLATION

To install this module type the following:

perl Makefile.PL make make test make install

You will need a C compiler compatible with the compiler used to build Perl, and the GMP development system installed. If you can install or have installed Math::BigInt::GMP or Math::GMPz then this module should have no issues.

Fedora: sudo yum install gmp gmp-devel Ubuntu: sudo apt-get install libgmp3 libgmp3-dev Cygwin: install gmp, libgmp-devel, libgmp3

If you would like to make a standalone executable for ECPP, the easiest method is to run the xt/create-standalone.sh script, which will create a standalone/ directory with Makefile and README. You should make sure you have the large discrimiment set (https://github.com/danaj/Math-Prime-Util-GMP/tree/master/xt/). You may also simply compile it with:

gcc -O3 -fomit-frame-pointer -DSTANDALONE -DSTANDALONE_ECPP ecpp.c bls75.c \ ecm.c simpqs.c prime_iterator.c gmp_main.c small_factor.c utility.c \ -lgmp -lm -o ecpp-dj

DEPENDENCIES

Perl 5.6.2 or later. No modules outside of Core have been used.

COPYRIGHT AND LICENCE

Copyright (C) 2011-2023 by Dana Jacobsen dana@acm.org

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.