glib2 1.1.4-x86-mingw32 → 1.1.5-x86-mingw32

data/vendor/local/share/man/man3/gnutls_x509_crt_get_serial.3

@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_crt_get_serial" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_crt_get_serial \- This function returns the certificate's serial number
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_crt_get_serial(gnutls_x509_crt_t " cert ", void * " result ", size_t * " result_size ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_crt_t cert" 12
+should contain a \fBgnutls_x509_crt_t\fP structure
+.IP "void * result" 12
+The place where the serial number will be copied
+.IP "size_t * result_size" 12
+Holds the size of the result field.
+.SH "DESCRIPTION"
+This function will return the X.509 certificate's serial number. 
+This is obtained by the X509 Certificate serialNumber
+field. Serial is not always a 32 or 64bit number. Some CAs use
+large serial numbers, thus it may be wise to handle it as something
+opaque. 
+.SH "RETURNS"
+On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a
+negative error value.and a negative value in case of an error.
+.SH "REPORTING BUGS"
+Report bugs to <bug-gnutls@gnu.org>.
+.SH COPYRIGHT
+Copyright \(co 2008 Free Software Foundation.
+.br
+Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
+.SH "SEE ALSO"
+The full documentation for
+.B gnutls
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B gnutls
+programs are properly installed at your site, the command
+.IP
+.B info gnutls
+.PP
+should give you access to the complete manual.

data/vendor/local/share/man/man3/gnutls_x509_crt_get_signature.3

@@ -0,0 +1,40 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_crt_get_signature" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_crt_get_signature \- Returns the Certificate's signature
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_crt_get_signature(gnutls_x509_crt_t " cert ", char * " sig ", size_t * " sizeof_sig ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_crt_t cert" 12
+should contain a \fBgnutls_x509_crt_t\fP structure
+.IP "char * sig" 12
+a pointer where the signature part will be copied (may be null).
+.IP "size_t * sizeof_sig" 12
+initially holds the size of \fIsig\fP
+.SH "DESCRIPTION"
+This function will extract the signature field of a certificate.
+.SH "RETURNS"
+On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a
+negative error value. and a negative value on error.
+.SH "REPORTING BUGS"
+Report bugs to <bug-gnutls@gnu.org>.
+.SH COPYRIGHT
+Copyright \(co 2008 Free Software Foundation.
+.br
+Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
+.SH "SEE ALSO"
+The full documentation for
+.B gnutls
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B gnutls
+programs are properly installed at your site, the command
+.IP
+.B info gnutls
+.PP
+should give you access to the complete manual.

data/vendor/local/share/man/man3/gnutls_x509_crt_get_signature_algorithm.3

@@ -0,0 +1,37 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_crt_get_signature_algorithm" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_crt_get_signature_algorithm \- This function returns the Certificate's signature algorithm
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_crt_get_signature_algorithm(gnutls_x509_crt_t " cert ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_crt_t cert" 12
+should contain a \fBgnutls_x509_crt_t\fP structure
+.SH "DESCRIPTION"
+This function will return a value of the \fBgnutls_sign_algorithm_t\fP
+enumeration that is the signature algorithm.
+.SH "RETURNS"
+a \fBgnutls_sign_algorithm_t\fP value, or a negative value on
+error.
+.SH "REPORTING BUGS"
+Report bugs to <bug-gnutls@gnu.org>.
+.SH COPYRIGHT
+Copyright \(co 2008 Free Software Foundation.
+.br
+Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
+.SH "SEE ALSO"
+The full documentation for
+.B gnutls
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B gnutls
+programs are properly installed at your site, the command
+.IP
+.B info gnutls
+.PP
+should give you access to the complete manual.

data/vendor/local/share/man/man3/gnutls_x509_crt_get_subject.3

@@ -0,0 +1,42 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_crt_get_subject" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_crt_get_subject \- API function
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_crt_get_subject(gnutls_x509_crt_t " cert ", gnutls_x509_dn_t * " dn ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_crt_t cert" 12
+should contain a \fBgnutls_x509_crt_t\fP structure
+.IP "gnutls_x509_dn_t * dn" 12
+output variable with pointer to opaque DN.
+.SH "DESCRIPTION"
+Return the Certificate's Subject DN as an opaque data type.  You
+may use \fBgnutls_x509_dn_get_rdn_ava()\fP to decode the DN. 
+
+Note that \fIdn\fP should be treated as constant. Because points 
+into the \fIcert\fP object, you may not deallocate \fIcert\fP 
+and continue to access \fIdn\fP.
+.SH "RETURNS"
+Returns 0 on success, or an error code.
+.SH "REPORTING BUGS"
+Report bugs to <bug-gnutls@gnu.org>.
+.SH COPYRIGHT
+Copyright \(co 2008 Free Software Foundation.
+.br
+Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
+.SH "SEE ALSO"
+The full documentation for
+.B gnutls
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B gnutls
+programs are properly installed at your site, the command
+.IP
+.B info gnutls
+.PP
+should give you access to the complete manual.

data/vendor/local/share/man/man3/gnutls_x509_crt_get_subject_alt_name.3

@@ -0,0 +1,64 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_crt_get_subject_alt_name" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_crt_get_subject_alt_name \- Get certificate's alternative name, if any
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_crt_get_subject_alt_name(gnutls_x509_crt_t " cert ", unsigned int " seq ", void * " ret ", size_t * " ret_size ", unsigned int * " critical ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_crt_t cert" 12
+should contain a \fBgnutls_x509_crt_t\fP structure
+.IP "unsigned int seq" 12
+specifies the sequence number of the alt name (0 for the first one, 1 for the second etc.)
+.IP "void * ret" 12
+is the place where the alternative name will be copied to
+.IP "size_t * ret_size" 12
+holds the size of ret.
+.IP "unsigned int * critical" 12
+will be non zero if the extension is marked as critical (may be null)
+.SH "DESCRIPTION"
+This function will return the alternative names, contained in the
+given certificate.
+
+This is specified in X509v3 Certificate Extensions.  GNUTLS will
+return the Alternative name (2.5.29.17), or a negative error code.
+
+When the SAN type is otherName, it will extract the data in the
+otherName's value field, and \fBGNUTLS_SAN_OTHERNAME\fP is returned.
+You may use \fBgnutls_x509_crt_get_subject_alt_othername_oid()\fP to get
+the corresponding OID and the "virtual" SAN types (e.g.,
+\fBGNUTLS_SAN_OTHERNAME_XMPP\fP).
+
+If an otherName OID is known, the data will be decoded.  Otherwise
+the returned data will be DER encoded, and you will have to decode
+it yourself.  Currently, only the RFC 3920 id\-on\-xmppAddr SAN is
+recognized.
+.SH "RETURNS"
+the alternative subject name type on success, one of the
+enumerated \fBgnutls_x509_subject_alt_name_t\fP.  It will return
+\fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP if \fIret_size\fP is not large enough to
+hold the value.  In that case \fIret_size\fP will be updated with the
+required size.  If the certificate does not have an Alternative
+name with the specified sequence number then
+\fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP is returned.
+.SH "REPORTING BUGS"
+Report bugs to <bug-gnutls@gnu.org>.
+.SH COPYRIGHT
+Copyright \(co 2008 Free Software Foundation.
+.br
+Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
+.SH "SEE ALSO"
+The full documentation for
+.B gnutls
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B gnutls
+programs are properly installed at your site, the command
+.IP
+.B info gnutls
+.PP
+should give you access to the complete manual.

data/vendor/local/share/man/man3/gnutls_x509_crt_get_subject_alt_name2.3

@@ -0,0 +1,49 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_crt_get_subject_alt_name2" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_crt_get_subject_alt_name2 \- Get certificate's alternative name, if any
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_crt_get_subject_alt_name2(gnutls_x509_crt_t " cert ", unsigned int " seq ", void * " ret ", size_t * " ret_size ", unsigned int* " ret_type ", unsigned int * " critical ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_crt_t cert" 12
+should contain a \fBgnutls_x509_crt_t\fP structure
+.IP "unsigned int seq" 12
+specifies the sequence number of the alt name (0 for the first one, 1 for the second etc.)
+.IP "void * ret" 12
+is the place where the alternative name will be copied to
+.IP "size_t * ret_size" 12
+holds the size of ret.
+.IP "unsigned int* ret_type" 12
+holds the type of the alternative name (one of gnutls_x509_subject_alt_name_t).
+.IP "unsigned int * critical" 12
+will be non zero if the extension is marked as critical (may be null)
+.SH "DESCRIPTION"
+This function will return the alternative names, contained in the
+given certificate. It is the same as \fBgnutls_x509_crt_get_subject_alt_name()\fP
+except for the fact that it will return the type of the alternative
+name in \fIret_type\fP even if the function fails for some reason (i.e.
+the buffer provided is not enough).
+
+The return values are the same as with \fBgnutls_x509_crt_get_subject_alt_name()\fP.
+.SH "REPORTING BUGS"
+Report bugs to <bug-gnutls@gnu.org>.
+.SH COPYRIGHT
+Copyright \(co 2008 Free Software Foundation.
+.br
+Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
+.SH "SEE ALSO"
+The full documentation for
+.B gnutls
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B gnutls
+programs are properly installed at your site, the command
+.IP
+.B info gnutls
+.PP
+should give you access to the complete manual.

data/vendor/local/share/man/man3/gnutls_x509_crt_get_subject_alt_othername_oid.3

@@ -0,0 +1,56 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_crt_get_subject_alt_othername_oid" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_crt_get_subject_alt_othername_oid \- Get SAN otherName OID
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_crt_get_subject_alt_othername_oid(gnutls_x509_crt_t " cert ", unsigned int " seq ", void * " ret ", size_t * " ret_size ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_crt_t cert" 12
+should contain a \fBgnutls_x509_crt_t\fP structure
+.IP "unsigned int seq" 12
+specifies the sequence number of the alt name (0 for the first one, 1 for the second etc.)
+.IP "void * ret" 12
+is the place where the otherName OID will be copied to
+.IP "size_t * ret_size" 12
+holds the size of ret.
+.SH "DESCRIPTION"
+This function will extract the type OID of an otherName Subject
+Alternative Name, contained in the given certificate, and return
+the type as an enumerated element.
+
+This function is only useful if
+\fBgnutls_x509_crt_get_subject_alt_name()\fP returned
+\fBGNUTLS_SAN_OTHERNAME\fP.
+.SH "RETURNS"
+the alternative subject name type on success, one of the
+enumerated gnutls_x509_subject_alt_name_t.  For supported OIDs, it
+will return one of the virtual (GNUTLS_SAN_OTHERNAME_*) types,
+e.g. \fBGNUTLS_SAN_OTHERNAME_XMPP\fP, and \fBGNUTLS_SAN_OTHERNAME\fP for
+unknown OIDs.  It will return \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP if
+\fIret_size\fP is not large enough to hold the value.  In that case
+\fIret_size\fP will be updated with the required size.  If the
+certificate does not have an Alternative name with the specified
+sequence number and with the otherName type then
+\fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP is returned.
+.SH "REPORTING BUGS"
+Report bugs to <bug-gnutls@gnu.org>.
+.SH COPYRIGHT
+Copyright \(co 2008 Free Software Foundation.
+.br
+Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
+.SH "SEE ALSO"
+The full documentation for
+.B gnutls
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B gnutls
+programs are properly installed at your site, the command
+.IP
+.B info gnutls
+.PP
+should give you access to the complete manual.

data/vendor/local/share/man/man3/gnutls_x509_crt_get_subject_key_id.3

@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_crt_get_subject_key_id" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_crt_get_subject_key_id \- This function returns the certificate's key identifier
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_crt_get_subject_key_id(gnutls_x509_crt_t " cert ", void * " ret ", size_t * " ret_size ", unsigned int * " critical ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_crt_t cert" 12
+should contain a \fBgnutls_x509_crt_t\fP structure
+.IP "void * ret" 12
+The place where the identifier will be copied
+.IP "size_t * ret_size" 12
+Holds the size of the result field.
+.IP "unsigned int * critical" 12
+will be non zero if the extension is marked as critical (may be null)
+.SH "DESCRIPTION"
+This function will return the X.509v3 certificate's subject key identifier.
+This is obtained by the X.509 Subject Key identifier extension
+field (2.5.29.14). 
+.SH "RETURNS"
+On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a
+negative error value.and a negative value in case of an error.
+.SH "REPORTING BUGS"
+Report bugs to <bug-gnutls@gnu.org>.
+.SH COPYRIGHT
+Copyright \(co 2008 Free Software Foundation.
+.br
+Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
+.SH "SEE ALSO"
+The full documentation for
+.B gnutls
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B gnutls
+programs are properly installed at your site, the command
+.IP
+.B info gnutls
+.PP
+should give you access to the complete manual.

data/vendor/local/share/man/man3/gnutls_x509_crt_get_version.3

@@ -0,0 +1,35 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_crt_get_version" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_crt_get_version \- return the Certificate's version number
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_crt_get_version(gnutls_x509_crt_t " cert ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_crt_t cert" 12
+should contain a \fBgnutls_x509_crt_t\fP structure
+.SH "DESCRIPTION"
+This function will return the version of the specified Certificate.
+.SH "RETURNS"
+version of certificate, or a negative value on error.
+.SH "REPORTING BUGS"
+Report bugs to <bug-gnutls@gnu.org>.
+.SH COPYRIGHT
+Copyright \(co 2008 Free Software Foundation.
+.br
+Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
+.SH "SEE ALSO"
+The full documentation for
+.B gnutls
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B gnutls
+programs are properly installed at your site, the command
+.IP
+.B info gnutls
+.PP
+should give you access to the complete manual.

data/vendor/local/share/man/man3/gnutls_x509_crt_import.3

@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_crt_import" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_crt_import \- This function will import a DER or PEM encoded Certificate
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_crt_import(gnutls_x509_crt_t " cert ", const gnutls_datum_t * " data ", gnutls_x509_crt_fmt_t " format ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_crt_t cert" 12
+The structure to store the parsed certificate.
+.IP "const gnutls_datum_t * data" 12
+The DER or PEM encoded certificate.
+.IP "gnutls_x509_crt_fmt_t format" 12
+One of DER or PEM
+.SH "DESCRIPTION"
+This function will convert the given DER or PEM encoded Certificate
+to the native gnutls_x509_crt_t format. The output will be stored in \fIcert\fP.
+
+If the Certificate is PEM encoded it should have a header of "X509 CERTIFICATE", or
+"CERTIFICATE".
+.SH "RETURNS"
+On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a
+negative error value.
+.SH "REPORTING BUGS"
+Report bugs to <bug-gnutls@gnu.org>.
+.SH COPYRIGHT
+Copyright \(co 2008 Free Software Foundation.
+.br
+Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
+.SH "SEE ALSO"
+The full documentation for
+.B gnutls
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B gnutls
+programs are properly installed at your site, the command
+.IP
+.B info gnutls
+.PP
+should give you access to the complete manual.