diff -r 000000000000 -r 6474c204b198 security/nss/lib/freebl/mpi/doc/lap.pod --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/security/nss/lib/freebl/mpi/doc/lap.pod Wed Dec 31 06:09:35 2014 +0100 @@ -0,0 +1,36 @@ +# This Source Code Form is subject to the terms of the Mozilla Public +# License, v. 2.0. If a copy of the MPL was not distributed with this +# file, You can obtain one at http://mozilla.org/MPL/2.0/. + +=head1 NAME + + lap - compute least annihilating power of a number + +=head1 SYNOPSIS + + lap + +=head1 DESCRIPTION + +The B program computes the order of I modulo I, for +arbitrary precision integers I and I. The B of I +modulo I is defined as the smallest positive value I for which +I raised to the Ith power, modulo I, is equal to 1. The +order may not exist, if I is composite. + +=head1 RESTRICTIONS + +This program is very slow, especially for large moduli. It is +intended as a way to help find primitive elements in a modular field, +but it does not do so in a particularly inefficient manner. It was +written simply to help verify that a particular candidate does not +have an obviously short cycle mod I. + +=head1 SEE ALSO + +gcd(1), invmod(1), isprime(1) + +=head1 AUTHOR + + Michael J. Fromberger + Thayer School of Engineering, Hanover, New Hampshire, USA