epoc32/include/stdapis/openssl/opensslv.h
author William Roberts <williamr@symbian.org>
Tue, 16 Mar 2010 16:12:26 +0000
branchSymbian2
changeset 2 2fe1408b6811
parent 0 061f57f2323e
permissions -rw-r--r--
Final list of Symbian^2 public API header files
williamr@2
     1
#ifndef HEADER_OPENSSLV_H
williamr@2
     2
#define HEADER_OPENSSLV_H
williamr@2
     3
williamr@2
     4
/* Numeric release version identifier:
williamr@2
     5
 * MNNFFPPS: major minor fix patch status
williamr@2
     6
 * The status nibble has one of the values 0 for development, 1 to e for betas
williamr@2
     7
 * 1 to 14, and f for release.  The patch level is exactly that.
williamr@2
     8
 * For example:
williamr@2
     9
 * 0.9.3-dev	  0x00903000
williamr@2
    10
 * 0.9.3-beta1	  0x00903001
williamr@2
    11
 * 0.9.3-beta2-dev 0x00903002
williamr@2
    12
 * 0.9.3-beta2    0x00903002 (same as ...beta2-dev)
williamr@2
    13
 * 0.9.3	  0x0090300f
williamr@2
    14
 * 0.9.3a	  0x0090301f
williamr@2
    15
 * 0.9.4	  0x0090400f
williamr@2
    16
 * 1.2.3z	  0x102031af
williamr@2
    17
 *
williamr@2
    18
 * For continuity reasons (because 0.9.5 is already out, and is coded
williamr@2
    19
 * 0x00905100), between 0.9.5 and 0.9.6 the coding of the patch level
williamr@2
    20
 * part is slightly different, by setting the highest bit.  This means
williamr@2
    21
 * that 0.9.5a looks like this: 0x0090581f.  At 0.9.6, we can start
williamr@2
    22
 * with 0x0090600S...
williamr@2
    23
 *
williamr@2
    24
 * (Prior to 0.9.3-dev a different scheme was used: 0.9.2b is 0x0922.)
williamr@2
    25
 * (Prior to 0.9.5a beta1, a different scheme was used: MMNNFFRBB for
williamr@2
    26
 *  major minor fix final patch/beta)
williamr@2
    27
 */
williamr@2
    28
williamr@2
    29
#if (defined(__SYMBIAN32__) && !defined(SYMBIAN))
williamr@2
    30
#define SYMBIAN
williamr@2
    31
#endif
williamr@2
    32
  
williamr@2
    33
#define OPENSSL_VERSION_NUMBER	0x0090807fL
williamr@2
    34
#ifdef OPENSSL_FIPS
williamr@2
    35
#define OPENSSL_VERSION_TEXT	"OpenSSL 0.9.8g-fips 19 Oct 2007"
williamr@2
    36
#else
williamr@2
    37
#define OPENSSL_VERSION_TEXT	"OpenSSL 0.9.8g 19 Oct 2007"
williamr@2
    38
#endif
williamr@2
    39
#define OPENSSL_VERSION_PTEXT	" part of " OPENSSL_VERSION_TEXT
williamr@2
    40
williamr@2
    41
williamr@2
    42
/* The macros below are to be used for shared library (.so, .dll, ...)
williamr@2
    43
 * versioning.  That kind of versioning works a bit differently between
williamr@2
    44
 * operating systems.  The most usual scheme is to set a major and a minor
williamr@2
    45
 * number, and have the runtime loader check that the major number is equal
williamr@2
    46
 * to what it was at application link time, while the minor number has to
williamr@2
    47
 * be greater or equal to what it was at application link time.  With this
williamr@2
    48
 * scheme, the version number is usually part of the file name, like this:
williamr@2
    49
 *
williamr@2
    50
 *	libcrypto.so.0.9
williamr@2
    51
 *
williamr@2
    52
 * Some unixen also make a softlink with the major verson number only:
williamr@2
    53
 *
williamr@2
    54
 *	libcrypto.so.0
williamr@2
    55
 *
williamr@2
    56
 * On Tru64 and IRIX 6.x it works a little bit differently.  There, the
williamr@2
    57
 * shared library version is stored in the file, and is actually a series
williamr@2
    58
 * of versions, separated by colons.  The rightmost version present in the
williamr@2
    59
 * library when linking an application is stored in the application to be
williamr@2
    60
 * matched at run time.  When the application is run, a check is done to
williamr@2
    61
 * see if the library version stored in the application matches any of the
williamr@2
    62
 * versions in the version string of the library itself.
williamr@2
    63
 * This version string can be constructed in any way, depending on what
williamr@2
    64
 * kind of matching is desired.  However, to implement the same scheme as
williamr@2
    65
 * the one used in the other unixen, all compatible versions, from lowest
williamr@2
    66
 * to highest, should be part of the string.  Consecutive builds would
williamr@2
    67
 * give the following versions strings:
williamr@2
    68
 *
williamr@2
    69
 *	3.0
williamr@2
    70
 *	3.0:3.1
williamr@2
    71
 *	3.0:3.1:3.2
williamr@2
    72
 *	4.0
williamr@2
    73
 *	4.0:4.1
williamr@2
    74
 *
williamr@2
    75
 * Notice how version 4 is completely incompatible with version, and
williamr@2
    76
 * therefore give the breach you can see.
williamr@2
    77
 *
williamr@2
    78
 * There may be other schemes as well that I haven't yet discovered.
williamr@2
    79
 *
williamr@2
    80
 * So, here's the way it works here: first of all, the library version
williamr@2
    81
 * number doesn't need at all to match the overall OpenSSL version.
williamr@2
    82
 * However, it's nice and more understandable if it actually does.
williamr@2
    83
 * The current library version is stored in the macro SHLIB_VERSION_NUMBER,
williamr@2
    84
 * which is just a piece of text in the format "M.m.e" (Major, minor, edit).
williamr@2
    85
 * For the sake of Tru64, IRIX, and any other OS that behaves in similar ways,
williamr@2
    86
 * we need to keep a history of version numbers, which is done in the
williamr@2
    87
 * macro SHLIB_VERSION_HISTORY.  The numbers are separated by colons and
williamr@2
    88
 * should only keep the versions that are binary compatible with the current.
williamr@2
    89
 */
williamr@2
    90
#define SHLIB_VERSION_HISTORY ""
williamr@2
    91
#define SHLIB_VERSION_NUMBER "0.9.8"
williamr@2
    92
williamr@2
    93
williamr@2
    94
#endif /* HEADER_OPENSSLV_H */