secport.h - mozsearch

/* This Source Code Form is subject to the terms of the Mozilla Public

 * License, v. 2.0. If a copy of the MPL was not distributed with this

 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

/*

 * secport.h - portability interfaces for security libraries

*/

#ifndef _SECPORT_H_

#define _SECPORT_H_

#include "utilrename.h"

#include "prlink.h"

/*

 * define XP_WIN, or XP_UNIX, in case they are not defined

 * by anyone else

*/

#ifdef _WINDOWS

#ifndef XP_WIN

#define XP_WIN

#endif

#if defined(_WIN32) || defined(WIN32)

#ifndef XP_WIN32

#define XP_WIN32

#endif

#endif

#endif

#ifdef unix

#ifndef XP_UNIX

#define XP_UNIX

#endif

#endif

#include <sys/types.h>

#include <ctype.h>

#include <string.h>

#include <stddef.h>

#include <stdlib.h>

#include <stdint.h>

#include "prtypes.h"

#include "prlog.h" /* for PR_ASSERT */

#include "plarena.h"

#include "plstr.h"

/*

 * HACK for NSS 2.8 to allow Admin to compile without source changes.

*/

#ifndef SEC_BEGIN_PROTOS

#include "seccomon.h"

#endif

/*

 * The PORT_*Arena* function signatures mostly involve PLArenaPool* arguments.

 * But this is misleading! It's not actually safe to use vanilla PLArenaPools

 * with them. There are two "subclasses" of PLArenaPool that should be used

 * instead.

 * - PORTArenaPool (defined in secport.c): this "subclass" is always

 *   heap-allocated and uses a (heap-allocated) lock to protect all accesses.

 *   Use PORT_NewArena() and PORT_FreeArena() to create and destroy

 *   PORTArenaPools.

 * - PORTCheapArenaPool (defined here): this "subclass" can be stack-allocated

 *   and does not use a lock to protect accesses. This makes it cheaper but

 *   less general. It is best used for arena pools that (a) are hot, (b) have

 *   lifetimes bounded within a single function, and (c) don't need locking.

 *   Use PORT_InitCheapArena() and PORT_DestroyCheapArena() to initialize and

 *   finalize PORTCheapArenaPools.

 * All the other PORT_Arena* functions will operate safely with either

 * subclass.

*/

} PORTCheapArenaPool;

SEC_BEGIN_PROTOS

extern void *PORT_Alloc(size_t len);

extern void *PORT_Realloc(void *old, size_t len);

extern void *PORT_ZAlloc(size_t len);

extern void *PORT_ZAllocAligned(size_t bytes, size_t alignment, void **mem);

extern void *PORT_ZAllocAlignedOffset(size_t bytes, size_t alignment,

                                      size_t offset);

extern void PORT_Free(void *ptr);

extern void PORT_ZFree(void *ptr, size_t len);

extern char *PORT_Strdup(const char *s);

extern void PORT_SetError(int value);

extern int PORT_GetError(void);

/* These functions are for use with PORTArenaPools. */

extern PLArenaPool *PORT_NewArena(unsigned long chunksize);

extern void PORT_FreeArena(PLArenaPool *arena, PRBool zero);

/* These functions are for use with PORTCheapArenaPools. */

extern void PORT_InitCheapArena(PORTCheapArenaPool *arena,

                                unsigned long chunksize);

extern void PORT_DestroyCheapArena(PORTCheapArenaPool *arena);

/* These functions work with both kinds of arena pool. */

extern void *PORT_ArenaAlloc(PLArenaPool *arena, size_t size);

extern void *PORT_ArenaZAlloc(PLArenaPool *arena, size_t size);

extern void *PORT_ArenaGrow(PLArenaPool *arena, void *ptr,

                            size_t oldsize, size_t newsize);

extern void *PORT_ArenaMark(PLArenaPool *arena);

extern void PORT_ArenaRelease(PLArenaPool *arena, void *mark);

extern void PORT_ArenaZRelease(PLArenaPool *arena, void *mark);

extern void PORT_ArenaUnmark(PLArenaPool *arena, void *mark);

extern char *PORT_ArenaStrdup(PLArenaPool *arena, const char *str);

SEC_END_PROTOS

#define PORT_Assert PR_ASSERT

/* This is a variation of PORT_Assert where the arguments will be always

 * used either in Debug or not. But, in optimized mode the result will be

 * ignored. See more details in Bug 1588015. */

