summaryrefslogtreecommitdiff
path: root/doc/man/asn1_der_decoding_element.3
blob: a96d925b09ba150869f242213d3be9e59c65bc22 (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
.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "asn1_der_decoding_element" 3 "4.19.0" "libtasn1" "libtasn1"
.SH NAME
asn1_der_decoding_element \- API function
.SH SYNOPSIS
.B #include <libtasn1.h>
.sp
.BI "int asn1_der_decoding_element(asn1_node * " structure ", const char * " elementName ", const void * " ider ", int " len ", char * " errorDescription ");"
.SH ARGUMENTS
.IP "asn1_node * structure" 12
pointer to an ASN1 structure
.IP "const char * elementName" 12
name of the element to fill
.IP "const void * ider" 12
vector that contains the DER encoding of the whole structure.
.IP "int len" 12
number of bytes of *der: der[0]..der[len\-1]
.IP "char * errorDescription" 12
null\-terminated string contains details when an
error occurred.
.SH "DESCRIPTION"
Fill the element named  \fIELEMENTNAME\fP with values of a DER encoding
string.  The structure must just be created with function
\fBasn1_create_element()\fP.  The DER vector must contain the encoding
string of the whole  \fISTRUCTURE\fP .  If an error occurs during the
decoding procedure, the * \fISTRUCTURE\fP is deleted and set equal to
\fBNULL\fP.

This function is deprecated and may just be an alias to asn1_der_decoding
in future versions. Use \fBasn1_der_decoding()\fP instead.
.SH "RETURNS"
\fBASN1_SUCCESS\fP if DER encoding OK, \fBASN1_ELEMENT_NOT_FOUND\fP
if ELEMENT is \fBNULL\fP or  \fIelementName\fP == NULL, and
\fBASN1_TAG_ERROR\fP or \fBASN1_DER_ERROR\fP if the der encoding doesn't
match the structure  \fIstructure\fP (*ELEMENT deleted).
.SH COPYRIGHT
Copyright \(co 2006-2022 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 https://www.gnu.org/software/libtasn1/manual/
.PP