296 lines
9.3 KiB
C
296 lines
9.3 KiB
C
/**
|
|
* @file coreApi.h
|
|
* @version $Format:%h%d$
|
|
*
|
|
* Prototypes for the Matrix core public APIs.
|
|
*/
|
|
/*
|
|
* Copyright (c) 2013-2016 INSIDE Secure Corporation
|
|
* Copyright (c) PeerSec Networks, 2002-2011
|
|
* All Rights Reserved
|
|
*
|
|
* The latest version of this code is available at http://www.matrixssl.org
|
|
*
|
|
* This software is open source; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This General Public License does NOT permit incorporating this software
|
|
* into proprietary programs. If you are unable to comply with the GPL, a
|
|
* commercial license for this software may be purchased from INSIDE at
|
|
* http://www.insidesecure.com/
|
|
*
|
|
* This program is distributed in WITHOUT ANY WARRANTY; without even the
|
|
* implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
* See the GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
* http://www.gnu.org/copyleft/gpl.html
|
|
*/
|
|
/******************************************************************************/
|
|
|
|
#ifndef _h_PS_COREAPI
|
|
#define _h_PS_COREAPI
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include "coreConfig.h" /* Must be first included */
|
|
#include "osdep.h"
|
|
#include "list.h"
|
|
#include "psmalloc.h"
|
|
|
|
/******************************************************************************/
|
|
/*
|
|
psCore helper macros: for communicating with compiler
|
|
These macros allow to remove spurious warnings.
|
|
*/
|
|
|
|
/* Tell compiler a variable is intended that it can be set, but not used.
|
|
(The variable is for debugging, future extension or used in some
|
|
conditionally disabled/unifdeffed branches of execution). */
|
|
#define PS_VARIABLE_SET_BUT_UNUSED(x) do { (void)(x); } while(0)
|
|
|
|
/* Tell compiler a variable is intended that it can be unused.
|
|
This is for compilers which detect variables that are not set.
|
|
(The variable is for debugging, future extension or used in some
|
|
conditionally disabled/unifdeffed branches of execution). */
|
|
#define PS_VARIABLE_UNUSED(x) do { (void)(x); } while(0)
|
|
|
|
/* Tell compiler a function parameter is intended that it can be unused.
|
|
This is for compilers which detect parameters that are not used.
|
|
(The parameter is for debugging, future extension or used in some
|
|
conditionally disabled/unifdeffed branches of execution). */
|
|
#define PS_PARAMETER_UNUSED(x) do { (void)(x); } while(0)
|
|
|
|
/******************************************************************************/
|
|
/*
|
|
psCore return codes
|
|
*/
|
|
#define PS_CORE_IS_OPEN 1
|
|
|
|
/******************************************************************************/
|
|
/*
|
|
Universal return codes
|
|
*/
|
|
#define PS_SUCCESS 0
|
|
#define PS_FAILURE -1
|
|
#define PS_FAIL PS_FAILURE /* Just another name */
|
|
|
|
/* NOTE: Failure return codes MUST be < 0 */
|
|
/* NOTE: The range for core error codes should be between -2 and -29 */
|
|
#define PS_ARG_FAIL -6 /* Failure due to bad function param */
|
|
#define PS_PLATFORM_FAIL -7 /* Failure as a result of system call error */
|
|
#define PS_MEM_FAIL -8 /* Failure to allocate requested memory */
|
|
#define PS_LIMIT_FAIL -9 /* Failure on sanity/limit tests */
|
|
#define PS_UNSUPPORTED_FAIL -10 /* Unimplemented feature error */
|
|
#define PS_DISABLED_FEATURE_FAIL -11 /* Incorrect #define toggle for feature */
|
|
#define PS_PROTOCOL_FAIL -12 /* A protocol error occurred */
|
|
#define PS_TIMEOUT_FAIL -13 /* A timeout occurred and MAY be an error */
|
|
#define PS_INTERRUPT_FAIL -14 /* An interrupt occurred and MAY be an error */
|
|
#define PS_PENDING -15 /* In process. Not necessarily an error */
|
|
#define PS_EAGAIN -16 /* Try again later. Not necessarily an error */
|
|
#define PS_OUTPUT_LENGTH -17 /* Output length negotiation:
|
|
output buffer is too small. */
|
|
#define PS_HOSTNAME_RESOLUTION -18 /* Cannot resolve host name. */
|
|
#define PS_CONNECT -19 /* Cannot connect to remote host. */
|
|
#define PS_TRUE 1
|
|
#define PS_FALSE 0
|
|
|
|
/******************************************************************************/
|
|
/* Public structures */
|
|
/******************************************************************************/
|
|
/*
|
|
psBuf_t
|
|
Empty buffer:
|
|
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
|
|
|.|.|.|.|.|.|.|.|.|.|.|.|.|.|.|.|
|
|
^
|
|
\end
|
|
\start
|
|
\buf
|
|
size = 16
|
|
len = (end - start) = 0
|
|
|
|
Buffer with data:
|
|
|
|
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
|
|
|.|.|a|b|c|d|e|f|g|h|i|j|.|.|.|.|
|
|
^ ^ ^
|
|
| | \end
|
|
| \start
|
|
\buf
|
|
size = 16
|
|
len = (end - start) = 10
|
|
|
|
Read from start pointer
|
|
Write to end pointer
|
|
Free from buf pointer
|
|
*/
|
|
typedef struct {
|
|
unsigned char *buf; /* Pointer to the start of the buffer */
|
|
unsigned char *start; /* Pointer to start of valid data */
|
|
unsigned char *end; /* Pointer to first byte of invalid data */
|
|
int32 size; /* Size of buffer in bytes */
|
|
} psBuf_t;
|
|
|
|
/* Dynamically allocated automatically resizing psBuf_t. */
|
|
struct psDynBuf;
|
|
typedef struct psDynBuf psDynBuf_t;
|
|
struct psDynBuf {
|
|
psBuf_t buf;
|
|
psPool_t *pool;
|
|
int err;
|
|
psDynBuf_t *master;
|
|
};
|
|
#define PS_DYNBUF_GROW 256 /* Usual grow amount. */
|
|
|
|
/* Buffer for parsing input. */
|
|
struct psParseBuf;
|
|
typedef struct psParseBuf psParseBuf_t;
|
|
/* The contents of parsebuf are exactly the same than psDynBuf_t.
|
|
this allows them to share some of implementation. */
|
|
struct psParseBuf {
|
|
psBuf_t buf;
|
|
psPool_t *pool;
|
|
int err;
|
|
psParseBuf_t *master;
|
|
};
|
|
|
|
/* psDynBuf or psParseBuf allocated from this pool
|
|
is never freed automatically. */
|
|
extern psPool_t * const psStaticAllocationsPool;
|
|
|
|
/* Function definitions for Static and Dynamic Buffer API. */
|
|
#include "psbuf.h"
|
|
|
|
/******************************************************************************/
|
|
|
|
#ifdef MATRIX_USE_FILE_SYSTEM
|
|
#define FILESYSTEM_CONFIG_STR "Y"
|
|
#else
|
|
#define FILESYSTEM_CONFIG_STR "N"
|
|
#endif
|
|
#define PSMALLOC_CONFIG_STR "N"
|
|
#ifdef USE_MULTITHREADING
|
|
#define MULTITHREAD_CONFIG_STR "Y"
|
|
#else
|
|
#define MULTITHREAD_CONFIG_STR "N"
|
|
#endif
|
|
|
|
#define PSCORE_CONFIG \
|
|
"Y" \
|
|
FILESYSTEM_CONFIG_STR \
|
|
PSMALLOC_CONFIG_STR \
|
|
MULTITHREAD_CONFIG_STR
|
|
|
|
/******************************************************************************/
|
|
/* Public APIs */
|
|
#include <time.h>
|
|
/******************************************************************************/
|
|
|
|
PSPUBLIC int32 psCoreOpen(const char *config);
|
|
PSPUBLIC void psCoreClose(void);
|
|
PSPUBLIC void psBurnStack(uint32 len);
|
|
PSPUBLIC int32 memcmpct(const void *s1, const void *s2, size_t len);
|
|
|
|
/******************************************************************************/
|
|
/*
|
|
Public interface to OS-dependant core functionality
|
|
|
|
OS/osdep.c must implement the below functions
|
|
*/
|
|
PSPUBLIC int32 psGetEntropy(unsigned char *bytes, uint32 size,
|
|
void *userPtr);
|
|
|
|
PSPUBLIC int32 psGetTime(psTime_t *t, void *userPtr);
|
|
PSPUBLIC int32 psDiffMsecs(psTime_t then, psTime_t now, void *userPtr);
|
|
|
|
/* psCompareTime is no longer used */
|
|
PSPUBLIC int32 psCompareTime(psTime_t a, psTime_t b, void *userPtr);
|
|
|
|
#ifdef MATRIX_USE_FILE_SYSTEM
|
|
PSPUBLIC int32 psGetFileBuf(psPool_t *pool, const char *fileName,
|
|
unsigned char **buf, int32 *bufLen);
|
|
#endif /* MATRIX_USE_FILE_SYSTEM */
|
|
|
|
#ifdef USE_MULTITHREADING
|
|
#define PS_SHARED 0x1
|
|
PSPUBLIC int32_t psCreateMutex(psMutex_t *mutex, uint32_t flags);
|
|
PSPUBLIC void psLockMutex(psMutex_t *mutex);
|
|
PSPUBLIC void psUnlockMutex(psMutex_t *mutex);
|
|
PSPUBLIC void psDestroyMutex(psMutex_t *mutex);
|
|
#else
|
|
/** @note These are defines rather than inline functions because it allows
|
|
the caller to not allocate a mutex that will never be used. */
|
|
#define psCreateMutex(A, B) (PS_SUCCESS)
|
|
#define psLockMutex(A) do { } while(0)
|
|
#define psUnlockMutex(A) do { } while(0)
|
|
#define psDestroyMutex(A)
|
|
#endif /* USE_MULTITHREADING */
|
|
|
|
/******************************************************************************/
|
|
/*
|
|
Internal list helpers
|
|
*/
|
|
extern int32 psParseList(psPool_t *pool, char *list, const char separator,
|
|
psList_t **items);
|
|
extern void psFreeList(psList_t *list, psPool_t *pool);
|
|
|
|
/******************************************************************************/
|
|
/*
|
|
Statistics helpers
|
|
*/
|
|
|
|
/** Number of samples to store take for running average. */
|
|
#define STAT_AVG_SAMPLES 32
|
|
|
|
typedef struct {
|
|
uint32_t h; /**< High water */
|
|
uint32_t a[STAT_AVG_SAMPLES]; /**< Values */
|
|
uint32_t atot; /**< Running total of a[] values */
|
|
uint16_t ai; /**< Most recent index into a[] */
|
|
uint16_t an; /**< Current number of valid entries in a[] */
|
|
} psAvgStat_t;
|
|
|
|
__inline static void STAT_INC_AVG(psAvgStat_t *s, uint32_t val)
|
|
{
|
|
/* Update high water */
|
|
if (val > s->h) {
|
|
s->h = val;
|
|
}
|
|
if (s->an < STAT_AVG_SAMPLES) {
|
|
/* Update total number of stats, if not at max */
|
|
s->an++;
|
|
} else {
|
|
/* Subtract the oldest value from the running total, if we're replacing */
|
|
s->atot -= s->a[s->ai];
|
|
}
|
|
/* Point to next entry, replace it and increment running total */
|
|
s->ai = (s->ai + 1) % STAT_AVG_SAMPLES;
|
|
s->a[s->ai] = val;
|
|
s->atot += val;
|
|
}
|
|
|
|
__inline static uint32_t STAT_AVG(psAvgStat_t *s)
|
|
{
|
|
return (s->atot / s->an);
|
|
}
|
|
|
|
__inline static uint32_t STAT_HIGH(psAvgStat_t *s)
|
|
{
|
|
return s->h;
|
|
}
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* _h_PS_COREAPI */
|
|
/******************************************************************************/
|
|
|