Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

asn1_der_decoding_startEnd (3)

Name

asn1_der_decoding_startEnd - API function

Synopsis

#include <libtasn1.h>

int  asn1_der_decoding_startEnd(asn1_node  element,  const void * ider,
int ider_len, const char * name_element, int * start, int * end);

Description

libtasn1                                         asn1_der_decoding_startEnd(3)



NAME
       asn1_der_decoding_startEnd - API function

SYNOPSIS
       #include <libtasn1.h>

       int  asn1_der_decoding_startEnd(asn1_node  element,  const void * ider,
       int ider_len, const char * name_element, int * start, int * end);

ARGUMENTS
       asn1_node element
                   pointer to an ASN1 element

       const void * ider
                   vector that contains the DER encoding.

       int ider_len
                   number of bytes of * ider :  ider [0].. ider [len-1]

       const char * name_element
                   an element of NAME structure.

       int * start the position of the first byte of NAME_ELEMENT  decoding  (
                   ider [*start])

       int * end   the  position  of  the last byte of NAME_ELEMENT decoding (
                   ider [*end])

DESCRIPTION
       Find the start and end point of an element in a DER encoding string.  I
       mean  that  if  you  have  a der encoding and you have already used the
       function asn1_der_decoding() to fill a structure, it  may  happen  that
       you  want  to  find  the  piece  of string concerning an element of the
       structure.

       One example is the sequence "tbsCertificate" inside  an  X509  certifi-
       cate.

       Note  that since libtasn1 3.7 the  ider and  ider_len parameters can be
       omitted, if the element is already decoded using asn1_der_decoding().

RETURNS
       ASN1_SUCCESS if DER encoding OK, ASN1_ELEMENT_NOT_FOUND if  ELEMENT  is
       asn1_node EMPTY or  name_element is not a valid element, ASN1_TAG_ERROR
       or ASN1_DER_ERROR if the der encoding doesn't match the structure  ELE-
       MENT.

COPYRIGHT
       Copyright (C) 2006-2015 Free Software Foundation, Inc..
       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.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/libtasn1 |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

SEE ALSO
       The  full documentation for libtasn1 is maintained as a Texinfo manual.
       If the info and libtasn1 programs are properly installed at your  site,
       the command

              info libtasn1

       should  give  you access to the complete manual.  As an alternative you
       may obtain the manual from:

              http://www.gnu.org/software/libtasn1/manual/

NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source  was  downloaded   from    https://ftp.gnu.org/gnu/libtasn1/lib-
       tasn1-4.13.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.gnu.org/software/libtasn1.



libtasn1                              4.8
                                                 asn1_der_decoding_startEnd(3)