Blame doc/manpages/gnutls_x509_crt_get_dn_oid.3

Packit aea12f
.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
Packit aea12f
.TH "gnutls_x509_crt_get_dn_oid" 3 "3.6.8" "gnutls" "gnutls"
Packit aea12f
.SH NAME
Packit aea12f
gnutls_x509_crt_get_dn_oid \- API function
Packit aea12f
.SH SYNOPSIS
Packit aea12f
.B #include <gnutls/x509.h>
Packit aea12f
.sp
Packit aea12f
.BI "int gnutls_x509_crt_get_dn_oid(gnutls_x509_crt_t " cert ", unsigned " indx ", void * " oid ", size_t * " oid_size ");"
Packit aea12f
.SH ARGUMENTS
Packit aea12f
.IP "gnutls_x509_crt_t cert" 12
Packit aea12f
should contain a \fBgnutls_x509_crt_t\fP type
Packit aea12f
.IP "unsigned indx" 12
Packit aea12f
This specifies which OID to return. Use (0) to get the first one.
Packit aea12f
.IP "void * oid" 12
Packit aea12f
a pointer to a buffer to hold the OID (may be null)
Packit aea12f
.IP "size_t * oid_size" 12
Packit aea12f
initially holds the size of  \fIoid\fP 
Packit aea12f
.SH "DESCRIPTION"
Packit aea12f
This function will extract the OIDs of the name of the Certificate
Packit aea12f
subject specified by the given index.
Packit aea12f
Packit aea12f
If  \fIoid\fP is null then only the size will be filled. The  \fIoid\fP returned will be null terminated, although  \fIoid_size\fP will not
Packit aea12f
account for the trailing null.
Packit aea12f
.SH "RETURNS"
Packit aea12f
\fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP if the provided buffer is not
Packit aea12f
long enough, and in that case the  \fIbuf_size\fP will be updated with
Packit aea12f
the required size. \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP if there 
Packit aea12f
are no data in the current index. On success 0 is returned.
Packit aea12f
.SH "REPORTING BUGS"
Packit aea12f
Report bugs to <bugs@gnutls.org>.
Packit aea12f
.br
Packit aea12f
Home page: https://www.gnutls.org
Packit aea12f
Packit aea12f
.SH COPYRIGHT
Packit aea12f
Copyright \(co 2001-2019 Free Software Foundation, Inc., and others.
Packit aea12f
.br
Packit aea12f
Copying and distribution of this file, with or without modification,
Packit aea12f
are permitted in any medium without royalty provided the copyright
Packit aea12f
notice and this notice are preserved.
Packit aea12f
.SH "SEE ALSO"
Packit aea12f
The full documentation for
Packit aea12f
.B gnutls
Packit aea12f
is maintained as a Texinfo manual.
Packit aea12f
If the /usr/share/doc/gnutls/
Packit aea12f
directory does not contain the HTML form visit
Packit aea12f
.B
Packit aea12f
.IP https://www.gnutls.org/manual/
Packit aea12f
.PP