gnutls_x509_crt_get_authority_info_access man page on OpenSuSE

Man page or keyword search:  
man Server   25941 pages
apropos Keyword Search (all sections)
Output format
OpenSuSE logo
[printable version]

gnutls_x509_crt_get_authority_infognutls_x509_crt_get_authority_info_access(3)

NAME
       gnutls_x509_crt_get_authority_info_access - API function

SYNOPSIS
       #include <gnutls/x509.h>

       int   gnutls_x509_crt_get_authority_info_access(gnutls_x509_crt_t  crt,
       unsigned int seq, int what, gnutls_datum_t * data, unsigned int * crit‐
       ical);

ARGUMENTS
       gnutls_x509_crt_t crt
		   Holds the certificate

       unsigned int seq
		   specifies  the  sequence number of the access descriptor (0
		   for the first one, 1 for the second etc.)

       int what	   what data to get, a gnutls_info_access_what_t type.

       gnutls_datum_t * data
		   output data to be freed with gnutls_free().

       unsigned int * critical
		   pointer to output integer that  is  set  to	non-0  if  the
		   extension is marked as critical (may be NULL)

DESCRIPTION
       This  function  extracts	 the Authority Information Access (AIA) exten‐
       sion, see RFC 5280 section  4.2.2.1  for	 more  information.   The  AIA
       extension holds a sequence of AccessDescription (AD) data:

       <informalexample><programlisting>     AuthorityInfoAccessSyntax	   ::=
       SEQUENCE SIZE (1..MAX) OF AccessDescription

       AccessDescription  ::=  SEQUENCE { accessMethod		OBJECT IDENTI‐
       FIER,  accessLocation	     GeneralName   } </programlisting></infor‐
       malexample>

       The  seq input parameter is  used  to  indicate	which  member  of  the
       sequence	 the caller is interested in.  The first member is 0, the sec‐
       ond member 1 and so  on.	  When	the   seq  value  is  out  of  bounds,
       GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE is returned.

       The  type of data returned in  data is specified via  what which should
       be gnutls_info_access_what_t values.

       If  what is GNUTLS_IA_ACCESSMETHOD_OID then  data will hold the access‐
       Method OID (e.g., "1.3.6.1.5.5.7.48.1").

       If   what is GNUTLS_IA_ACCESSLOCATION_GENERALNAME_TYPE,	data will hold
       the  accessLocation  GeneralName	 type  (e.g.,  "uniformResourceIdenti‐
       fier").

       If  what is GNUTLS_IA_URI,  data will hold the accessLocation URI data.
       Requesting this	what value leads to an error if the accessLocation  is
       not of the "uniformResourceIdentifier" type.

       If  what is GNUTLS_IA_OCSP_URI,	data will hold the OCSP URI.  Request‐
       ing this	 what value leads to an	 error	if  the	 accessMethod  is  not
       1.3.6.1.5.5.7.48.1  aka	OSCP, or if accessLocation is not of the "uni‐
       formResourceIdentifier" type.

       If  what is GNUTLS_IA_CAISSUERS_URI,  data will hold the caIssuers URI.
       Requesting  this	  what	value leads to an error if the accessMethod is
       not 1.3.6.1.5.5.7.48.2 aka caIssuers, or if accessLocation  is  not  of
       the "uniformResourceIdentifier" type.

       More  what values may be allocated in the future as needed.

       If  data is NULL, the function does the same without storing the output
       data, that is, it will set  critical and do error checking as usual.

       The value of the critical flag is returned in * critical	 .   Supply  a
       NULL   critical	if you want the function to make sure the extension is
       non-critical, as required by RFC 5280.

RETURNS
       GNUTLS_E_SUCCESS on success, GNUTLS_E_INVALID_REQUEST on invalid	 crt ,
       GNUTLS_E_CONSTRAINT_ERROR  if  the  extension  is incorrectly marked as
       critical (use a non-NULL	 critical to override), GNUTLS_E_UNKNOWN_ALGO‐
       RITHM   if   the	 requested  OID	 does  not  match  (e.g.,  when	 using
       GNUTLS_IA_OCSP_URI), otherwise a negative error code.

SINCE
       3.0

REPORTING BUGS
       Report bugs to <bug-gnutls@gnu.org>.
       General guidelines for reporting bugs: http://www.gnu.org/gethelp/
       GnuTLS home page: http://www.gnu.org/software/gnutls/

COPYRIGHT
       Copyright © 2001-2013 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.

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

	      info gnutls

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

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

gnutls				  gnutls_x509_crt_get_authority_info_access(3)
[top]

List of man pages available for OpenSuSE

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net