#define PORT_AssertArg PR_ASSERT_ARG

/* Assert the current location can't be reached, passing a reason-string. */

#define PORT_AssertNotReached(reasonStr) PR_NOT_REACHED(reasonStr)

/* macros to handle endian based byte conversion */

#define PORT_GET_BYTE_BE(value, offset, len) \

    ((unsigned char)(((len) - (offset)-1) >= sizeof(value) ? 0 : (((value) >> (((len) - (offset)-1) * PR_BITS_PER_BYTE)) & 0xff)))

#define PORT_GET_BYTE_LE(value, offset, len) \

    ((unsigned char)((offset) > sizeof(value) ? 0 : (((value) >> ((offset)*PR_BITS_PER_BYTE)) & 0xff)))

/* This runs a function that should return SECSuccess.

 * Intended for NSS internal use only.

 * The return value is asserted in a debug build, otherwise it is ignored.

 * This is no substitute for proper error handling.  It is OK only if you

 * have ensured that the function cannot fail by other means such as checking

 * prerequisites.  In that case this can be used as a safeguard against

 * unexpected changes in a function.

*/

#ifdef DEBUG

#define PORT_CheckSuccess(f) PR_ASSERT((f) == SECSuccess)

#else

#define PORT_CheckSuccess(f) (f)

#endif

#define PORT_ZNew(type) (type *)PORT_ZAlloc(sizeof(type))

#define PORT_ZNewAligned(type, alignment, mem) \

    (type *)PORT_ZAllocAlignedOffset(sizeof(type), alignment, offsetof(type, mem))

#define PORT_New(type) (type *)PORT_Alloc(sizeof(type))

#define PORT_ArenaNew(poolp, type) \

    (type *)PORT_ArenaAlloc(poolp, sizeof(type))

#define PORT_ArenaZNew(poolp, type) \

    (type *)PORT_ArenaZAlloc(poolp, sizeof(type))

#define PORT_NewArray(type, num) \

    (type *)PORT_Alloc(sizeof(type) * (num))

#define PORT_ZNewArray(type, num) \

    (type *)PORT_ZAlloc(sizeof(type) * (num))

#define PORT_ArenaNewArray(poolp, type, num) \

    (type *)PORT_ArenaAlloc(poolp, sizeof(type) * (num))

#define PORT_ArenaZNewArray(poolp, type, num) \

    (type *)PORT_ArenaZAlloc(poolp, sizeof(type) * (num))

/* Please, keep these defines sorted alphabetically.  Thanks! */

#define PORT_Atoi(buff) (int)strtol(buff, NULL, 10)

/* Returns a UTF-8 encoded constant error string for err.

 * Returns NULL if initialization of the error tables fails

 * due to insufficient memory.

 * This string must not be modified by the application.

*/

#define PORT_ErrorToString(err) PR_ErrorToString((err), PR_LANGUAGE_I_DEFAULT)

#define PORT_ErrorToName PR_ErrorToName

#define PORT_Memcmp memcmp

#define PORT_Memcpy memcpy

#define PORT_Memmove memmove

#define PORT_Memset memset

#define PORT_Strcasecmp PL_strcasecmp

#define PORT_Strcat strcat

#define PORT_Strchr strchr

#define PORT_Strrchr strrchr

#define PORT_Strcmp strcmp

#define PORT_Strcpy strcpy

#define PORT_Strlen(s) strlen(s)

#define PORT_Strncasecmp PL_strncasecmp

#define PORT_Strncat strncat

#define PORT_Strncmp strncmp

#define PORT_Strncpy strncpy

#define PORT_Strpbrk strpbrk

#define PORT_Strstr strstr

#define PORT_Strtok strtok

#define PORT_Tolower tolower

typedef PRBool(PR_CALLBACK *PORTCharConversionWSwapFunc)(PRBool toUnicode,

                                                         unsigned char *inBuf, unsigned int inBufLen,

                                                         unsigned char *outBuf, unsigned int maxOutBufLen,

                                                         unsigned int *outBufLen, PRBool swapBytes);

typedef PRBool(PR_CALLBACK *PORTCharConversionFunc)(PRBool toUnicode,

                                                    unsigned char *inBuf, unsigned int inBufLen,

                                                    unsigned char *outBuf, unsigned int maxOutBufLen,

                                                    unsigned int *outBufLen);

SEC_BEGIN_PROTOS

void PORT_SetUCS4_UTF8ConversionFunction(PORTCharConversionFunc convFunc);

