This manual page is part of Xcode Tools version 3.2

To obtain these tools:

If you are running a version of Xcode Tools other than 3.2, view the documentation locally:

  • In Xcode

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • For more information about the manual page format, see the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Reference Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.


BN_new(3)                                          OpenSSL                                         BN_new(3)



NAME
       BN_new, BN_init, BN_clear, BN_free, BN_clear_free - allocate and free BIGNUMs

SYNOPSIS
        #include <openssl/bn.h>

        BIGNUM *BN_new(void);

        void BN_init(BIGNUM *);

        void BN_clear(BIGNUM *a);

        void BN_free(BIGNUM *a);

        void BN_clear_free(BIGNUM *a);

DESCRIPTION
       BN_new() allocates and initializes a BIGNUM structure. BN_init() initializes an existing
       uninitialized BIGNUM.

       BN_clear() is used to destroy sensitive data such as keys when they are no longer needed. It erases
       the memory used by a and sets it to the value 0.

       BN_free() frees the components of the BIGNUM, and if it was created by BN_new(), also the structure
       itself. BN_clear_free() additionally overwrites the data before the memory is returned to the system.

RETURN VALUES
       BN_new() returns a pointer to the BIGNUM. If the allocation fails, it returns NULL and sets an error
       code that can be obtained by ERR_get_error(3).

       BN_init(), BN_clear(), BN_free() and BN_clear_free() have no return values.

SEE ALSO
       bn(3), ERR_get_error(3)

HISTORY
       BN_new(), BN_clear(), BN_free() and BN_clear_free() are available in all versions on SSLeay and
       OpenSSL.  BN_init() was added in SSLeay 0.9.1b.



0.9.8                                            2009-04-03                                        BN_new(3)

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation to the OpenSSL project by sending email to [email protected].
Bug reports
Report bugs in the functionality of the described tool or API to Apple through Bug Reporter and to the OpenSSL project by sending email to [email protected].
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.