.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "shishi_asn1_read" 3 "1.0.2" "shishi" "shishi"
.SH NAME
shishi_asn1_read \- API function
.SH SYNOPSIS
.B #include <shishi.h>
.sp
.BI "int shishi_asn1_read(Shishi * " handle ", Shishi_asn1 " node ", const char * " field ", char ** " data ", size_t * " datalen ");"
.SH ARGUMENTS
.IP "Shishi * handle" 12
shishi handle as allocated by \fBshishi_init()\fP.
.IP "Shishi_asn1 node" 12
ASN.1 variable to read field from.
.IP "const char * field" 12
name of field in \fInode\fP to read.
.IP "char ** data" 12
newly allocated output buffer that will hold ASN.1 field data.
.IP "size_t * datalen" 12
actual size of output buffer.
.SH "DESCRIPTION"
Extract data stored in a ASN.1 field into a newly allocated buffer.
The buffer will always be zero terminated, even though \fIdatalen\fP
will not include the added zero.
.SH "RETURN VALUE"
Returns SHISHI_OK if successful,
SHISHI_ASN1_NO_ELEMENT if the element do not exist,
SHISHI_ASN1_NO_VALUE if the field has no value, ot
SHISHI_ASN1_ERROR otherwise.
.SH "REPORTING BUGS"
Report bugs to <bug-shishi@gnu.org>.
.SH COPYRIGHT
Copyright \(co 2002-2010 Simon Josefsson.
.br
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
.SH "SEE ALSO"
The full documentation for
.B shishi
is maintained as a Texinfo manual.  If the
.B info
and
.B shishi
programs are properly installed at your site, the command
.IP
.B info shishi
.PP
should give you access to the complete manual.