Header for the native RDM Runtime types. More...

#include "psptypes.h"
#include "rdmretcodetypes.h"

Include dependency graph for rdmtypes.h:

This graph shows which files directly or indirectly include this file:

Data Structures
struct	RDM_SEARCH_KEY
	The RDM Partial Key data structure. More...

union	RDM_RTREE_FILTER

struct	RDM_RTREE_KEY
	The RDM R-tree Key data structure. More...

struct	RDM_RANGE_KEY
	The RDM Range Key data structure. More...

struct	RDM_ROW_STATUS_INFO
	RDM Rows status info. More...

struct	RDM_COLUMN_INFO

Macros
#define	RDM_IDENTIFIER_LEN 127

#define	RDM_CATALOG_EMPTY_SCHEMA
	A catalog with an empty schema. More...

#define	RDM_LOCK_NONE (const RDM_TABLE_ID *) (-1)

#define	RDM_LOCK_ALL (const RDM_TABLE_ID *) (-2)

#define	RDM_LOCK_SCHEMA (const RDM_TABLE_ID *) (-3)

#define	RDM_LOCK_DB_OPEN (RDM_TABLE_ID) (-4)

#define	TABLE_SCHEMA (RDM_TABLE_ID) (0x10002)

#define	REF_CURSOR ((RDM_REF_ID) 0)

#define	RDM_COL_HAS_VALUE ((RDM_HAS_VALUE_T) 1)

#define	RDM_COL_IS_NULL ((RDM_HAS_VALUE_T) 0)

#define	RDM_ALL_DATA ((size_t) -1)

#define	RDM_COLUMN_SIZE(table, column) sizeof (((table *) 0)->column)
	Macro for getting the size of a column in the struct definition. More...

Typedefs
typedef uint32_t	RDM_TABLE_ID

typedef uint32_t	RDM_COLUMN_ID

typedef uint32_t	RDM_KEY_ID

typedef uint32_t	RDM_REF_ID

typedef uint64_t	RDM_TX

typedef RDM_RETCODE()	RDM_REBUILD_INDEX_REPORT_FCN(const char table, const char indexes, uint64_t current, uint64_t total)
	Callback function signature to report status on an ID-index rebuild. More...

typedef uint8_t	RDM_HAS_VALUE_T

typedef struct RDM_DB_S *	RDM_DB

typedef struct RDM_CURSOR_S *	RDM_CURSOR

typedef struct RDM_TRANS_S *	RDM_TRANS

typedef struct RDM_ENCRYPT_S *	RDM_ENCRYPT

typedef const struct RDM_ENCRYPT_S *	RDM_ENCRYPT_C

typedef void(*	RDM_ERROR_FCN) (RDM_DB, RDM_RETCODE, const char , void )

typedef void(*	RDM_ERROR_A_FCN) (RDM_DB, RDM_RETCODE, const char , void )

typedef void(*	RDM_ERROR_W_FCN) (RDM_DB, RDM_RETCODE, const wchar_t , void )

Enumerations
enum	RDM_RTREE_TYPE { RDM_RTREE_ALL, RDM_RTREE_EXACT, RDM_RTREE_OVERLAP, RDM_RTREE_CONTAINS, RDM_RTREE_NEAREST, RDM_RTREE_RADIUS_OVERLAP, RDM_RTREE_RADIUS_CONTAINS, RDM_RTREE_POLYGON_OVERLAP, RDM_RTREE_POLYGON_CONTAINS }
	Query types for an R-tree index. More...

enum	RDM_RANGE { RDM_RANGE_OPEN = 0, RDM_RANGE_CLOSED }
	The range include or exclude enumeration. More...

enum	RDM_TRANS_STATUS { RDM_TRANS_READ = 1, RDM_TRANS_UPDATE, RDM_TRANS_SNAPSHOT, RDM_TRANS_NONE }
	The RDM transaction status identifiers. More...

