mp(3X)             UNIX System V(BSD Compatibility Package)              mp(3X)


NAME
      mp:  madd, msub, mult, mdiv, mcmp, min, mout, pow, gcd, rpow, msqrt,
      sdiv, itom, xtom, mtox, mfree - multiple precision integer arithmetic

SYNOPSIS
      cc [ flag. . . ] file . . .  -lmp

      #include <mp.h>
      madd(a, b, c)
      MINT *a, *b, *c;
      msub(a, b, c)
      MINT *a, *b, *c;
      mult(a, b, c)
      MINT *a, *b, *c;
      mdiv(a, b, q, r)
      MINT *a, *b, *q, *r;
      mcmp(a,b)
      MINT *a, *b;
      min(a)
      MINT *a;
      mout(a)
      MINT *a;
      pow(a, b, c, d)
      MINT *a, *b, *c, *d;
      gcd(a, b, c)
      MINT *a, *b, *c;
      rpow(a, n, b)
      MINT *a, *b;
      short n;
      msqrt(a, b, r)
      MINT *a, *b, *r;
      sdiv(a, n, q, r)
      MINT *a, *q;
      short n, *r;
      MINT *itom(n)
      short n;
      MINT *xtom(s)
      char *s;
      char *mtox(a)
      MINT *a;
      void mfree(a)
      MINT *a;

DESCRIPTION
      These routines perform arithmetic on integers of arbitrary length.  The
      integers are stored using the defined type MINT.  Pointers to a MINT
      should be initialized using the function itom, which sets the initial
      value to n.  Alternatively, xtom may be used to initialize a MINT from a
      string of hexadecimal digits.  mfree may be used to release the storage
      allocated by the itom and xtom routines.




10/89                                                                    Page 1

mp(3X)             UNIX System V(BSD Compatibility Package)              mp(3X)


      madd, msub and mult assign to their third arguments the sum, difference,
      and product, respectively, of their first two arguments.  mdiv assigns
      the quotient and remainder, respectively, to its third and fourth
      arguments.  sdiv is like mdiv except that the divisor is an ordinary
      integer.  msqrt produces the square root and remainder of its first
      argument.  mcmp compares the values of its arguments and returns 0 if the
      two values are equal, >0 if the first argument is greater than the
      second, and <0 if the second argument is greater than the first.  rpow
      calculates a raised to the power b, while pow calculates this reduced
      modulo m.  min and mout do decimal input and output.  gcd finds the
      greatest common divisor of the first two arguments, returning it in the
      third argument.  mtox provides the inverse of xtom.  To release the
      storage allocated by mtox, use free [see malloc(3)].

      Use the -libmp loader option to obtain access to these functions.

RETURN VALUE
      Illegal operations and running out of memory produce messages and core
      images.

FILES
      /usr/ucblib/libmp.a

SEE ALSO
      malloc(3) in the Programmer's Reference Manual





























Page 2                                                                    10/89