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

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

@@ -0,0 +1,45 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_srp_base64_encode_alloc" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_srp_base64_encode_alloc \- encode raw data using SRP-Base64
+.SH SYNOPSIS
+.B #include <gnutls/gnutls.h>
+.sp
+.BI "int gnutls_srp_base64_encode_alloc(const gnutls_datum_t * " data ", gnutls_datum_t * " result ");"
+.SH ARGUMENTS
+.IP "const gnutls_datum_t * data" 12
+contains the raw data
+.IP "gnutls_datum_t * result" 12
+will hold the newly allocated encoded data
+.SH "DESCRIPTION"
+This function will convert the given data to printable data, using
+the base64 encoding.  This is the encoding used in SRP password
+files.  This function will allocate the required memory to hold
+the encoded data.
+
+You should use \fBgnutls_free()\fP to free the returned data.
+
+Warning!  This base64 encoding is not the "standard" encoding, so
+do not use it for non\-SRP purposes.
+.SH "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_srp_free_client_credentials.3

@@ -0,0 +1,34 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_srp_free_client_credentials" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_srp_free_client_credentials \- Used to free an allocated gnutls_srp_client_credentials_t structure
+.SH SYNOPSIS
+.B #include <gnutls/gnutls.h>
+.sp
+.BI "void gnutls_srp_free_client_credentials(gnutls_srp_client_credentials_t " sc ");"
+.SH ARGUMENTS
+.IP "gnutls_srp_client_credentials_t sc" 12
+is an \fBgnutls_srp_client_credentials_t\fP structure.
+.SH "DESCRIPTION"
+This structure is complex enough to manipulate directly thus
+this helper function is provided in order to free (deallocate) it.
+.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_srp_free_server_credentials.3

@@ -0,0 +1,34 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_srp_free_server_credentials" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_srp_free_server_credentials \- Used to free an allocated gnutls_srp_server_credentials_t structure
+.SH SYNOPSIS
+.B #include <gnutls/gnutls.h>
+.sp
+.BI "void gnutls_srp_free_server_credentials(gnutls_srp_server_credentials_t " sc ");"
+.SH ARGUMENTS
+.IP "gnutls_srp_server_credentials_t sc" 12
+is an \fBgnutls_srp_server_credentials_t\fP structure.
+.SH "DESCRIPTION"
+This structure is complex enough to manipulate directly thus
+this helper function is provided in order to free (deallocate) it.
+.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_srp_server_get_username.3

@@ -0,0 +1,37 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_srp_server_get_username" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_srp_server_get_username \- return the username of the peer
+.SH SYNOPSIS
+.B #include <gnutls/gnutls.h>
+.sp
+.BI "const char * gnutls_srp_server_get_username(gnutls_session_t " session ");"
+.SH ARGUMENTS
+.IP "gnutls_session_t session" 12
+is a gnutls session
+.SH "DESCRIPTION"
+This function will return the username of the peer.  This should
+only be called in case of SRP authentication and in case of a
+server.  Returns NULL in case of an error.
+.SH "RETURNS"
+SRP username of the peer, or NULL in case of 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_srp_set_client_credentials.3

@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_srp_set_client_credentials" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_srp_set_client_credentials \- Used to set the username/password, in a gnutls_srp_client_credentials_t structure
+.SH SYNOPSIS
+.B #include <gnutls/gnutls.h>
+.sp
+.BI "int gnutls_srp_set_client_credentials(gnutls_srp_client_credentials_t " res ", const char * " username ", const char * " password ");"
+.SH ARGUMENTS
+.IP "gnutls_srp_client_credentials_t res" 12
+is an \fBgnutls_srp_client_credentials_t\fP structure.
+.IP "const char * username" 12
+is the user's userid
+.IP "const char * password" 12
+is the user's password
+.SH "DESCRIPTION"
+This function sets the username and password, in a
+\fBgnutls_srp_client_credentials_t\fP structure.  Those will be used in
+SRP authentication.  \fIusername\fP and \fIpassword\fP should be ASCII
+strings or UTF\-8 strings prepared using the "SASLprep" profile of
+"stringprep".
+.SH "RETURNS"
+On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, 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_srp_set_client_credentials_function.3

@@ -0,0 +1,54 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_srp_set_client_credentials_function" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_srp_set_client_credentials_function \- Used to set a callback to retrieve the username and password
+.SH SYNOPSIS
+.B #include <gnutls/gnutls.h>
+.sp
+.BI "void gnutls_srp_set_client_credentials_function(gnutls_srp_client_credentials_t " cred ", gnutls_srp_client_credentials_function * " func ");"
+.SH ARGUMENTS
+.IP "gnutls_srp_client_credentials_t cred" 12
+is a \fBgnutls_srp_server_credentials_t\fP structure.
+.IP "gnutls_srp_client_credentials_function * func" 12
+is the callback function
+.SH "DESCRIPTION"
+This function can be used to set a callback to retrieve the username and
+password for client SRP authentication.
+
+The callback's function form is:
+
+int (*callback)(gnutls_session_t, char** username, char**password);
+
+The \fIusername\fP and \fIpassword\fP must be allocated using
+\fBgnutls_malloc()\fP.  \fIusername\fP and \fIpassword\fP should be ASCII strings
+or UTF\-8 strings prepared using the "SASLprep" profile of
+"stringprep".
+
+The callback function will be called once per handshake before the
+initial hello message is sent.
+
+The callback should not return a negative error code the second
+time called, since the handshake procedure will be aborted.
+
+The callback function should return 0 on success.
+\-1 indicates 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_srp_set_server_credentials_file.3

