summaryrefslogtreecommitdiffstats
path: root/doc/manpages/gnutls_x509_crt_print.3
blob: 405644281df2b1f88da1b01eb1ec473625cbab8a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "gnutls_x509_crt_print" 3 "3.7.9" "gnutls" "gnutls"
.SH NAME
gnutls_x509_crt_print \- API function
.SH SYNOPSIS
.B #include <gnutls/x509.h>
.sp
.BI "int gnutls_x509_crt_print(gnutls_x509_crt_t " cert ", gnutls_certificate_print_formats_t " format ", gnutls_datum_t * " out ");"
.SH ARGUMENTS
.IP "gnutls_x509_crt_t cert" 12
The data to be printed
.IP "gnutls_certificate_print_formats_t format" 12
Indicate the format to use
.IP "gnutls_datum_t * out" 12
Newly allocated datum with null terminated string.
.SH "DESCRIPTION"
This function will pretty print a X.509 certificate, suitable for
display to a human.

If the format is \fBGNUTLS_CRT_PRINT_FULL\fP then all fields of the
certificate will be output, on multiple lines.  The
\fBGNUTLS_CRT_PRINT_ONELINE\fP format will generate one line with some
selected fields, which is useful for logging purposes.

The output  \fIout\fP needs to be deallocated using \fBgnutls_free()\fP.
.SH "RETURNS"
On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise a
negative error value.
.SH "REPORTING BUGS"
Report bugs to <bugs@gnutls.org>.
.br
Home page: https://www.gnutls.org

.SH COPYRIGHT
Copyright \(co 2001- Free Software Foundation, Inc., and others.
.br
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.
.SH "SEE ALSO"
The full documentation for
.B gnutls
is maintained as a Texinfo manual.
If the /usr/share/doc/gnutls/
directory does not contain the HTML form visit
.B
.IP https://www.gnutls.org/manual/
.PP