Blame doc/functions/gnutls_x509_crq_get_basic_constraints

Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
@deftypefun {int} {gnutls_x509_crq_get_basic_constraints} (gnutls_x509_crq_t @var{crq}, unsigned int * @var{critical}, unsigned int * @var{ca}, int * @var{pathlen})
Packit Service 4684c1
@var{crq}: should contain a @code{gnutls_x509_crq_t}  type
Packit Service 4684c1
Packit Service 4684c1
@var{critical}: will be non-zero if the extension is marked as critical
Packit Service 4684c1
Packit Service 4684c1
@var{ca}: pointer to output integer indicating CA status, may be NULL,
Packit Service 4684c1
value is 1 if the certificate CA flag is set, 0 otherwise.
Packit Service 4684c1
Packit Service 4684c1
@var{pathlen}: pointer to output integer indicating path length (may be
Packit Service 4684c1
NULL), non-negative error codes indicate a present pathLenConstraint
Packit Service 4684c1
field and the actual value, -1 indicate that the field is absent.
Packit Service 4684c1
Packit Service 4684c1
This function will read the certificate's basic constraints, and
Packit Service 4684c1
return the certificates CA status.  It reads the basicConstraints
Packit Service 4684c1
X.509 extension (2.5.29.19).
Packit Service 4684c1
Packit Service 4684c1
@strong{Returns:} If the certificate is a CA a positive value will be
Packit Service 4684c1
returned, or (0) if the certificate does not have CA flag set.
Packit Service 4684c1
A negative error code may be returned in case of errors.  If the
Packit Service 4684c1
certificate does not contain the basicConstraints extension
Packit Service 4684c1
@code{GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE}  will be returned.
Packit Service 4684c1
Packit Service 4684c1
@strong{Since:} 2.8.0
Packit Service 4684c1
@end deftypefun