2024 π Daylatest newsbuy art
Poetry is just the evidence of life. If your life is burning well, poetry is just the ashLeonard Cohenburn somethingmore quotes
very clickable
data + munging

The Perl Journal

Volumes 1–6 (1996–2002)

Code tarballs available for issues 1–21.

I reformatted the CD-ROM contents. Some things may still be a little wonky — oh, why hello there <FONT> tag. Syntax highlighting is iffy. Please report any glaring issues.

The Perl Journal
#8
Winter 1997
vol 2
num 4
Unreal Numbers
Why 21.09 doesn't always equal 21.09.
Torture Testing Web Servers and CGI Scripts
Throw random input at your servers and scripts.
JPL: The Java-Perl Library
A glue interface linking Perl and Java.
Perl and EBCDIC
Before Unicode, before ASCII, there was EBCDIC.
Interprocess Communication with MacPerl
Using AppleEvents from Perl.
Perl News
What's new in the Perl Community.
SWIG
Generate Perl wrappers around C/C++ code - automatically.
Telnetting with Perl
How Net::Telnet lets your programs talk to other computers.
B-Trees
An extremely efficient tree data structure.
NT Administration with Perl
Common sysadmin tasks, automated with Perl.
The Great Internet Mersenne Prime Search
A highly distributed computing effort to find new primes.
The Perl Wizard's Quiz
Not for the timid.
The Perl Journal One-Liners
David Nicol (1997) The Great Internet Mersenne Prime Search. The Perl Journal, vol 2(4), issue #8, Winter 1997.

The Great Internet Mersenne Prime Search

A highly distributed computing effort to find new primes.

David Nicol


