Tizen 2.0 Release
[external/libgnutls26.git] / doc / manpages / gnutls_x509_crt_get_subject_unique_id.3
1 .\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
2 .TH "gnutls_x509_crt_get_subject_unique_id" 3 "2.12.6.1" "gnutls" "gnutls"
3 .SH NAME
4 gnutls_x509_crt_get_subject_unique_id \- API function
5 .SH SYNOPSIS
6 .B #include <gnutls/x509.h>
7 .sp
8 .BI "int gnutls_x509_crt_get_subject_unique_id(gnutls_x509_crt_t " crt ", char * " buf ", size_t * " sizeof_buf ");"
9 .SH ARGUMENTS
10 .IP "gnutls_x509_crt_t crt" 12
11 Holds the certificate
12 .IP "char * buf" 12
13 user allocated memory buffer, will hold the unique id
14 .IP "size_t * sizeof_buf" 12
15 size of user allocated memory buffer (on input), will hold
16 actual size of the unique ID on return.
17 .SH "DESCRIPTION"
18 This function will extract the subjectUniqueID value (if present) for
19 the given certificate.
20
21 If the user allocated memory buffer is not large enough to hold the
22 full subjectUniqueID, then a GNUTLS_E_SHORT_MEMORY_BUFFER error will be
23 returned, and sizeof_buf will be set to the actual length.
24 .SH "RETURNS"
25 \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error.
26 .SH "REPORTING BUGS"
27 Report bugs to <bug-gnutls@gnu.org>.
28 GnuTLS home page: http://www.gnu.org/software/gnutls/
29 General help using GNU software: http://www.gnu.org/gethelp/
30 .SH COPYRIGHT
31 Copyright \(co 2008 Free Software Foundation.
32 .br
33 Copying and distribution of this file, with or without modification,
34 are permitted in any medium without royalty provided the copyright
35 notice and this notice are preserved.
36 .SH "SEE ALSO"
37 The full documentation for
38 .B gnutls
39 is maintained as a Texinfo manual.  If the
40 .B info
41 and
42 .B gnutls
43 programs are properly installed at your site, the command
44 .IP
45 .B info gnutls
46 .PP
47 should give you access to the complete manual.