void PORT_SetUCS2_ASCIIConversionFunction(PORTCharConversionWSwapFunc convFunc);

PRBool PORT_UCS4_UTF8Conversion(PRBool toUnicode, unsigned char *inBuf,

                                unsigned int inBufLen, unsigned char *outBuf,

                                unsigned int maxOutBufLen, unsigned int *outBufLen);

PRBool PORT_UCS2_ASCIIConversion(PRBool toUnicode, unsigned char *inBuf,

                                 unsigned int inBufLen, unsigned char *outBuf,

                                 unsigned int maxOutBufLen, unsigned int *outBufLen,

                                 PRBool swapBytes);

void PORT_SetUCS2_UTF8ConversionFunction(PORTCharConversionFunc convFunc);

PRBool PORT_UCS2_UTF8Conversion(PRBool toUnicode, unsigned char *inBuf,

                                unsigned int inBufLen, unsigned char *outBuf,

                                unsigned int maxOutBufLen, unsigned int *outBufLen);

/* One-way conversion from ISO-8859-1 to UTF-8 */

PRBool PORT_ISO88591_UTF8Conversion(const unsigned char *inBuf,

                                    unsigned int inBufLen, unsigned char *outBuf,

                                    unsigned int maxOutBufLen, unsigned int *outBufLen);

extern PRBool

sec_port_ucs4_utf8_conversion_function(

    PRBool toUnicode,

    unsigned char *inBuf,

    unsigned int inBufLen,

    unsigned char *outBuf,

    unsigned int maxOutBufLen,

    unsigned int *outBufLen);

extern PRBool

sec_port_ucs2_utf8_conversion_function(

    PRBool toUnicode,

    unsigned char *inBuf,

    unsigned int inBufLen,

    unsigned char *outBuf,

    unsigned int maxOutBufLen,

    unsigned int *outBufLen);

/* One-way conversion from ISO-8859-1 to UTF-8 */

extern PRBool

sec_port_iso88591_utf8_conversion_function(

    const unsigned char *inBuf,

    unsigned int inBufLen,

    unsigned char *outBuf,

    unsigned int maxOutBufLen,

    unsigned int *outBufLen);

extern int NSS_PutEnv(const char *envVarName, const char *envValue);

extern int NSS_SecureMemcmp(const void *a, const void *b, size_t n);

extern unsigned int NSS_SecureMemcmpZero(const void *mem, size_t n);

extern void NSS_SecureSelect(void *dest, const void *src0, const void *src1, size_t n, unsigned char b);

extern PRBool NSS_GetSystemFIPSEnabled(void);

/*

 * Load a shared library called "newShLibName" in the same directory as

 * a shared library that is already loaded, called existingShLibName.

 * A pointer to a static function in that shared library,

 * staticShLibFunc, is required.

 * existingShLibName:

 *   The file name of the shared library that shall be used as the

 *   "reference library". The loader will attempt to load the requested

 *   library from the same directory as the reference library.

 * staticShLibFunc:

 *   Pointer to a static function in the "reference library".

 * newShLibName:

 *   The simple file name of the new shared library to be loaded.

 * We use PR_GetLibraryFilePathname to get the pathname of the loaded

 * shared lib that contains this function, and then do a

 * PR_LoadLibraryWithFlags with an absolute pathname for the shared

 * library to be loaded.

 * On Windows, the "alternate search path" strategy is employed, if available.

 * On Unix, if existingShLibName is a symbolic link, and no link exists for the

 * new library, the original link will be resolved, and the new library loaded

 * from the resolved location.

 * If the new shared library is not found in the same location as the reference

 * library, it will then be loaded from the normal system library path.

*/

PRLibrary *

PORT_LoadLibraryFromOrigin(const char *existingShLibName,

                           PRFuncPtr staticShLibFunc,

                           const char *newShLibName);

SEC_END_PROTOS

/*

 * Constant time macros

*/