enum	RDM_TRANS_PRECOMMIT_STATUS { RDM_TRANS_NOT_PRECOMMITTED = 0, RDM_TRANS_PRECOMMITTED, RDM_TRANS_PRECOMMITTED_NO_UPDATES }
	The RDM transaction status identifiers. More...

enum	RDM_USER_STATUS { RDM_U_EMPTY = 0, RDM_U_LIVE }
	The RDM user status. More...

enum	RDM_LOCK_STATUS { RDM_LOCK_FREE = 0x0000, RDM_LOCK_READ = 0x0001, RDM_LOCK_WRITE = 0x0003, RDM_LOCK_SNAPSHOT = 0x0005, RDM_LOCK_CATALOG = 0x0310 }
	Enumeration for RDM table lock status. More...

enum	RDM_CURSOR_STATUS { CURSOR_NOT_AT_ROW = 0, CURSOR_AT_ROW, CURSOR_BETWEEN, CURSOR_BEFORE_FIRST, CURSOR_AFTER_LAST, CURSOR_DELETED, CURSOR_CHANGED, CURSOR_UNLINKED, CURSOR_ROW_GONE, CURSOR_SET_GONE, CURSOR_DROPPED }
	Enumeration for RDM cursor positions / statuses. More...

enum	RDM_CURSOR_COMPARE { CURSOR_BEFORE, CURSOR_EQUAL = RDM_EQ, CURSOR_AFTER }
	Enumeration for RDM cursor comparisons. More...

enum	RDM_OPEN_MODE { RDM_OPEN_SHARED = 0x0000, RDM_OPEN_EXCLUSIVE = 0x0001, RDM_OPEN_READONLY = 0x0002, RDM_OPEN_SHARED_LOCAL = 0x0080, RDM_OPEN_EXCLUSIVE_LOCAL = 0x0081, RDM_OPEN_REPLICATE_SOURCE = 0x1002, RDM_OPEN_REPLICATE_TARGET = 0x1020 }
	Enumeration for open modes. More...

enum	RDM_CURSOR_TYPE { CURSOR_TYPE_BEFORE_FIRST = 1, CURSOR_TYPE_AFTER_LAST, CURSOR_TYPE_REC_SCAN, CURSOR_TYPE_KEY_SCAN, CURSOR_TYPE_RTREE_SCAN, CURSOR_TYPE_SET_SCAN, CURSOR_TYPE_SINGLETON, CURSOR_TYPE_SYSCOLUMN, CURSOR_TYPE_ALLOCATED }
	Enumeration for cursor types. More...

enum	RDM_ENC_TYPE { RDM_ENC_NONE, RDM_ENC_XOR, RDM_ENC_AES128, RDM_ENC_AES192, RDM_ENC_AES256, RDM_ENC_DEFAULT }

enum	RDM_TRIGGERS_STATUS { RDM_TRIGGERS_ON = 1, RDM_TRIGGERS_OFF = -1, RDM_TRIGGERS_UNDEFINED = 0 }
	Triggers status values. More...

Detailed Description

Header for the native RDM Runtime types.

Macro Definition Documentation

RDM_ALL_DATA

#define RDM_ALL_DATA ((size_t) -1)

RDM_CATALOG_EMPTY_SCHEMA

#define RDM_CATALOG_EMPTY_SCHEMA

Value:

"{\n"                                                                      \
"  \"database\":{\n"                                                       \
"    \"catver\":151,\n"                                                    \
"    \"dbver\":1,\n"                                                       \
"    \"encryption\":\"none\",\n"                                           \
"    \"maxdrawers\":0,\n"                                                  \
"    \"nodrawers\":0,\n"                                                   \
"    \"nextdrawer\":0,\n"                                                  \
"    \"nodoms\":0,\n"                                                      \
"    \"maxdoms\":0,\n"                                                     \
"    \"maxtabs\":32768,\n"                                                 \
"    \"notabs\":1,\n"                                                      \
"    \"nexttab\":1,\n"                                                     \
"    \"drawers\":[\n"                                                      \
"    ],\n"                                                                 \
"    \"tables\":[\n"                                                       \
"    ]\n"                                                                  \
"  }\n"                                                                    \
"}\n"
                                                            

