summaryrefslogtreecommitdiff
path: root/doc/man/asn1_der_decoding2.3
blob: d88bc21175e7e4c3ec936491a28d8fbdf93c219a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "asn1_der_decoding2" 3 "4.8" "libtasn1" "libtasn1"
.SH NAME
asn1_der_decoding2 \- API function
.SH SYNOPSIS
.B #include <libtasn1.h>
.sp
.BI "int asn1_der_decoding2(asn1_node * " element ", const void * " ider ", int * " max_ider_len ", unsigned int " flags ", char * " errorDescription ");"
.SH ARGUMENTS
.IP "asn1_node * element" 12
pointer to an ASN1 structure.
.IP "const void * ider" 12
vector that contains the DER encoding.
.IP "int * max_ider_len" 12
pointer to an integer giving the information about the
maximal number of bytes occupied by * \fIider\fP . The real size of the DER
encoding is returned through this pointer.
.IP "unsigned int flags" 12
flags controlling the behaviour of the function.
.IP "char * errorDescription" 12
null\-terminated string contains details when an
error occurred.
.SH "DESCRIPTION"
Fill the structure * \fIelement\fP with values of a DER encoding string. The
structure must just be created with function \fBasn1_create_element()\fP.

If \fBASN1_DECODE_FLAG_ALLOW_PADDING\fP flag is set then the function will ignore
padding after the decoded DER data. Upon a successful return the value of
* \fImax_ider_len\fP will be set to the number of bytes decoded.

If \fBASN1_DECODE_FLAG_STRICT_DER\fP flag is set then the function will
not decode any BER\-encoded elements.
.SH "RETURNS"
\fBASN1_SUCCESS\fP if DER encoding OK, \fBASN1_ELEMENT_NOT_FOUND\fP
if  \fIELEMENT\fP is \fBNULL\fP, and \fBASN1_TAG_ERROR\fP or
\fBASN1_DER_ERROR\fP if the der encoding doesn't match the structure
name (* \fIELEMENT\fP deleted).
.SH COPYRIGHT
Copyright \(co 2006-2015 Free Software Foundation, Inc..
.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 libtasn1
is maintained as a Texinfo manual.  If the
.B info
and
.B libtasn1
programs are properly installed at your site, the command
.IP
.B info libtasn1
.PP
should give you access to the complete manual.
As an alternative you may obtain the manual from:
.IP
.B http://www.gnu.org/software/libtasn1/manual/
.PP