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

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

@@ -0,0 +1,43 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_ia_permute_inner_secret" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_ia_permute_inner_secret \- API function
+.SH SYNOPSIS
+.B #include <gnutls/extra.h>
+.sp
+.BI "int gnutls_ia_permute_inner_secret(gnutls_session_t " session ", size_t " session_keys_size ", const char * " session_keys ");"
+.SH ARGUMENTS
+.IP "gnutls_session_t session" 12
+is a \fBgnutls_session_t\fP structure.
+.IP "size_t session_keys_size" 12
+Size of generated session keys (0 if none).
+.IP "const char * session_keys" 12
+Generated session keys, used to permute inner secret
+(NULL if none).
+.SH "DESCRIPTION"
+Permute the inner secret using the generated session keys.
+
+This can be called in the TLS/IA AVP callback to mix any generated
+session keys with the TLS/IA inner secret.
+.SH "RETURN VALUE"
+Return zero on success, or a negative 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_ia_recv.3

@@ -0,0 +1,57 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_ia_recv" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_ia_recv \- read data from the TLS/IA protocol
+.SH SYNOPSIS
+.B #include <gnutls/extra.h>
+.sp
+.BI "ssize_t gnutls_ia_recv(gnutls_session_t " session ", char * " data ", size_t " sizeofdata ");"
+.SH ARGUMENTS
+.IP "gnutls_session_t session" 12
+is a \fBgnutls_session_t\fP structure.
+.IP "char * data" 12
+the buffer that the data will be read into, must hold >= 12 bytes.
+.IP "size_t sizeofdata" 12
+the number of requested bytes, must be >= 12.
+.SH "DESCRIPTION"
+Receive TLS/IA data.  This function has the similar semantics with
+\fBrecv()\fP. The only difference is that is accepts a GNUTLS session,
+and uses different error codes.
+
+If the server attempt to finish an application phase, this function
+will return \fBGNUTLS_E_WARNING_IA_IPHF_RECEIVED\fP or
+\fBGNUTLS_E_WARNING_IA_FPHF_RECEIVED\fP.  The caller should then invoke
+\fBgnutls_ia_verify_endphase()\fP, and if it runs the client side, also
+send an endphase message of its own using gnutls_ia_endphase_send.
+
+If EINTR is returned by the internal push function (the default is
+\fIcode\fP{\fBrecv()\fP}) then GNUTLS_E_INTERRUPTED will be returned.  If
+GNUTLS_E_INTERRUPTED or GNUTLS_E_AGAIN is returned, you must call
+this function again, with the same parameters; alternatively you
+could provide a NULL pointer for data, and 0 for size.
+.SH "RETURNS"
+The number of bytes received.  A negative error code is
+returned in case of an error.  The
+\fBGNUTLS_E_WARNING_IA_IPHF_RECEIVED\fP and
+\fBGNUTLS_E_WARNING_IA_FPHF_RECEIVED\fP errors are returned when an
+application phase finished message has been sent by the server.
+.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_ia_send.3

@@ -0,0 +1,56 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_ia_send" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_ia_send \- API function
+.SH SYNOPSIS
+.B #include <gnutls/extra.h>
+.sp
+.BI "ssize_t gnutls_ia_send(gnutls_session_t " session ", const char * " data ", size_t " sizeofdata ");"
+.SH ARGUMENTS
+.IP "gnutls_session_t session" 12
+is a \fBgnutls_session_t\fP structure.
+.IP "const char * data" 12
+contains the data to send
+.IP "size_t sizeofdata" 12
+is the length of the data
+.SH "DESCRIPTION"
+Send TLS/IA application payload data.  This function has the
+similar semantics with \fBsend()\fP. The only difference is that is
+accepts a GNUTLS session, and uses different error codes.
+
+The TLS/IA protocol is synchronous, so you cannot send more than
+one packet at a time.  The client always send the first packet.
+
+To finish an application phase in the server, use
+\fBgnutls_ia_endphase_send()\fP.  The client cannot end an application
+phase unilaterally; rather, a client is required to respond with an
+endphase of its own if gnutls_ia_recv indicates that the server has
+sent one.
+
+If the EINTR is returned by the internal push function (the default
+is \fBsend()\fP} then \fBGNUTLS_E_INTERRUPTED\fP will be returned.  If
+\fBGNUTLS_E_INTERRUPTED\fP or \fBGNUTLS_E_AGAIN\fP is returned, you must call
+this function again, with the same parameters; alternatively you
+could provide a \fBNULL\fP pointer for data, and 0 for size.
+.SH "RETURNS"
+The number of bytes sent, or a negative 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_ia_set_client_avp_function.3