A catalog with an empty schema.

Use this string as a parameter to rdm_dbLoadCatalog() to set an empty schema

RDM_COL_HAS_VALUE

#define RDM_COL_HAS_VALUE ((RDM_HAS_VALUE_T) 1)

Column has a value

Examples: core15Example_main.c, core16Example_main.c, core17Example_main.c, core19Example_main.c, core31Example_main.c, core32Example_main.c, core33Example_main.c, learn/bookStore_client.c, learn/bookStore_embed.c, and learn/bookStore_vxWorks7.c.

RDM_COL_IS_NULL

#define RDM_COL_IS_NULL ((RDM_HAS_VALUE_T) 0)

Coulumn is null

Examples: core16Example_main.c, core30Example_main.c, and core31Example_main.c.

RDM_COLUMN_SIZE

#define RDM_COLUMN_SIZE	(	table,
		column
	)	sizeof (((table *) 0)->column)

Macro for getting the size of a column in the struct definition.

Examples: core03Example_main.c, core04Example_main.c, core06Example_main.c, and core10Example_main.c.

RDM_IDENTIFIER_LEN

#define RDM_IDENTIFIER_LEN 127

The maximum identifier length measured in characters not including a null terminator

RDM_LOCK_ALL

#define RDM_LOCK_ALL (const RDM_TABLE_ID *) (-2)

Lock all of the tables in the database

Examples: core02Example_main.c, core03Example_main.c, core04Example_main.c, core05Example_main.c, core06Example_main.c, core07Example_main.c, core08Example_main.c, core09Example_main.c, core10Example_main.c, core11Example_main.c, core12Example_main.c, core13Example_main.c, core20Example_main.c, core21Example_main.c, core22Example_main.c, core23Example_main.c, core24Example_main.c, core25Example_main.c, core28Example_main.c, core29Example_main.c, core30Example_main.c, core31Example_main.c, core34Example_main.c, core35Example_main.c, core38Example_main.c, cpp70Example_main.cpp, rtree/deleteZipcode.c, rtree/insertZipcode.c, rtree/retrieveAllZipcode.c, rtree/retrieveContainedZipcode.c, rtree/retrieveExactZipcode.c, rtree/retrieveOverlapZipcode.c, and rtree/updateZipcode.c.

RDM_LOCK_DB_OPEN

#define RDM_LOCK_DB_OPEN (RDM_TABLE_ID) (-4)

Lock for opening a database exclusively

RDM_LOCK_NONE

#define RDM_LOCK_NONE (const RDM_TABLE_ID *) (-1)

Don't lock any tables in the database

Examples: cpp55Example_main.cpp.

RDM_LOCK_SCHEMA

#define RDM_LOCK_SCHEMA (const RDM_TABLE_ID *) (-3)

Lock the schema

REF_CURSOR

#define REF_CURSOR ((RDM_REF_ID) 0)

The default foreign reference ID for the cursor

TABLE_SCHEMA

#define TABLE_SCHEMA (RDM_TABLE_ID) (0x10002)

The table ID for the schema

Typedef Documentation

RDM_COLUMN_ID

typedef uint32_t RDM_COLUMN_ID

The RDM column ID

RDM_CURSOR

typedef struct RDM_CURSOR_S* RDM_CURSOR

RDM cursor handle

RDM_DB

typedef struct RDM_DB_S* RDM_DB

RDM database handle

RDM_ENCRYPT

typedef struct RDM_ENCRYPT_S* RDM_ENCRYPT

RDM encryption handle

RDM_ENCRYPT_C

typedef const struct RDM_ENCRYPT_S* RDM_ENCRYPT_C

const RDM encryption handle

RDM_ERROR_A_FCN

typedef void( * RDM_ERROR_A_FCN) (RDM_DB, RDM_RETCODE, const char *, void *)

RDM_ERROR_FCN

typedef void( * RDM_ERROR_FCN) (RDM_DB, RDM_RETCODE, const char *, void *)

