doc/man/asn1_der_decoding.3

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
   2 .TH "asn1_der_decoding" 3 "2.7" "libtasn1" "libtasn1"
   3 .SH NAME
   4 asn1_der_decoding \- API function
   5 .SH SYNOPSIS
   6 .B #include <libtasn1.h>
   7 .sp
   8 .BI "asn1_retCode asn1_der_decoding(ASN1_TYPE * " element ", const void * " ider ", int " len ", char * " errorDescription ");"
   9 .SH ARGUMENTS
  10 .IP "ASN1_TYPE * element" 12
  11 pointer to an ASN1 structure.
  12 .IP "const void * ider" 12
  13 vector that contains the DER encoding.
  14 .IP "int len" 12
  15 number of bytes of *\fIider\fP: \fIider\fP[0]..\fIider\fP[len\-1].
  16 .IP "char * errorDescription" 12
  17 null\-terminated string contains details when an
  18 error occurred.
  19 .SH "DESCRIPTION"
  20 Fill the structure *\fIELEMENT\fP with values of a DER encoding
  21 string. The structure must just be created with function
  22 \fBasn1_create_element()\fP.  If an error occurs during the decoding
  23 procedure, the *\fIELEMENT\fP is deleted and set equal to
  24 \fBASN1_TYPE_EMPTY\fP.
  25 .SH "RETURNS"
  26 \fBASN1_SUCCESS\fP if DER encoding OK, \fBASN1_ELEMENT_NOT_FOUND\fP
  27 if \fIELEMENT\fP is \fBASN1_TYPE_EMPTY\fP, and \fBASN1_TAG_ERROR\fP or
  28 \fBASN1_DER_ERROR\fP if the der encoding doesn't match the structure
  29 name (*\fIELEMENT\fP deleted).
  30 .SH COPYRIGHT
  31 Copyright \(co 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc..
  32 .br
  33 Copying and distribution of this file, with or without modification,
  34 are permitted in any medium without royalty provided the copyright
  35 notice and this notice are preserved.
  36 .SH "SEE ALSO"
  37 The full documentation for
  38 .B libtasn1
  39 is maintained as a Texinfo manual.  If the
  40 .B info
  41 and
  42 .B libtasn1
  43 programs are properly installed at your site, the command
  44 .IP
  45 .B info libtasn1
  46 .PP
  47 should give you access to the complete manual.