Detailed Description
The streaming BER functions handle the BER encode of primitive ASN.1 data types. Calls to these functions are assembled in the C source code generated by the ASN1C compiler (with -stream option) to accomplish the encoding of complex ASN.1 structures. These functions are also directly callable from within a user's application program if the need to accomplish a low level encoding function exists. In contrast to the non-streaming C BER functions, these operate with streams, rather than the memory buffer, the sources or destination. Thus, the data may be encoded directly to the file stream or socket output stream and may be decoded directly from the file or socket input stream.
Define Documentation
| #define BS_CHKEND |
( |
pctxt, |
|
|
ccb_p |
|
) |
|
Value:((ccb_p)->stat = 0, \
(((ccb_p)->len == ASN_K_INDEFLEN) ? berDecStrmTestEOC (pctxt,ccb_p) : \
(((int)(OSRTSTREAM_BYTEINDEX(pctxt) - (ccb_p)->bytes) >= (ccb_p)->len))))
| #define BS_CHKEOB |
( |
pctxt |
|
) |
|
Value:(((pctxt)->buffer.byteIndex + 2 > (pctxt)->buffer.size) ? TRUE : \
(((pctxt)->buffer.data[(pctxt)->buffer.byteIndex] == 0 && \
(pctxt)->buffer.data[(pctxt)->buffer.byteIndex + 1] == 0 ) ? \
TRUE : FALSE))
| #define cerAddBufLocDescr |
Value:(pctxt, pElemList, pDescr) \
rtxAddBufLocDescr(pctxt, pElemList, pDescr)
| #define cerEncCanonicalSort |
Value:(pctxt, pMemCtxt, pList) \
rtxEncCanonicalSort(pctxt, pMemCtxt, pList)
| #define cerGetBufLocDescr |
Value:(pctxt, pDescr) \
rtxGetBufLocDescr(pctxt, pDescr)
Function Documentation
| int berStrmFreeContext |
( |
OSCTXT * |
pctxt |
) |
|
This function closes the stream and frees all dynamic memory associated with a context.
- Parameters:
-
| pctxt | A pointer to a context structure. |
- Returns:
- Completion status of operation:
- 0 (0) = success,
- negative return value is error.
| int berStrmInitContext |
( |
OSCTXT * |
pctxt |
) |
|
This function initializes an OSCTXT block for further streaming operations. It makes sure that if the block was not previoiusly initialized, that all key working parameters are set to their correct initial state values (i.e. declared within a function as a normal working variable). It also initialize stream block.
- Parameters:
-
| pctxt | Pointer to context structure variable to be initialized. |
- Returns:
- Completion status of operation:
- 0 (0) = success,
- negative return value is error.