RDM_ERROR_W_FCN

typedef void( * RDM_ERROR_W_FCN) (RDM_DB, RDM_RETCODE, const wchar_t *, void *)

RDM_HAS_VALUE_T

typedef uint8_t RDM_HAS_VALUE_T

RDM Type for whether column has a value or is null

RDM_KEY_ID

typedef uint32_t RDM_KEY_ID

The RDM key ID

RDM_REBUILD_INDEX_REPORT_FCN

typedef RDM_RETCODE() RDM_REBUILD_INDEX_REPORT_FCN(const char *table, const char *indexes, uint64_t current, uint64_t total)

Callback function signature to report status on an ID-index rebuild.

RDM_REF_ID

typedef uint32_t RDM_REF_ID

The RDM foreign reference ID

RDM_TABLE_ID

typedef uint32_t RDM_TABLE_ID

The RDM table ID

RDM_TRANS

typedef struct RDM_TRANS_S* RDM_TRANS

RDM transaction handle handle

RDM_TX

typedef uint64_t RDM_TX

Enumeration Type Documentation

RDM_CURSOR_COMPARE

enum RDM_CURSOR_COMPARE

Enumeration for RDM cursor comparisons.

The enumeration allows for position comparisons between two cursors. A cursor can either be positioned before, after, or equal to the position of another cursor. How positioning is determined is based on the type of cursor being compared.

Enumerator
CURSOR_BEFORE	The cursor is positioned before the position of the other cursor
CURSOR_EQUAL	The cursor is positioned at the same position as the position of the other cursor
CURSOR_AFTER	The cursor is positioned after the position of the other cursor

 {
CURSOR_BEFORE =
RDM_LT, 
CURSOR_EQUAL = RDM_EQ, 
CURSOR_AFTER =
RDM_GT 
 } RDM_CURSOR_COMPARE;

RDM_CURSOR_STATUS

enum RDM_CURSOR_STATUS

Enumeration for RDM cursor positions / statuses.

The enumeration identifies the current position for an RDM cursor. A cursor can be positioned at a row, between rows, before all rows, or after all rows

Enumerator
CURSOR_NOT_AT_ROW	A cursor not positioned at a valid row.
CURSOR_AT_ROW	A cursor positioned at a valid row.
CURSOR_BETWEEN	A cursor positioned between rows.
CURSOR_BEFORE_FIRST	A cursor positioned before all rows.
CURSOR_AFTER_LAST	A cursor positioned after all rows.
CURSOR_DELETED	A cursor whose current row has been deleted.
CURSOR_CHANGED	A cursor whose key value has been changed.
CURSOR_UNLINKED	A cursor whose curent row has been unlinked.
CURSOR_ROW_GONE	A singleton cursor that has had it's row deleted.
CURSOR_SET_GONE	A set cursor that has had it's owner deleted.
CURSOR_DROPPED	A cursor that is based on an object that has been dropped.

 {
CURSOR_NOT_AT_ROW = 0, 
CURSOR_AT_ROW,         
CURSOR_BETWEEN,        
CURSOR_BEFORE_FIRST,   
CURSOR_AFTER_LAST,     
CURSOR_DELETED,        
CURSOR_CHANGED,        
CURSOR_UNLINKED,       
CURSOR_ROW_GONE, 
CURSOR_SET_GONE, 
CURSOR_DROPPED 
 } RDM_CURSOR_STATUS;

RDM_CURSOR_TYPE

enum RDM_CURSOR_TYPE

Enumeration for cursor types.

The enumeration specifies the type of a cursor