@@ -0,0 +1,43 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_srp_set_server_credentials_file" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_srp_set_server_credentials_file \- Used to set the password files, in a gnutls_srp_server_credentials_t structure
+.SH SYNOPSIS
+.B #include <gnutls/gnutls.h>
+.sp
+.BI "int gnutls_srp_set_server_credentials_file(gnutls_srp_server_credentials_t      " res ", const char * " password_file ", const char * " password_conf_file ");"
+.SH ARGUMENTS
+.IP "gnutls_srp_server_credentials_t      res" 12
+is an \fBgnutls_srp_server_credentials_t\fP structure.
+.IP "const char * password_file" 12
+is the SRP password file (tpasswd)
+.IP "const char * password_conf_file" 12
+is the SRP password conf file (tpasswd.conf)
+.SH "DESCRIPTION"
+This function sets the password files, in a
+\fBgnutls_srp_server_credentials_t\fP structure.  Those password files
+hold usernames and verifiers and will be used for SRP
+authentication.
+.SH "RETURNS"
+On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, 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_srp_set_server_credentials_function.3

@@ -0,0 +1,56 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_srp_set_server_credentials_function" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_srp_set_server_credentials_function \- Used to set a callback to retrieve the user's SRP credentials
+.SH SYNOPSIS
+.B #include <gnutls/gnutls.h>
+.sp
+.BI "void gnutls_srp_set_server_credentials_function(gnutls_srp_server_credentials_t          " cred ", gnutls_srp_server_credentials_function          * " func ");"
+.SH ARGUMENTS
+.IP "gnutls_srp_server_credentials_t          cred" 12
+is a \fBgnutls_srp_server_credentials_t\fP structure.
+.IP "gnutls_srp_server_credentials_function          * func" 12
+is the callback function
+.SH "DESCRIPTION"
+This function can be used to set a callback to retrieve the user's SRP credentials.
+The callback's function form is:
+int (*callback)(gnutls_session_t, const char* username,
+gnutls_datum_t* salt, gnutls_datum_t *verifier, gnutls_datum_t* g,
+gnutls_datum_t* n);
+
+\fIusername\fP contains the actual username. 
+The \fIsalt\fP, \fIverifier\fP, \fIgenerator\fP and \fIprime\fP must be filled
+in using the \fBgnutls_malloc()\fP. For convenience \fIprime\fP and \fIgenerator\fP 
+may also be one of the static parameters defined in extra.h.
+
+In case the callback returned a negative number then gnutls will
+assume that the username does not exist.
+
+In order to prevent attackers from guessing valid usernames,
+if a user does not exist, g and n values should be filled in
+using a random user's parameters. In that case the callback must
+return the special value (1).
+
+The callback function will only be called once per handshake.
+The callback function should return 0 on success, while
+\-1 indicates 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_srp_verifier.3

@@ -0,0 +1,53 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_srp_verifier" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_srp_verifier \- Used to calculate an SRP verifier
+.SH SYNOPSIS
+.B #include <gnutls/gnutls.h>
+.sp
+.BI "int gnutls_srp_verifier(const char * " username ", const char * " password ", const gnutls_datum_t * " salt ", const gnutls_datum_t * " generator ", const gnutls_datum_t * " prime ", gnutls_datum_t * " res ");"
+.SH ARGUMENTS
+.IP "const char * username" 12
+is the user's name
+.IP "const char * password" 12
+is the user's password
+.IP "const gnutls_datum_t * salt" 12
+should be some randomly generated bytes
+.IP "const gnutls_datum_t * generator" 12
+is the generator of the group
+.IP "const gnutls_datum_t * prime" 12
+is the group's prime
+.IP "gnutls_datum_t * res" 12
+where the verifier will be stored.
+.SH "DESCRIPTION"
+This function will create an SRP verifier, as specified in
+RFC2945.  The \fIprime\fP and \fIgenerator\fP should be one of the static
+parameters defined in gnutls/extra.h or may be generated using the
+libgcrypt functions \fBgcry_prime_generate()\fP and
+\fBgcry_prime_group_generator()\fP.
+
+The verifier will be allocated with \fImalloc\fP and will be stored in
+\fIres\fP using binary format.
+.SH "RETURNS"
+On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, 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_strerror.3

@@ -0,0 +1,35 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_strerror" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_strerror \- Returns a string with a description of an error
+.SH SYNOPSIS
+.B #include <gnutls/gnutls.h>
+.sp
+.BI "const char * gnutls_strerror(int " error ");"
+.SH ARGUMENTS
+.IP "int error" 12
+is an error returned by a gnutls function. Error is always a negative value.
+.SH "DESCRIPTION"
+This function is similar to \fBstrerror()\fP. Differences: it accepts an error
+number returned by a gnutls function; In case of an unknown error
+a descriptive string is sent instead of NULL.
+.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.