Classes
struct	_OSRTBufLocDescr

Macros
#define	OSRTPUTCHAR(pctxt, ch) rtxWriteBytes (pctxt, (OSOCTET*)&ch, 1)

#define	OSRTPUTCHARREV(pctxt, ch) (pctxt)->buffer.data[--(pctxt)->buffer.byteIndex]=(OSOCTET)ch;

#define	OSRTZTERM(pctxt) (pctxt)->buffer.data[(pctxt)->buffer.byteIndex]=(OSOCTET)0;

#define	OSRTSAFEZTERM(pctxt)

#define	OSRTSAFEPUTCHAR(pctxt, ch)

#define	OSRTSAFEPUTCHAR_ZTERM(pctxt, ch)

#define	OSRTSAFEPUTCHAR1(pctxt, ch, stat)

#define	OSRTMEMCPY(pctxt, bdata, len)

#define	OSRTMEMCPYREV(pctxt, bdata, len)

#define	OSRTSAFEMEMCPY(pctxt, bdata, len)

#define	OSRTSAFEMEMCPY1(pctxt, bdata, len, stat)

#define	OSRTGETBUFUTF8LEN(pctxt) rtxCalcUTF8Len (OSRTBUFPTR (pctxt), OSRTBUFSIZE (pctxt))

#define	OSRTCHKBUFUTF8LEN(pctxt, lower, upper, stat)

#define	OSRTENDOFBUF(pctxt) ((pctxt)->buffer.byteIndex >= (pctxt)->buffer.size)

Typedefs
typedef struct _OSRTBufLocDescr	OSRTBufLocDescr

Functions
int	rtxCheckBuffer (OSCTXT *pctxt, size_t nbytes)

int	rtxCheckOutputBuffer (OSCTXT *pctxt, size_t nbytes)

OSBOOL	rtxIsOutputBufferFlushable (OSCTXT *pctxt)

int	rtxFlushOutputBuffer (OSCTXT *pctxt)

int	rtxExpandOutputBuffer (OSCTXT *pctxt, size_t nbytes)

int	rtxCheckInputBuffer (OSCTXT *pctxt, size_t nbytes)

int	rtxCopyAsciiText (OSCTXT pctxt, const char text)

int	rtxCopyUTF8Text (OSCTXT pctxt, const OSUTF8CHAR text)

int	rtxCopyUnicodeText (OSCTXT pctxt, const OSUNICHAR text)

int	rtxReadBytesSafe (OSCTXT pctxt, OSOCTET buffer, size_t bufsize, size_t nocts)

int	rtxReadBytes (OSCTXT pctxt, OSOCTET pdata, size_t nocts)

int	rtxReadBytesDynamic (OSCTXT pctxt, OSOCTET ppdata, size_t nocts, OSBOOL pMemAlloc)

int	rtxWriteBytes (OSCTXT pctxt, const OSOCTET pdata, size_t nocts)

OSBOOL	rtxCanonicalSort (OSOCTET refPoint, OSRTSList pList, OSBOOL normal)

int	rtxEncCanonicalSort (OSCTXT pctxt, OSCTXT pMemCtxt, OSRTSList *pList)

void	rtxGetBufLocDescr (OSCTXT pctxt, OSRTBufLocDescr pDescr)

void	rtxAddBufLocDescr (OSCTXT pctxt, OSRTSList pElemList, OSRTBufLocDescr *pDescr)

Detailed Description

The context message buffer can be written to, or read from, using various functions.

Macro Definition Documentation

◆ OSRTCHKBUFUTF8LEN

#define OSRTCHKBUFUTF8LEN	(	pctxt,
		lower,
		upper,
		stat
	)

Value:

do { size_t nchars = OSRTGETBUFUTF8LEN (pctxt); \

stat = (nchars >= lower && nchars <= upper) ? 0 : RTERR_CONSVIO; } while(0)

RTERR_CONSVIO

#define RTERR_CONSVIO

Definition: rtxErrCodes.h:185

◆ OSRTMEMCPY

#define OSRTMEMCPY	(	pctxt,
		bdata,
		len
	)

Value:

