Man Linux: Main Page and Category List

NAME

       gnutls_x509_crt_get_crl_dist_points  -  This  function  returns the CRL
       distribution points

SYNOPSIS

       #include <gnutls/x509.h>

       int     gnutls_x509_crt_get_crl_dist_points(gnutls_x509_crt_t     cert,
       unsigned  int  seq,  void  *  ret,  size_t  *  ret_size, unsigned int *
       reason_flags, unsigned int * critical);

ARGUMENTS

       gnutls_x509_crt_t cert
                   should contain a gnutls_x509_crt_t structure

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

       void * ret  is the place where the distribution point will be copied to

       size_t * ret_size
                   holds the size of ret.

       unsigned int * reason_flags
                   Revocation reasons flags.

       unsigned int * critical
                   will be non zero if the extension  is  marked  as  critical
                   (may be null)

DESCRIPTION

       This  function  will  return  the  CRL distribution points (2.5.29.31),
       contained in the given certificate.

       reason_flags should be an ORed  sequence  of  GNUTLS_CRL_REASON_UNUSED,
       GNUTLS_CRL_REASON_KEY_COMPROMISE,      GNUTLS_CRL_REASON_CA_COMPROMISE,
       GNUTLS_CRL_REASON_AFFILIATION_CHANGED,   GNUTLS_CRL_REASON_SUPERSEEDED,
       GNUTLS_CRL_REASON_CESSATION_OF_OPERATION,
       GNUTLS_CRL_REASON_CERTIFICATE_HOLD,
       GNUTLS_CRL_REASON_PRIVILEGE_WITHDRAWN, GNUTLS_CRL_REASON_AA_COMPROMISE,
       or zero for all possible reasons.

       This is specified in X509v3 Certificate Extensions. GNUTLS will  return
       the distribution point type, or a negative error code on error.

RETURNS

       GNUTLS_E_SHORT_MEMORY_BUFFER  and updates &ret_size if &ret_size is not
       enough to hold the distribution point, or the type of the  distribution
       point  if  everything  was  ok.  The  type  is  one  of  the enumerated
       gnutls_x509_subject_alt_name_t.  If the certificate does  not  have  an
       Alternative    name   with   the   specified   sequence   number   then
       GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE is returned.

REPORTING BUGS

       Report   bugs   to    <bug-gnutls@gnu.org>.     GnuTLS    home    page:
       http://www.gnu.org/software/gnutls/  General  help  using GNU software:
       http://www.gnu.org/gethelp/

COPYRIGHT

       Copyright © 2008 Free Software Foundation.
       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.

gnutls                               2.8gnutls_x509_crt_get_crl_dist_points(3)