Enumerator
CURSOR_TYPE_BEFORE_FIRST	enum value for a BeforeFirst special cursor
CURSOR_TYPE_AFTER_LAST	enum value for a AfterLast special cursor
CURSOR_TYPE_REC_SCAN	enum value for a record scan cursor
CURSOR_TYPE_KEY_SCAN	enum value for a key scan cursor
CURSOR_TYPE_RTREE_SCAN	enum value for a R-tree scan cursor
CURSOR_TYPE_SET_SCAN	enum value for a set scan cursor
CURSOR_TYPE_SINGLETON	enum value for a singleton cursor
CURSOR_TYPE_SYSCOLUMN	enum value for a syscolumn meta cursor
CURSOR_TYPE_ALLOCATED	enum value for a cursor that has only been allocated

 {
CURSOR_TYPE_BEFORE_FIRST = 1, 
CURSOR_TYPE_AFTER_LAST, 
CURSOR_TYPE_REC_SCAN,   
CURSOR_TYPE_KEY_SCAN,   
CURSOR_TYPE_RTREE_SCAN, 
CURSOR_TYPE_SET_SCAN,   
CURSOR_TYPE_SINGLETON,  
CURSOR_TYPE_SYSCOLUMN,  
 #if !defined (RDM_DOXYGEN)
     CURSOR_TYPE_SYSTABLE,   
     CURSOR_TYPE_SYSREF,     
     CURSOR_TYPE_SYSKEY,     
     CURSOR_TYPE_SYSDOMAIN,  
     CURSOR_TYPE_SYSSORT,    
     CURSOR_TYPE_SYSELEM,    
     CURSOR_TYPE_SYSDB,      
     CURSOR_TYPE_SYSDRAWER,  
 #endif
CURSOR_TYPE_ALLOCATED 
 } RDM_CURSOR_TYPE;

RDM_ENC_TYPE

enum RDM_ENC_TYPE

Enumeration for RDM encryption algorithms

The enumeration identifies the supported encryption algorithms.

RDM_ENC_XOR is the only type of encryption that is included in packages without export restrictions.

Enumerator
RDM_ENC_NONE	No encryption
RDM_ENC_XOR	XOR encryption
RDM_ENC_AES128	AES-128 encryption
RDM_ENC_AES192	AES-192 encryption
RDM_ENC_AES256	AES-256 encryption
RDM_ENC_DEFAULT	Default encryption

 {
RDM_ENC_NONE,   
RDM_ENC_XOR,    
RDM_ENC_AES128, 
RDM_ENC_AES192, 
RDM_ENC_AES256, 
RDM_ENC_DEFAULT 
 } RDM_ENC_TYPE;

RDM_LOCK_STATUS

enum RDM_LOCK_STATUS

Enumeration for RDM table lock status.

This enumeration specifies the table lock status for RDM databases

Enumerator
RDM_LOCK_FREE	The table is not locked
RDM_LOCK_READ	The table is locked for reads
RDM_LOCK_WRITE	The table is locked for updates
RDM_LOCK_SNAPSHOT	The table has an active snapshot
RDM_LOCK_CATALOG	The database has the catalog write locked

 {
RDM_LOCK_FREE = 0x0000,     
RDM_LOCK_READ = 0x0001,     
RDM_LOCK_WRITE = 0x0003,    
RDM_LOCK_SNAPSHOT = 0x0005, 
RDM_LOCK_CATALOG = 0x0310 
 } RDM_LOCK_STATUS;

RDM_OPEN_MODE

enum RDM_OPEN_MODE

Enumeration for open modes.

The enumeration specifies the open modes. The creat flags always require a catalog set using rdm_dbSetCatalog(). The append modes require any catalog that have been set to match the catalog stored in the database. RDM_OPEN_EXCLUSIVE and RDM_OPEN_SHARED default to create if a catalog have been set and append if it have not been set.