@@ -0,0 +1,61 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_ia_set_client_avp_function" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_ia_set_client_avp_function \- Used to set a AVP callback
+.SH SYNOPSIS
+.B #include <gnutls/extra.h>
+.sp
+.BI "void gnutls_ia_set_client_avp_function(gnutls_ia_client_credentials_t " cred ", gnutls_ia_avp_func " avp_func ");"
+.SH ARGUMENTS
+.IP "gnutls_ia_client_credentials_t cred" 12
+is a \fBgnutls_ia_client_credentials_t\fP structure.
+.IP "gnutls_ia_avp_func avp_func" 12
+is the callback function
+.SH "DESCRIPTION"
+Set the TLS/IA AVP callback handler used for the session.
+
+The AVP callback is called to process AVPs received from the
+server, and to get a new AVP to send to the server.
+
+The callback's function form is:
+int (*avp_func) (gnutls_session_t session, void *ptr,
+const char *last, size_t lastlen,
+char **next, size_t *nextlen);
+
+The \fIsession\fP parameter is the \fBgnutls_session_t\fP structure
+corresponding to the current session.  The \fIptr\fP parameter is the
+application hook pointer, set through
+\fBgnutls_ia_set_client_avp_ptr()\fP.  The AVP received from the server
+is present in \fIlast\fP of \fIlastlen\fP size, which will be \fBNULL\fP on the
+first invocation.  The newly allocated output AVP to send to the
+server should be placed in *\fInext\fP of *\fInextlen\fP size.
+
+The callback may invoke \fBgnutls_ia_permute_inner_secret()\fP to mix any
+generated session keys with the TLS/IA inner secret.
+
+Return 0 (\fBGNUTLS_IA_APPLICATION_PAYLOAD\fP) on success, or a negative
+error code to abort the TLS/IA handshake.
+
+Note that the callback must use allocate the \fInext\fP parameter using
+\fBgnutls_malloc()\fP, because it is released via \fBgnutls_free()\fP by the
+TLS/IA handshake function.
+.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_ia_set_client_avp_ptr.3

@@ -0,0 +1,36 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_ia_set_client_avp_ptr" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_ia_set_client_avp_ptr \- Sets a pointer to be sent to TLS/IA callback
+.SH SYNOPSIS
+.B #include <gnutls/extra.h>
+.sp
+.BI "void gnutls_ia_set_client_avp_ptr(gnutls_ia_client_credentials_t " cred ", void * " ptr ");"
+.SH ARGUMENTS
+.IP "gnutls_ia_client_credentials_t cred" 12
+is a \fBgnutls_ia_client_credentials_t\fP structure.
+.IP "void * ptr" 12
+is the pointer
+.SH "DESCRIPTION"
+Sets the pointer that will be provided to the TLS/IA callback
+function as the first argument.
+.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_ia_set_server_avp_function.3

@@ -0,0 +1,68 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_ia_set_server_avp_function" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_ia_set_server_avp_function \- Used to set a AVP callback
+.SH SYNOPSIS
+.B #include <gnutls/extra.h>
+.sp
+.BI "void gnutls_ia_set_server_avp_function(gnutls_ia_server_credentials_t " cred ", gnutls_ia_avp_func " avp_func ");"
+.SH ARGUMENTS
+.IP "gnutls_ia_server_credentials_t cred" 12
+is a \fBgnutls_ia_server_credentials_t\fP structure.
+.IP "gnutls_ia_avp_func avp_func" 12
+.SH "DESCRIPTION"
+Set the TLS/IA AVP callback handler used for the session.
+
+The callback's function form is:
+int (*avp_func) (gnutls_session_t session, void *ptr,
+const char *last, size_t lastlen,
+char **next, size_t *nextlen);
+
+The \fIsession\fP parameter is the \fBgnutls_session_t\fP structure
+corresponding to the current session.  The \fIptr\fP parameter is the
+application hook pointer, set through
+\fBgnutls_ia_set_server_avp_ptr()\fP.  The AVP received from the client
+is present in \fIlast\fP of \fIlastlen\fP size.  The newly allocated output
+AVP to send to the client should be placed in *\fInext\fP of *\fInextlen\fP
+size.
+
+The AVP callback is called to process incoming AVPs from the
+client, and to get a new AVP to send to the client.  It can also be
+used to instruct the TLS/IA handshake to do go into the
+Intermediate or Final phases.  It return a negative error code, or
+an \fBgnutls_ia_apptype_t\fP message type.
+
+The callback may invoke \fBgnutls_ia_permute_inner_secret()\fP to mix any
+generated session keys with the TLS/IA inner secret.
+
+Specifically, return \fBGNUTLS_IA_APPLICATION_PAYLOAD\fP (0) to send
+another AVP to the client, return
+\fBGNUTLS_IA_INTERMEDIATE_PHASE_FINISHED\fP (1) to indicate that an
+IntermediatePhaseFinished message should be sent, and return
+\fBGNUTLS_IA_FINAL_PHASE_FINISHED\fP (2) to indicate that an
+FinalPhaseFinished message should be sent.  In the last two cases,
+the contents of the \fInext\fP and \fInextlen\fP parameter is not used.
+
+Note that the callback must use allocate the \fInext\fP parameter using
+\fBgnutls_malloc()\fP, because it is released via \fBgnutls_free()\fP by the
+TLS/IA handshake function.
+.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_ia_set_server_avp_ptr.3