do { \
OSCRTLSAFEMEMCPY (&(pctxt)->buffer.data[(pctxt)->buffer.byteIndex], \
      (pctxt)->buffer.size-(pctxt)->buffer.byteIndex, bdata, len); \
(pctxt)->buffer.byteIndex += len; \
(pctxt)->lastChar = (pctxt)->buffer.data[(pctxt)->buffer.byteIndex-1]; \
} while (0)

◆ OSRTMEMCPYREV

#define OSRTMEMCPYREV	(	pctxt,
		bdata,
		len
	)

Value:

do { \
(pctxt)->buffer.byteIndex -= len; \
OSCRTLSAFEMEMCPY (&(pctxt)->buffer.data[(pctxt)->buffer.byteIndex], \
      (pctxt)->buffer.size-(pctxt)->buffer.byteIndex, bdata, len); \
} while (0)

◆ OSRTSAFEMEMCPY

#define OSRTSAFEMEMCPY	(	pctxt,
		bdata,
		len
	)

Value:

do { \
if (rtxCheckOutputBuffer (pctxt, len) == 0) { \
OSCRTLMEMCPY (&(pctxt)->buffer.data[(pctxt)->buffer.byteIndex], bdata, len); \
(pctxt)->buffer.byteIndex += len; \
(pctxt)->lastChar = (pctxt)->buffer.data[(pctxt)->buffer.byteIndex-1]; } \
else return LOG_RTERRNEW (pctxt, RTERR_BUFOVFLW); \
} while (0)

◆ OSRTSAFEMEMCPY1

#define OSRTSAFEMEMCPY1	(	pctxt,
		bdata,
		len,
		stat
	)

Value:

do { \
if (rtxCheckOutputBuffer (pctxt, len) == 0) { \
OSCRTLMEMCPY (&(pctxt)->buffer.data[(pctxt)->buffer.byteIndex], bdata, len); \
(pctxt)->buffer.byteIndex += len; \
(pctxt)->lastChar = (pctxt)->buffer.data[(pctxt)->buffer.byteIndex-1]; \
stat = 0; } \
else stat = RTERR_BUFOVFLW; \
} while (0)

◆ OSRTSAFEPUTCHAR

#define OSRTSAFEPUTCHAR	(	pctxt,
		ch
	)

Value:

do { \
if (rtxCheckOutputBuffer (pctxt, 1) == 0) \
(pctxt)->lastChar= \
(pctxt)->buffer.data[(pctxt)->buffer.byteIndex++]=(OSOCTET)ch; \
else return LOG_RTERRNEW (pctxt, RTERR_BUFOVFLW); \
} while (0)

◆ OSRTSAFEPUTCHAR1

#define OSRTSAFEPUTCHAR1	(	pctxt,
		ch,
		stat
	)

Value:

do { \
OSOCTET b = (OSOCTET)ch; \
rtxWriteBytes (pctxt, &b, 1); \
} while (0)

◆ OSRTSAFEPUTCHAR_ZTERM

#define OSRTSAFEPUTCHAR_ZTERM	(	pctxt,
		ch
	)

Value:

do { \
if (rtxCheckOutputBuffer (pctxt, 2) == 0) { \
(pctxt)->lastChar= \
(pctxt)->buffer.data[(pctxt)->buffer.byteIndex++]=(OSOCTET)ch; \
(pctxt)->buffer.data[(pctxt)->buffer.byteIndex]=(OSOCTET)0; } \
else return LOG_RTERRNEW (pctxt, RTERR_BUFOVFLW); \
} while (0)

◆ OSRTSAFEZTERM

#define OSRTSAFEZTERM ( pctxt )

Value:

do { \
if (rtxCheckOutputBuffer (pctxt, 1) == 0) \
(pctxt)->buffer.data[(pctxt)->buffer.byteIndex]=(OSOCTET)0; \
else return LOG_RTERRNEW (pctxt, RTERR_BUFOVFLW); \
} while (0)

Typedef Documentation

◆ OSRTBufLocDescr

typedef struct _OSRTBufLocDescr OSRTBufLocDescr

Buffer location descriptor

Function Documentation