Enumerator
RDM_OPEN_SHARED	Open database in shared mode, requiring locks
RDM_OPEN_EXCLUSIVE	Open database in exclusive mode
RDM_OPEN_READONLY	Open database in readonly mode, requiring locks
RDM_OPEN_SHARED_LOCAL	Open database in shared mode all changes kept in the runtime until close or persist
RDM_OPEN_EXCLUSIVE_LOCAL	Open database in exclusive mode all changes kept in the runtime until close or persist
RDM_OPEN_REPLICATE_SOURCE	Open database as a replication source
RDM_OPEN_REPLICATE_TARGET	Open database as a replication target

 {
/* GEN_OPEN_MODE_BEGIN */
                                                            
RDM_OPEN_SHARED = 0x0000, 
RDM_OPEN_EXCLUSIVE = 0x0001, 
RDM_OPEN_READONLY = 0x0002, 
RDM_OPEN_SHARED_LOCAL = 0x0080, 
RDM_OPEN_EXCLUSIVE_LOCAL = 0x0081, 
RDM_OPEN_REPLICATE_SOURCE = 0x1002, 
RDM_OPEN_REPLICATE_TARGET = 0x1020, 
 #if !defined (RDM_DOXYGEN)
     RDM_OPEN_SHARED_APPEND = 0x0010, 
     RDM_OPEN_EXCLUSIVE_APPEND = 0x0011, 
     RDM_OPEN_SHARED_CREAT = 0x0020, 
     RDM_OPEN_EXCLUSIVE_CREAT = 0x0021, 
     RDM_OPEN_SHARED_CREAT_TRUNC =0x0120, 
     RDM_OPEN_EXCLUSIVE_CREAT_TRUNC = 0x0121, 
     RDM_OPEN_SHARED_CREAT_EXCL = 0x0220, 
     RDM_OPEN_EXCLUSIVE_CREAT_EXCL = 0x0221 
 #endif
/* GEN_OPEN_MODE_END */
                                                            
 } RDM_OPEN_MODE;

RDM_RANGE

enum RDM_RANGE

The range include or exclude enumeration.

Enumerator
RDM_RANGE_OPEN	The range includes the specified value
RDM_RANGE_CLOSED	The range excludes the specified value

 {
RDM_RANGE_OPEN = 0, 
RDM_RANGE_CLOSED
                                                            
 } RDM_RANGE;

RDM_RTREE_TYPE

enum RDM_RTREE_TYPE

Query types for an R-tree index.

Enumerator
RDM_RTREE_ALL	Return all entries in the R-tree index
RDM_RTREE_EXACT	Return only an exact match for the query criteria
RDM_RTREE_OVERLAP	Return all rows that overlap the query criteria
RDM_RTREE_CONTAINS	Return all rows that are contained in the query criteria
RDM_RTREE_NEAREST	Return the nearest neighbors to the query criteria.
RDM_RTREE_RADIUS_OVERLAP	Return all rows that overlap the radius query criteria.
RDM_RTREE_RADIUS_CONTAINS	Return all rows that are contained in the radius query criteria.
RDM_RTREE_POLYGON_OVERLAP	Return all rows that overlap the polygon query criteria.
RDM_RTREE_POLYGON_CONTAINS	Return all rows that are contained in the polygon query criteria.

 {
RDM_RTREE_ALL,     
RDM_RTREE_EXACT,   
RDM_RTREE_OVERLAP, 
RDM_RTREE_CONTAINS, 
RDM_RTREE_NEAREST, 
RDM_RTREE_RADIUS_OVERLAP, 
RDM_RTREE_RADIUS_CONTAINS, 
RDM_RTREE_POLYGON_OVERLAP, 
RDM_RTREE_POLYGON_CONTAINS 
 } RDM_RTREE_TYPE;

RDM_TRANS_PRECOMMIT_STATUS

enum RDM_TRANS_PRECOMMIT_STATUS

The RDM transaction status identifiers.

Enumerator
RDM_TRANS_NOT_PRECOMMITTED	A transaction is not precommitted
RDM_TRANS_PRECOMMITTED	A transaction with changes has been precommitted
RDM_TRANS_PRECOMMITTED_NO_UPDATES	A transaction without changes has been precommited

 {
RDM_TRANS_NOT_PRECOMMITTED = 0, 
RDM_TRANS_PRECOMMITTED,   
RDM_TRANS_PRECOMMITTED_NO_UPDATES 
 } RDM_TRANS_PRECOMMIT_STATUS;

RDM_TRANS_STATUS

enum RDM_TRANS_STATUS