.links: Drop obsolete `lib-config.in' file.

[u/mdw/catacomb] / mp-modsqrt.c

diff --git a/mp-modsqrt.c b/mp-modsqrt.c
index f9e4b0f..1791185 100644 (file)
--- a/mp-modsqrt.c
+++ b/mp-modsqrt.c
@@ -7,7 +7,7 @@
  * (c) 2000 Straylight/Edgeware
  */
 
-/*----- Licensing notice --------------------------------------------------* 
+/*----- Licensing notice --------------------------------------------------*
  *
  * This file is part of Catacomb.
  *
@@ -15,12 +15,12 @@
  * it under the terms of the GNU Library General Public License as
  * published by the Free Software Foundation; either version 2 of the
  * License, or (at your option) any later version.
- * 
+ *
  * Catacomb 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 Library General Public License for more details.
- * 
+ *
  * You should have received a copy of the GNU Library General Public
  * License along with Catacomb; if not, write to the Free
  * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
@@ -51,6 +51,9 @@
  *             work if %$p$% is composite: you must factor the modulus, take
  *             a square root mod each factor, and recombine the results
  *             using the Chinese Remainder Theorem.
+ *
+ *             We guarantee that the square root returned is the smallest
+ *             one (i.e., the `positive' square root).
  */
 
 mp *mp_modsqrt(mp *d, mp *a, mp *p)
@@ -86,7 +89,7 @@ mp *mp_modsqrt(mp *d, mp *a, mp *p)
   /* --- Find the inverse of %$a$% --- */
 
   ainv = mp_modinv(MP_NEW, a, p);
-  
+
   /* --- Split %$p - 1$% into a power of two and an odd number --- */
 
   t = mp_sub(MP_NEW, p, MP_ONE);
@@ -116,7 +119,7 @@ mp *mp_modsqrt(mp *d, mp *a, mp *p)
     dd = mpmont_reduce(&mm, dd, dd);
     dd = mpmont_mul(&mm, dd, dd, ainv);
 
-    /* --- Now %$d = d_0^{s - i - 1}$% --- */
+    /* --- Now %$d = d_0^{2^{s - i - 1}}$% --- */
 
     for (j = i; j < s - 1; j++) {
       dd = mp_sqr(dd, dd);
@@ -131,9 +134,14 @@ mp *mp_modsqrt(mp *d, mp *a, mp *p)
     c = mpmont_reduce(&mm, c, c);
   }
 
-  /* --- Done, so tidy up --- */
+  /* --- Done, so tidy up --- *
+   *
+   * Canonify the answer.
+   */
 
   d = mpmont_reduce(&mm, d, r);
+  r = mp_sub(r, p, d);
+  if (MP_CMP(r, <, d)) { mp *tt = r; r = d; d = tt; }
   mp_drop(ainv);
   mp_drop(r); mp_drop(c);
   mp_drop(dd);
@@ -161,22 +169,17 @@ static int verify(dstr *v)
     ok = 0;
   else if (MP_EQ(r, rr))
     ok = 1;
-  else {
-    r = mp_sub(r, p, r);
-    if (MP_EQ(r, rr))
-      ok = 1;
-  }
 
   if (!ok) {
     fputs("\n*** fail\n", stderr);
     fputs("a  = ", stderr); mp_writefile(a, stderr, 10); fputc('\n', stderr);
     fputs("p  = ", stderr); mp_writefile(p, stderr, 10); fputc('\n', stderr);
     if (r) {
-      fputs("r  = ", stderr);
+      fputs("r = ", stderr);
       mp_writefile(r, stderr, 10);
       fputc('\n', stderr);
     } else
-      fputs("r  = <undef>\n", stderr);
+      fputs("r = <undef>\n", stderr);
     fputs("rr = ", stderr); mp_writefile(rr, stderr, 10); fputc('\n', stderr);
     ok = 0;
   }