◆ rtxAddBufLocDescr()

void rtxAddBufLocDescr	(	OSCTXT *	pctxt,
		OSRTSList *	pElemList,
		OSRTBufLocDescr *	pDescr
	)

Create a new Asn1BufLocDescr for an element just encoded and append it to pElemList.

Parameters

pctxt	Pointer to context where data has been encoded.
pElemList	List of Asn1BufLocDescr to which a new entry will be added.
pDescr	Pointer to Asn1BufLocDescr whose offset indicates the start of the element just encoded. The new Asn1BufLocDescr that is added will have the same offset and will have numocts determined by this offset and pctxt's current buffer position.

◆ rtxCanonicalSort()

OSBOOL rtxCanonicalSort	(	OSOCTET *	refPoint,
		OSRTSList *	pList,
		OSBOOL	normal
	)

Sort a list of buffer locations, referring to component encodings, by comparing the referenced encodings as octet strings.

The sorting can be used with canonical-BER (CER), distinguished-BER (DER), and canonical-XER (XER).

Encoding into the buffer may be done as a normal encoding (start to end) or as a reverse encoding (end to start). This affects the parameters as described below.

Parameters

refPoint	Reference point in the buffer for the buffer locations. For normal encoding, refPoint is the start of the buffer; for reverse encoding, refPoint is the end of the buffer.
pList	List of OSRTBufLocDescr, each of which locates the start of an encoded component. The offsets for the locations are relative to refPoint. If normal is TRUE, this function orders the list from least to greatest. Otherwise, it is ordered from greatest to least.
normal	TRUE for normal encoding; FALSE for reverse encoding. This tells the function whether to add or substract offsets from refPoint to locate the component encodings and also how to order the list.

Returns: TRUE if any changes to pList were made; FALSE otherwise (meaning the list was already in the desired order).

◆ rtxCheckOutputBuffer()

int rtxCheckOutputBuffer	(	OSCTXT *	pctxt,
		size_t	nbytes
	)

This function checks to ensure that the output buffer has sufficient space to hold an additional nbytes full bytes (if there is a partially filled byte, it is treated as though full). Dynamic buffers are resized if the check fails, while static buffers induce a buffer overflow error. This function may return RTERR_NOMEM if reallocating the dynamic buffer fails.

Parameters

pctxt	Pointer to a context structure.
nbytes	The requested capacity for the buffer.

Returns: 0 on success, or less than zero on failure.

◆ rtxEncCanonicalSort()

int rtxEncCanonicalSort	(	OSCTXT *	pctxt,
		OSCTXT *	pMemCtxt,
		OSRTSList *	pList
	)

Encode the encodings held in pMemCtxt into pctxt, first sorting them as required for canonical BER (and other encoding rules) by X.690 11.6.

Parameters

pctxt	Pointer to context structure into which the sorted encodings should be encoded.
pMemCtxt	Pointer to context structure which holds the unsorted encodings.
pList	List of Asn1BufLocDescr, each of which locates an encoding in pMemCtxt's buffer, the whole being the encodings that are to be sorted.

◆ rtxExpandOutputBuffer()

int rtxExpandOutputBuffer	(	OSCTXT *	pctxt,
		size_t	nbytes
	)

This function attempts to ensure the output buffer has at least the given number of bytes available. A partially full byte in the buffer counts as being available. Dynamic buffers are resized, if necessary, while static buffers induce a buffer overflow error. This function may return RTERR_NOMEM if reallocating a dynamic buffer fails.

Parameters

pctxt	Pointer to a context structure.
nbytes	The requested capacity for the buffer.

Returns: 0 on success, or less than zero on failure.

◆ rtxFlushOutputBuffer()

int rtxFlushOutputBuffer ( OSCTXT * pctxt )

This function flushes the buffer to a stream. This function MUST only be called if rtxIsOutputBufferFlushable(pctxt) returns TRUE; the behavior is otherwise undefined. After a successful call, pctxt->buffer.byteIndex == 0. Note that pctxt->buffer.bitOffset is not changed - if there was a partial byte in the buffer before this call, there will be a partial by afterward.

Parameters

pctxt Pointer to a context structure.

