BNCTXstart(3) OpenSSL BNCTXstart(3)

NAME
       BNCTXstart, BNCTXget, BNCTXend - use temporary BIGNUM variables

SYNOPSIS
        #include 

        void BNCTXstart(BNCTX *ctx);

        BIGNUM *BNCTXget(BNCTX *ctx);

        void BNCTXend(BNCTX *ctx);

DESCRIPTION
       These functions are used to obtain temporary BBIIGGNNUUMM variables from a
       BBNNCCTTXX (which can been created by using BNCTXnew(3)) in order to save
       the overhead of repeatedly creating and freeing BBIIGGNNUUMMs in functions
       that are called from inside a loop.

       A function must call BNCTXstart() first. Then, BNCTXget() may be
       called repeatedly to obtain temporary BBIIGGNNUUMMs. All BNCTXget() calls
       must be made before calling any other functions that use the ccttxx as an
       argument.

       Finally, BNCTXend() must be called before returning from the
       function.  When BNCTXend() is called, the BBIIGGNNUUMM pointers obtained
       from BNCTXget() become invalid.

RETURN VALUES
       BNCTXstart() and BNCTXend() return no values.

       BNCTXget() returns a pointer to the BBIIGGNNUUMM, or NNUULLLL on error.  Once
       BNCTXget() has failed, the subsequent calls will return NNUULLLL as well,
       so it is sufficient to check the return value of the last BNCTXget()
       call. In case of an error, an error code is set, which can be obtained
       by ERRgeterror(3).

SEE ALSO
       BNCTXnew(3)

HISTORY       BNCTXstart(), BNCTXget() and BNCTXend() were added in OpenSSL
       0.9.5.



0.9.7l                            2000-07-11                   BNCTXstart(3)