epoc32/include/stdapis/openssl/rand.h
author William Roberts <williamr@symbian.org>
Wed, 31 Mar 2010 12:33:34 +0100
branchSymbian3
changeset 4 837f303aceeb
parent 0 061f57f2323e
permissions -rw-r--r--
Current Symbian^3 public API header files (from PDK 3.0.h)
This is the epoc32/include tree with the "platform" subtrees removed, and
all but a selected few mbg and rsg files removed.
     1 /* crypto/rand/rand.h */
     2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
     3  * All rights reserved.
     4  *
     5  * This package is an SSL implementation written
     6  * by Eric Young (eay@cryptsoft.com).
     7  * The implementation was written so as to conform with Netscapes SSL.
     8  * 
     9  * This library is free for commercial and non-commercial use as long as
    10  * the following conditions are aheared to.  The following conditions
    11  * apply to all code found in this distribution, be it the RC4, RSA,
    12  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
    13  * included with this distribution is covered by the same copyright terms
    14  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
    15  * 
    16  * Copyright remains Eric Young's, and as such any Copyright notices in
    17  * the code are not to be removed.
    18  * If this package is used in a product, Eric Young should be given attribution
    19  * as the author of the parts of the library used.
    20  * This can be in the form of a textual message at program startup or
    21  * in documentation (online or textual) provided with the package.
    22  * 
    23  * Redistribution and use in source and binary forms, with or without
    24  * modification, are permitted provided that the following conditions
    25  * are met:
    26  * 1. Redistributions of source code must retain the copyright
    27  *    notice, this list of conditions and the following disclaimer.
    28  * 2. Redistributions in binary form must reproduce the above copyright
    29  *    notice, this list of conditions and the following disclaimer in the
    30  *    documentation and/or other materials provided with the distribution.
    31  * 3. All advertising materials mentioning features or use of this software
    32  *    must display the following acknowledgement:
    33  *    "This product includes cryptographic software written by
    34  *     Eric Young (eay@cryptsoft.com)"
    35  *    The word 'cryptographic' can be left out if the rouines from the library
    36  *    being used are not cryptographic related :-).
    37  * 4. If you include any Windows specific code (or a derivative thereof) from 
    38  *    the apps directory (application code) you must include an acknowledgement:
    39  *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
    40  * 
    41  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
    42  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
    43  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
    44  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
    45  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
    46  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
    47  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
    48  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
    49  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
    50  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
    51  * SUCH DAMAGE.
    52  * 
    53  * The licence and distribution terms for any publically available version or
    54  * derivative of this code cannot be changed.  i.e. this code cannot simply be
    55  * copied and put under another distribution licence
    56  * [including the GNU Public Licence.]
    57  */
    58 /*
    59  © Portions copyright (c) 2006 Nokia Corporation.  All rights reserved.
    60  */
    61 
    62 #ifndef HEADER_RAND_H
    63 #define HEADER_RAND_H
    64 #if (defined(__SYMBIAN32__) && !defined(SYMBIAN))
    65 #define SYMBIAN
    66 #endif
    67 
    68 #ifdef SYMBIAN
    69 #include <e32def.h>
    70 #endif
    71 #include <stdlib.h>
    72 #include <openssl/ossl_typ.h>
    73 #include <openssl/e_os2.h>
    74 
    75 #if defined(OPENSSL_SYS_WINDOWS)
    76 /*MRT
    77 #include <windows.h>
    78 */
    79 #endif
    80 
    81 #ifdef  __cplusplus
    82 extern "C" {
    83 #endif
    84 
    85 #if defined(OPENSSL_FIPS)
    86 #define FIPS_RAND_SIZE_T size_t
    87 #endif
    88 
    89 /* Already defined in ossl_typ.h */
    90 /* typedef struct rand_meth_st RAND_METHOD; */
    91 
    92 struct rand_meth_st
    93 	{
    94 	void (*seed)(const void *buf, int num);
    95 	int (*bytes)(unsigned char *buf, int num);
    96 	void (*cleanup)(void);
    97 	void (*add)(const void *buf, int num, double entropy);
    98 	int (*pseudorand)(unsigned char *buf, int num);
    99 	int (*status)(void);
   100 	};
   101 
   102 #ifdef BN_DEBUG
   103 extern int rand_predictable;
   104 #endif
   105 
   106 IMPORT_C int RAND_set_rand_method(const RAND_METHOD *meth);
   107 IMPORT_C const RAND_METHOD *RAND_get_rand_method(void);
   108 #ifndef OPENSSL_NO_ENGINE
   109 IMPORT_C int RAND_set_rand_engine(ENGINE *engine);
   110 #endif
   111 IMPORT_C RAND_METHOD *RAND_SSLeay(void);
   112 void RAND_cleanup(void );
   113 IMPORT_C int  RAND_bytes(unsigned char *buf,int num);
   114 IMPORT_C int  RAND_pseudo_bytes(unsigned char *buf,int num);
   115 IMPORT_C void RAND_seed(const void *buf,int num);
   116 IMPORT_C void RAND_add(const void *buf,int num,double entropy);
   117 IMPORT_C int  RAND_load_file(const char *file,long max_bytes);
   118 IMPORT_C int  RAND_write_file(const char *file);
   119 IMPORT_C const char *RAND_file_name(char *file,size_t num);
   120 IMPORT_C int RAND_status(void);
   121 IMPORT_C int RAND_query_egd_bytes(const char *path, unsigned char *buf, int bytes);
   122 IMPORT_C int RAND_egd(const char *path);
   123 IMPORT_C int RAND_egd_bytes(const char *path,int bytes);
   124 IMPORT_C int RAND_poll(void);
   125 /*
   126 #if defined(OPENSSL_SYS_WINDOWS) || defined(OPENSSL_SYS_WIN32)
   127 
   128 void RAND_screen(void);
   129 int RAND_event(UINT, WPARAM, LPARAM);
   130 
   131 #endif
   132 */
   133 /* BEGIN ERROR CODES */
   134 /* The following lines are auto generated by the script mkerr.pl. Any changes
   135  * made after this point may be overwritten when the script is next run.
   136  */
   137 IMPORT_C void ERR_load_RAND_strings(void);
   138 
   139 /* Error codes for the RAND functions. */
   140 
   141 /* Function codes. */
   142 #define RAND_F_RAND_GET_RAND_METHOD			 101
   143 #define RAND_F_SSLEAY_RAND_BYTES			 100
   144 
   145 /* Reason codes. */
   146 #define RAND_R_PRNG_NOT_SEEDED				 100
   147 
   148 #ifdef  __cplusplus
   149 }
   150 #endif
   151 #endif