@@ -0,0 +1,36 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_ia_set_server_avp_ptr" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_ia_set_server_avp_ptr \- Sets a pointer to be sent to TLS/IA callback
+.SH SYNOPSIS
+.B #include <gnutls/extra.h>
+.sp
+.BI "void gnutls_ia_set_server_avp_ptr(gnutls_ia_server_credentials_t " cred ", void * " ptr ");"
+.SH ARGUMENTS
+.IP "gnutls_ia_server_credentials_t cred" 12
+is a \fBgnutls_ia_client_credentials_t\fP structure.
+.IP "void * ptr" 12
+is the pointer
+.SH "DESCRIPTION"
+Sets the pointer that will be provided to the TLS/IA callback
+function as the first argument.
+.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_ia_verify_endphase.3

@@ -0,0 +1,45 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_ia_verify_endphase" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_ia_verify_endphase \- API function
+.SH SYNOPSIS
+.B #include <gnutls/extra.h>
+.sp
+.BI "int gnutls_ia_verify_endphase(gnutls_session_t " session ", const char * " checksum ");"
+.SH ARGUMENTS
+.IP "gnutls_session_t session" 12
+is a \fBgnutls_session_t\fP structure.
+.IP "const char * checksum" 12
+12-byte checksum data, received from \fBgnutls_ia_recv()\fP.
+.SH "DESCRIPTION"
+Verify TLS/IA end phase checksum data.  If verification fails, the
+\fBGNUTLS_A_INNER_APPLICATION_VERIFICATION\fP alert is sent to the other
+sie.
+
+This function is called when \fBgnutls_ia_recv()\fP return
+\fBGNUTLS_E_WARNING_IA_IPHF_RECEIVED\fP or
+\fBGNUTLS_E_WARNING_IA_FPHF_RECEIVED\fP.
+.SH "RETURN VALUE"
+Return 0 on successful verification, or an error
+code.  If the checksum verification of the end phase message fails,
+\fBGNUTLS_E_IA_VERIFY_FAILED\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_init.3

@@ -0,0 +1,42 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "gnutls_init" 3 "2.4.2" "gnutls" "gnutls"
+.SH NAME
+gnutls_init \- initialize the session to null (null encryption etc...).
+.SH SYNOPSIS
+.B #include <gnutls/gnutls.h>
+.sp
+.BI "int gnutls_init(gnutls_session_t * " session ", gnutls_connection_end_t " con_end ");"
+.SH ARGUMENTS
+.IP "gnutls_session_t * session" 12
+is a pointer to a \fBgnutls_session_t\fP structure.
+.IP "gnutls_connection_end_t con_end" 12
+indicate if this session is to be used for server or client.
+.SH "DESCRIPTION"
+This function initializes the current session to null. Every
+session must be initialized before use, so internal structures can
+be allocated.  This function allocates structures which can only
+be free'd by calling \fBgnutls_deinit()\fP.  Returns zero on success.
+
+\fIcon_end\fP can be one of \fBGNUTLS_CLIENT\fP and \fBGNUTLS_SERVER\fP.
+.SH "RETURNS"
+\fBGNUTLS_E_SUCCESS\fP 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.