shishi_asn1_read_optional(3)

shishi_asn1_read_optional3

Api function

Usage

#include <shishi.h>

int shishi_asn1_read_optional(Shishi * handle, Shishi_asn1 node, const char * field, char ** data, size_t * datalen);

Arguments

Shishi * handle

shishi handle as allocated by shishi_init().

Shishi_asn1 node

ASN.1 variable to read field from.

const char * field

name of field in node to read.

char ** data

newly allocated output buffer that will hold ASN.1 field data.

size_t * datalen

actual size of output buffer.

Overview

Extract data stored in a ASN.1 field into a newly allocated buffer. If the field does not exist (i.e., SHISHI_ASN1_NO_ELEMENT), this function set datalen to 0 and succeeds. Can be useful to read ASN.1 fields which are marked OPTIONAL in the grammar, if you want to avoid special error handling in your code.

Return value

Returns SHISHI_OK if successful, SHISHI_ASN1_NO_VALUE if the field has no value, ot SHISHI_ASN1_ERROR otherwise.

Releases

10 releases since Debian 4.0 (Etch); the text changed 5 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7
  5. 8–11
  6. 12–13

Reporting bugs

Report bugs to <[email protected]>. GNU Shishi home page: http://www.gnu.org/software/shishi/ General help using GNU software: http://www.gnu.org/gethelp/

From shishi-doc 1.0.3-5 in Debian 13 (Trixie). Parsed by carta from the page's man source.