Returns: 0 on success, or less than zero on failure.

◆ rtxGetBufLocDescr()

void rtxGetBufLocDescr	(	OSCTXT *	pctxt,
		OSRTBufLocDescr *	pDescr
	)

Set the buffer location description's offset (pDescr->offset) to the current position in pCtxt's buffer.

◆ rtxIsOutputBufferFlushable()

OSBOOL rtxIsOutputBufferFlushable ( OSCTXT * pctxt )

This function returns true if the context buffer can be flushed to a stream by calling rtxFlushOutputBuffer. This function is used to determine whether it is safe to call rtxFlushOutputBuffer.

Parameters

pctxt Pointer to a context structure.

Returns: TRUE if the buffer can be flushed; FALSE is not.

◆ rtxReadBytes()

int rtxReadBytes	(	OSCTXT *	pctxt,
		OSOCTET *	pdata,
		size_t	nocts
	)

This function reads bytes from the currently open stream or memory buffer.

Parameters

pctxt	Pointer to a context structure.
pdata	Pointer to byte array where bytes are to be copied.
nocts	Number of bytes (octets) to read.

Returns: Status of the operation: 0 if success, negative value if error.

◆ rtxReadBytesDynamic()

int rtxReadBytesDynamic	(	OSCTXT *	pctxt,
		OSOCTET **	ppdata,
		size_t	nocts,
		OSBOOL *	pMemAlloc
	)

This function reads bytes from the currently open stream or memory buffer. In this case the function MAY allocate memory to hold the read bytes. It will only do this if the requested number of bytes will not fit in the context buffer; othwerwise, a pointer to a location in the context buffer is returned. If memory was allocated, it should be freed using rtxMemFreePtr.

Parameters

pctxt	Pointer to a context structure.
ppdata	Pointer to byte buffer pointer.
nocts	Number of bytes (octets) to read.
pMemAlloc	Pointer to boolean value which is set to true if memory was allocated to hold requested bytes.

Returns: Status of the operation: 0 if success, negative value if error.

◆ rtxReadBytesSafe()

int rtxReadBytesSafe	(	OSCTXT *	pctxt,
		OSOCTET *	buffer,
		size_t	bufsize,
		size_t	nocts
	)

This function safely reads bytes from the currently open stream or memory buffer into the given static buffer. This function is preferred over rtxReadBytes because it will detect buffer overflow.

Parameters

pctxt	Pointer to a context structure.
buffer	Static buffer into which bytes are to be read.
bufsize	Size of the static buffer.
nocts	Number of bytes (octets) to read.

Returns: Status of the operation: 0 if success, negative value if error.

◆ rtxWriteBytes()

int rtxWriteBytes	(	OSCTXT *	pctxt,
		const OSOCTET *	pdata,
		size_t	nocts
	)

This function writes bytes to the currently open stream or memory buffer.

Parameters

pctxt	Pointer to a context structure.
pdata	Pointer to location where bytes are to be copied.
nocts	Number of bytes to read.

Returns: I/O byte count.

Classes

Macros

Typedefs

Functions

Detailed Description

Macro Definition Documentation

◆ OSRTCHKBUFUTF8LEN

◆ OSRTMEMCPY

◆ OSRTMEMCPYREV

◆ OSRTSAFEMEMCPY

◆ OSRTSAFEMEMCPY1

◆ OSRTSAFEPUTCHAR

◆ OSRTSAFEPUTCHAR1

◆ OSRTSAFEPUTCHAR_ZTERM

◆ OSRTSAFEZTERM

Typedef Documentation

◆ OSRTBufLocDescr

Function Documentation

◆ rtxAddBufLocDescr()

◆ rtxCanonicalSort()

◆ rtxCheckOutputBuffer()

◆ rtxEncCanonicalSort()

◆ rtxExpandOutputBuffer()

◆ rtxFlushOutputBuffer()

◆ rtxGetBufLocDescr()

◆ rtxIsOutputBufferFlushable()

◆ rtxReadBytes()

◆ rtxReadBytesDynamic()

◆ rtxReadBytesSafe()

◆ rtxWriteBytes()