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

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

@@ -0,0 +1,43 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_privkey_generate" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_privkey_generate \- generate a private key
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_privkey_generate(gnutls_x509_privkey_t " key ", gnutls_pk_algorithm_t " algo ", unsigned int " bits ", unsigned int " flags ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_privkey_t key" 12
+should contain a \fBgnutls_x509_privkey_t\fP structure
+.IP "gnutls_pk_algorithm_t algo" 12
+is one of RSA or DSA.
+.IP "unsigned int bits" 12
+the size of the modulus
+.IP "unsigned int flags" 12
+unused for now.  Must be 0.
+.SH "DESCRIPTION"
+This function will generate a random private key. Note that this
+function must be called on an empty private key.
+.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.

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

@@ -0,0 +1,50 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_privkey_get_key_id" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_privkey_get_key_id \- Return unique ID of the key's parameters
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_privkey_get_key_id(gnutls_x509_privkey_t " key ", unsigned int " flags ", unsigned char * " output_data ", size_t * " output_data_size ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_privkey_t key" 12
+Holds the key
+.IP "unsigned int flags" 12
+should be 0 for now
+.IP "unsigned char * output_data" 12
+will contain the key ID
+.IP "size_t * output_data_size" 12
+holds the size of output_data (and will be
+replaced by the actual size of parameters)
+.SH "DESCRIPTION"
+This function will return a unique ID the depends on the public key
+parameters. This ID can be used in checking whether a certificate
+corresponds to the given key.
+
+If the buffer provided is not long enough to hold the output, then
+*\fIoutput_data_size\fP is updated and \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP will
+be returned.  The output will normally be a SHA\-1 hash output,
+which is 20 bytes.
+.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.

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

@@ -0,0 +1,37 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_privkey_get_pk_algorithm" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_privkey_get_pk_algorithm \- returns the key's PublicKey algorithm
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_privkey_get_pk_algorithm(gnutls_x509_privkey_t " key ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_privkey_t key" 12
+should contain a \fBgnutls_x509_privkey_t\fP structure
+.SH "DESCRIPTION"
+This function will return the public key algorithm of a private
+key.
+.SH "RETURNS"
+a member of the \fBgnutls_pk_algorithm_t\fP enumeration on
+success, 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_privkey_import.3

@@ -0,0 +1,45 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_privkey_import" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_privkey_import \- import a DER or PEM encoded key
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_privkey_import(gnutls_x509_privkey_t " key ", const gnutls_datum_t * " data ", gnutls_x509_crt_fmt_t " format ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_privkey_t key" 12
+The structure to store the parsed key
+.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 key to the
+native \fBgnutls_x509_privkey_t\fP format. The output will be stored in
+\fIkey\fP .
+
+If the key is PEM encoded it should have a header of "RSA PRIVATE
+KEY", or "DSA PRIVATE KEY".
+.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.

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

@@ -0,0 +1,48 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_privkey_import_dsa_raw" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_privkey_import_dsa_raw \- import a raw DSA key
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_privkey_import_dsa_raw(gnutls_x509_privkey_t " key ", const gnutls_datum_t * " p ", const gnutls_datum_t * " q ", const gnutls_datum_t * " g ", const gnutls_datum_t * " y ", const gnutls_datum_t * " x ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_privkey_t key" 12
+The structure to store the parsed key
+.IP "const gnutls_datum_t * p" 12
+holds the p
+.IP "const gnutls_datum_t * q" 12
+holds the q
+.IP "const gnutls_datum_t * g" 12
+holds the g
+.IP "const gnutls_datum_t * y" 12
+holds the y
+.IP "const gnutls_datum_t * x" 12
+holds the x
+.SH "DESCRIPTION"
+This function will convert the given DSA raw parameters to the
+native \fBgnutls_x509_privkey_t\fP format.  The output will be stored
+in \fIkey\fP.
+.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.

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

@@ -0,0 +1,54 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_privkey_import_pkcs8" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_privkey_import_pkcs8 \- This function will import a DER or PEM PKCS8 encoded key
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_privkey_import_pkcs8(gnutls_x509_privkey_t " key ", const gnutls_datum_t * " data ", gnutls_x509_crt_fmt_t " format ", const char * " password ", unsigned int " flags ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_privkey_t key" 12
+The structure to store the parsed key
+.IP "const gnutls_datum_t * data" 12
+The DER or PEM encoded key.
+.IP "gnutls_x509_crt_fmt_t format" 12
+One of DER or PEM
+.IP "const char * password" 12
+the password to decrypt the key (if it is encrypted).
+.IP "unsigned int flags" 12
+0 if encrypted or GNUTLS_PKCS_PLAIN if not encrypted.
+.SH "DESCRIPTION"
+This function will convert the given DER or PEM encoded PKCS8 2.0 encrypted key
+to the native gnutls_x509_privkey_t format. The output will be stored in \fIkey\fP.
+Both RSA and DSA keys can be imported, and flags can only be used to indicate
+an unencrypted key.
+
+The \fIpassword\fP can be either ASCII or UTF\-8 in the default PBES2
+encryption schemas, or ASCII for the PKCS12 schemas.
+
+If the Certificate is PEM encoded it should have a header of "ENCRYPTED PRIVATE KEY",
+or "PRIVATE KEY". You only need to specify the flags if the key is DER encoded, since
+in that case the encryption status cannot be auto\-detected.
+.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.

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

@@ -0,0 +1,50 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_privkey_import_rsa_raw" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_privkey_import_rsa_raw \- import a raw RSA key
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_privkey_import_rsa_raw(gnutls_x509_privkey_t " key ", const gnutls_datum_t * " m ", const gnutls_datum_t * " e ", const gnutls_datum_t * " d ", const gnutls_datum_t * " p ", const gnutls_datum_t * " q ", const gnutls_datum_t * " u ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_privkey_t key" 12
+The structure to store the parsed key
+.IP "const gnutls_datum_t * m" 12
+holds the modulus
+.IP "const gnutls_datum_t * e" 12
+holds the public exponent
+.IP "const gnutls_datum_t * d" 12
+holds the private exponent
+.IP "const gnutls_datum_t * p" 12
+holds the first prime (p)
+.IP "const gnutls_datum_t * q" 12
+holds the second prime (q)
+.IP "const gnutls_datum_t * u" 12
+holds the coefficient
+.SH "DESCRIPTION"
+This function will convert the given RSA raw parameters to the
+native \fBgnutls_x509_privkey_t\fP format.  The output will be stored in
+\fIkey\fP.
+.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.

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

@@ -0,0 +1,36 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_privkey_init" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_privkey_init \- initialize a #gnutls_privkey_t structure
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_privkey_init(gnutls_x509_privkey_t * " key ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_privkey_t * key" 12
+The structure to be initialized
+.SH "DESCRIPTION"
+This function will initialize an private key structure.
+.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.

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

@@ -0,0 +1,54 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_privkey_sign_data" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_privkey_sign_data \- sign data using the private key
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_privkey_sign_data(gnutls_x509_privkey_t " key ", gnutls_digest_algorithm_t " digest ", unsigned int " flags ", const gnutls_datum_t * " data ", void * " signature ", size_t * " signature_size ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_privkey_t key" 12
+Holds the key
+.IP "gnutls_digest_algorithm_t digest" 12
+should be MD5 or SHA1
+.IP "unsigned int flags" 12
+should be 0 for now
+.IP "const gnutls_datum_t * data" 12
+holds the data to be signed
+.IP "void * signature" 12
+will contain the signature
+.IP "size_t * signature_size" 12
+holds the size of signature (and will be replaced
+by the new size)
+.SH "DESCRIPTION"
+This function will sign the given data using a signature algorithm
+supported by the private key. Signature algorithms are always used
+together with a hash functions.  Different hash functions may be
+used for the RSA algorithm, but only SHA\-1 for the DSA keys.
+
+If the buffer provided is not long enough to hold the output, then
+*\fIsignature_size\fP is updated and \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP will
+be returned.
+.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.

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

@@ -0,0 +1,40 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_x509_privkey_sign_hash" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_x509_privkey_sign_hash \- sign hash using the private key
+.SH SYNOPSIS
+.B #include <gnutls/x509.h>
+.sp
+.BI "int gnutls_x509_privkey_sign_hash(gnutls_x509_privkey_t " key ", const gnutls_datum_t * " hash ", gnutls_datum_t * " signature ");"
+.SH ARGUMENTS
+.IP "gnutls_x509_privkey_t key" 12
+Holds the key
+.IP "const gnutls_datum_t * hash" 12
+holds the data to be signed
+.IP "gnutls_datum_t * signature" 12
+will contain newly allocated signature
+.SH "DESCRIPTION"
+This function will sign the given hash using the private key.
+.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.