/* These macros use the fact that arithmetic shift shifts-in the sign bit.

 * However, this is not ensured by the C standard so you may need to replace

 * them with something else for odd compilers. These macros work for object

 * sizes up to 32 bits. The inequalities will produce incorrect results if

 * abs(a-b) >= PR_UINT32_MAX/2. This can be a voided if unsigned values stay

 * within the range 0-PRUINT32_MAX/2 and signed values stay within the range

 * -PRINT32_MAX/2-PRINT32_MAX/2. If these are insufficient, we can fix

 * this by either expanding the PORT_CT_DUPLICATE_MSB_TO_ALL to PRUint64

 * or by creating the following new macros for inequality:

 * PORT_CT_OVERFLOW prevents the overflow condition by handling the case

 * where the high bits in a and b are different specially. Basically if

 * the high bit in a and b differs we can just

 * copy the high bit of one of the parameters to determine the result as

 * follows:

 *    GxU if a has the high bit on, a>b, so d=a

 *    LxU if b has the high bit on, a<b, so d=b

 *    GxS if b has the high bit on, it's negative a>b so d=b

 *    LxS if a has the high bit on, it's negative a<b so d=a

 * where PORT_CT_xxU() macros do unsigned compares and PORT_CT_xxS() do signed

 * compares.

 * #define PORT_CT_OVERFLOW(a,b,c,d) \

 *       PORT_CT_SEL(PORT_CT_DUPLICATE_MSB_TO_ALL((a)^(b)), \

 *                  (PORT_CT_DUPLICATE_MSB_TO_ALL(d)),c)

 * #define PORT_CT_GTU(a,b) PORT_CT_OVERFLOW(a,b,PORT_CT_GT(a,b),a)

 * #define PORT_CT_LTU(a,b) PORT_CT_OVERFLOW(a,b,PORT_CT_LT(a,b),b)

 * #define PORT_CT_GEU(a,b) PORT_CT_OVERFLOW(a,b,PORT_CT_GE(a,b),a)

 * #define PORT_CT_LEU(a,b) PORT_CT_OVERFLOW(a,b,PORT_CT_LE(a,b),b)

 * #define PORT_CT_GTS(a,b) PORT_CT_OVERFLOW(a,b,PORT_CT_GT(a,b),b)

 * #define PORT_CT_LTS(a,b) PORT_CT_OVERFLOW(a,b,PORT_CT_LT(a,b),a)

 * #define PORT_CT_GES(a,b) PORT_CT_OVERFLOW(a,b,PORT_CT_GE(a,b),b)

 * #define PORT_CT_LES(a,b) PORT_CT_OVERFLOW(a,b,PORT_CT_LE(a,b),a)

 * */

/* Constant-time helper macro that copies the MSB of x to all other bits. */

#define PORT_CT_DUPLICATE_MSB_TO_ALL(x) ((PRUint32)((PRInt32)(x) >> (sizeof(PRInt32) * 8 - 1)))

/* Constant-time helper macro that selects l or r depending on all-1 or all-0

 * mask m */

#define PORT_CT_SEL(m, l, r) (((m) & (l)) | (~(m) & (r)))

/* Constant-time helper macro that returns all-1s if x is not 0; and all-0s

 * otherwise. */

#define PORT_CT_NOT_ZERO(x) (PORT_CT_DUPLICATE_MSB_TO_ALL(((x) | (0 - (x)))))

/* Constant-time helper macro that returns all-1s if x is 0; and all-0s

 * otherwise. */

#define PORT_CT_ZERO(x) (~PORT_CT_DUPLICATE_MSB_TO_ALL(((x) | (0 - (x)))))

/* Constant-time helper macro for equalities and inequalities.

 * returns all-1's for true and all-0's for false */

#define PORT_CT_EQ(a, b) PORT_CT_ZERO(((a) - (b)))

#define PORT_CT_NE(a, b) PORT_CT_NOT_ZERO(((a) - (b)))

#define PORT_CT_GT(a, b) PORT_CT_DUPLICATE_MSB_TO_ALL((b) - (a))

#define PORT_CT_LT(a, b) PORT_CT_DUPLICATE_MSB_TO_ALL((a) - (b))

#define PORT_CT_GE(a, b) (~PORT_CT_LT(a, b))

#define PORT_CT_LE(a, b) (~PORT_CT_GT(a, b))

#define PORT_CT_TRUE (~0)

#define PORT_CT_FALSE 0

#ifdef CT_VERIF

#include <valgrind/memcheck.h>

#define NSS_CLASSIFY(buf, length) VALGRIND_MAKE_MEM_UNDEFINED(buf, length);

#define NSS_DECLASSIFY(buf, length) VALGRIND_MAKE_MEM_DEFINED(buf, length);

#else

#define NSS_CLASSIFY(buf, length)

#define NSS_DECLASSIFY(buf, length)

#endif

#endif /* _SECPORT_H_ */

Source code

Revision control

Copy as Markdown

Other Tools