Until I became acquainted with GIMPS, the Great Internet Mersenne Prime Search (https://www.mersenne.org), the idle cycles on my workstation were spent entirely in wait states. No longer. Now my computer continuously runs a program that breaks new mathematical ground. Even as I write this, it's running in the intervals between my keystrokes, factoring large numbers as part of an Internet-wide coordinated effort to find the highest known prime number. In this article I'll describe how I use Perl not for factoring - a C program does that - but for automating communication with the computer (and person) in charge of GIMPS.

Recently, the world has seen two large problems successfully attacked with massively distributed systems, an approach sometimes called "metacomputing." On June 18, the DES Challenge (DESCHALL), which teamed up computers around the world to decipher a message encrypted with a 56-bit RSA secret key, succeeded. On August 24, the GIMPS project demonstrated that 22976221-1 is a prime number. Both DESCHALL and GIMPS are computer programs that ran with low priority on thousands of computers volunteered around the world.

Prime numbers are integers that can be evenly divided only by themselves and one. They are considered by number theorists to be basic building blocks of arithmetic; all whole numbers have exactly one set of "prime factors" which multiply together to produce them. General truths about primes, such as that there are infinitely many of them, have been pursued by mathematicians since Euclid wrote Elements 2300 years ago. Computers provide us with powers of calculation that were impossible decades ago, and inconceivable centuries ago.

But why search for ever-larger prime numbers? What good does it do? One answer is that the search for prime numbers is merely symbolic, like mountain climbing or space exploration. Just as new technologies are used to explore previously unknown places, new approaches to calculation further the reaches of mathematical knowledge. Before mechanical calculation, Edouard Lucas's 2127-1 was the largest known prime number, even though people had known forever since Euclid that there was necessarily one greater. This record stood from 1876 to 1951, which was a very busy year. A larger prime was found by a man with a mechanical calculator. Then a team with an electrical computer found a dozen higher ones.

So what difference can finding a new highest prime number make? Outside of the prestige of having your name appear in math almanacs, not a lot. George Woltman's GIMPS project is just for fun. Not that there's anything wrong with that; my personal daydream is a distributed computerized Go opponent. Other metacomputing projects, in which thousands of computers work independently and simultaneously on different portions of a large problem like weather modeling, may have bearing on less frivolous tasks. The DESCHALL project showed that 56-bit RSA keys are not secure.

Mersenne numbers, named after the French monk Marin Mersenne (1588-1648), are numbers of the form 2p-1, where p is a prime number. Since Mersenne was born, the highest known prime number since Mersenne was born has always been either a Mersenne prime or a factor of a Mersenne composite, except for a brief period in 1951.

It's not that Mersenne numbers tend to be prime, it's just vastly easier to test them. Most numbers require exhaustive factoring to determine primality, but it's possible to test a Mersenne number for primality with only bit-rotation and addition, using a method called the "Lucas-Lehmer test." The relative ease of the Lucas method of verifying primality is what made Lucas' prime, 2127-1, reign as the highest known prime number before mechanical computing devices. Since 127 is prime, Lucas' prime is also a Mersenne prime.

Currently 35 Mersenne numbers are known to be prime, and more are being tested even as you are reading these words. The tool is a mprime, written by George Woltman and optimized for the Intel x86 architecture. mprime survives sudden shutdown or termination by keeping its state written out to a file, so not all work is lost if the program is interrupted. A more generic version of mprime suitable for other architectures is mers, distributed as C source code by Will Edgington, at ftp://ftp.delta.com/pub/users/mersenne.

Here's how to enroll your computer in GIMPS.

  1. Download mprime (the Lucas-Lehmer factoring software) and the database of factors.
  2. Reserve a range of numbers to factor or test, to avoid duplication of effort.
  3. Configure your machine to launch the software on reboot.
  4. Launch the software.
My mprime.sh and NewAssignment.pl scripts (both available from the TPJ web site) automate all but step 1. That requires an account named mprime on your Unix system and this .netrc file in its home directory:

machine ftp.mersenne.org 
login anonymous 
password mprimescripts_user 
macdef init 
binary get database.gz 
! gunzip --force database.gz 
quit

You'll also need to set up a cron job (type man cron or man crontab at your Unix command line) to periodically FTP from ftp.mersenne.org. A crontab entry like this will do:

# periodically download a new database 
51 3 25 * * ftp ftp.mersenne.org

(The five fields at the beginning of crontab entries represent the minute, hour, day of month, month, and day of week. The above entry will download a new database at 51 minutes after 3 am, on the 25th of the month, on every month (that's the first *) and regardless of the day of the week (the second *). Please choose different numbers to avoid a network bottleneck. Better yet, uncomment the # ftp ftp.mersenne.org line in mprime.sh after your .netrc file is working. People installing mprime on machines without permanent network connections (like myself) will of course get errors unless their dialup connections are brought up before running FTP.

When this cron job runs, it invokes the FTP program with one command line argument: ftp.mersenne.org. The FTP program then connects to ftp.mersenne.org and checks the local .netrc file for instructions pertaining to the connection. That .netrc file will make FTP log in as anonymous, provide a password of mprimescripts_user, change the mode of the FTP connection to binary, and download database.gz, the database of factors. After downloading, the line starting with the exclamation point is passed to a shell. Provided gunzip is available, the database will be uncompressed, overwriting the old one (that's what the --force is for).

Although steps two, three, and four could have been included in a slightly more complex Perl program, the vast majority of the system's running time is spent waiting for mprime to complete, which means that the program will be mostly sitting around doing nothing. That's why we want a program that will consume minimal memory. The winner isn't Perl, alas, but a shell script: and a little used one at that: ash. I don't use Perl for everything, just what it's best suited to: practically extracting data from a report. That report is the "Choose a Range page" and the data are the range of numbers to be given to mprime.

Figure 1: The Choose a Range Page, parsed by NewAssignment.pl

Figure 1: The Choose a Range Page, parsed by NewAssignment.pl

The shell script mprime.sh invokes the mprime program with command line arguments read from a file called assignment, stands patiently by while it runs, and then invokes NewAssignment.pl once mprime completes its assignment and needs a new one. To preserve mprime's "killability," mprime.sh checks the results file created by mprime to see if mprime actually finished its task or was terminated abnormally.

Unless the words "Please send the results file to" appear in the results file, it is assumed that mprime was killed by a signal, which means that something is wrong and it's time for mprime.sh to quit. Otherwise, mprime.sh archives the results file, mails George Woltman the results file, and runs NewAssignment.pl to choose a new assignment. You'll have to edit lines 59 and 76 so that the mail program on your system is invoked with the correct options.

Choosing a new assignment is too complex a task for a shell script; luckily, Perl's regular expression support makes it easy. NewAssignment.pl downloads the web page, chooses a range based on its contents, and mails George Woltman a claim to the range. This approach could easily be adapted to other large problems that can be cleanly divided into smaller problems.

The first step in choosing a new GIMPS assignment is obtaining the list of available assignments by downloading George Woltman's Choose a Range page at https://www.mersenne.org/range.htm. The lynx text-based web browser is used; it takes a command line switch, -dump, that makes it print a web page to standard output. In Perl, external programs are launched (and their output retrieved) with backquotes:

# load the "reserve a range" web page into a variable: 
$ChooseARangePage = 
           'lynx -dump https://www.mersenne.org/range.htm';

This gives us the web page we need. We could also have used the LWP library from the CPAN to create a virtual web browser, and then we wouldn't even need lynx.

There are three sets of ranges. Each range begins with a description of what the task is, followed by the words "a range of" and the minimum recommended range size, followed by more words, the last of which is "from," followed by a comma-separated list of pairs of the form M to N, where M and N are both natural numbers. A period terminates the range.

This structure can be represented as a Perl regular expression:

m/a range of (\d+) .*? from ([\s0-9to,]+)\./s

Here's a quick review of the regular expression atoms used:

  • The m (matching operator) begins the regular expression.
  • The text a range of matches exactly those words, wherever they appear.
  • \d matches any one of the digits 0123456789.
  • + means "one or more," so \d+ matches one or more digits.
  • Parentheses remember their contents, in this case \d+. That's the first and lower of the suggested range sizes.
  • Dot matches any character. (Except newline, unless the regex has the /s modifier. Ours will.)
  • * means "zero or more," so .* matches as many characters as possible. This is often called "greedy matching."
  • But ? after * or + means match as little as possible, so .*? means match a few characters as possible.
  • Square brackets define a set of characters, in this case an \s (whitespace), a digit between 0 and 9, a t, an o, or a comma.
  • ([\s0-9to,]+) thus matches substrings like 8 to 80 and 9to9,999.
  • \. matches an actual period.
The part of this regex that matches the range in NewAssignment.pl is called $RangeMatcher:

$RangeMatcher = '.*a range of (\d+) .* from ([\s0-9to,]+)\.';

$RangeMatcher is defined as a single-quoted string so that the special regex characters aren't translated. If it were doublequoted, the backslashes in it would be inadvertently interpreted before the match took place.

Coupled with another word to localize the search to a part of the file, this regex remembers the number of numbers we want to test and the comma-separated list of ranges. We can assign them to two variables:

($PortionSize, $RangeListing) =
           ($ChooseARangePage =~ m/$PreText$RangeMatcher/s);

We know what $RangeMatcher matches now; the other part of the regex is $PreText, the text before the range. There are five tasks we might want our computer to attempt. The first three are called B1, B2, and B3 in NewAssignment.pl, and search for increasingly larger sets of Mersenne primes. Task R checks "reclaimed" numbers that were dropped by other users, and task F factors known composites to speed up others' Lucas-Lehmer tests. Each task requires a slightly different regular expression for the Choose a Range page; task F in particular requires that the -f command-line switch be provided to mprime.

Once we've decided what we want to do by randomly selecting B1, B2, B3, R, or F in line 22, the script invokes lynx to capture the web page. This happens inside a loop, in case the local network or www.mersenne.org is down. Once we have the web page, it's matched against /$PreText$RangeMatcher/s, and if all goes well it matches and sets $PortionSize and $RangeListing appropriately for whichever assignment we've chosen.

Making it past the until loop means that $PortionSize and $RangeListing have been successfully set. The only change that might be necessary is if we're running mprimescripts on a speedy machine that can handle an unusually large range (line 42). Massaging $RangeListing takes a few steps. The script strips the whitespace out (line 44), splits the result on commas into @Ranges (line 45), chooses one of those elements at random (line 47), and splits on the word "to" to extract the lower and upper boundaries of the range (line 49). If we're ambitious enough to have increased $PortionSize in line 42, it's possible that our range isn't big enough, in which case lines 51 through 55 redefine $High as $Low plus $PortionSize.

All that remains is to write $Assignment into the assignment file, and mail mprime and George Woltman with the selected range. All mail sent from mprimescripts has subject lines which could be filtered by software such as procmail and directed to another Perl script for similar automation. Of course, to adapt this system for use in a different distributed idle-time project, you'll need an equivalent of George Woltman: a central authority responsible for declaring which assignments are available.

Mathematicians who have theories about where the next Mersenne prime occurs can reserve that range in the hope of getting their names in the history books; in contrast, NewAssignment.pl chooses its assignment randomly to minimize the possibility of collisions, since random selection from a long list of choices is a good way to lower the probability of duplications. In fully automated systems designed from the beginning to be distributed, the clients might query a central server for their next assignment instead. The DESCHALL project, for instance, was distributed as source code, and each client program in the brute force search of the 56-bit RSA key space checked into a central key server regularly to get a new range of numbers. (Had DESCHALL not been distributed as source code, this would have been a substantial security risk. Allowing foreign programs access to your computer is risky without assurance that the metacomputing client does only what it's supposed to be doing.)


David Nicol (dnconsult@tipjar.com) does Unix system administration in Kansas City. He can often be found logged on to the Internet Go Server as kcspirit.

listing 1

NewAssignment.pl, called from mprime.sh
David Nicol (1997) The Great Internet Mersenne Prime Search. The Perl Journal, vol 2(4), issue #8, Winter 1997.
01 #!/usr/bin/perl
02 
03 $RangeMatcher = ’.*?a range of (\d+) .*? from ([\s0-9to,]+)\.’;
04
05 $PreTextB1 = "easiest";       # "These are the easiest exponents to test."
06 $Flags{B1} = "";
07 $PreTextB2 = "little longer"; # "These exponents take a little longer to test"
08 $Flags{B2} = ""
09 $PreTextB3 = "slowest"        # "These are the slowest numbers to test"
10 $Flags{B3} = "";
11 $PreTextR  = "Reclaimed"      # "Reclaimed Ranges" section
12 $Flags{R}  = ""
13 $PreTextF  = "Factoring";     # "Factoring" section
14 $Flags{F}  = "-f ";           # An extra command line flag for 
                                 # factoring composites
15
16 srand(time ^ ($$ + ($$ << 15)));  # Seed the random number generator
17
18 # edit the next line, leaving only the tests you want to consider
19 @Suffixes = qw(B1, B2, B3, R, F);
20
21 # choose which kind of search to perform
22 $Suffix   = $Suffixes[int rand scalar(@Suffixes)];
23 $PreText  = ${’PreText’ . $Suffix};
24 $PreFlags = "-i500000 -l2.1 -p300";       # Command line flags for mprime
25 print "Chose to search for list after <$PreText>\n";
26 
27 # If the network is down, we try until lynx -dump meets our expectations. 
28 until ($RangeListing){
29     # load the "Choose a Range" web page into a variable:
30     $ChooseARangePage = `lynx -dump https://www.mersenne.org/range.htm`;
31     last if ($PortionSize, $RangeListing) = 
               ($ChooseARangePage =~ m/$PreText$RangeMatcher/s);
32
33     # invoke your ppp-down script here, e.g. system( ’ppp-down’ );
34
35     die "Bad data from https://www.mersenne.org/range.htm\n" 
                                      unless $Tries++ < 20;
       # try once every three hours, twenty minutes, for nearly a week
36     sleep 200;     
37
38     # invoke your ppp-up script here, e.g. system( ’ppp-up’);
39 };
40
41 # If you have a fast machine and you want a large portion, uncomment this:
42 # $PortionSize *= 2
43 
44 $RangeListing =~ s/\s//g;            # lose spaces, tabs, newlines
45 @Ranges = split /,/, $RangeListing;  # Split $RangeListing, using "," 
                                        # as a delimiter
46 
47 $MyRange = $Ranges[int rand scalar(@Ranges)];
48
   # narrow MyRange down to a normal size portion
49 ($Low,$High)=split(/to/, $MyRange);  
50 
   # for when there’s a missing chunk
51 unless ($High - $Low < $PortionSize) {    
52     #redefine $MyRange to be a normal portion
53     $High    = $Low + $PortionSize;
54     $MyRange = "$Low $High";
55 };
56 
57 $Assignment = "$Flags{$Suffix} $MyRange $PreFlags";
58 $Hostname   = `hostname`;
59 open(MAIL, "|mail mprime");   # open a pipe to the mail program; 
                                 # assumes mprime is a valid address
60 print MAIL <<"END";
61 Subject: New GIMPS assignment for $Hostname
62 
63     This message is coming from the mprime script, choosing
64     a new assignment for $Hostname.
65 
66     I’ve randomly chosen to do $Assignment, and have registered it
67     with George Woltman. 
68 
69 END
70 
71 open (ASSIGNMENT, ">assignment") or die "Can’t open 
         assignment file, check permissions and ownership";
72 print ASSIGNMENT $Assignment;
73 close ASSIGNMENT;   # Write $Assignment out to the assignment file
74
75 # Send mail to George Woltman to reserve the range.
76 open(MAIL, "|mail -s \"Automated assignment choice: 
                         $Assignment\" woltman\@magicnet.net");
77 print MAIL <<"ENDMAIL";
78 
79 Hi George!
80 
81 My computer has finished its last assignment and 
82 in theory has sent you the results file.
83 
84 I have chosen, at random, from https://www.mersenne.org/range.htm,
85 to do $Assignment
86 
87 A reply to this message should get back to me if I need to change
88 that range by 
89 
90 editing my assignment file, 
91 killing mprime, 
92 and running mprime.sh again.
93 
94 See ya in a couple months!
95 ENDMAIL
Martin Krzywinski | contact | Canada's Michael Smith Genome Sciences CentreBC Cancer Research CenterBC CancerPHSA
Google whack “vicissitudinal corporealization”
{ 10.9.234.152 }