./gnutls-2.8.1-i686/0000755000000000000000000000000011271476461012374 5ustar rootroot./gnutls-2.8.1-i686/usr/0000755000000000000000000000000011271476041013177 5ustar rootroot./gnutls-2.8.1-i686/usr/share/0000755000000000000000000000000011271476230014301 5ustar rootroot./gnutls-2.8.1-i686/usr/share/man/0000755000000000000000000000000011271476044015057 5ustar rootroot./gnutls-2.8.1-i686/usr/share/man/man1/0000755000000000000000000000000011271476043015712 5ustar rootroot./gnutls-2.8.1-i686/usr/share/man/man1/certtool.10000644000000000000000000001050111271476017017625 0ustar rootroot.TH certtool 1 "May 23rd 2005" .SH NAME certtool \- Manipulate certificates and keys. .SH SYNOPSIS certtool [\fIoptions\fR] .SH DESCRIPTION Generate X.509 certificates, certificate requests, and private keys. .SH OPTIONS .SS Program control options .IP "\-d, \-\-debug LEVEL" Specify the debug level. Default is 1. .IP "\-h, \-\-help" Shows this help text .IP "\-v, \-\-version" Shows the program's version .SS Getting information on X.509 certificates .IP "\-i, \-\-certificate\-info" Print information on a certificate. .IP "\-k, \-\-key\-info" Print information on a private key. .IP "\-l, \-\-crl\-info" Print information on a CRL. .IP "\-\-p12\-info" Print information on a PKCS #12 structure. .SS Getting information on Openpgp certificates .IP "\-\-pgp\-\-certificate\-info" Print information on an OpenPGP certificate. .IP "\-\-pgp\-\-key\-info" Print information on an OpenPGP private key. .IP "\-\-pgp\-\-ring\-info" Print information on a keyring. .SS Generating/verifying X.509 certificates/keys .IP "\-c, \-\-generate\-certificate" Generate a signed certificate. .IP "\-e, \-\-verify\-chain" Verify a PEM encoded certificate chain. The last certificate in the chain must be a self signed one. .IP "\-\-generate\-dh\-params" Generate PKCS #3 encoded Diffie-Hellman parameters. .IP "\-\-load\-ca\-certificate FILE" Certificate authority's certificate file to use. .IP "\-\-load\-ca\-privkey FILE" Certificate authority's private key file to use. .IP "\-\-load\-certificate FILE" Certificate file to use. .IP "\-\-load\-privkey FILE" Private key file to use. .IP "\-\-load\-request FILE" Certificate request file to use. .IP "\-p, \-\-generate\-privkey" Generate a private key. .IP "\-q, \-\-generate\-request" Generate a PKCS #10 certificate request. .IP "\-s, \-\-generate\-self\-signed" Generate a self-signed certificate. .IP "\-u, \-\-update\-certificate" Update a signed certificate. .SS Controlling output .IP "\-8, \-\-pkcs8" Use PKCS #8 format for private keys. .IP "\-\-dsa" Generate a DSA key. .IP "\-\-bits BITS" Specify the number of bits for key generation. .IP "\-\-export\-ciphers" Use weak encryption algorithms. .IP "\-\-inraw" Use RAW/DER format for input certificates and private keys. .IP "\-\-infile FILE" Input file. .IP "\-\-outraw" Use RAW/DER format for output certificates and private keys. .IP "\-\-outfile FILE" Output file. .IP "\-\-password PASSWORD" Password to use. .IP "\-\-to\-p12" Generate a PKCS #12 structure. .IP "\-\-template" Use a template file to read input. See the doc/certtool.cfg in the distribution, for an example. .IP "\-\-fix\-key" Some previous versions of certtool generated wrongly the optional parameters in a private key. This may affect programs that used them. To fix an old private key use \-\-key\-info in combination with this parameter. .IP "\-\-v1" When generating a certificate use the X.509 version 1 format. This does not add any extensions (such as indication for a CA) but some programs do need these. .SH EXAMPLES To create a private key, run: .RS .nf $ certtool \-\-generate\-privkey \-\-outfile key.pem .fi .RE To create a certificate request (needed when the certificate is issued by another party), run: .RS .nf $ certtool \-\-generate\-request \-\-load\-privkey key.pem \\ \-\-outfile request.pem .fi .RE To generate a certificate using the previous request, use the command: .RS .nf $ certtool \-\-generate\-certificate \-\-load\-request request.pem \\ \-\-outfile cert.pem \-\-load\-ca\-certificate ca\-cert.pem \\ \-\-load\-ca\-privkey ca\-key.pem .fi .RE To generate a certificate using the private key only, use the command: .RS .nf $ certtool \-\-generate\-certificate \-\-load\-privkey key.pem \\ \-\-outfile cert.pem \-\-load\-ca\-certificate ca\-cert.pem \\ \-\-load\-ca\-privkey ca\-key.pem .fi .RE To view the certificate information, use: .RS .nf $ certtool \-\-certificate\-info \-\-infile cert.pem .fi .RE To generate a PKCS #12 structure using the previous key and certificate, use the command: .RS .nf $ certtool \-\-load\-certificate cert.pem \-\-load\-privkey key.pem \\ \-\-to\-p12 \-\-outder \-\-outfile key.p12 .fi .RE .SH AUTHOR .PP Nikos Mavroyanopoulos and others; see /usr/share/doc/gnutls\-bin/AUTHORS for a complete list. .PP This manual page was written by Ivo Timmermans , for the Debian GNU/Linux system (but may be used by others). ./gnutls-2.8.1-i686/usr/share/man/man1/srptool.10000644000000000000000000000421011271476017017474 0ustar rootroot.TH srptool 1 "February 21st 2005" .SH NAME srptool \- Simple SRP password tool .SH SYNOPSIS srptool [\fIoptions\fR] .SH DESCRIPTION Very simple program that emulates the programs in the Stanford SRP (Secure Remote Password) libraries using GNU TLS. It is intended for use in places where you don't expect SRP authentication to be the used for system users. In brief, to use SRP you need to create two files. These are the password file that holds the users and the verifiers associated with them and the configuration file to hold the group parameters (called tpasswd.conf). .SH OPTIONS .IP "\-\-bits \fIBITS\fR" specify the number of bits for prime numbers (used only when the \fB\-\-create\-conf\fR option is used). .IP "\-\-create\-conf \fIFILE\fR" Generate a tpasswd.conf file. .IP "\-h, \-\-help" Prints a short reminder of the command line options. .IP "\-i, \-\-index \fIINDEX\fR" Specify the index of the parameters in tpasswd.conf to use. .IP "\-p, \-\-passwd \fIFILE\fR" Specify a password file. .IP "\-\-passwd\-conf \fIFILE\fR" Specify a password configuration file. .IP "\-s, \-\-salt \fISALT\fR" Specify salt size for crypt algorithm. .IP "\-u, \-\-username \fIusername\fR" Specify username. .IP "\-\-verify" Just verify password. .SH EXAMPLES To create tpasswd.conf which holds the g and n values for SRP protocol (generator and a large prime), run: .RS .nf $ srptool \-\-create\-conf /etc/tpasswd.conf .fi .RE This command will create /etc/tpasswd and will add user 'test' (you will also be prompted for a password). Verifiers are stored by default in the way libsrp expects. .RS .nf $ srptool \-\-passwd /etc/tpasswd \\ \-\-passwd\-conf /etc/tpasswd.conf \-u test .fi .RE This command will check against a password. If the password matches the one in /etc/tpasswd you will get an ok. .RS .nf $ srptool \-\-passwd /etc/tpasswd \\ \-\-passwd\-conf /etc/tpasswd.conf \-\-verify \-u test .fi .RE .SH AUTHOR .PP Nikos Mavroyanopoulos and others; see /usr/share/doc/gnutls\-bin/AUTHORS for a complete list. .PP This manual page was written by Ivo Timmermans , for the Debian GNU/Linux system (but may be used by others). ./gnutls-2.8.1-i686/usr/share/man/man1/gnutls-cli-debug.10000644000000000000000000000177311271476017021152 0ustar rootroot.TH gnutls\-cli\-debug 1 "December 1st 2003" .SH NAME gnutls\-cli\-debug \- GNU TLS test client, with verbose output .SH SYNOPSIS gnutls\-cli\-debug [\fIoptions\fR] \fIhostname\fI .SH DESCRIPTION Simple client program to set up a TLS connection to some other computer. Like .BR gnutls\-cli (1), it sets up a TLS connection and forwards data from the standard input to the socket. Any information about the TLS control connection is printed to standard error. .SH OPTIONS .IP "\-d, \-\-debug \fIinteger\fR" Enable debugging. .IP "\-p, \-\-port \fIinteger\fR" The port to connect to. .IP "\-h, \-\-help" Prints a short reminder of the command line options. .IP "\-v, \-\-verbose" Even more verbose output. .SH "SEE ALSO" .BR gnutls\-cli (1), .BR gnutls\-serv (1) .SH AUTHOR .PP Nikos Mavroyanopoulos and others; see /usr/share/doc/gnutls-bin/AUTHORS for a complete list. .PP This manual page was written by Ivo Timmermans , for the Debian GNU/Linux system (but may be used by others). ./gnutls-2.8.1-i686/usr/share/man/man1/gnutls-cli.10000644000000000000000000001173711271476017020067 0ustar rootroot.TH gnutls\-cli 1 "December 1st 2003" .SH NAME gnutls\-cli \- GNU TLS test client .SH SYNOPSIS gnutls\-cli [\fIoptions\fR] \fIhostname\fI .SH DESCRIPTION Simple client program to set up a TLS connection to some other computer. It sets up a TLS connection and forwards data from the standard input to the secured socket and vice versa. .SH OPTIONS .SS Program control options .IP "\-d, \-\-debug LEVEL" Specify the debug level. Default is 1. .IP "\-h, \-\-help" Prints a short reminder of the command line options. .IP "\-l, \-\-list" Print a list of the supported algorithms and modes. .IP "\-r, \-\-resume" Connect, establish a session. Connect again and resume this session. .IP "\-s, \-\-starttls" Connect, establish a plain session and start TLS when EOF or a SIGALRM is received. .IP "\-v, \-\-version" Prints the program's version number. .IP "\-V, \-\-verbose" More verbose output. .SS TLS/SSL control options .IP "\-\-priority \fIPRIORITY STRING\fR" TLS algorithms and protocols to enable. Unless the first keyword is "NONE" the defaults are: .IP Protocols: TLS1.1, TLS1.0, and SSL3.0. .IP Compression: NULL. .IP Certificate types: X.509, OpenPGP. .IP You can also use predefined sets of ciphersuites such as: .IP .B "PERFORMANCE" all the "secure" ciphersuites are enabled, limited to 128 bit ciphers and sorted by terms of speed performance. .IP .B "NORMAL" option enables all "secure" ciphersuites. The 256-bit ciphers are included as a fallback only. The ciphers are sorted by security margin. .IP .B "SECURE128" flag enables all "secure" ciphersuites with ciphers up to 128 bits, sorted by security margin. .IP .B "SECURE256" flag enables all "secure" ciphersuites including the 256 bit ciphers, sorted by security margin. .IP .B "EXPORT" all the ciphersuites are enabled, including the low-security 40 bit ciphers. .IP .B "NONE" nothing is enabled. This disables even protocols and compression methods. .IP .IP Special keywords: .IP "!" or "-" appended with an algorithm will remove this algorithm. .IP "+" appended with an algorithm will add this algorithm. .IP "%COMPAT" will enable compatibility features for a server. .IP "%SSL3_RECORD_VERSION" force SSL3.0 record version in the first client hello. This is to avoid buggy servers from terminating connection. .IP To avoid collisions in order to specify a compression algorithm in this string you have to prefix it with "COMP-", protocol versions with "VERS-" and certificate types with "CTYPE-". All other algorithms don't need a prefix. .IP .B Examples: .IP "NORMAL" .IP "NORMAL:%COMPAT" .IP "NORMAL:!AES-128-CBC" .IP "NONE:+VERS-TLS1.0:+AES-128-CBC:+RSA:+SHA1:+COMP-NULL" .IP "\-\-crlf" Send CR LF instead of LF. .IP "\-f, \-\-fingerprint" Send the openpgp fingerprint, instead of the key. .IP "\-p, \-\-port \fIinteger\fR" The port to connect to. .IP "\-\-ciphers \fIcipher1 cipher2...\fR" Ciphers to enable (use \fBgnutls\-cli \-\-list\fR to show the supported ciphers). .IP "\-\-protocols \fIprotocol1 protocol2...\fR" Protocols to enable (use \fBgnutls\-cli \-\-list\fR to show the supported protocols). .IP "\-\-comp \fIcomp1 comp2...\fR" Compression methods to enable (use \fBgnutls\-cli \-\-list\fR to show the supported methods). .IP "\-\-macs \fImac1 mac2...\fR" MACs to enable (use \fBgnutls\-cli \-\-list\fR to show the supported MACs). .IP "\-\-kx \fIkx1 kx2...\fR" Key exchange methods to enable (use \fBgnutls\-cli \-\-list\fR to show the supported methods). .IP "\-\-ctypes \fIcertType1 certType2...\fR" Certificate types to enable (use \fBgnutls\-cli \-\-list\fR to show the supported types). .IP "\-\-recordsize \fIinteger\fR" The maximum record size to advertize. .IP "\-\-disable-extensions" Disable all the TLS extensions. .IP "\-\-print-cert" Print the certificate in PEM format. .IP "\-\-insecure" Don't abort program if server certificates can't be validated. .SS Certificate options .IP "\-\-pgpcertfile \fIFILE\fR" PGP Public Key (certificate) file to use. .IP "\-\-pgpkeyfile \fIFILE\fR" PGP Key file to use. .IP "\-\-pgpkeyring \fIFILE\fR" PGP Key ring file to use. .IP "\-\-pgptrustdb \fIFILE\fR" PGP trustdb file to use. .IP "\-\-pgpsubkey \fIHEX|auto\fR2 PGP subkey to use. .IP "\-\-srppasswd \fIPASSWD\fR" SRP password to use. .IP "\-\-srpusername \fINAME\fR" SRP username to use. .IP "\-\-x509cafile \fIFILE\fR" Certificate file to use. .IP "\-\-x509certfile \fIFILE\fR" X.509 Certificate file to use. .IP "\-\-x509fmtder" Use DER format for certificates .IP "\-\-x509keyfile \fIFILE\fR" X.509 key file to use. .IP "\-\-x509crlfile \fIFILE\fR" X.509 CRL file to use. .IP "\-\-pskusername \fINAME\fR" PSK username to use. .IP "\-\-pskkey \fIKEY\fR" PSK key (in hex) to use. .IP "\-\-opaque-prf-input \fIDATA\fR" Use Opaque PRF Input DATA. .SH "SEE ALSO" .BR gnutls\-cli\-debug (1), .BR gnutls\-serv (1) .SH AUTHOR .PP Nikos Mavroyanopoulos and others; see /usr/share/doc/gnutls\-bin/AUTHORS for a complete list. .PP This manual page was written by Ivo Timmermans , for the Debian GNU/Linux system (but may be used by others). ./gnutls-2.8.1-i686/usr/share/man/man1/psktool.10000644000000000000000000000144111271476017017470 0ustar rootroot.TH psktool 1 "February 21st 2005" .SH NAME psktool \- Simple PSK password tool .SH SYNOPSIS psktool [\fIoptions\fR] .SH DESCRIPTION Very simple program that generates random keys for use with TLS-PSK. The keys are stored in hexadecimal format in a file. .SH OPTIONS .IP "\-\-keysize \fIBYTES\fR" specify the number of bytes of the key .IP "\-p, \-\-passwd \fIFILE\fR" Specify a password file. .IP "\-u, \-\-username \fIusername\fR" Specify username. .IP "\-h, \-\-help" Prints a short reminder of the command line options. .SH EXAMPLES To create a passwd.psk with a user called test for use with gnuTLS run: .RS .nf $ psktool \-\-passwd /etc/passwd.psk \-u test .fi .RE .SH AUTHOR .PP Nikos Mavroyanopoulos and others; see /usr/share/doc/gnutls\-bin/AUTHORS for a complete list. ./gnutls-2.8.1-i686/usr/share/man/man1/gnutls-serv.10000644000000000000000000000676011271476017020277 0ustar rootroot.TH gnutls\-serv 1 "December 1st 2003" .SH NAME gnutls\-serv \- GNU TLS test server .SH SYNOPSIS gnutls\-serv [\fIoptions\fR] .SH DESCRIPTION Simple server program that listens to incoming TLS connections. .SH OPTIONS .SS Program control options .IP "\-d, \-\-debug LEVEL" Specify the debug level. Default is 1. .IP "\-h, \-\-help" prints this help .IP "\-l, \-\-list" Print a list of the supported algorithms and modes. .IP "\-q, \-\-quiet" Suppress some messages. .IP "\-v, \-\-version" prints the program's version number .SS Server options .IP "\-p, \-\-port \fIinteger\fR" The port to listen on. .IP "\-\-nodb" Does not use the resume database. .IP "\-\-http" Act as an HTTP Server. .IP "\-\-echo" Act as an Echo Server. .SS TLS/SSL control options .IP "\-\-priority \fIPRIORITY STRING\fR" TLS algorithms and protocols to enable. Unless the first keyword is "NONE" the defaults are: .IP Protocols: TLS1.1, TLS1.0, and SSL3.0. .IP Compression: NULL. .IP Certificate types: X.509, OpenPGP. .IP You can also use predefined sets of ciphersuites such as: .IP .B "PERFORMANCE" all the "secure" ciphersuites are enabled, limited to 128 bit ciphers and sorted by terms of speed performance. .IP .B "NORMAL" option enables all "secure" ciphersuites. The 256-bit ciphers are included as a fallback only. The ciphers are sorted by security margin. .IP .B "SECURE128" flag enables all "secure" ciphersuites with ciphers up to 128 bits, sorted by security margin. .IP .B "SECURE256" flag enables all "secure" ciphersuites including the 256 bit ciphers, sorted by security margin. .IP .B "EXPORT" all the ciphersuites are enabled, including the low-security 40 bit ciphers. .IP .B "NONE" nothing is enabled. This disables even protocols and compression methods. .IP .IP Special keywords: .IP '!' or '-' appended with an algorithm will remove this algorithm. .IP '+' appended with an algorithm will add this algorithm. .IP '%COMPAT' will enable compatibility features for a server. .IP To avoid collisions in order to specify a compression algorithm in this string you have to prefix it with "COMP-", protocol versions with "VERS-" and certificate types with "CTYPE-". All other algorithms don't need a prefix. .IP .B Examples: .IP "NORMAL" .IP "NORMAL:%COMPAT" .IP "NORMAL:!AES-128-CBC" .IP "NONE:+VERS-TLS1.0:+AES-128-CBC:+RSA:+SHA1:+COMP-NULL" .IP "\-g, \-\-generate" Generate Diffie-Hellman Parameters. .IP "\-\-kx \fIkx1 kx2...\fR" Key exchange methods to enable (use \fBgnutls\-cli \-\-list\fR to show the supported key exchange methods). .IP "\-p, \-\-port \fIinteger\fR" The port to connect to. .SS Certificate options .IP "\-\-pgpcertfile \fIFILE\fR" PGP Public Key (certificate) file to use. .IP "\-\-pgpkeyfile \fIFILE\fR" PGP Key file to use. .IP "\-\-pgpkeyring \fIFILE\fR" PGP Key ring file to use. .IP "\-\-pgptrustdb \fIFILE\fR" PGP trustdb file to use. .IP "\-\-srppasswd \fIFILE\fR" SRP password file to use. .IP "\-\-srppasswdconf \fIFILE\fR" SRP password configuration file to use. .IP "\-\-x509cafile \fIFILE\fR" Certificate file to use. .IP "\-\-x509certfile \fIFILE\fR" X.509 Certificate file to use. .IP "\-\-x509fmtder" Use DER format for certificates .IP "\-\-x509keyfile \fIFILE\fR" X.509 key file to use. .SH "SEE ALSO" .BR gnutls\-cli (1), .BR gnutls\-cli\-debug (1) .SH AUTHOR .PP Nikos Mavroyanopoulos and others; see /usr/share/doc/gnutls\-bin/AUTHORS for a complete list. .PP This manual page was written by Ivo Timmermans , for the Debian GNU/Linux system (but may be used by others). ./gnutls-2.8.1-i686/usr/share/man/man3/0000755000000000000000000000000011271476230015712 5ustar rootroot./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_dh_get_pubkey.30000644000000000000000000000271311271476020022203 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_dh_get_pubkey" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_dh_get_pubkey \- return the peer's public key used in DH authentication .SH SYNOPSIS .B #include .sp .BI "int gnutls_dh_get_pubkey(gnutls_session_t " session ", gnutls_datum_t * " raw_key ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .IP "gnutls_datum_t * raw_key" 12 will hold the public key. .SH "DESCRIPTION" This function will return the peer's public key used in the last Diffie\-Hellman authentication. This function should be used for both anonymous and ephemeral Diffie\-Hellman. The output parameters must be freed with \fBgnutls_free()\fP. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_srp_free_client_credentials.30000644000000000000000000000241111271476020025105 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_srp_free_client_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_srp_free_client_credentials \- Used to free an allocated gnutls_srp_client_credentials_t structure .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_credentials_clear.30000644000000000000000000000215011271476020023030 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_credentials_clear" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_credentials_clear \- Clears all the credentials previously set .SH SYNOPSIS .B #include .sp .BI "void gnutls_credentials_clear(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Clears all the credentials previously set in this session. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_verify_self.30000644000000000000000000000274011271476020024307 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_verify_self" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_verify_self \- Verify the self signature on the key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_verify_self(gnutls_openpgp_crt_t " key ", unsigned int " flags ", unsigned int * " verify ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the structure that holds the key. .IP "unsigned int flags" 12 unused (should be 0) .IP "unsigned int * verify" 12 will hold the key verification output. .SH "DESCRIPTION" Verifies the self signature in the key. The key verification output will be put in \fIverify\fP and will be one or more of the gnutls_certificate_status_t enumerated elements bitwise or'd. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_db_remove_session.30000644000000000000000000000260411271476020023076 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_db_remove_session" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_db_remove_session \- remove the current session data from the database .SH SYNOPSIS .B #include .sp .BI "void gnutls_db_remove_session(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" This function will remove the current session data from the session database. This will prevent future handshakes reusing these session data. This function should be called if a session was terminated abnormally, and before \fBgnutls_deinit()\fP is called. Normally \fBgnutls_deinit()\fP will remove abnormally terminated sessions. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_check_hostname.30000644000000000000000000000270511271476020024746 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_check_hostname" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_check_hostname \- compare hostname with the key's hostname .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_check_hostname(gnutls_openpgp_crt_t " key ", const char * " hostname ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 should contain an \fBgnutls_openpgp_crt_t\fP structure .IP "const char * hostname" 12 A null terminated string that contains a DNS name .SH "DESCRIPTION" This function will check if the given key's owner matches the given hostname. This is a basic implementation of the matching described in RFC2818 (HTTPS), which takes into account wildcards. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_key_id.30000644000000000000000000000235511271476020024077 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_key_id \- Gets the keyID .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_key_id(gnutls_openpgp_crt_t " key ", gnutls_openpgp_keyid_t " keyid ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the structure that contains the OpenPGP public key. .IP "gnutls_openpgp_keyid_t keyid" 12 the buffer to save the keyid. .SH "DESCRIPTION" Get key id string. .SH "RETURNS" the 64\-bit keyID of the OpenPGP key. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_client_set_retrieve_function.30000644000000000000000000000475411271476020027706 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_client_set_retrieve_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_client_set_retrieve_function \- Used to set a callback to retrieve the certificate .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_client_set_retrieve_function(gnutls_certificate_credentials_t " cred ", gnutls_certificate_client_retrieve_function * " func ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t cred" 12 is a \fBgnutls_certificate_credentials_t\fP structure. .IP "gnutls_certificate_client_retrieve_function * func" 12 is the callback function .SH "DESCRIPTION" This function sets a callback to be called in order to retrieve the certificate to be used in the handshake. The callback's function prototype is: int (*callback)(gnutls_session_t, const gnutls_datum_t* req_ca_dn, int nreqs, const gnutls_pk_algorithm_t* pk_algos, int pk_algos_length, gnutls_retr_st* st); \fIreq_ca_cert\fP is only used in X.509 certificates. Contains a list with the CA names that the server considers trusted. Normally we should send a certificate that is signed by one of these CAs. These names are DER encoded. To get a more meaningful value use the function \fBgnutls_x509_rdn_get()\fP. \fIpk_algos\fP contains a list with server's acceptable signature algorithms. The certificate returned should support the server's given algorithms. \fIst\fP should contain the certificates and private keys. If the callback function is provided then gnutls will call it, in the handshake, after the certificate request message has been received. The callback function should set the certificate list to be sent, and return 0 on success. If no certificate was selected then the number of certificates should be set to zero. The value (\-1) indicates error and the handshake will be terminated. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_cpy_crl_dist_points.30000644000000000000000000000271311271476020025101 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_cpy_crl_dist_points" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_cpy_crl_dist_points \- Copy the CRL dist points .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_cpy_crl_dist_points(gnutls_x509_crt_t " dst ", gnutls_x509_crt_t " src ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t dst" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "gnutls_x509_crt_t src" 12 the certificate where the dist points will be copied from .SH "DESCRIPTION" This function will copy the CRL distribution points certificate extension, from the source to the destination certificate. This may be useful to copy from a CA certificate to issued ones. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_psk_free_client_credentials.30000644000000000000000000000241111271476020025076 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_psk_free_client_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_psk_free_client_credentials \- Used to free an allocated gnutls_psk_client_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_psk_free_client_credentials(gnutls_psk_client_credentials_t " sc ");" .SH ARGUMENTS .IP "gnutls_psk_client_credentials_t sc" 12 is an \fBgnutls_psk_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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_print.30000644000000000000000000000301111271476020022150 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_print" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_print \- Pretty print PKCS 10 certificate request .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_print(gnutls_x509_crq_t " crq ", gnutls_certificate_print_formats_t " format ", gnutls_datum_t * " out ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 The structure to be printed .IP "gnutls_certificate_print_formats_t format" 12 Indicate the format to use .IP "gnutls_datum_t * out" 12 Newly allocated datum with zero terminated string. .SH "DESCRIPTION" This function will pretty print a certificate request, suitable for display to a human. The output \fIout\fP needs to be deallocate using \fBgnutls_free()\fP. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_serial.30000644000000000000000000000321011271476020023136 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_serial" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_serial \- This function returns the certificate's serial number .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_issuer.30000644000000000000000000000272511271476020023203 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_issuer" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_issuer \- API function .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_issuer(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 Issuer 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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_record_check_pending.30000644000000000000000000000256611271476020023517 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_record_check_pending" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_record_check_pending \- checks if there are any data to receive in gnutls buffers. .SH SYNOPSIS .B #include .sp .BI "size_t gnutls_record_check_pending(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" This function checks if there are any data to receive in the gnutls buffers. Notice that you may also use \fBselect()\fP to check for data in a TCP connection, instead of this function. GnuTLS leaves some data in the tcp buffer in order for select to work. .SH "RETURNS" the size of that data or 0. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_set_default_export_priority.30000644000000000000000000000330611271476020025232 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_set_default_export_priority" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_set_default_export_priority \- Sets some default priority on the cipher suites supported by gnutls. .SH SYNOPSIS .B #include .sp .BI "int gnutls_set_default_export_priority(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Sets some default priority on the ciphers, key exchange methods, macs and compression methods. This function also includes weak algorithms. .SH "THIS IS THE SAME AS CALLING" gnutls_priority_set_direct (session, "EXPORT", NULL); This function is kept around for backwards compatibility, but because of its wide use it is still fully supported. If you wish to allow users to provide a string that specify which ciphers to use (which is recommended), you should use \fBgnutls_priority_set_direct()\fP or \fBgnutls_priority_set()\fP instead. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_dh_params_generate2.30000644000000000000000000000332011271476020023257 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_dh_params_generate2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_dh_params_generate2 \- generate new DH parameters .SH SYNOPSIS .B #include .sp .BI "int gnutls_dh_params_generate2(gnutls_dh_params_t " params ", unsigned int " bits ");" .SH ARGUMENTS .IP "gnutls_dh_params_t params" 12 Is the structure that the DH parameters will be stored .IP "unsigned int bits" 12 is the prime's number of bits .SH "DESCRIPTION" This function will generate a new pair of prime and generator for use in the Diffie\-Hellman key exchange. The new parameters will be allocated using \fBgnutls_malloc()\fP and will be stored in the appropriate datum. This function is normally slow. Note that the bits value should be one of 768, 1024, 2048, 3072 or 4096. Also note that the DH parameters are only useful to servers. Since clients use the parameters sent by the server, it's of no use to call this in client side. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_get_authority_key_id.30000644000000000000000000000333411271476020025232 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_get_authority_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_get_authority_key_id \- get the CRL authority's identifier .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_get_authority_key_id(gnutls_x509_crl_t " crl ", void * " ret ", size_t * " ret_size ", unsigned int * " critical ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a \fBgnutls_x509_crl_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 CRL authority's key identifier. This is obtained by the X.509 Authority Key identifier extension field (2.5.29.35). Note that this function only returns the keyIdentifier field of the extension. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative value in case of an error. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_verify_peers2.30000644000000000000000000000411611271476020024517 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_verify_peers2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_verify_peers2 \- return the peer's certificate verification status .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_verify_peers2(gnutls_session_t " session ", unsigned int * " status ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .IP "unsigned int * status" 12 is the output of the verification .SH "DESCRIPTION" This function will try to verify the peer's certificate and return its status (trusted, invalid etc.). The value of \fIstatus\fP should be one or more of the gnutls_certificate_status_t enumerated elements bitwise or'd. To avoid denial of service attacks some default upper limits regarding the certificate key size and chain size are set. To override them use \fBgnutls_certificate_set_verify_limits()\fP. Note that you must also check the peer's name in order to check if the verified certificate belongs to the actual peer. This function uses \fBgnutls_x509_crt_list_verify()\fP with the CAs in the credentials as trusted CAs. Note that some commonly used X.509 Certificate Authorities are still using Version 1 certificates. If you want to accept them, you need to call \fBgnutls_certificate_set_verify_flags()\fP with, e.g., \fBGNUTLS_VERIFY_ALLOW_X509_V1_CA_CRT\fP parameter. .SH "RETURNS" a negative error code on error and zero on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_import.30000644000000000000000000000310111271476020023232 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_import" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_import \- import a DER or PEM encoded key .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_sign_callback_set.30000644000000000000000000000325011271476020023016 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_sign_callback_set" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_sign_callback_set \- API function .SH SYNOPSIS .B #include .sp .BI "void gnutls_sign_callback_set(gnutls_session_t " session ", gnutls_sign_func " sign_func ", void * " userdata ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .IP "gnutls_sign_func sign_func" 12 function pointer to application's sign callback. .IP "void * userdata" 12 void pointer that will be passed to sign callback. .SH "DESCRIPTION" Set the callback function. The function must have this prototype: typedef int (*gnutls_sign_func) (gnutls_session_t session, void *userdata, gnutls_certificate_type_t cert_type, const gnutls_datum_t * cert, const gnutls_datum_t * hash, gnutls_datum_t * signature); The \fIuserdata\fP parameter is passed to the \fIsign_func\fP verbatim, and can be used to store application\-specific data needed in the callback function. See also \fBgnutls_sign_callback_get()\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_type_list.30000644000000000000000000000245111271476020023747 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_type_list" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_type_list \- Get a list of supported certificate types .SH SYNOPSIS .B #include .sp .BI "const gnutls_certificate_type_t * gnutls_certificate_type_list( " void ");" .SH ARGUMENTS .IP " void" 12 .SH "DESCRIPTION" Get a list of certificate types. Note that to be able to use OpenPGP certificates, you must link to libgnutls\-extra and call \fBgnutls_global_init_extra()\fP. .SH "RETURNS" a zero\-terminated list of \fBgnutls_certificate_type_t\fP integers indicating the available certificate types. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_import_dsa_raw.30000644000000000000000000000324311271476020024741 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_import_dsa_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_import_dsa_raw \- import a raw DSA key .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_server_set_request.30000644000000000000000000000304411271476020025663 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_server_set_request" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_server_set_request \- Used to set whether to request a client certificate .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_server_set_request(gnutls_session_t " session ", gnutls_certificate_request_t " req ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is an \fBgnutls_session_t\fP structure. .IP "gnutls_certificate_request_t req" 12 is one of GNUTLS_CERT_REQUEST, GNUTLS_CERT_REQUIRE .SH "DESCRIPTION" This function specifies if we (in case of a server) are going to send a certificate request message to the client. If \fIreq\fP is GNUTLS_CERT_REQUIRE then the server will return an error if the peer does not provide a certificate. If you do not call this function then the client will not be asked to send a certificate. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs7_export.30000644000000000000000000000336511271476020022026 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs7_export" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs7_export \- export the pkcs7 structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs7_export(gnutls_pkcs7_t " pkcs7 ", gnutls_x509_crt_fmt_t " format ", void * " output_data ", size_t * " output_data_size ");" .SH ARGUMENTS .IP "gnutls_pkcs7_t pkcs7" 12 Holds the pkcs7 structure .IP "gnutls_x509_crt_fmt_t format" 12 the format of output params. One of PEM or DER. .IP "void * output_data" 12 will contain a structure PEM or DER encoded .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 export the pkcs7 structure to DER or PEM format. 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. If the structure is PEM encoded, it will have a header of "BEGIN PKCS7". .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_deinit.30000644000000000000000000000215111271476020022274 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_deinit" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_deinit \- This function deinitializes memory used by a gnutls_x509_crq_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_x509_crq_deinit(gnutls_x509_crq_t " crq ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 The structure to be initialized .SH "DESCRIPTION" This function will deinitialize a CRL structure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_sign2.30000644000000000000000000000344211271476020022041 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_sign2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_sign2 \- This function will sign a CRL with a key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_sign2(gnutls_x509_crl_t " crl ", gnutls_x509_crt_t " issuer ", gnutls_x509_privkey_t " issuer_key ", gnutls_digest_algorithm_t " dig ", unsigned int " flags ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a gnutls_x509_crl_t structure .IP "gnutls_x509_crt_t issuer" 12 is the certificate of the certificate issuer .IP "gnutls_x509_privkey_t issuer_key" 12 holds the issuer's private key .IP "gnutls_digest_algorithm_t dig" 12 The message digest to use. GNUTLS_DIG_SHA1 is the safe choice unless you know what you're doing. .IP "unsigned int flags" 12 must be 0 .SH "DESCRIPTION" This function will sign the CRL with the issuer's private key, and will copy the issuer's information into the CRL. This must be the last step in a certificate CRL since all the previously set parameters are now signed. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_cipher_suite_info.30000644000000000000000000000407011271476020023066 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_cipher_suite_info" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_cipher_suite_info \- API function .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_cipher_suite_info(size_t " idx ", char * " cs_id ", gnutls_kx_algorithm_t * " kx ", gnutls_cipher_algorithm_t * " cipher ", gnutls_mac_algorithm_t * " mac ", gnutls_protocol_t * " version ");" .SH ARGUMENTS .IP "size_t idx" 12 index of cipher suite to get information about, starts on 0. .IP "char * cs_id" 12 output buffer with room for 2 bytes, indicating cipher suite value .IP "gnutls_kx_algorithm_t * kx" 12 output variable indicating key exchange algorithm, or \fBNULL\fP. .IP "gnutls_cipher_algorithm_t * cipher" 12 output variable indicating cipher, or \fBNULL\fP. .IP "gnutls_mac_algorithm_t * mac" 12 output variable indicating MAC algorithm, or \fBNULL\fP. .IP "gnutls_protocol_t * version" 12 output variable indicating TLS protocol version, or \fBNULL\fP. .SH "DESCRIPTION" Get information about supported cipher suites. Use the function iteratively to get information about all supported cipher suites. Call with idx=0 to get information about first cipher suite, then idx=1 and so on until the function returns NULL. .SH "RETURNS" the name of \fIidx\fP cipher suite, and set the information about the cipher suite in the output variables. If \fIidx\fP is out of bounds, \fBNULL\fP is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_export.30000644000000000000000000000317511271476020023316 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_export" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_export \- export a RAW or BASE64 encoded key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_export(gnutls_openpgp_crt_t " key ", gnutls_openpgp_crt_fmt_t " format ", void * " output_data ", size_t * " output_data_size ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 Holds the key. .IP "gnutls_openpgp_crt_fmt_t format" 12 One of gnutls_openpgp_crt_fmt_t elements. .IP "void * output_data" 12 will contain the key base64 encoded or raw .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 convert the given key to RAW or Base64 format. If the buffer provided is not long enough to hold the output, then \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP will be returned. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_dn_by_oid.30000644000000000000000000000376111271476020023634 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_dn_by_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_dn_by_oid \- Set the Certificate request subject's distinguished name .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_dn_by_oid(gnutls_x509_crt_t " crt ", const char * " oid ", unsigned int " raw_flag ", const void * " name ", unsigned int " sizeof_name ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "const char * oid" 12 holds an Object Identifier in a null terminated string .IP "unsigned int raw_flag" 12 must be 0, or 1 if the data are DER encoded .IP "const void * name" 12 a pointer to the name .IP "unsigned int sizeof_name" 12 holds the size of \fIname\fP .SH "DESCRIPTION" This function will set the part of the name of the Certificate subject, specified by the given OID. The input string should be ASCII or UTF\-8 encoded. Some helper macros with popular OIDs can be found in gnutls/x509.h With this function you can only set the known OIDs. You can test for known OIDs using \fBgnutls_x509_dn_oid_known()\fP. For OIDs that are not known (by gnutls) you should properly DER encode your data, and call this function with \fIraw_flag\fP set. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_export_subkey_rsa_raw.30000644000000000000000000000363011271476020027313 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_export_subkey_rsa_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_export_subkey_rsa_raw \- export the RSA private key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_export_subkey_rsa_raw(gnutls_openpgp_privkey_t " pkey ", unsigned int " idx ", gnutls_datum_t * " m ", gnutls_datum_t * " e ", gnutls_datum_t * " d ", gnutls_datum_t * " p ", gnutls_datum_t * " q ", gnutls_datum_t * " u ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t pkey" 12 Holds the certificate .IP "unsigned int idx" 12 Is the subkey index .IP "gnutls_datum_t * m" 12 will hold the modulus .IP "gnutls_datum_t * e" 12 will hold the public exponent .IP "gnutls_datum_t * d" 12 will hold the private exponent .IP "gnutls_datum_t * p" 12 will hold the first prime (p) .IP "gnutls_datum_t * q" 12 will hold the second prime (q) .IP "gnutls_datum_t * u" 12 will hold the coefficient .SH "DESCRIPTION" This function will export the RSA private key's parameters found in the given structure. The new parameters will be allocated using \fBgnutls_malloc()\fP and will be stored in the appropriate datum. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_srp_allocate_server_credentials.30000644000000000000000000000255211271476020026006 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_srp_allocate_server_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_srp_allocate_server_credentials \- Used to allocate an gnutls_srp_server_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_srp_allocate_server_credentials(gnutls_srp_server_credentials_t * " sc ");" .SH ARGUMENTS .IP "gnutls_srp_server_credentials_t * sc" 12 is a pointer to 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 allocate it. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_rsa_params_export_pkcs1.30000644000000000000000000000345611271476020024231 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_rsa_params_export_pkcs1" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_rsa_params_export_pkcs1 \- export RSA params to a pkcs1 structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_rsa_params_export_pkcs1(gnutls_rsa_params_t " params ", gnutls_x509_crt_fmt_t " format ", unsigned char * " params_data ", size_t * " params_data_size ");" .SH ARGUMENTS .IP "gnutls_rsa_params_t params" 12 Holds the RSA parameters .IP "gnutls_x509_crt_fmt_t format" 12 the format of output params. One of PEM or DER. .IP "unsigned char * params_data" 12 will contain a PKCS1 RSAPublicKey structure PEM or DER encoded .IP "size_t * params_data_size" 12 holds the size of params_data (and will be replaced by the actual size of parameters) .SH "DESCRIPTION" This function will export the given RSA parameters to a PKCS1 RSAPublicKey structure. If the buffer provided is not long enough to hold the output, then GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. If the structure is PEM encoded, it will have a header of "BEGIN RSA PRIVATE KEY". .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an negative error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_type_get_id.30000644000000000000000000000237711271476020024236 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_type_get_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_type_get_id \- Returns the gnutls id of the specified in string type .SH SYNOPSIS .B #include .sp .BI "gnutls_certificate_type_t gnutls_certificate_type_get_id(const char * " name ");" .SH ARGUMENTS .IP "const char * name" 12 is a certificate type name .SH "DESCRIPTION" The names are compared in a case insensitive way. .SH "RETURNS" an \fBgnutls_certificate_type_t\fP for the specified in a string certificate type, or \fBGNUTLS_CRT_UNKNOWN\fP on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_crq_extensions.30000644000000000000000000000253511271476020024750 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_crq_extensions" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_crq_extensions \- Associate the Certificate with a request .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_crq_extensions(gnutls_x509_crt_t " crt ", gnutls_x509_crq_t " crq ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "gnutls_x509_crq_t crq" 12 holds a certificate request .SH "DESCRIPTION" This function will set extensions from the given request to the certificate. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_ca_status.30000644000000000000000000000332211271476020023651 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_ca_status" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_ca_status \- This function returns the certificate CA status .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_ca_status(gnutls_x509_crt_t " cert ", unsigned int * " critical ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "unsigned int * critical" 12 will be non zero if the extension is marked as critical .SH "DESCRIPTION" This function will return certificates CA status, by reading the basicConstraints X.509 extension (2.5.29.19). If the certificate is a CA a positive value will be returned, or zero if the certificate does not have CA flag set. Use \fBgnutls_x509_crt_get_basic_constraints()\fP if you want to read the pathLenConstraint field too. .SH "RETURNS" A negative value may be returned in case of parsing error. If the certificate does not contain the basicConstraints extension \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_get_next_update.30000644000000000000000000000242711271476020024200 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_get_next_update" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_get_next_update \- return the CRL's nextUpdate time .SH SYNOPSIS .B #include .sp .BI "time_t gnutls_x509_crl_get_next_update(gnutls_x509_crl_t " crl ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a \fBgnutls_x509_crl_t\fP structure .SH "DESCRIPTION" This function will return the time the next CRL will be issued. This field is optional in a CRL so it might be normal to get an error instead. .SH "RETURNS" when the next CRL will be issued, or (time_t)\-1 on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_psk_allocate_client_credentials.30000644000000000000000000000253111271476020025744 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_psk_allocate_client_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_psk_allocate_client_credentials \- Used to allocate an gnutls_psk_server_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_psk_allocate_client_credentials(gnutls_psk_client_credentials_t * " sc ");" .SH ARGUMENTS .IP "gnutls_psk_client_credentials_t * sc" 12 is a pointer to an \fBgnutls_psk_server_credentials_t\fP structure. .SH "DESCRIPTION" This structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_sign_get_id.30000644000000000000000000000234011271476020021641 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_sign_get_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_sign_get_id \- Returns the gnutls id of the specified in signature algorithm .SH SYNOPSIS .B #include .sp .BI "gnutls_sign_algorithm_t gnutls_sign_get_id(const char * " name ");" .SH ARGUMENTS .IP "const char * name" 12 is a MAC algorithm name .SH "DESCRIPTION" The names are compared in a case insensitive way. .SH "RETURNS" return a \fBgnutls_sign_algorithm_t\fP value corresponding to the specified cipher, or \fBGNUTLS_SIGN_UNKNOWN\fP on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_export_pkcs8.30000644000000000000000000000455311271476020024365 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_export_pkcs8" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_export_pkcs8 \- This function will export the private key to PKCS8 format .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_privkey_export_pkcs8(gnutls_x509_privkey_t " key ", gnutls_x509_crt_fmt_t " format ", const char * " password ", unsigned int " flags ", void * " output_data ", size_t * " output_data_size ");" .SH ARGUMENTS .IP "gnutls_x509_privkey_t key" 12 Holds the key .IP "gnutls_x509_crt_fmt_t format" 12 the format of output params. One of PEM or DER. .IP "const char * password" 12 the password that will be used to encrypt the key. .IP "unsigned int flags" 12 an ORed sequence of gnutls_pkcs_encrypt_flags_t .IP "void * output_data" 12 will contain a private key PEM or DER encoded .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 export the private key to a PKCS8 structure. Both RSA and DSA keys can be exported. For DSA keys we use PKCS \fB11\fP definitions. If the flags do not specify the encryption cipher, then the default 3DES (PBES2) will be used. The \fIpassword\fP can be either ASCII or UTF\-8 in the default PBES2 encryption schemas, or ASCII for the PKCS12 schemas. If the buffer provided is not long enough to hold the output, then *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. If the structure is PEM encoded, it will have a header of "BEGIN ENCRYPTED PRIVATE KEY" or "BEGIN PRIVATE KEY" if encryption is not used. .SH "RETURN VALUE" In case of failure a negative value will be returned, and 0 on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_transport_set_global_errno.30000644000000000000000000000345311271476020025030 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_transport_set_global_errno" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_transport_set_global_errno \- API function .SH SYNOPSIS .B #include .sp .BI "void gnutls_transport_set_global_errno(int " err ");" .SH ARGUMENTS .IP "int err" 12 error value to store in global errno variable. .SH "DESCRIPTION" Store \fIerr\fP in the global errno variable. Useful values for \fIerr\fP is EAGAIN and EINTR, other values are treated will be treated as real errors in the push/pull function. This function is useful in replacement push/pull functions set by gnutls_transport_set_push_function and gnutls_transport_set_pullpush_function under Windows, where the replacement push/pull may not have access to the same \fIerrno\fP variable that is used by GnuTLS (e.g., the application is linked to msvcr71.dll and gnutls is linked to msvcrt.dll). Whether this function is thread safe or not depends on whether the global variable errno is thread safe, some system libraries make it a thread\-local variable. When feasible, using the guaranteed thread\-safe \fBgnutls_transport_set_errno()\fP may be better. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_set_key_purpose_oid.30000644000000000000000000000322011271476020025071 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_set_key_purpose_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_set_key_purpose_oid \- Sets the Certificate's key purpose OIDs .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_set_key_purpose_oid(gnutls_x509_crq_t " cert ", const void * " oid ", unsigned int " critical ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t cert" 12 a certificate of type \fBgnutls_x509_crq_t\fP .IP "const void * oid" 12 a pointer to a null terminated string that holds the OID .IP "unsigned int critical" 12 Whether this extension will be critical or not .SH "DESCRIPTION" This function will set the key purpose OIDs of the Certificate. These are stored in the Extended Key Usage extension (2.5.29.37) See the GNUTLS_KP_* definitions for human readable names. Subsequent calls to this function will append OIDs to the OID list. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_signature.30000644000000000000000000000267411271476020023675 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_signature" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_signature \- Returns the Certificate's signature .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ext_register.30000644000000000000000000000316611271476020022101 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ext_register" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ext_register \- Register a handler for a TLS extension .SH SYNOPSIS .B #include .sp .BI "int gnutls_ext_register(int " type ", const char * " name ", gnutls_ext_parse_type_t " parse_type ", gnutls_ext_recv_func " recv_func ", gnutls_ext_send_func " send_func ");" .SH ARGUMENTS .IP "int type" 12 the 16\-bit integer referring to the extension type .IP "const char * name" 12 human printable name of the extension used for debugging .IP "gnutls_ext_parse_type_t parse_type" 12 either \fBGNUTLS_EXT_TLS\fP or \fBGNUTLS_EXT_APPLICATION\fP. .IP "gnutls_ext_recv_func recv_func" 12 a function to receive extension data .IP "gnutls_ext_send_func send_func" 12 a function to send extension data .SH "DESCRIPTION" This function is used to register a new TLS extension handler. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs7_get_crt_raw.30000644000000000000000000000337411271476020023005 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs7_get_crt_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs7_get_crt_raw \- get a certificate from a PKCS7 certificate set .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs7_get_crt_raw(gnutls_pkcs7_t " pkcs7 ", int " indx ", void * " certificate ", size_t * " certificate_size ");" .SH ARGUMENTS .IP "gnutls_pkcs7_t pkcs7" 12 should contain a gnutls_pkcs7_t structure .IP "int indx" 12 contains the index of the certificate to extract .IP "void * certificate" 12 the contents of the certificate will be copied there (may be null) .IP "size_t * certificate_size" 12 should hold the size of the certificate .SH "DESCRIPTION" This function will return a certificate of the PKCS7 or RFC2630 certificate set. After the last certificate has been read \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. If the provided buffer is not long enough, then \fIcertificate_size\fP is updated and \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_deinit.30000644000000000000000000000215411271476020023203 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_deinit" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_deinit \- deinitializes a #gnutls_x509_privkey_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_x509_privkey_deinit(gnutls_x509_privkey_t " key ");" .SH ARGUMENTS .IP "gnutls_x509_privkey_t key" 12 The structure to be initialized .SH "DESCRIPTION" This function will deinitialize a private key structure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_srp_set_client_credentials.30000644000000000000000000000323411271476020024763 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_srp_set_client_credentials" 3 "2.8.1" "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 .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_crypto_single_cipher_register2.30000644000000000000000000000357011271476020025575 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_crypto_single_cipher_register2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_crypto_single_cipher_register2 \- register a cipher algorithm .SH SYNOPSIS .B #include .sp .BI "int gnutls_crypto_single_cipher_register2(gnutls_cipher_algorithm_t " algorithm ", int " priority ", int " version ", gnutls_crypto_single_cipher_st * " s ");" .SH ARGUMENTS .IP "gnutls_cipher_algorithm_t algorithm" 12 is the gnutls algorithm identifier .IP "int priority" 12 is the priority of the algorithm .IP "int version" 12 should be set to \fBGNUTLS_CRYPTO_API_VERSION\fP .IP "gnutls_crypto_single_cipher_st * s" 12 is a structure holding new cipher's data .SH "DESCRIPTION" This function will register a cipher algorithm to be used by gnutls. Any algorithm registered will override the included algorithms and by convention kernel implemented algorithms have priority of 90. The algorithm with the lowest priority will be used by gnutls. This function should be called before \fBgnutls_global_init()\fP. For simplicity you can use the convenience \fBgnutls_crypto_single_cipher_register()\fP macro. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_deinit.30000644000000000000000000000215311271476020022301 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_deinit" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_deinit \- This function deinitializes memory used by a gnutls_x509_crt_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_x509_crt_deinit(gnutls_x509_crt_t " cert ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 The structure to be initialized .SH "DESCRIPTION" This function will deinitialize a CRL structure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_import.30000644000000000000000000000273511271476020023310 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_import" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_import \- import a RAW or BASE64 encoded key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_import(gnutls_openpgp_crt_t " key ", const gnutls_datum_t * " data ", gnutls_openpgp_crt_fmt_t " format ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 The structure to store the parsed key. .IP "const gnutls_datum_t * data" 12 The RAW or BASE64 encoded key. .IP "gnutls_openpgp_crt_fmt_t format" 12 One of gnutls_openpgp_crt_fmt_t elements. .SH "DESCRIPTION" This function will convert the given RAW or Base64 encoded key to the native \fBgnutls_openpgp_crt_t\fP format. The output will be stored in 'key'. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_sign2.30000644000000000000000000000342011271476020022045 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_sign2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_sign2 \- Sign a certificate with a key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_sign2(gnutls_x509_crt_t " crt ", gnutls_x509_crt_t " issuer ", gnutls_x509_privkey_t " issuer_key ", gnutls_digest_algorithm_t " dig ", unsigned int " flags ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "gnutls_x509_crt_t issuer" 12 is the certificate of the certificate issuer .IP "gnutls_x509_privkey_t issuer_key" 12 holds the issuer's private key .IP "gnutls_digest_algorithm_t dig" 12 The message digest to use, \fBGNUTLS_DIG_SHA1\fP is a safe choice .IP "unsigned int flags" 12 must be 0 .SH "DESCRIPTION" This function will sign the certificate with the issuer's private key, and will copy the issuer's information into the certificate. This must be the last step in a certificate generation since all the previously set parameters are now signed. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_get_fingerprint.30000644000000000000000000000272211271476020026061 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_get_fingerprint" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_get_fingerprint \- Gets the fingerprint .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_get_fingerprint(gnutls_openpgp_privkey_t " key ", void * " fpr ", size_t * " fprlen ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 the raw data that contains the OpenPGP secret key. .IP "void * fpr" 12 the buffer to save the fingerprint, must hold at least 20 bytes. .IP "size_t * fprlen" 12 the integer to save the length of the fingerprint. .SH "DESCRIPTION" Get the fingerprint of the OpenPGP key. Depends on the algorithm, the fingerprint can be 16 or 20 bytes. .SH "RETURNS" On success, 0 is returned, or an error code. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_deinit.30000644000000000000000000000215711271476020023250 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_deinit" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_deinit \- deinitialize memory used by a #gnutls_openpgp_crt_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_openpgp_crt_deinit(gnutls_openpgp_crt_t " key ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 The structure to be initialized .SH "DESCRIPTION" This function will deinitialize a key structure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_endphase_send.30000644000000000000000000000262011271476020022640 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_endphase_send" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_endphase_send \- API function .SH SYNOPSIS .B #include .sp .BI "int gnutls_ia_endphase_send(gnutls_session_t " session ", int " final_p ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "int final_p" 12 Set iff this should signal the final phase. .SH "DESCRIPTION" Send a TLS/IA end phase message. In the client, this should only be used to acknowledge an end phase message sent by the server. In the server, this can be called instead of \fBgnutls_ia_send()\fP if the server wishes to end an application phase. .SH "RETURN VALUE" Return 0 on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_session_set_data.30000644000000000000000000000327011271476020022720 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_session_set_data" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_session_set_data \- Sets all session parameters .SH SYNOPSIS .B #include .sp .BI "int gnutls_session_set_data(gnutls_session_t " session ", const void * " session_data ", size_t " session_data_size ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "const void * session_data" 12 is a pointer to space to hold the session. .IP "size_t session_data_size" 12 is the session's size .SH "DESCRIPTION" Sets all session parameters, in order to resume a previously established session. The session data given must be the one returned by \fBgnutls_session_get_data()\fP. This function should be called before \fBgnutls_handshake()\fP. Keep in mind that session resuming is advisory. The server may choose not to resume the session, thus a full handshake will be performed. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_srp_base64_encode.30000644000000000000000000000321111271476020022651 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_srp_base64_encode" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_srp_base64_encode \- Encode raw data using SRP-Base64 .SH SYNOPSIS .B #include .sp .BI "int gnutls_srp_base64_encode(const gnutls_datum_t * " data ", char * " result ", size_t * " result_size ");" .SH ARGUMENTS .IP "const gnutls_datum_t * data" 12 contain the raw data .IP "char * result" 12 the place where base64 data will be copied .IP "size_t * result_size" 12 holds the size of the result .SH "DESCRIPTION" This function will convert the given data to printable data, using the base64 encoding, as used in the libsrp. This is the encoding used in SRP password files. If the provided buffer is not long enough GNUTLS_E_SHORT_MEMORY_BUFFER is returned. Warning! This base64 encoding is not the "standard" encoding, so do not use it for non\-SRP purposes. .SH "RETURNS" \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP if the buffer given is not long enough, or 0 on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_keyring_check_id.30000644000000000000000000000263411271476020024405 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_keyring_check_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_keyring_check_id \- Check if a key id exists in the keyring .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_keyring_check_id(gnutls_openpgp_keyring_t " ring ", const gnutls_openpgp_keyid_t " keyid ", unsigned int " flags ");" .SH ARGUMENTS .IP "gnutls_openpgp_keyring_t ring" 12 holds the keyring to check against .IP "const gnutls_openpgp_keyid_t keyid" 12 will hold the keyid to check for. .IP "unsigned int flags" 12 unused (should be 0) .SH "DESCRIPTION" Check if a given key ID exists in the keyring. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success (if keyid exists) and a negative error code on failure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_init.30000644000000000000000000000261111271476020021757 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_init" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_init \- initializes a #gnutls_x509_crl_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_init(gnutls_x509_crl_t * " crl ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t * crl" 12 The structure to be initialized .SH "DESCRIPTION" This function will initialize a CRL structure. CRL stands for Certificate Revocation List. A revocation list usually contains lists of certificate serial numbers that have been revoked by an Authority. The revocation lists are always signed with the authority's private key. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_rdn_get.30000644000000000000000000000306511271476020021602 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_rdn_get" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_rdn_get \- parse an RDN sequence and returns a string .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_rdn_get(const gnutls_datum_t * " idn ", char * " buf ", size_t * " sizeof_buf ");" .SH ARGUMENTS .IP "const gnutls_datum_t * idn" 12 should contain a DER encoded RDN sequence .IP "char * buf" 12 a pointer to a structure to hold the peer's name .IP "size_t * sizeof_buf" 12 holds the size of \fIbuf\fP .SH "DESCRIPTION" This function will return the name of the given RDN sequence. The name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described in RFC2253. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, or \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP is returned and *\fIsizeof_buf\fP is updated if the provided buffer is not long enough, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_subject_alt_name.30000644000000000000000000000370711271476020025205 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_subject_alt_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_subject_alt_name \- Set the subject Alternative Name .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_subject_alt_name(gnutls_x509_crt_t " crt ", gnutls_x509_subject_alt_name_t " type ", const void * " data ", unsigned int " data_size ", unsigned int " flags ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "gnutls_x509_subject_alt_name_t type" 12 is one of the gnutls_x509_subject_alt_name_t enumerations .IP "const void * data" 12 The data to be set .IP "unsigned int data_size" 12 The size of data to be set .IP "unsigned int flags" 12 GNUTLS_FSAN_SET to clear previous data or GNUTLS_FSAN_APPEND to append. .SH "DESCRIPTION" This function will set the subject alternative name certificate extension. It can set the following types: &GNUTLS_SAN_DNSNAME: as a text string &GNUTLS_SAN_RFC822NAME: as a text string &GNUTLS_SAN_URI: as a text string &GNUTLS_SAN_IPADDRESS: as a binary IP address (4 or 16 bytes) Other values can be set as binary values with the proper DER encoding. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_anon_free_server_credentials.30000644000000000000000000000242011271476020025264 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_anon_free_server_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_anon_free_server_credentials \- Used to free an allocated gnutls_anon_server_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_anon_free_server_credentials(gnutls_anon_server_credentials_t " sc ");" .SH ARGUMENTS .IP "gnutls_anon_server_credentials_t sc" 12 is an \fBgnutls_anon_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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_dh_params_init.30000644000000000000000000000232011271476020022345 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_dh_params_init" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_dh_params_init \- initialize the DH parameters .SH SYNOPSIS .B #include .sp .BI "int gnutls_dh_params_init(gnutls_dh_params_t * " dh_params ");" .SH ARGUMENTS .IP "gnutls_dh_params_t * dh_params" 12 Is a structure that will hold the prime numbers .SH "DESCRIPTION" This function will initialize the DH parameters structure. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_get_subkey_revoked_status.30000644000000000000000000000257711271476020030166 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_get_subkey_revoked_status" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_get_subkey_revoked_status \- Get the revoked status of the key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_get_subkey_revoked_status(gnutls_openpgp_privkey_t " key ", unsigned int " idx ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 the structure that contains the OpenPGP private key. .IP "unsigned int idx" 12 is the subkey index .SH "DESCRIPTION" Get revocation status of key. .SH "RETURNS" true (1) if the key has been revoked, or false (0) if it has not, or a negative value indicates an error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_check_issuer.30000644000000000000000000000261111271476020023473 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_check_issuer" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_check_issuer \- check if certificate has given issuer .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_check_issuer(gnutls_x509_crt_t " cert ", gnutls_x509_crt_t " issuer ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 is the certificate to be checked .IP "gnutls_x509_crt_t issuer" 12 is the certificate of a possible issuer .SH "DESCRIPTION" This function will check if the given certificate was issued by the given issuer. .SH "RETURNS" It will return true (1) if the given certificate is issued by the given issuer, and false (0) if not. A negative value is returned in case of an error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_compression_get.30000644000000000000000000000232011271476020022564 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_compression_get" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_compression_get \- Returns the currently used compression algorithm. .SH SYNOPSIS .B #include .sp .BI "gnutls_compression_method_t gnutls_compression_get(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Get currently used compression algorithm. .SH "RETURNS" the currently used compression method, a \fBgnutls_compression_method_t\fP value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_get_pk_algorithm.30000644000000000000000000000313311271476020026207 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_get_pk_algorithm" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_get_pk_algorithm \- return the key's PublicKey algorithm .SH SYNOPSIS .B #include .sp .BI "gnutls_pk_algorithm_t gnutls_openpgp_privkey_get_pk_algorithm(gnutls_openpgp_privkey_t " key ", unsigned int * " bits ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 is an OpenPGP key .IP "unsigned int * bits" 12 if bits is non null it will hold the size of the parameters' in bits .SH "DESCRIPTION" This function will return the public key algorithm of an OpenPGP certificate. If bits is non null, it should have enough size to hold the parameters size in bits. For RSA the bits returned is the modulus. For DSA the bits returned are of the public exponent. .SH "RETURNS" a member of the \fBgnutls_pk_algorithm_t\fP enumeration on success, or a negative value on error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_db_set_retrieve_function.30000644000000000000000000000306311271476020024443 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_db_set_retrieve_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_db_set_retrieve_function \- Set the function that will be used to get data .SH SYNOPSIS .B #include .sp .BI "void gnutls_db_set_retrieve_function(gnutls_session_t " session ", gnutls_db_retr_func " retr_func ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "gnutls_db_retr_func retr_func" 12 is the function. .SH "DESCRIPTION" Sets the function that will be used to retrieve data from the resumed sessions database. This function must return a gnutls_datum_t containing the data on success, or a gnutls_datum_t containing null and 0 on failure. The datum's data must be allocated using the function \fBgnutls_malloc()\fP. The first argument to \fBretr_func()\fP will be null unless \fBgnutls_db_set_ptr()\fP has been called. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_get_subkey_pk_algorithm.30000644000000000000000000000330311271476020027570 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_get_subkey_pk_algorithm" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_get_subkey_pk_algorithm \- return the subkey's PublicKey algorithm .SH SYNOPSIS .B #include .sp .BI "gnutls_pk_algorithm_t gnutls_openpgp_privkey_get_subkey_pk_algorithm(gnutls_openpgp_privkey_t " key ", unsigned int " idx ", unsigned int * " bits ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 is an OpenPGP key .IP "unsigned int idx" 12 is the subkey index .IP "unsigned int * bits" 12 if bits is non null it will hold the size of the parameters' in bits .SH "DESCRIPTION" This function will return the public key algorithm of a subkey of an OpenPGP certificate. If bits is non null, it should have enough size to hold the parameters size in bits. For RSA the bits returned is the modulus. For DSA the bits returned are of the public exponent. .SH "RETURNS" a member of the \fBgnutls_pk_algorithm_t\fP enumeration on success, or a negative value on error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_psk_free_server_credentials.30000644000000000000000000000241111271476020025126 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_psk_free_server_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_psk_free_server_credentials \- Used to free an allocated gnutls_psk_server_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_psk_free_server_credentials(gnutls_psk_server_credentials_t " sc ");" .SH ARGUMENTS .IP "gnutls_psk_server_credentials_t sc" 12 is an \fBgnutls_psk_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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs7_set_crt_raw.30000644000000000000000000000251011271476020023010 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs7_set_crt_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs7_set_crt_raw \- add a certificate in a PKCS7 certificate set .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs7_set_crt_raw(gnutls_pkcs7_t " pkcs7 ", const gnutls_datum_t * " crt ");" .SH ARGUMENTS .IP "gnutls_pkcs7_t pkcs7" 12 should contain a \fBgnutls_pkcs7_t\fP structure .IP "const gnutls_datum_t * crt" 12 the DER encoded certificate to be added .SH "DESCRIPTION" This function will add a certificate to the PKCS7 or RFC2630 certificate set. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_transport_set_ptr.30000644000000000000000000000244311271476020023166 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_transport_set_ptr" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_transport_set_ptr \- Used to set first argument of the transport functions .SH SYNOPSIS .B #include .sp .BI "void gnutls_transport_set_ptr(gnutls_session_t " session ", gnutls_transport_ptr_t " ptr ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "gnutls_transport_ptr_t ptr" 12 is the value. .SH "DESCRIPTION" Used to set the first argument of the transport function (like PUSH and PULL). In berkeley style sockets this function will set the connection handle. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_authority_key_id.30000644000000000000000000000267611271476020025266 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_authority_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_authority_key_id \- Set the certificate authority's key id .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_authority_key_id(gnutls_x509_crt_t " cert ", const void * " id ", size_t " id_size ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "const void * id" 12 The key ID .IP "size_t id_size" 12 Holds the size of the serial field. .SH "DESCRIPTION" This function will set the X.509 certificate's authority key ID extension. Only the keyIdentifier field can be set with this function. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_verify_data.30000644000000000000000000000271611271476020023327 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_verify_data" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_verify_data \- verify the given signed data. .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_verify_data(gnutls_x509_crt_t " crt ", unsigned int " flags ", const gnutls_datum_t * " data ", const gnutls_datum_t * " signature ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 Holds the certificate .IP "unsigned int flags" 12 should be 0 for now .IP "const gnutls_datum_t * data" 12 holds the data to be signed .IP "const gnutls_datum_t * signature" 12 contains the signature .SH "DESCRIPTION" This function will verify the given signed data, using the parameters from the certificate. .SH "RETURNS" In case of a verification failure 0 is returned, and 1 on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_export.30000644000000000000000000000335711271476020022345 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_export" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_export \- export the CRL .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_export(gnutls_x509_crl_t " crl ", gnutls_x509_crt_fmt_t " format ", void * " output_data ", size_t * " output_data_size ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 Holds the revocation list .IP "gnutls_x509_crt_fmt_t format" 12 the format of output params. One of PEM or DER. .IP "void * output_data" 12 will contain a private key PEM or DER encoded .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 export the revocation list to DER or PEM format. If the buffer provided is not long enough to hold the output, then ¤GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. If the structure is PEM encoded, it will have a header of "BEGIN X509 CRL". .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. and a negative value on failure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_print.30000644000000000000000000000334511271476020022165 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_print" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_print \- Pretty print X.509 certificates .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_print(gnutls_x509_crt_t " cert ", gnutls_certificate_print_formats_t " format ", gnutls_datum_t * " out ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 The structure to be printed .IP "gnutls_certificate_print_formats_t format" 12 Indicate the format to use .IP "gnutls_datum_t * out" 12 Newly allocated datum with zero terminated string. .SH "DESCRIPTION" This function will pretty print a X.509 certificate, suitable for display to a human. If the format is \fBGNUTLS_CRT_PRINT_FULL\fP then all fields of the certificate will be output, on multiple lines. The \fBGNUTLS_CRT_PRINT_ONELINE\fP format will generate one line with some selected fields, which is useful for logging purposes. The output \fIout\fP needs to be deallocate using \fBgnutls_free()\fP. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_openpgp_key_file.30000644000000000000000000000317111271476020026125 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_openpgp_key_file" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_openpgp_key_file \- Used to set OpenPGP keys .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_openpgp_key_file(gnutls_certificate_credentials_t " res ", const char * " certfile ", const char * " keyfile ", gnutls_openpgp_crt_fmt_t " format ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 the destination context to save the data. .IP "const char * certfile" 12 the file that contains the public key. .IP "const char * keyfile" 12 the file that contains the secret key. .IP "gnutls_openpgp_crt_fmt_t format" 12 the format of the keys .SH "DESCRIPTION" This funtion is used to load OpenPGP keys into the GnuTLS credentials structure. The files should only contain one key which is not encrypted. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_rdn_get_oid.30000644000000000000000000000316111271476020022432 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_rdn_get_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_rdn_get_oid \- parse an RDN sequence and returns an OID. .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_rdn_get_oid(const gnutls_datum_t * " idn ", int " indx ", void * " buf ", size_t * " sizeof_buf ");" .SH ARGUMENTS .IP "const gnutls_datum_t * idn" 12 should contain a DER encoded RDN sequence .IP "int indx" 12 Indicates which OID to return. Use 0 for the first one. .IP "void * buf" 12 a pointer to a structure to hold the peer's name OID .IP "size_t * sizeof_buf" 12 holds the size of \fIbuf\fP .SH "DESCRIPTION" This function will return the specified Object identifier, of the RDN sequence. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, or \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP is returned and *\fIsizeof_buf\fP is updated if the provided buffer is not long enough, otherwise a negative error value. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_record_send.30000644000000000000000000000435011271476020021660 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_record_send" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_record_send \- sends to the peer the specified data .SH SYNOPSIS .B #include .sp .BI "ssize_t gnutls_record_send(gnutls_session_t " session ", const void * " data ", size_t " sizeofdata ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "const void * data" 12 contains the data to send .IP "size_t sizeofdata" 12 is the length of the data .SH "DESCRIPTION" This function has the similar semantics with \fBsend()\fP. The only difference is that it accepts a GnuTLS session, and uses different error codes. Note that if the send buffer is full, \fBsend()\fP will block this function. See the \fBsend()\fP documentation for full information. You can replace the default push function by using \fBgnutls_transport_set_ptr2()\fP with a call to \fBsend()\fP with a MSG_DONTWAIT flag if blocking is a problem. 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. cf. \fBgnutls_record_get_direction()\fP. .SH "RETURNS" the number of bytes sent, or a negative error code. The number of bytes sent might be less than \fIsizeofdata\fP. The maximum number of bytes this function can send in a single call depends on the negotiated maximum record size. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_import.30000644000000000000000000000300011271476020022317 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_import" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_import \- import a DER or PEM encoded CRL .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_import(gnutls_x509_crl_t " crl ", const gnutls_datum_t * " data ", gnutls_x509_crt_fmt_t " format ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 The structure to store the parsed CRL. .IP "const gnutls_datum_t * data" 12 The DER or PEM encoded CRL. .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 CRL to the native \fBgnutls_x509_crl_t\fP format. The output will be stored in 'crl'. If the CRL is PEM encoded it should have a header of "X509 CRL". .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_hex_decode.30000644000000000000000000000265611271476020021467 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_hex_decode" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_hex_decode \- decode hex encoded data .SH SYNOPSIS .B #include .sp .BI "int gnutls_hex_decode(const gnutls_datum_t * " hex_data ", char * " result ", size_t * " result_size ");" .SH ARGUMENTS .IP "const gnutls_datum_t * hex_data" 12 contain the encoded data .IP "char * result" 12 the place where decoded data will be copied .IP "size_t * result_size" 12 holds the size of the result .SH "DESCRIPTION" This function will decode the given encoded data, using the hex encoding used by PSK password files. Note that hex_data should be null terminated. .SH "RETURNS" \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP if the buffer given is not long enough, or 0 on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_alert_get_name.30000644000000000000000000000243111271476020022335 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_alert_get_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_alert_get_name \- Returns a string describing the alert number given .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_alert_get_name(gnutls_alert_description_t " alert ");" .SH ARGUMENTS .IP "gnutls_alert_description_t alert" 12 is an alert number \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" This function will return a string that describes the given alert number, or \fBNULL\fP. See \fBgnutls_alert_get()\fP. .SH "RETURNS" string corresponding to \fBgnutls_alert_description_t\fP value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_priority_deinit.30000644000000000000000000000212411271476020022603 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_priority_deinit" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_priority_deinit \- deinitialize the priorities cache .SH SYNOPSIS .B #include .sp .BI "void gnutls_priority_deinit(gnutls_priority_t " priority_cache ");" .SH ARGUMENTS .IP "gnutls_priority_t priority_cache" 12 is a \fBgnutls_prioritity_t\fP structure. .SH "DESCRIPTION" Deinitializes the priority cache. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_set_client_avp_ptr.30000644000000000000000000000236011271476020023725 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_set_client_avp_ptr" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_set_client_avp_ptr \- Sets a pointer to be sent to TLS/IA callback .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_cipher_suite_get_name.30000644000000000000000000000301211271476020023705 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_cipher_suite_get_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_cipher_suite_get_name \- get name of the specified cipher suite .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_cipher_suite_get_name(gnutls_kx_algorithm_t " kx_algorithm ", gnutls_cipher_algorithm_t " cipher_algorithm ", gnutls_mac_algorithm_t " mac_algorithm ");" .SH ARGUMENTS .IP "gnutls_kx_algorithm_t kx_algorithm" 12 is a Key exchange algorithm .IP "gnutls_cipher_algorithm_t cipher_algorithm" 12 is a cipher algorithm .IP "gnutls_mac_algorithm_t mac_algorithm" 12 is a MAC algorithm .SH "DESCRIPTION" Note that the full cipher suite name must be prepended by TLS or SSL depending of the protocol in use. .SH "RETURNS" a string that contains the name of a TLS cipher suite, specified by the given algorithms, or \fBNULL\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_server_name_get.30000644000000000000000000000431611271476020022540 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_server_name_get" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_server_name_get \- Used to get the server name indicator send by a client .SH SYNOPSIS .B #include .sp .BI "int gnutls_server_name_get(gnutls_session_t " session ", void * " data ", size_t * " data_length ", unsigned int * " type ", unsigned int " indx ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "void * data" 12 will hold the data .IP "size_t * data_length" 12 will hold the data length. Must hold the maximum size of data. .IP "unsigned int * type" 12 will hold the server name indicator type .IP "unsigned int indx" 12 is the index of the server_name .SH "DESCRIPTION" This function will allow you to get the name indication (if any), a client has sent. The name indication may be any of the enumeration gnutls_server_name_type_t. If \fItype\fP is GNUTLS_NAME_DNS, then this function is to be used by servers that support virtual hosting, and the data will be a null terminated UTF\-8 string. If \fIdata\fP has not enough size to hold the server name GNUTLS_E_SHORT_MEMORY_BUFFER is returned, and \fIdata_length\fP will hold the required size. \fIindex\fP is used to retrieve more than one server names (if sent by the client). The first server name has an index of 0, the second 1 and so on. If no name with the given index exists GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE is returned. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_preferred_key_id.30000644000000000000000000000252211271476020026131 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_preferred_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_preferred_key_id \- Gets the preferred keyID .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_preferred_key_id(gnutls_openpgp_crt_t " key ", gnutls_openpgp_keyid_t " keyid ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the structure that contains the OpenPGP public key. .IP "gnutls_openpgp_keyid_t keyid" 12 the struct to save the keyid. .SH "DESCRIPTION" Get preferred key id. If it hasn't been set it returns \fBGNUTLS_E_INVALID_REQUEST\fP. .SH "RETURNS" the 64\-bit preferred keyID of the OpenPGP key. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_set_key_usage.30000644000000000000000000000247311271476020023656 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_set_key_usage" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_set_key_usage \- Set the keyUsage extension .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_set_key_usage(gnutls_x509_crq_t " crq ", unsigned int " usage ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 a certificate of type \fBgnutls_x509_crq_t\fP .IP "unsigned int usage" 12 an ORed sequence of the GNUTLS_KEY_* elements. .SH "DESCRIPTION" This function will set the keyUsage certificate extension. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_sign2.30000644000000000000000000000361611271476020022051 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_sign2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_sign2 \- Sign a Certificate request with a key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_sign2(gnutls_x509_crq_t " crq ", gnutls_x509_privkey_t " key ", gnutls_digest_algorithm_t " dig ", unsigned int " flags ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 should contain a \fBgnutls_x509_crq_t\fP structure .IP "gnutls_x509_privkey_t key" 12 holds a private key .IP "gnutls_digest_algorithm_t dig" 12 The message digest to use, \fBGNUTLS_DIG_SHA1\fP is the safe choice unless you know what you're doing. .IP "unsigned int flags" 12 must be 0 .SH "DESCRIPTION" This function will sign the certificate request with a private key. This must be the same key as the one used in \fBgnutls_x509_crt_set_key()\fP since a certificate request is self signed. This must be the last step in a certificate request generation since all the previously set parameters are now signed. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. \fBGNUTLS_E_ASN1_VALUE_NOT_FOUND\fP is returned if you didn't set all information in the certificate request (e.g., the version using \fBgnutls_x509_crq_set_version()\fP). .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_set_next_update.30000644000000000000000000000243511271476020024213 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_set_next_update" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_set_next_update \- This function will set the CRL next update time .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_set_next_update(gnutls_x509_crl_t " crl ", time_t " exp_time ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a gnutls_x509_crl_t structure .IP "time_t exp_time" 12 The actual time .SH "DESCRIPTION" This function will set the time this CRL will be updated. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_dh_params_import_pkcs3.30000644000000000000000000000321011271476020024016 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_dh_params_import_pkcs3" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_dh_params_import_pkcs3 \- import DH params from a pkcs3 structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_dh_params_import_pkcs3(gnutls_dh_params_t " params ", const gnutls_datum_t * " pkcs3_params ", gnutls_x509_crt_fmt_t " format ");" .SH ARGUMENTS .IP "gnutls_dh_params_t params" 12 A structure where the parameters will be copied to .IP "const gnutls_datum_t * pkcs3_params" 12 should contain a PKCS3 DHParams structure PEM or DER encoded .IP "gnutls_x509_crt_fmt_t format" 12 the format of params. PEM or DER. .SH "DESCRIPTION" This function will extract the DHParams found in a PKCS3 formatted structure. This is the format generated by "openssl dhparam" tool. If the structure is PEM encoded, it should have a header of "BEGIN DH PARAMETERS". .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_global_init.30000644000000000000000000000446411271476020021662 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_global_init" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_global_init \- initialize the global data to defaults. .SH SYNOPSIS .B #include .sp .BI "int gnutls_global_init( " void ");" .SH ARGUMENTS .IP " void" 12 .SH "DESCRIPTION" This function initializes the global data to defaults. Every gnutls application has a global data which holds common parameters shared by gnutls session structures. You should call \fBgnutls_global_deinit()\fP when gnutls usage is no longer needed Note that this function will also initialize libgcrypt, if it has not been initialized before. Thus if you want to manually initialize libgcrypt you must do it before calling this function. This is useful in cases you want to disable libgcrypt's internal lockings etc. This function increment a global counter, so that \fBgnutls_global_deinit()\fP only releases resources when it has been called as many times as \fBgnutls_global_init()\fP. This is useful when GnuTLS is used by more than one library in an application. This function can be called many times, but will only do something the first time. Note! This function is not thread safe. If two threads call this function simultaneously, they can cause a race between checking the global counter and incrementing it, causing both threads to execute the library initialization code. That would lead to a memory leak. To handle this, your application could invoke this function after aquiring a thread mutex. To ignore the potential memory leak is also an option. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_get_key_id.30000644000000000000000000000237311271476020025000 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_get_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_get_key_id \- Gets the keyID .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_get_key_id(gnutls_openpgp_privkey_t " key ", gnutls_openpgp_keyid_t " keyid ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 the structure that contains the OpenPGP secret key. .IP "gnutls_openpgp_keyid_t keyid" 12 the buffer to save the keyid. .SH "DESCRIPTION" Get key\-id. .SH "RETURNS" the 64\-bit keyID of the OpenPGP key. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_get_number.30000644000000000000000000000311011271476020023136 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_get_number" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_get_number \- get the CRL number (extension) .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_get_number(gnutls_x509_crl_t " crl ", void * " ret ", size_t * " ret_size ", unsigned int * " critical ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a \fBgnutls_x509_crl_t\fP structure .IP "void * ret" 12 The place where the number 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 CRL number extension. This is obtained by the CRL Number extension field (2.5.29.20). .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative value in case of an error. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_key_usage.30000644000000000000000000000267311271476020024612 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_key_usage" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_key_usage \- This function returns the key's usage .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_key_usage(gnutls_openpgp_crt_t " key ", unsigned int * " key_usage ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 should contain a gnutls_openpgp_crt_t structure .IP "unsigned int * key_usage" 12 where the key usage bits will be stored .SH "DESCRIPTION" This function will return certificate's key usage, by checking the key algorithm. The key usage value will ORed values of the: \fBGNUTLS_KEY_DIGITAL_SIGNATURE\fP, \fBGNUTLS_KEY_KEY_ENCIPHERMENT\fP. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_extension_info.30000644000000000000000000000411511271476020024713 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_extension_info" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_extension_info \- Get extension id and criticality .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_extension_info(gnutls_x509_crt_t " cert ", int " indx ", void * " oid ", size_t * " sizeof_oid ", int * " critical ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "int indx" 12 Specifies which extension OID to send. Use zero to get the first one. .IP "void * oid" 12 a pointer to a structure to hold the OID .IP "size_t * sizeof_oid" 12 initially holds the maximum size of \fIoid\fP, on return holds actual size of \fIoid\fP. .IP "int * critical" 12 output variable with critical flag, may be NULL. .SH "DESCRIPTION" This function will return the requested extension OID in the certificate, and the critical flag for it. The extension OID will be stored as a string in the provided buffer. Use \fBgnutls_x509_crt_get_extension_data()\fP to extract the data. If the buffer provided is not long enough to hold the output, then *\fIsizeof_oid\fP is updated and \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP will be returned. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. If you have reached the last extension available \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pem_base64_encode.30000644000000000000000000000325111271476020022632 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pem_base64_encode" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pem_base64_encode \- convert raw data to Base64 encoded .SH SYNOPSIS .B #include .sp .BI "int gnutls_pem_base64_encode(const char * " msg ", const gnutls_datum_t * " data ", char * " result ", size_t * " result_size ");" .SH ARGUMENTS .IP "const char * msg" 12 is a message to be put in the header .IP "const gnutls_datum_t * data" 12 contain the raw data .IP "char * result" 12 the place where base64 data will be copied .IP "size_t * result_size" 12 holds the size of the result .SH "DESCRIPTION" This function will convert the given data to printable data, using the base64 encoding. This is the encoding used in PEM messages. The output string will be null terminated, although the size will not include the terminating null. .SH "RETURNS" On success \fBGNUTLS_E_SUCCESS\fP (0) is returned, \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP is returned if the buffer given is not long enough, or 0 on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_free_client_credentials.30000644000000000000000000000240211271476020024672 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_free_client_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_free_client_credentials \- Used to free an allocated #gnutls_ia_client_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_ia_free_client_credentials(gnutls_ia_client_credentials_t " sc ");" .SH ARGUMENTS .IP "gnutls_ia_client_credentials_t sc" 12 is an \fBgnutls_ia_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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_record_recv.30000644000000000000000000000441111271476020021664 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_record_recv" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_record_recv \- reads data from the TLS record protocol .SH SYNOPSIS .B #include .sp .BI "ssize_t gnutls_record_recv(gnutls_session_t " session ", void * " data ", size_t " sizeofdata ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "void * data" 12 the buffer that the data will be read into .IP "size_t sizeofdata" 12 the number of requested bytes .SH "DESCRIPTION" This function has the similar semantics with \fBrecv()\fP. The only difference is that it accepts a GnuTLS session, and uses different error codes. In the special case that a server requests a renegotiation, the client may receive an error code of \fBGNUTLS_E_REHANDSHAKE\fP. This message may be simply ignored, replied with an alert \fBGNUTLS_A_NO_RENEGOTIATION\fP, or replied with a new handshake, depending on the client's will. If \fBEINTR\fP is returned by the internal push function (the default is \fBrecv()\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 to get the data. See also \fBgnutls_record_get_direction()\fP. A server may also receive \fBGNUTLS_E_REHANDSHAKE\fP when a client has initiated a handshake. In that case the server can only initiate a handshake or terminate the connection. .SH "RETURNS" the number of bytes received and zero on EOF. A negative error code is returned in case of an error. The number of bytes received might be less than \fIsizeofdata\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_bag_set_crl.30000644000000000000000000000243311271476020023020 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_bag_set_crl" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_bag_set_crl \- insert the CRL into the bag .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_bag_set_crl(gnutls_pkcs12_bag_t " bag ", gnutls_x509_crl_t " crl ");" .SH ARGUMENTS .IP "gnutls_pkcs12_bag_t bag" 12 The bag .IP "gnutls_x509_crl_t crl" 12 the CRL to be copied. .SH "DESCRIPTION" This function will insert the given CRL into the bag. This is just a wrapper over \fBgnutls_pkcs12_bag_set_data()\fP. .SH "RETURNS" the index of the added bag on success, or a negative value on failure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_global_deinit.30000644000000000000000000000224011271476020022161 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_global_deinit" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_global_deinit \- deinitialize the global data .SH SYNOPSIS .B #include .sp .BI "void gnutls_global_deinit( " void ");" .SH ARGUMENTS .IP " void" 12 .SH "DESCRIPTION" This function deinitializes the global data, that were initialized using \fBgnutls_global_init()\fP. Note! This function is not thread safe. See the discussion for \fBgnutls_global_init()\fP for more information. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_key_id.30000644000000000000000000000347211271476020023135 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_key_id \- Return unique ID of public key's parameters .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_key_id(gnutls_x509_crt_t " crt ", unsigned int " flags ", unsigned char * " output_data ", size_t * " output_data_size ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 Holds the certificate .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 private key. If the buffer provided is not long enough to hold the output, then *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. The output will normally be a SHA\-1 hash output, which is 20 bytes. .SH "RETURN VALUE" In case of failure a negative value will be returned, and 0 on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_extension_oid.30000644000000000000000000000331111271476020024530 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_extension_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_extension_oid \- get the specified extension OID .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_extension_oid(gnutls_x509_crt_t " cert ", int " indx ", void * " oid ", size_t * " sizeof_oid ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "int indx" 12 Specifies which extension OID to send. Use zero to get the first one. .IP "void * oid" 12 a pointer to a structure to hold the OID (may be null) .IP "size_t * sizeof_oid" 12 initially holds the size of \fIoid\fP .SH "DESCRIPTION" This function will return the requested extension OID in the certificate. The extension OID will be stored as a string in the provided buffer. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. If you have reached the last extension available \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_global_set_log_level.30000644000000000000000000000246011271476020023534 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_global_set_log_level" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_global_set_log_level \- set the logging level .SH SYNOPSIS .B #include .sp .BI "void gnutls_global_set_log_level(int " level ");" .SH ARGUMENTS .IP "int level" 12 it's an integer from 0 to 9. .SH "DESCRIPTION" This is the function that allows you to set the log level. The level is an integer between 0 and 9. Higher values mean more verbosity. The default value is 0. Larger values should only be used with care, since they may reveal sensitive information. Use a log level over 10 to enable all debugging options. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_srp_free_server_credentials.30000644000000000000000000000241111271476020025135 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_srp_free_server_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_srp_free_server_credentials \- Used to free an allocated gnutls_srp_server_credentials_t structure .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_bag_get_count.30000644000000000000000000000225411271476020023355 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_bag_get_count" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_bag_get_count \- This function returns the bag's elements count .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_bag_get_count(gnutls_pkcs12_bag_t " bag ");" .SH ARGUMENTS .IP "gnutls_pkcs12_bag_t bag" 12 The bag .SH "DESCRIPTION" This function will return the number of the elements withing the bag. .SH "RETURNS" Number of elements in bag, or an negative error code on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_transport_get_ptr.30000644000000000000000000000243211271476020023150 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_transport_get_ptr" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_transport_get_ptr \- Used to return the first argument of the transport functions .SH SYNOPSIS .B #include .sp .BI "gnutls_transport_ptr_t gnutls_transport_get_ptr(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Used to get the first argument of the transport function (like PUSH and PULL). This must have been set using \fBgnutls_transport_set_ptr()\fP. .SH "RETURNS" first argument of the transport function. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_cpy.30000644000000000000000000000242411271476020022522 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_cpy" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_cpy \- copy a private key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_privkey_cpy(gnutls_x509_privkey_t " dst ", gnutls_x509_privkey_t " src ");" .SH ARGUMENTS .IP "gnutls_x509_privkey_t dst" 12 The destination key, which should be initialized. .IP "gnutls_x509_privkey_t src" 12 The source key .SH "DESCRIPTION" This function will copy a private key from source to destination key. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_srp_base64_encode_alloc.30000644000000000000000000000307511271476020024033 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_srp_base64_encode_alloc" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_srp_base64_encode_alloc \- encode raw data using SRP-Base64 .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_srp_set_server_credentials_function.30000644000000000000000000000445511271476020026726 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_srp_set_server_credentials_function" 3 "2.8.1" "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 .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_bag_init.30000644000000000000000000000246611271476020022336 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_bag_init" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_bag_init \- This function initializes a gnutls_pkcs12_bag_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_bag_init(gnutls_pkcs12_bag_t * " bag ");" .SH ARGUMENTS .IP "gnutls_pkcs12_bag_t * bag" 12 The structure to be initialized .SH "DESCRIPTION" This function will initialize a PKCS12 bag structure. PKCS12 Bags usually contain private keys, lists of X.509 Certificates and X.509 Certificate revocation lists. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_verify_limits.30000644000000000000000000000311511271476020025471 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_verify_limits" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_verify_limits \- set the upper limits to be used at certificate verification .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_set_verify_limits(gnutls_certificate_credentials_t " res ", unsigned int " max_bits ", unsigned int " max_depth ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is a gnutls_certificate_credentials structure .IP "unsigned int max_bits" 12 is the number of bits of an acceptable certificate (default 8200) .IP "unsigned int max_depth" 12 is maximum depth of the verification of a certificate chain (default 5) .SH "DESCRIPTION" This function will set some upper limits for the default verification function, \fBgnutls_certificate_verify_peers2()\fP, to avoid denial of service attacks. You can set them to zero to disable limits. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_version.30000644000000000000000000000227011271476020024314 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_version" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_version \- Extracts the version of the key. .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_version(gnutls_openpgp_crt_t " key ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the structure that contains the OpenPGP public key. .SH "DESCRIPTION" Extract the version of the OpenPGP key. .SH "RETURNS" the version number is returned, or a negative value on errors. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_proxy.30000644000000000000000000000325711271476020023067 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_proxy" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_proxy \- Set the proxyCertInfo extension .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_proxy(gnutls_x509_crt_t " crt ", int " pathLenConstraint ", const char * " policyLanguage ", const char * " policy ", size_t " sizeof_policy ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "int pathLenConstraint" 12 non\-negative values indicate maximum length of path, and negative values indicate that the pathLenConstraints field should not be present. .IP "const char * policyLanguage" 12 OID describing the language of \fIpolicy\fP. .IP "const char * policy" 12 opaque byte array with policy language, can be \fBNULL\fP .IP "size_t sizeof_policy" 12 size of \fIpolicy\fP. .SH "DESCRIPTION" This function will set the proxyCertInfo extension. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_import.30000644000000000000000000000312611271476020022340 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_import" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_import \- This function will import a DER or PEM encoded Certificate .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_permute_inner_secret.30000644000000000000000000000300211271476020024254 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_permute_inner_secret" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_permute_inner_secret \- API function .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_key_rsa_raw.30000644000000000000000000000275511271476020024177 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_key_rsa_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_key_rsa_raw \- export the RSA public key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_key_rsa_raw(gnutls_x509_crq_t " crq ", gnutls_datum_t * " m ", gnutls_datum_t * " e ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 Holds the certificate .IP "gnutls_datum_t * m" 12 will hold the modulus .IP "gnutls_datum_t * e" 12 will hold the public exponent .SH "DESCRIPTION" This function will export the RSA public key's parameters found in the given structure. The new parameters will be allocated using \fBgnutls_malloc()\fP and will be stored in the appropriate datum. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_extension_by_oid.30000644000000000000000000000332011271476020025236 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_extension_by_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_extension_by_oid \- Set an arbitrary extension .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_extension_by_oid(gnutls_x509_crt_t " crt ", const char * " oid ", const void * " buf ", size_t " sizeof_buf ", unsigned int " critical ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "const char * oid" 12 holds an Object Identified in null terminated string .IP "const void * buf" 12 a pointer to a DER encoded data .IP "size_t sizeof_buf" 12 holds the size of \fIbuf\fP .IP "unsigned int critical" 12 should be non zero if the extension is to be marked as critical .SH "DESCRIPTION" This function will set an the extension, by the specified OID, in the certificate. The extension data should be binary data DER encoded. .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_verify_data.30000644000000000000000000000274311271476020024230 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_verify_data" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_verify_data \- Verify the signed data using private key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_privkey_verify_data(gnutls_x509_privkey_t " key ", unsigned int " flags ", const gnutls_datum_t * " data ", const gnutls_datum_t * " signature ");" .SH ARGUMENTS .IP "gnutls_x509_privkey_t key" 12 Holds the key .IP "unsigned int flags" 12 should be 0 for now .IP "const gnutls_datum_t * data" 12 holds the data to be signed .IP "const gnutls_datum_t * signature" 12 contains the signature .SH "DESCRIPTION" This function will verify the given signed data, using the parameters in the private key. .SH "RETURNS" In case of a verification failure 0 is returned, and 1 on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_compression_get_id.30000644000000000000000000000233611271476020023247 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_compression_get_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_compression_get_id \- Returns the gnutls id of the specified in string algorithm .SH SYNOPSIS .B #include .sp .BI "gnutls_compression_method_t gnutls_compression_get_id(const char * " name ");" .SH ARGUMENTS .IP "const char * name" 12 is a compression method name .SH "DESCRIPTION" The names are compared in a case insensitive way. .SH "RETURNS" an id of the specified in a string compression method, or \fBGNUTLS_COMP_UNKNOWN\fP on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_get_subkey_creation_time.30000644000000000000000000000244211271476020027735 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_get_subkey_creation_time" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_get_subkey_creation_time \- Extract the timestamp .SH SYNOPSIS .B #include .sp .BI "time_t gnutls_openpgp_privkey_get_subkey_creation_time(gnutls_openpgp_privkey_t " key ", unsigned int " idx ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 the structure that contains the OpenPGP private key. .IP "unsigned int idx" 12 the subkey index .SH "DESCRIPTION" Get subkey creation time. .SH "RETURNS" the timestamp when the OpenPGP key was created. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_mac_set_priority.30000644000000000000000000000306611271476020022750 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_mac_set_priority" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_mac_set_priority \- Sets the priority on the mac algorithms supported by gnutls. .SH SYNOPSIS .B #include .sp .BI "int gnutls_mac_set_priority(gnutls_session_t " session ", const int * " list ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "const int * list" 12 is a 0 terminated list of gnutls_mac_algorithm_t elements. .SH "DESCRIPTION" Sets the priority on the mac algorithms supported by gnutls. Priority is higher for elements specified before others. After specifying the algorithms you want, you must append a 0. Note that the priority is set on the client. The server does not use the algorithm's priority except for disabling algorithms that were not specified. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_alert_send.30000644000000000000000000000333711271476020021515 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_alert_send" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_alert_send \- send an alert message to the peer .SH SYNOPSIS .B #include .sp .BI "int gnutls_alert_send(gnutls_session_t " session ", gnutls_alert_level_t " level ", gnutls_alert_description_t " desc ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "gnutls_alert_level_t level" 12 is the level of the alert .IP "gnutls_alert_description_t desc" 12 is the alert description .SH "DESCRIPTION" This function will send an alert to the peer in order to inform him of something important (eg. his Certificate could not be verified). If the alert level is Fatal then the peer is expected to close the connection, otherwise he may ignore the alert and continue. The error code of the underlying record send function will be returned, so you may also receive \fBGNUTLS_E_INTERRUPTED\fP or \fBGNUTLS_E_AGAIN\fP as well. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_set_preferred_key_id.30000644000000000000000000000263611271476020027054 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_set_preferred_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_set_preferred_key_id \- Set the prefered keyID .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_set_preferred_key_id(gnutls_openpgp_privkey_t " key ", const gnutls_openpgp_keyid_t " keyid ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 the structure that contains the OpenPGP public key. .IP "const gnutls_openpgp_keyid_t keyid" 12 the selected keyid .SH "DESCRIPTION" This allows setting a preferred key id for the given certificate. This key will be used by functions that involve key handling. .SH "RETURNS" On success, 0 is returned, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_db_get_ptr.30000644000000000000000000000225211271476020021501 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_db_get_ptr" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_db_get_ptr \- Returns the pointer which is sent to db functions .SH SYNOPSIS .B #include .sp .BI "void * gnutls_db_get_ptr(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Get db function pointer. .SH "RETURNS" the pointer that will be sent to db store, retrieve and delete functions, as the first argument. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_keyring_init.30000644000000000000000000000230211271476020023607 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_keyring_init" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_keyring_init \- initializes a #gnutls_openpgp_keyring_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_keyring_init(gnutls_openpgp_keyring_t * " keyring ");" .SH ARGUMENTS .IP "gnutls_openpgp_keyring_t * keyring" 12 The structure to be initialized .SH "DESCRIPTION" This function will initialize an keyring structure. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_srp_allocate_client_credentials.30000644000000000000000000000255211271476020025756 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_srp_allocate_client_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_srp_allocate_client_credentials \- Used to allocate an gnutls_srp_server_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_srp_allocate_client_credentials(gnutls_srp_client_credentials_t * " sc ");" .SH ARGUMENTS .IP "gnutls_srp_client_credentials_t * sc" 12 is a pointer to 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 allocate it. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_export_rsa_raw.30000644000000000000000000000352211271476020025731 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_export_rsa_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_export_rsa_raw \- This function will export the RSA private key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_export_rsa_raw(gnutls_openpgp_privkey_t " pkey ", gnutls_datum_t * " m ", gnutls_datum_t * " e ", gnutls_datum_t * " d ", gnutls_datum_t * " p ", gnutls_datum_t * " q ", gnutls_datum_t * " u ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t pkey" 12 Holds the certificate .IP "gnutls_datum_t * m" 12 will hold the modulus .IP "gnutls_datum_t * e" 12 will hold the public exponent .IP "gnutls_datum_t * d" 12 will hold the private exponent .IP "gnutls_datum_t * p" 12 will hold the first prime (p) .IP "gnutls_datum_t * q" 12 will hold the second prime (q) .IP "gnutls_datum_t * u" 12 will hold the coefficient .SH "DESCRIPTION" This function will export the RSA private key's parameters found in the given structure. The new parameters will be allocated using \fBgnutls_malloc()\fP and will be stored in the appropriate datum. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_subkey_revoked_status.30000644000000000000000000000253111271476020027253 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_subkey_revoked_status" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_subkey_revoked_status \- Gets the revoked status of the key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_subkey_revoked_status(gnutls_openpgp_crt_t " key ", unsigned int " idx ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the structure that contains the OpenPGP public key. .IP "unsigned int idx" 12 is the subkey index .SH "DESCRIPTION" Get subkey revocation status. A negative value indicates an error. .SH "RETURNS" true (1) if the key has been revoked, or false (0) if it has not. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_transport_get_ptr2.30000644000000000000000000000271311271476020023234 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_transport_get_ptr2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_transport_get_ptr2 \- Used to return the first argument of the transport functions .SH SYNOPSIS .B #include .sp .BI "void gnutls_transport_get_ptr2(gnutls_session_t " session ", gnutls_transport_ptr_t * " recv_ptr ", gnutls_transport_ptr_t * " send_ptr ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "gnutls_transport_ptr_t * recv_ptr" 12 will hold the value for the pull function .IP "gnutls_transport_ptr_t * send_ptr" 12 will hold the value for the push function .SH "DESCRIPTION" Used to get the arguments of the transport functions (like PUSH and PULL). These should have been set using \fBgnutls_transport_set_ptr2()\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_session_get_data2.30000644000000000000000000000323311271476020022765 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_session_get_data2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_session_get_data2 \- Returns all session parameters. .SH SYNOPSIS .B #include .sp .BI "int gnutls_session_get_data2(gnutls_session_t " session ", gnutls_datum_t * " data ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "gnutls_datum_t * data" 12 is a pointer to a datum that will hold the session. .SH "DESCRIPTION" Returns all session parameters, in order to support resuming. The client should call this, and keep the returned session, if he wants to resume that current version later by calling \fBgnutls_session_set_data()\fP. This function must be called after a successful handshake. The returned datum must be freed with \fBgnutls_free()\fP. Resuming sessions is really useful and speedups connections after a succesful one. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_export_subkey_dsa_raw.30000644000000000000000000000341411271476020027275 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_export_subkey_dsa_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_export_subkey_dsa_raw \- export the DSA private key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_export_subkey_dsa_raw(gnutls_openpgp_privkey_t " pkey ", unsigned int " idx ", gnutls_datum_t * " p ", gnutls_datum_t * " q ", gnutls_datum_t * " g ", gnutls_datum_t * " y ", gnutls_datum_t * " x ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t pkey" 12 Holds the certificate .IP "unsigned int idx" 12 Is the subkey index .IP "gnutls_datum_t * p" 12 will hold the p .IP "gnutls_datum_t * q" 12 will hold the q .IP "gnutls_datum_t * g" 12 will hold the g .IP "gnutls_datum_t * y" 12 will hold the y .IP "gnutls_datum_t * x" 12 will hold the x .SH "DESCRIPTION" This function will export the DSA private key's parameters found in the given certificate. The new parameters will be allocated using \fBgnutls_malloc()\fP and will be stored in the appropriate datum. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_x509_key_mem.30000644000000000000000000000452611271476020025026 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_x509_key_mem" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_x509_key_mem \- Used to set keys in a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_x509_key_mem(gnutls_certificate_credentials_t " res ", const gnutls_datum_t * " cert ", const gnutls_datum_t * " key ", gnutls_x509_crt_fmt_t " type ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .IP "const gnutls_datum_t * cert" 12 contains a certificate list (path) for the specified private key .IP "const gnutls_datum_t * key" 12 is the private key, or \fBNULL\fP .IP "gnutls_x509_crt_fmt_t type" 12 is PEM or DER .SH "DESCRIPTION" This function sets a certificate/private key pair in the gnutls_certificate_credentials_t structure. This function may be called more than once (in case multiple keys/certificates exist for the server). .SH "CURRENTLY ARE SUPPORTED" RSA PKCS\-1 encoded private keys, DSA private keys. DSA private keys are encoded the OpenSSL way, which is an ASN.1 DER sequence of 6 INTEGERs \- version, p, q, g, pub, priv. Note that the keyUsage (2.5.29.15) PKIX extension in X.509 certificates is supported. This means that certificates intended for signing cannot be used for ciphersuites that require encryption. If the certificate and the private key are given in PEM encoding then the strings that hold their values must be null terminated. The \fIkey\fP may be \fBNULL\fP if you are using a sign callback, see \fBgnutls_sign_callback_set()\fP. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_session_get_ptr.30000644000000000000000000000240511271476020022577 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_session_get_ptr" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_session_get_ptr \- Get the user pointer from the session structure .SH SYNOPSIS .B #include .sp .BI "void * gnutls_session_get_ptr(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Get user pointer for session. Useful in callbacks. This is the pointer set with \fBgnutls_session_set_ptr()\fP. .SH "RETURNS" the user given pointer from the session structure, or \fBNULL\fP if it was never set. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pk_algorithm_get_name.30000644000000000000000000000233211271476020023706 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pk_algorithm_get_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pk_algorithm_get_name \- Get string with name of public key algorithm .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_pk_algorithm_get_name(gnutls_pk_algorithm_t " algorithm ");" .SH ARGUMENTS .IP "gnutls_pk_algorithm_t algorithm" 12 is a pk algorithm .SH "DESCRIPTION" Convert a \fBgnutls_pk_algorithm_t\fP value to a string. .SH "RETURNS" a string that contains the name of the specified public key algorithm, or \fBNULL\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_verify_endphase.30000644000000000000000000000313711271476020023217 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_verify_endphase" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_verify_endphase \- API function .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_get_this_update.30000644000000000000000000000226711271476020024173 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_get_this_update" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_get_this_update \- return the CRL's thisUpdate time .SH SYNOPSIS .B #include .sp .BI "time_t gnutls_x509_crl_get_this_update(gnutls_x509_crl_t " crl ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a \fBgnutls_x509_crl_t\fP structure .SH "DESCRIPTION" This function will return the time this CRL was issued. .SH "RETURNS" when the CRL was issued, or (time_t)\-1 on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_error_to_alert.30000644000000000000000000000302011271476020022404 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_error_to_alert" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_error_to_alert \- return an alert code based on the given error code .SH SYNOPSIS .B #include .sp .BI "int gnutls_error_to_alert(int " err ", int * " level ");" .SH ARGUMENTS .IP "int err" 12 is a negative integer .IP "int * level" 12 the alert level will be stored there .SH "DESCRIPTION" Get an alert depending on the error code returned by a gnutls function. All alerts sent by this function should be considered fatal. The only exception is when \fIerr\fP is \fBGNUTLS_E_REHANDSHAKE\fP, where a warning alert should be sent to the peer indicating that no renegotiation will be performed. If there is no mapping to a valid alert the alert to indicate internal error is returned. .SH "RETURNS" the alert code to use for a particular error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_set_server_avp_function.30000644000000000000000000000542611271476020025003 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_set_server_avp_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_set_server_avp_function \- Used to set a AVP callback .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_set_default_priority.30000644000000000000000000000320311271476020023625 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_set_default_priority" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_set_default_priority \- Sets some default priority on the cipher suites supported by gnutls. .SH SYNOPSIS .B #include .sp .BI "int gnutls_set_default_priority(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Sets some default priority on the ciphers, key exchange methods, macs and compression methods. .SH "THIS IS THE SAME AS CALLING" gnutls_priority_set_direct (session, "NORMAL", NULL); This function is kept around for backwards compatibility, but because of its wide use it is still fully supported. If you wish to allow users to provide a string that specify which ciphers to use (which is recommended), you should use \fBgnutls_priority_set_direct()\fP or \fBgnutls_priority_set()\fP instead. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_handshake_set_max_packet_length.30000644000000000000000000000300111271476020025717 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_handshake_set_max_packet_length" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_handshake_set_max_packet_length \- set the maximum size of the handshake .SH SYNOPSIS .B #include .sp .BI "void gnutls_handshake_set_max_packet_length(gnutls_session_t " session ", size_t " max ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "size_t max" 12 is the maximum number. .SH "DESCRIPTION" This function will set the maximum size of all handshake messages. Handshakes over this size are rejected with \fBGNUTLS_E_HANDSHAKE_TOO_LARGE\fP error code. The default value is 48kb which is typically large enough. Set this to 0 if you do not want to set an upper limit. The reason for restricting the handshake message sizes are to limit Denial of Service attacks. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_rsa_params_import_pkcs1.30000644000000000000000000000310211271476020024206 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_rsa_params_import_pkcs1" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_rsa_params_import_pkcs1 \- import RSA params from a pkcs1 structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_rsa_params_import_pkcs1(gnutls_rsa_params_t " params ", const gnutls_datum_t * " pkcs1_params ", gnutls_x509_crt_fmt_t " format ");" .SH ARGUMENTS .IP "gnutls_rsa_params_t params" 12 A structure where the parameters will be copied to .IP "const gnutls_datum_t * pkcs1_params" 12 should contain a PKCS1 RSAPublicKey structure PEM or DER encoded .IP "gnutls_x509_crt_fmt_t format" 12 the format of params. PEM or DER. .SH "DESCRIPTION" This function will extract the RSAPublicKey found in a PKCS1 formatted structure. If the structure is PEM encoded, it should have a header of "BEGIN RSA PRIVATE KEY". .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an negative error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_dh_get_peers_public_bits.30000644000000000000000000000244511271476020024403 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_dh_get_peers_public_bits" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_dh_get_peers_public_bits \- return the bits used in DH authentication .SH SYNOPSIS .B #include .sp .BI "int gnutls_dh_get_peers_public_bits(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .SH "DESCRIPTION" Get the Diffie\-Hellman public key bit size. Can be used for both anonymous and ephemeral Diffie\-Hellman. .SH "RETURNS" the public key bit size used in the last Diffie\-Hellman authentication with the peer, or a negative value in case of error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_deinit.30000644000000000000000000000215011271476020022024 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_deinit" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_deinit \- This function deinitializes memory used by a gnutls_pkcs12_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_pkcs12_deinit(gnutls_pkcs12_t " pkcs12 ");" .SH ARGUMENTS .IP "gnutls_pkcs12_t pkcs12" 12 The structure to be initialized .SH "DESCRIPTION" This function will deinitialize a PKCS12 structure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_get_crt_count.30000644000000000000000000000232311271476020023653 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_get_crt_count" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_get_crt_count \- get number of revoked certificates in a CRL .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_get_crt_count(gnutls_x509_crl_t " crl ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a \fBgnutls_x509_crl_t\fP structure .SH "DESCRIPTION" This function will return the number of revoked certificates in the given CRL. .SH "RETURNS" number of certificates, a negative value on failure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_export.30000644000000000000000000000341111271476020022072 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_export" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_export \- This function will export the pkcs12 structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_export(gnutls_pkcs12_t " pkcs12 ", gnutls_x509_crt_fmt_t " format ", void * " output_data ", size_t * " output_data_size ");" .SH ARGUMENTS .IP "gnutls_pkcs12_t pkcs12" 12 Holds the pkcs12 structure .IP "gnutls_x509_crt_fmt_t format" 12 the format of output params. One of PEM or DER. .IP "void * output_data" 12 will contain a structure PEM or DER encoded .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 export the pkcs12 structure to DER or PEM format. If the buffer provided is not long enough to hold the output, then *output_data_size will be updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. If the structure is PEM encoded, it will have a header of "BEGIN PKCS12". .SH "RETURN VALUE" In case of failure a negative value will be returned, and 0 on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_get_dn_oid.30000644000000000000000000000326611271476020023116 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_get_dn_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_get_dn_oid \- returns the Certificate request issuer's distinguished name OIDs .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_get_dn_oid(gnutls_x509_crl_t " crl ", int " indx ", void * " oid ", size_t * " sizeof_oid ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a gnutls_x509_crl_t structure .IP "int indx" 12 Specifies which DN OID to send. Use zero to get the first one. .IP "void * oid" 12 a pointer to a structure to hold the name (may be null) .IP "size_t * sizeof_oid" 12 initially holds the size of 'oid' .SH "DESCRIPTION" This function will extract the requested OID of the name of the CRL issuer, specified by the given index. If oid is null then only the size will be filled. .SH "RETURNS" \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP if the provided buffer is not long enough, and in that case the sizeof_oid will be updated with the required size. On success 0 is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_record_set_max_size.30000644000000000000000000000332411271476020023421 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_record_set_max_size" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_record_set_max_size \- sets the maximum record size .SH SYNOPSIS .B #include .sp .BI "ssize_t gnutls_record_set_max_size(gnutls_session_t " session ", size_t " size ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "size_t size" 12 is the new size .SH "DESCRIPTION" This function sets the maximum record packet size in this connection. This property can only be set to clients. The server may choose not to accept the requested size. Acceptable values are 512(=2^9), 1024(=2^10), 2048(=2^11) and 4096(=2^12). The requested record size does get in effect immediately only while sending data. The receive part will take effect after a successful handshake. This function uses a TLS extension called 'max record size'. Not all TLS implementations use or even understand this extension. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_init.30000644000000000000000000000231211271476020021762 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_init" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_init \- This function initializes a gnutls_x509_crq_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_init(gnutls_x509_crq_t * " crq ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t * crq" 12 The structure to be initialized .SH "DESCRIPTION" This function will initialize a PKCS10 certificate request structure. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_protocol_list.30000644000000000000000000000221611271476020022264 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_protocol_list" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_protocol_list \- Get a list of supported protocols .SH SYNOPSIS .B #include .sp .BI "const gnutls_protocol_t * gnutls_protocol_list( " void ");" .SH ARGUMENTS .IP " void" 12 .SH "DESCRIPTION" Get a list of supported protocols, e.g. SSL 3.0, TLS 1.0 etc. .SH "RETURNS" a zero\-terminated list of \fBgnutls_protocol_t\fP integers indicating the available protocols. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_cipher_get.30000644000000000000000000000222311271476020021477 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_cipher_get" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_cipher_get \- Returns the currently used cipher. .SH SYNOPSIS .B #include .sp .BI "gnutls_cipher_algorithm_t gnutls_cipher_get(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Get currently used cipher. .SH "RETURNS" the currently used cipher, an \fBgnutls_cipher_algorithm_t\fP type. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_dn.30000644000000000000000000000333011271476020022263 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_dn" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_dn \- This function returns the Certificate's distinguished name .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_dn(gnutls_x509_crt_t " cert ", char * " buf ", size_t * " sizeof_buf ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "char * buf" 12 a pointer to a structure to hold the name (may be null) .IP "size_t * sizeof_buf" 12 initially holds the size of \fIbuf\fP .SH "DESCRIPTION" This function will copy the name of the Certificate in the provided buffer. The name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described in RFC2253. The output string will be ASCII or UTF\-8 encoded, depending on the certificate data. If \fIbuf\fP is null then only the size will be filled. .SH "RETURNS" GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_buf will be updated with the required size. On success 0 is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_key_usage.30000644000000000000000000000365311271476020023646 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_key_usage" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_key_usage \- return the certificate's key usage .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_key_usage(gnutls_x509_crt_t " cert ", unsigned int * " key_usage ", unsigned int * " critical ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "unsigned int * key_usage" 12 where the key usage bits will be stored .IP "unsigned int * critical" 12 will be non zero if the extension is marked as critical .SH "DESCRIPTION" This function will return certificate's key usage, by reading the keyUsage X.509 extension (2.5.29.15). The key usage value will .SH "ORED VALUES OF THE" \fBGNUTLS_KEY_DIGITAL_SIGNATURE\fP, \fBGNUTLS_KEY_NON_REPUDIATION\fP, \fBGNUTLS_KEY_KEY_ENCIPHERMENT\fP, \fBGNUTLS_KEY_DATA_ENCIPHERMENT\fP, \fBGNUTLS_KEY_KEY_AGREEMENT\fP, \fBGNUTLS_KEY_KEY_CERT_SIGN\fP, \fBGNUTLS_KEY_CRL_SIGN\fP, \fBGNUTLS_KEY_ENCIPHER_ONLY\fP, \fBGNUTLS_KEY_DECIPHER_ONLY\fP. .SH "RETURNS" the certificate key usage, or a negative value in case of parsing error. If the certificate does not contain the keyUsage extension \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_keyring_deinit.30000644000000000000000000000222411271476020024123 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_keyring_deinit" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_keyring_deinit \- deinitializes memory used by a #gnutls_openpgp_keyring_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_openpgp_keyring_deinit(gnutls_openpgp_keyring_t " keyring ");" .SH ARGUMENTS .IP "gnutls_openpgp_keyring_t keyring" 12 The structure to be initialized .SH "DESCRIPTION" This function will deinitialize a keyring structure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_anon_allocate_server_credentials.30000644000000000000000000000255411271476020026137 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_anon_allocate_server_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_anon_allocate_server_credentials \- Used to allocate an gnutls_anon_server_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_anon_allocate_server_credentials(gnutls_anon_server_credentials_t * " sc ");" .SH ARGUMENTS .IP "gnutls_anon_server_credentials_t * sc" 12 is a pointer to an \fBgnutls_anon_server_credentials_t\fP structure. .SH "DESCRIPTION" This structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_x509_trust_mem.30000644000000000000000000000355311271476020025416 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_x509_trust_mem" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_x509_trust_mem \- Used to add trusted CAs in a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_x509_trust_mem(gnutls_certificate_credentials_t " res ", const gnutls_datum_t * " ca ", gnutls_x509_crt_fmt_t " type ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .IP "const gnutls_datum_t * ca" 12 is a list of trusted CAs or a DER certificate .IP "gnutls_x509_crt_fmt_t type" 12 is DER or PEM .SH "DESCRIPTION" This function adds the trusted CAs in order to verify client or server certificates. In case of a client this is not required to be called if the certificates are not verified using \fBgnutls_certificate_verify_peers2()\fP. This function may be called multiple times. In case of a server the CAs set here will be sent to the client if a certificate request is sent. This can be disabled using \fBgnutls_certificate_send_x509_rdn_sequence()\fP. .SH "RETURNS" the number of certificates processed or a negative value on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_get_version.30000644000000000000000000000225411271476020023343 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_get_version" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_get_version \- returns the CRL's version number .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_get_version(gnutls_x509_crl_t " crl ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a \fBgnutls_x509_crl_t\fP structure .SH "DESCRIPTION" This function will return the version of the specified CRL. .SH "RETURNS" The version number, or a negative value on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_sign_list.30000644000000000000000000000223511271476020021364 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_sign_list" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_sign_list \- Get a list of supported public key signature algorithms .SH SYNOPSIS .B #include .sp .BI "const gnutls_sign_algorithm_t * gnutls_sign_list( " void ");" .SH ARGUMENTS .IP " void" 12 .SH "DESCRIPTION" Get a list of supported public key signature algorithms. .SH "RETURNS" a zero\-terminated list of \fBgnutls_sign_algorithm_t\fP integers indicating the available ciphers. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_export.30000644000000000000000000000355511271476020024221 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_export" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_export \- export a RAW or BASE64 encoded key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_export(gnutls_openpgp_privkey_t " key ", gnutls_openpgp_crt_fmt_t " format ", const char * " password ", unsigned int " flags ", void * " output_data ", size_t * " output_data_size ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 Holds the key. .IP "gnutls_openpgp_crt_fmt_t format" 12 One of gnutls_openpgp_crt_fmt_t elements. .IP "const char * password" 12 the password that will be used to encrypt the key. (unused for now) .IP "unsigned int flags" 12 zero for future compatibility .IP "void * output_data" 12 will contain the key base64 encoded or raw .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 convert the given key to RAW or Base64 format. If the buffer provided is not long enough to hold the output, then GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_type_set_priority.30000644000000000000000000000315411271476020025531 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_type_set_priority" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_type_set_priority \- Sets the priority on the certificate types supported by gnutls. .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_type_set_priority(gnutls_session_t " session ", const int * " list ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "const int * list" 12 is a 0 terminated list of gnutls_certificate_type_t elements. .SH "DESCRIPTION" Sets the priority on the certificate types supported by gnutls. Priority is higher for elements specified before others. After specifying the types you want, you must append a 0. Note that the certificate type priority is set on the client. The server does not use the cert type priority except for disabling types that were not specified. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_keyring_get_crt.30000644000000000000000000000304711271476020024302 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_keyring_get_crt" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_keyring_get_crt \- export an openpgp certificate from a keyring .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_keyring_get_crt(gnutls_openpgp_keyring_t " ring ", unsigned int " idx ", gnutls_openpgp_crt_t * " cert ");" .SH ARGUMENTS .IP "gnutls_openpgp_keyring_t ring" 12 Holds the keyring. .IP "unsigned int idx" 12 the index of the certificate to export .IP "gnutls_openpgp_crt_t * cert" 12 An uninitialized \fBgnutls_openpgp_crt_t\fP structure .SH "DESCRIPTION" This function will extract an OpenPGP certificate from the given keyring. If the index given is out of range \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. The returned structure needs to be deinited. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_proxy.30000644000000000000000000000363111271476020023047 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_proxy" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_proxy \- This function returns the proxy certificate info .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_proxy(gnutls_x509_crt_t " cert ", unsigned int * " critical ", int * " pathlen ", char ** " policyLanguage ", char ** " policy ", size_t * " sizeof_policy ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "unsigned int * critical" 12 will be non zero if the extension is marked as critical .IP "int * pathlen" 12 pointer to output integer indicating path length (may be NULL), non\-negative values indicate a present pCPathLenConstraint field and the actual value, \-1 indicate that the field is absent. .IP "char ** policyLanguage" 12 output variable with OID of policy language .IP "char ** policy" 12 output variable with policy data .IP "size_t * sizeof_policy" 12 output variable size of policy data .SH "DESCRIPTION" This function will get information from a proxy certificate. It reads the ProxyCertInfo X.509 extension (1.3.6.1.5.5.7.1.14). .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_x509_simple_pkcs12_mem.30000644000000000000000000000474311271476020026713 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_x509_simple_pkcs12_mem" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_x509_simple_pkcs12_mem \- API function .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_x509_simple_pkcs12_mem(gnutls_certificate_credentials_t " res ", const gnutls_datum * " p12blob ", gnutls_x509_crt_fmt_t " type ", const char * " password ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .IP "const gnutls_datum * p12blob" 12 the PKCS\fB12\fP blob. .IP "gnutls_x509_crt_fmt_t type" 12 is PEM or DER of the \fIpkcs12file\fP. .IP "const char * password" 12 optional password used to decrypt PKCS\fB12\fP file, bags and keys. .SH "DESCRIPTION" This function sets a certificate/private key pair and/or a CRL in the gnutls_certificate_credentials_t structure. This function may be called more than once (in case multiple keys/certificates exist for the server). .SH "MAC" ed PKCS\fB12\fP files are supported. Encrypted PKCS\fB12\fP bags are supported. Encrypted PKCS\fB8\fP private keys are supported. However, only password based security, and the same password for all operations, are supported. The private keys may be RSA PKCS\fB1\fP or DSA private keys encoded in the OpenSSL way. PKCS\fB12\fP file may contain many keys and/or certificates, and there is no way to identify which key/certificate pair you want. You should make sure the PKCS\fB12\fP file only contain one key/certificate pair and/or one CRL. It is believed that the limitations of this function is acceptable for most usage, and that any more flexibility would introduce complexity that would make it harder to use this functionality at all. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_record_disable_padding.30000644000000000000000000000266011271476020024022 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_record_disable_padding" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_record_disable_padding \- Used to disabled padding in TLS 1.0 and above .SH SYNOPSIS .B #include .sp .BI "void gnutls_record_disable_padding(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Used to disabled padding in TLS 1.0 and above. Normally you do not need to use this function, but there are buggy clients that complain if a server pads the encrypted data. This of course will disable protection against statistical attacks on the data. Normally only servers that require maximum compatibility with everything out there, need to call this function. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_get_ours.30000644000000000000000000000261511271476020023564 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_get_ours" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_get_ours \- return the raw certificate sent in the last handshake .SH SYNOPSIS .B #include .sp .BI "const gnutls_datum_t * gnutls_certificate_get_ours(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .SH "DESCRIPTION" Get the certificate as sent to the peer, in the last handshake. These certificates are in raw format. In X.509 this is a certificate list. In OpenPGP this is a single certificate. .SH "RETURNS" return a pointer to a \fBgnutls_datum_t\fP containing our certificates, or \fBNULL\fP in case of an error or if no certificate was used. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_hex2bin.30000644000000000000000000000266411271476020020736 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_hex2bin" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_hex2bin \- convert hex string into binary buffer. .SH SYNOPSIS .B #include .sp .BI "int gnutls_hex2bin(const char * " hex_data ", size_t " hex_size ", char * " bin_data ", size_t * " bin_size ");" .SH ARGUMENTS .IP "const char * hex_data" 12 string with data in hex format .IP "size_t hex_size" 12 size of hex data .IP "char * bin_data" 12 output array with binary data .IP "size_t * bin_size" 12 when calling *\fIbin_size\fP should hold size of \fIbin_data\fP, on return will hold actual size of \fIbin_data\fP. .SH "DESCRIPTION" Convert a buffer with hex data to binary data. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_extension_data.30000644000000000000000000000371011271476020024666 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_extension_data" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_extension_data \- Get the specified extension data .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_extension_data(gnutls_x509_crq_t " cert ", int " indx ", void * " data ", size_t * " sizeof_data ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t cert" 12 should contain a \fBgnutls_x509_crq_t\fP structure .IP "int indx" 12 Specifies which extension OID to send. Use zero to get the first one. .IP "void * data" 12 a pointer to a structure to hold the data (may be null) .IP "size_t * sizeof_data" 12 initially holds the size of \fIoid\fP .SH "DESCRIPTION" This function will return the requested extension data in the certificate. The extension data will be stored as a string in the provided buffer. Use \fBgnutls_x509_crq_get_extension_info()\fP to extract the OID and critical flag. Use \fBgnutls_x509_crq_get_extension_by_oid()\fP instead, if you want to get data indexed by the extension OID rather than sequence. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative value in case of an error. If your have reached the last extension available \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_allocate_server_credentials.30000644000000000000000000000312211271476020025565 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_allocate_server_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_allocate_server_credentials \- Used to allocate an gnutls_ia_server_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_ia_allocate_server_credentials(gnutls_ia_server_credentials_t * " sc ");" .SH ARGUMENTS .IP "gnutls_ia_server_credentials_t * sc" 12 is a pointer to an \fBgnutls_ia_server_credentials_t\fP structure. .SH "DESCRIPTION" This structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. Adding this credential to a session will enable TLS/IA, and will require an Application Phase after the TLS handshake (if the client support TLS/IA). Use \fBgnutls_ia_require_inner_phase()\fP to toggle the TLS/IA mode. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_set_version.30000644000000000000000000000256511271476020023371 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_set_version" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_set_version \- This function will set the Certificate request version .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_set_version(gnutls_x509_crq_t " crq ", unsigned int " version ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 should contain a gnutls_x509_crq_t structure .IP "unsigned int version" 12 holds the version number. For v1 Requests must be 1. .SH "DESCRIPTION" This function will set the version of the certificate request. For version 1 requests this must be one. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_rsa_export_get_pubkey.30000644000000000000000000000300311271476020023767 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_rsa_export_get_pubkey" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_rsa_export_get_pubkey \- return the peer's public key used in RSA-EXPORT authentication .SH SYNOPSIS .B #include .sp .BI "int gnutls_rsa_export_get_pubkey(gnutls_session_t " session ", gnutls_datum_t * " exponent ", gnutls_datum_t * " modulus ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .IP "gnutls_datum_t * exponent" 12 will hold the exponent. .IP "gnutls_datum_t * modulus" 12 will hold the modulus. .SH "DESCRIPTION" This function will return the peer's public key exponent and modulus used in the last RSA\-EXPORT authentication. The output parameters must be freed with \fBgnutls_free()\fP. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_rsa_params_export_raw.30000644000000000000000000000357511271476020024003 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_rsa_params_export_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_rsa_params_export_raw \- export the RSA parameters .SH SYNOPSIS .B #include .sp .BI "int gnutls_rsa_params_export_raw(gnutls_rsa_params_t " params ", gnutls_datum_t * " m ", gnutls_datum_t * " e ", gnutls_datum_t * " d ", gnutls_datum_t * " p ", gnutls_datum_t * " q ", gnutls_datum_t * " u ", unsigned int * " bits ");" .SH ARGUMENTS .IP "gnutls_rsa_params_t params" 12 a structure that holds the rsa parameters .IP "gnutls_datum_t * m" 12 will hold the modulus .IP "gnutls_datum_t * e" 12 will hold the public exponent .IP "gnutls_datum_t * d" 12 will hold the private exponent .IP "gnutls_datum_t * p" 12 will hold the first prime (p) .IP "gnutls_datum_t * q" 12 will hold the second prime (q) .IP "gnutls_datum_t * u" 12 will hold the coefficient .IP "unsigned int * bits" 12 if non null will hold the prime's number of bits .SH "DESCRIPTION" This function will export the RSA parameters found in the given structure. The new parameters will be allocated using \fBgnutls_malloc()\fP and will be stored in the appropriate datum. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an negative error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_pk_algorithm.30000644000000000000000000000313311271476020024340 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_pk_algorithm" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_pk_algorithm \- This function returns the certificate request's PublicKey algorithm .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_pk_algorithm(gnutls_x509_crq_t " crq ", unsigned int * " bits ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 should contain a gnutls_x509_crq_t structure .IP "unsigned int * bits" 12 if bits is non null it will hold the size of the parameters' in bits .SH "DESCRIPTION" This function will return the public key algorithm of a PKCS \\fB10\fP certificate request. If bits is non null, it should have enough size to hold the parameters size in bits. For RSA the bits returned is the modulus. For DSA the bits returned are of the public exponent. .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_free_credentials.30000644000000000000000000000264011271476020025231 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_free_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_free_credentials \- Used to free an allocated gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_free_credentials(gnutls_certificate_credentials_t " sc ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t sc" 12 is an \fBgnutls_certificate_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. This function does not free any temporary parameters associated with this structure (ie RSA and DH parameters are not freed by this function). .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_handshake.30000644000000000000000000000233611271476020021772 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_handshake" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_handshake \- API function .SH SYNOPSIS .B #include .sp .BI "int gnutls_ia_handshake(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Perform a TLS/IA handshake. This should be called after \fBgnutls_handshake()\fP iff \fBgnutls_ia_handshake_p()\fP. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_openpgp_key_mem2.30000644000000000000000000000363411271476020026052 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_openpgp_key_mem2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_openpgp_key_mem2 \- Used to set OpenPGP keys .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_openpgp_key_mem2(gnutls_certificate_credentials_t " res ", const gnutls_datum_t * " cert ", const gnutls_datum_t * " key ", const char * " subkey_id ", gnutls_openpgp_crt_fmt_t " format ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 the destination context to save the data. .IP "const gnutls_datum_t * cert" 12 the datum that contains the public key. .IP "const gnutls_datum_t * key" 12 the datum that contains the secret key. .IP "const char * subkey_id" 12 a hex encoded subkey id .IP "gnutls_openpgp_crt_fmt_t format" 12 the format of the keys .SH "DESCRIPTION" This funtion is used to load OpenPGP keys into the GnuTLS credentials structure. The files should only contain one key which is not encrypted. The special keyword "auto" is also accepted as \fIsubkey_id\fP. In that case the \fBgnutls_openpgp_crt_get_auth_subkey()\fP will be used to retrieve the subkey. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_psk_client_get_hint.30000644000000000000000000000245611271476020023412 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_psk_client_get_hint" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_psk_client_get_hint \- return the PSK identity hint of the peer .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_psk_client_get_hint(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .SH "DESCRIPTION" The PSK identity hint may give the client help in deciding which username to use. This should only be called in case of PSK authentication and in case of a client. .SH "RETURNS" the identity hint of the peer, or \fBNULL\fP in case of an error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_basic_constraints.30000644000000000000000000000406711271476020025377 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_basic_constraints" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_basic_constraints \- get certificate's basic constraints .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_basic_constraints(gnutls_x509_crq_t " cert ", unsigned int * " critical ", int * " ca ", int * " pathlen ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t cert" 12 should contain a \fBgnutls_x509_crq_t\fP structure .IP "unsigned int * critical" 12 will be non zero if the extension is marked as critical .IP "int * ca" 12 pointer to output integer indicating CA status, may be NULL, value is 1 if the certificate CA flag is set, 0 otherwise. .IP "int * pathlen" 12 pointer to output integer indicating path length (may be NULL), non\-negative values indicate a present pathLenConstraint field and the actual value, \-1 indicate that the field is absent. .SH "DESCRIPTION" This function will read the certificate's basic constraints, and return the certificates CA status. It reads the basicConstraints X.509 extension (2.5.29.19). .SH "RETURN VALUE" If the certificate is a CA a positive value will be returned, or zero if the certificate does not have CA flag set. A negative value may be returned in case of errors. If the certificate does not contain the basicConstraints extension \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_psk_set_params_function.30000644000000000000000000000255411271476020024315 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_psk_set_params_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_psk_set_params_function \- set the DH or RSA parameters callback .SH SYNOPSIS .B #include .sp .BI "void gnutls_psk_set_params_function(gnutls_psk_server_credentials_t " res ", gnutls_params_function * " func ");" .SH ARGUMENTS .IP "gnutls_psk_server_credentials_t res" 12 is a gnutls_psk_server_credentials_t structure .IP "gnutls_params_function * func" 12 is the function to be called .SH "DESCRIPTION" This function will set a callback in order for the server to get the Diffie\-Hellman or RSA parameters for psk authentication. The callback should return zero on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_strerror.30000644000000000000000000000245211271476020021254 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_strerror" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_strerror \- Returns a string with a description of an error .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_strerror(int " error ");" .SH ARGUMENTS .IP "int error" 12 is a GnuTLS error code, 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. Error codes are always a negative value. .SH "RETURNS" A string explaining the GnuTLS error message. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_psk_netconf_derive_key.30000644000000000000000000000311011271476020024101 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_psk_netconf_derive_key" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_psk_netconf_derive_key \- derive PSK Netconf key from password .SH SYNOPSIS .B #include .sp .BI "int gnutls_psk_netconf_derive_key(const char * " password ", const char * " psk_identity ", const char * " psk_identity_hint ", gnutls_datum_t * " output_key ");" .SH ARGUMENTS .IP "const char * password" 12 zero terminated string containing password. .IP "const char * psk_identity" 12 zero terminated string with PSK identity. .IP "const char * psk_identity_hint" 12 zero terminated string with PSK identity hint. .IP "gnutls_datum_t * output_key" 12 output variable, contains newly allocated *data pointer. .SH "DESCRIPTION" This function will derive a PSK key from a password, for use with the Netconf protocol. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_kx_get.30000644000000000000000000000225411271476020020653 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_kx_get" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_kx_get \- Returns the key exchange algorithm. .SH SYNOPSIS .B #include .sp .BI "gnutls_kx_algorithm_t gnutls_kx_get(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Get currently used key exchange algorithm. .SH "RETURNS" the key exchange algorithm used in the last handshake, a \fBgnutls_kx_algorithm_t\fP value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_x509_key_file.30000644000000000000000000000354311271476020025165 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_x509_key_file" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_x509_key_file \- Used to set keys in a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_x509_key_file(gnutls_certificate_credentials_t " res ", const char * " certfile ", const char * " keyfile ", gnutls_x509_crt_fmt_t " type ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .IP "const char * certfile" 12 is a file that containing the certificate list (path) for the specified private key, in PKCS7 format, or a list of certificates .IP "const char * keyfile" 12 is a file that contains the private key .IP "gnutls_x509_crt_fmt_t type" 12 is PEM or DER .SH "DESCRIPTION" This function sets a certificate/private key pair in the gnutls_certificate_credentials_t structure. This function may be called more than once (in case multiple keys/certificates exist for the server). Currently only PKCS\-1 encoded RSA and DSA private keys are accepted by this function. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_dh_set_prime_bits.30000644000000000000000000000310711271476020023053 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_dh_set_prime_bits" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_dh_set_prime_bits \- Used to set the bits for a DH ciphersuite .SH SYNOPSIS .B #include .sp .BI "void gnutls_dh_set_prime_bits(gnutls_session_t " session ", unsigned int " bits ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "unsigned int bits" 12 is the number of bits .SH "DESCRIPTION" This function sets the number of bits, for use in an Diffie\-Hellman key exchange. This is used both in DH ephemeral and DH anonymous cipher suites. This will set the minimum size of the prime that will be used for the handshake. In the client side it sets the minimum accepted number of bits. If a server sends a prime with less bits than that \fBGNUTLS_E_DH_PRIME_UNACCEPTABLE\fP will be returned by the handshake. This function has no effect in server side. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_key_usage.30000644000000000000000000000367611271476020023650 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_key_usage" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_key_usage \- return the certificate's key usage .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_key_usage(gnutls_x509_crq_t " cert ", unsigned int * " key_usage ", unsigned int * " critical ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t cert" 12 should contain a \fBgnutls_x509_crq_t\fP structure .IP "unsigned int * key_usage" 12 where the key usage bits will be stored .IP "unsigned int * critical" 12 will be non zero if the extension is marked as critical .SH "DESCRIPTION" This function will return certificate's key usage, by reading the keyUsage X.509 extension (2.5.29.15). The key usage value will .SH "ORED VALUES OF THE" \fBGNUTLS_KEY_DIGITAL_SIGNATURE\fP, \fBGNUTLS_KEY_NON_REPUDIATION\fP, \fBGNUTLS_KEY_KEY_ENCIPHERMENT\fP, \fBGNUTLS_KEY_DATA_ENCIPHERMENT\fP, \fBGNUTLS_KEY_KEY_AGREEMENT\fP, \fBGNUTLS_KEY_KEY_CERT_SIGN\fP, \fBGNUTLS_KEY_CRL_SIGN\fP, \fBGNUTLS_KEY_ENCIPHER_ONLY\fP, \fBGNUTLS_KEY_DECIPHER_ONLY\fP. .SH "RETURNS" the certificate key usage, or a negative value in case of parsing error. If the certificate does not contain the keyUsage extension \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_set_authority_key_id.30000644000000000000000000000266111271476020025250 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_set_authority_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_set_authority_key_id \- Set the CRL's authority key id .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_set_authority_key_id(gnutls_x509_crl_t " crl ", const void * " id ", size_t " id_size ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 a CRL of type \fBgnutls_x509_crl_t\fP .IP "const void * id" 12 The key ID .IP "size_t id_size" 12 Holds the size of the serial field. .SH "DESCRIPTION" This function will set the CRL's authority key ID extension. Only the keyIdentifier field can be set with this function. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_pk_rsa_raw.30000644000000000000000000000274111271476020024762 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_pk_rsa_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_pk_rsa_raw \- export the RSA public key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_pk_rsa_raw(gnutls_openpgp_crt_t " crt ", gnutls_datum_t * " m ", gnutls_datum_t * " e ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t crt" 12 Holds the certificate .IP "gnutls_datum_t * m" 12 will hold the modulus .IP "gnutls_datum_t * e" 12 will hold the public exponent .SH "DESCRIPTION" This function will export the RSA public key's parameters found in the given structure. The new parameters will be allocated using \fBgnutls_malloc()\fP and will be stored in the appropriate datum. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_set_key.30000644000000000000000000000256211271476020022471 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_set_key" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_set_key \- This function will associate the Certificate request with a key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_set_key(gnutls_x509_crq_t " crq ", gnutls_x509_privkey_t " key ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 should contain a gnutls_x509_crq_t structure .IP "gnutls_x509_privkey_t key" 12 holds a private key .SH "DESCRIPTION" This function will set the public parameters from the given private key to the request. Only RSA keys are currently supported. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_params_function.30000644000000000000000000000261711271476020026002 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_params_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_params_function \- set the DH or RSA parameters callback .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_set_params_function(gnutls_certificate_credentials_t " res ", gnutls_params_function * " func ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is a gnutls_certificate_credentials_t structure .IP "gnutls_params_function * func" 12 is the function to be called .SH "DESCRIPTION" This function will set a callback in order for the server to get the Diffie\-Hellman or RSA parameters for certificate authentication. The callback should return zero on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_dn_deinit.30000644000000000000000000000213011271476020022105 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_dn_deinit" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_dn_deinit \- API function .SH SYNOPSIS .B #include .sp .BI "void gnutls_x509_dn_deinit(gnutls_x509_dn_t " dn ");" .SH ARGUMENTS .IP "gnutls_x509_dn_t dn" 12 a DN opaque object pointer. .SH "DESCRIPTION" This function deallocates the DN object as returned by \fBgnutls_x509_dn_import()\fP. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_dn_import.30000644000000000000000000000272011271476020022150 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_dn_import" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_dn_import \- API function .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_dn_import(gnutls_x509_dn_t " dn ", const gnutls_datum_t * " data ");" .SH ARGUMENTS .IP "gnutls_x509_dn_t dn" 12 the structure that will hold the imported DN .IP "const gnutls_datum_t * data" 12 should contain a DER encoded RDN sequence .SH "DESCRIPTION" This function parses an RDN sequence and stores the result to a \fBgnutls_x509_dn_t\fP structure. The structure must have been initialized with \fBgnutls_x509_dn_init()\fP. You may use \fBgnutls_x509_dn_get_rdn_ava()\fP to decode the DN. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_bag_deinit.30000644000000000000000000000217211271476020022641 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_bag_deinit" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_bag_deinit \- This function deinitializes memory used by a gnutls_pkcs12_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_pkcs12_bag_deinit(gnutls_pkcs12_bag_t " bag ");" .SH ARGUMENTS .IP "gnutls_pkcs12_bag_t bag" 12 The structure to be initialized .SH "DESCRIPTION" This function will deinitialize a PKCS12 Bag structure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_verify_ring.30000644000000000000000000000317611271476020024321 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_verify_ring" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_verify_ring \- Verify all signatures in the key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_verify_ring(gnutls_openpgp_crt_t " key ", gnutls_openpgp_keyring_t " keyring ", unsigned int " flags ", unsigned int * " verify ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the structure that holds the key. .IP "gnutls_openpgp_keyring_t keyring" 12 holds the keyring to check against .IP "unsigned int flags" 12 unused (should be 0) .IP "unsigned int * verify" 12 will hold the certificate verification output. .SH "DESCRIPTION" Verify all signatures in the key, using the given set of keys (keyring). The key verification output will be put in \fIverify\fP and will be one or more of the \fBgnutls_certificate_status_t\fP enumerated elements bitwise or'd. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_srp_verifier.30000644000000000000000000000367311271476020022077 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_srp_verifier" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_srp_verifier \- Used to calculate an SRP verifier .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_protocol_get_version.30000644000000000000000000000227011271476020023635 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_protocol_get_version" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_protocol_get_version \- Returns the version of the currently used protocol .SH SYNOPSIS .B #include .sp .BI "gnutls_protocol_t gnutls_protocol_get_version(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Get TLS version, a \fBgnutls_protocol_t\fP value. .SH "RETURNS" the version of the currently used protocol. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs7_delete_crl.30000644000000000000000000000245411271476020022605 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs7_delete_crl" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs7_delete_crl \- deletes a CRL from a PKCS7 crl set .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs7_delete_crl(gnutls_pkcs7_t " pkcs7 ", int " indx ");" .SH ARGUMENTS .IP "gnutls_pkcs7_t pkcs7" 12 should contain a \fBgnutls_pkcs7_t\fP structure .IP "int indx" 12 the index of the crl to delete .SH "DESCRIPTION" This function will delete a crl from a PKCS7 or RFC2630 crl set. Index starts from 0. Returns 0 on success. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_proxy_dn.30000644000000000000000000000367611271476020023555 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_proxy_dn" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_proxy_dn \- Set Proxy Certificate subject's distinguished name .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_proxy_dn(gnutls_x509_crt_t " crt ", gnutls_x509_crt_t " eecrt ", unsigned int " raw_flag ", const void * " name ", unsigned int " sizeof_name ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a gnutls_x509_crt_t structure with the new proxy cert .IP "gnutls_x509_crt_t eecrt" 12 the end entity certificate that will be issuing the proxy .IP "unsigned int raw_flag" 12 must be 0, or 1 if the CN is DER encoded .IP "const void * name" 12 a pointer to the CN name, may be NULL (but MUST then be added later) .IP "unsigned int sizeof_name" 12 holds the size of \fIname\fP .SH "DESCRIPTION" This function will set the subject in \fIcrt\fP to the end entity's \fIeecrt\fP subject name, and add a single Common Name component \fIname\fP of size \fIsizeof_name\fP. This corresponds to the required proxy certificate naming style. Note that if \fIname\fP is \fBNULL\fP, you MUST set it later by using \fBgnutls_x509_crt_set_dn_by_oid()\fP or similar. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_compression_get_name.30000644000000000000000000000243111271476020023567 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_compression_get_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_compression_get_name \- Returns a string with the name of the specified compression algorithm .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_compression_get_name(gnutls_compression_method_t " algorithm ");" .SH ARGUMENTS .IP "gnutls_compression_method_t algorithm" 12 is a Compression algorithm .SH "DESCRIPTION" Convert a \fBgnutls_compression_method_t\fP value to a string. .SH "RETURNS" a pointer to a string that contains the name of the specified compression algorithm, or \fBNULL\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_deinit.30000644000000000000000000000221011271476020024137 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_deinit" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_deinit \- deinitializes memory used by a #gnutls_openpgp_privkey_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_openpgp_privkey_deinit(gnutls_openpgp_privkey_t " key ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 The structure to be initialized .SH "DESCRIPTION" This function will deinitialize a key structure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_kx_list.30000644000000000000000000000222011271476020021040 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_kx_list" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_kx_list \- Get a list of supported key exchange methods .SH SYNOPSIS .B #include .sp .BI "const gnutls_kx_algorithm_t * gnutls_kx_list( " void ");" .SH ARGUMENTS .IP " void" 12 .SH "DESCRIPTION" Get a list of supported key exchange algorithms. .SH "RETURNS" a zero\-terminated list of \fBgnutls_kx_algorithm_t\fP integers indicating the available key exchange algorithms. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_check_revocation.30000644000000000000000000000303411271476020024332 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_check_revocation" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_check_revocation \- This function checks if the given certificate is revoked .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_check_revocation(gnutls_x509_crt_t " cert ", const gnutls_x509_crl_t * " crl_list ", int " crl_list_length ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "const gnutls_x509_crl_t * crl_list" 12 should contain a list of gnutls_x509_crl_t structures .IP "int crl_list_length" 12 the length of the crl_list .SH "DESCRIPTION" This function will return check if the given certificate is revoked. It is assumed that the CRLs have been verified before. .SH "RETURNS" 0 if the certificate is NOT revoked, and 1 if it is. A negative value is returned on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_print.30000644000000000000000000000301311271476020022145 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_print" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_print \- Pretty print X.509 certificate revocation list .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_print(gnutls_x509_crl_t " crl ", gnutls_certificate_print_formats_t " format ", gnutls_datum_t * " out ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 The structure to be printed .IP "gnutls_certificate_print_formats_t format" 12 Indicate the format to use .IP "gnutls_datum_t * out" 12 Newly allocated datum with zero terminated string. .SH "DESCRIPTION" This function will pretty print a X.509 certificate revocation list, suitable for display to a human. The output \fIout\fP needs to be deallocate using \fBgnutls_free()\fP. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pk_get_id.30000644000000000000000000000256311271476020021322 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pk_get_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pk_get_id \- Get #gnutls_pk_algorithm_t from a string .SH SYNOPSIS .B #include .sp .BI "gnutls_pk_algorithm_t gnutls_pk_get_id(const char * " name ");" .SH ARGUMENTS .IP "const char * name" 12 is a string containing a public key algorithm name. .SH "DESCRIPTION" Convert a string to a \fBgnutls_pk_algorithm_t\fP value. The names are compared in a case insensitive way. For example, gnutls_pk_get_id("RSA") will return \fBGNUTLS_PK_RSA\fP. .SH "RETURNS" an \fBgnutls_pk_algorithm_tid\fP of the specified in a string public key algorithm, or \fBGNUTLS_PK_UNKNOWN\fP on failures. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_srp_base64_decode.30000644000000000000000000000305211271476020022642 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_srp_base64_decode" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_srp_base64_decode \- decode SRP-base64 encoded data .SH SYNOPSIS .B #include .sp .BI "int gnutls_srp_base64_decode(const gnutls_datum_t * " b64_data ", char * " result ", size_t * " result_size ");" .SH ARGUMENTS .IP "const gnutls_datum_t * b64_data" 12 contain the encoded data .IP "char * result" 12 the place where decoded data will be copied .IP "size_t * result_size" 12 holds the size of the result .SH "DESCRIPTION" This function will decode the given encoded data, using the base64 encoding found in libsrp. Note that b64_data should be null terminated. Warning! This base64 encoding is not the "standard" encoding, so do not use it for non\-SRP purposes. .SH "RETURNS" \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP if the buffer given is not long enough, or 0 on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_openpgp_key.30000644000000000000000000000324611271476020025131 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_openpgp_key" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_openpgp_key \- Used to set keys in a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_openpgp_key(gnutls_certificate_credentials_t " res ", gnutls_openpgp_crt_t " crt ", gnutls_openpgp_privkey_t " pkey ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .IP "gnutls_openpgp_crt_t crt" 12 .IP "gnutls_openpgp_privkey_t pkey" 12 is an openpgp private key .SH "DESCRIPTION" This function sets a certificate/private key pair in the gnutls_certificate_credentials_t structure. This function may be called more than once (in case multiple keys/certificates exist for the server). With this function the subkeys of the certificate are not used. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_key_id.30000644000000000000000000000353411271476020023131 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_key_id \- Return unique ID of public key's parameters .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_key_id(gnutls_x509_crq_t " crq ", unsigned int " flags ", unsigned char * " output_data ", size_t * " output_data_size ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 Holds the certificate signing request .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 private key. If the buffer provided is not long enough to hold the output, then *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. The output will normally be a SHA\-1 hash output, which is 20 bytes. .SH "RETURN VALUE" In case of failure a negative value will be returned, and 0 on success. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_get_signature_algorithm.30000644000000000000000000000245511271476020025730 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_get_signature_algorithm" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_get_signature_algorithm \- returns the CRL's signature algorithm .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_get_signature_algorithm(gnutls_x509_crl_t " crl ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a \fBgnutls_x509_crl_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" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_bye.30000644000000000000000000000465011271476020020153 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_bye" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_bye \- terminate the current TLS/SSL connection. .SH SYNOPSIS .B #include .sp .BI "int gnutls_bye(gnutls_session_t " session ", gnutls_close_request_t " how ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "gnutls_close_request_t how" 12 is an integer .SH "DESCRIPTION" Terminates the current TLS/SSL connection. The connection should have been initiated using \fBgnutls_handshake()\fP. \fIhow\fP should be one of \fBGNUTLS_SHUT_RDWR\fP, \fBGNUTLS_SHUT_WR\fP. In case of \fBGNUTLS_SHUT_RDWR\fP then the TLS connection gets terminated and further receives and sends will be disallowed. If the return value is zero you may continue using the connection. \fBGNUTLS_SHUT_RDWR\fP actually sends an alert containing a close request and waits for the peer to reply with the same message. In case of \fBGNUTLS_SHUT_WR\fP then the TLS connection gets terminated and further sends will be disallowed. In order to reuse the connection you should wait for an EOF from the peer. \fBGNUTLS_SHUT_WR\fP sends an alert containing a close request. Note that not all implementations will properly terminate a TLS connection. Some of them, usually for performance reasons, will terminate only the underlying transport layer, thus causing a transmission error to the peer. This error cannot be distinguished from a malicious party prematurely terminating the session, thus this behavior is not recommended. This function may also return \fBGNUTLS_E_AGAIN\fP or \fBGNUTLS_E_INTERRUPTED\fP; cf. \fBgnutls_record_get_direction()\fP. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code, see function documentation for entire semantics. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_subject_key_id.30000644000000000000000000000326111271476020024650 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_subject_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_subject_key_id \- This function returns the certificate's key identifier .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_bag_encrypt.30000644000000000000000000000257011271476020023053 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_bag_encrypt" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_bag_encrypt \- This function will encrypt a bag .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_bag_encrypt(gnutls_pkcs12_bag_t " bag ", const char * " pass ", unsigned int " flags ");" .SH ARGUMENTS .IP "gnutls_pkcs12_bag_t bag" 12 The bag .IP "const char * pass" 12 The password used for encryption, must be ASCII .IP "unsigned int flags" 12 should be one of \fBgnutls_pkcs_encrypt_flags_t\fP elements bitwise or'd .SH "DESCRIPTION" This function will encrypt the given bag. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pem_base64_decode_alloc.30000644000000000000000000000324211271476020023772 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pem_base64_decode_alloc" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pem_base64_decode_alloc \- decode base64 encoded data .SH SYNOPSIS .B #include .sp .BI "int gnutls_pem_base64_decode_alloc(const char * " header ", const gnutls_datum_t * " b64_data ", gnutls_datum_t * " result ");" .SH ARGUMENTS .IP "const char * header" 12 The PEM header (eg. CERTIFICATE) .IP "const gnutls_datum_t * b64_data" 12 contains the encoded data .IP "gnutls_datum_t * result" 12 the place where decoded data lie .SH "DESCRIPTION" This function will decode the given encoded data. The decoded data will be allocated, and stored into result. If the header given is non null this function will search for "\-\-\-\-\-BEGIN header" and decode only this part. Otherwise it will decode the first PEM packet found. You should use \fBgnutls_free()\fP to free the returned data. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_cipher_get_key_size.30000644000000000000000000000227711271476020023412 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_cipher_get_key_size" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_cipher_get_key_size \- Returns the length of the cipher's key size .SH SYNOPSIS .B #include .sp .BI "size_t gnutls_cipher_get_key_size(gnutls_cipher_algorithm_t " algorithm ");" .SH ARGUMENTS .IP "gnutls_cipher_algorithm_t algorithm" 12 is an encryption algorithm .SH "DESCRIPTION" Get key size for cipher. .SH "RETURNS" length (in bytes) of the given cipher's key size, or 0 if the given cipher is invalid. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_extension_data.30000644000000000000000000000366111271476020024676 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_extension_data" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_extension_data \- Get the specified extension data .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_extension_data(gnutls_x509_crt_t " cert ", int " indx ", void * " data ", size_t * " sizeof_data ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "int indx" 12 Specifies which extension OID to send. Use zero to get the first one. .IP "void * data" 12 a pointer to a structure to hold the data (may be null) .IP "size_t * sizeof_data" 12 initially holds the size of \fIoid\fP .SH "DESCRIPTION" This function will return the requested extension data in the certificate. The extension data will be stored as a string in the provided buffer. Use \fBgnutls_x509_crt_get_extension_info()\fP to extract the OID and critical flag. Use \fBgnutls_x509_crt_get_extension_by_oid()\fP instead, if you want to get data indexed by the extension OID rather than sequence. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. If you have reached the last extension available \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_pk_rsa_raw.30000644000000000000000000000272011271476020024014 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_pk_rsa_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_pk_rsa_raw \- This function will export the RSA public key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_pk_rsa_raw(gnutls_x509_crt_t " crt ", gnutls_datum_t * " m ", gnutls_datum_t * " e ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 Holds the certificate .IP "gnutls_datum_t * m" 12 will hold the modulus .IP "gnutls_datum_t * e" 12 will hold the public exponent .SH "DESCRIPTION" This function will export the RSA public key's parameters found in the given structure. The new parameters will be allocated using \fBgnutls_malloc()\fP and will be stored in the appropriate datum. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_mac_get.30000644000000000000000000000223111271476020020764 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_mac_get" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_mac_get \- Returns the currently used mac algorithm. .SH SYNOPSIS .B #include .sp .BI "gnutls_mac_algorithm_t gnutls_mac_get(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Get currently used MAC algorithm. .SH "RETURNS" the currently used mac algorithm, a \fBgnutls_mac_algorithm_t\fP value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_srp_set_client_credentials_function.30000644000000000000000000000404111271476020026665 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_srp_set_client_credentials_function" 3 "2.8.1" "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 .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_transport_set_lowat.30000644000000000000000000000272711271476020023514 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_transport_set_lowat" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_transport_set_lowat \- Used to set the lowat value in order for select to check for pending data. .SH SYNOPSIS .B #include .sp .BI "void gnutls_transport_set_lowat(gnutls_session_t " session ", int " num ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "int num" 12 is the low water value. .SH "DESCRIPTION" Used to set the lowat value in order for select to check if there are pending data to socket buffer. Used only if you have changed the default low water value (default is 1). Normally you will not need that function. This function is only useful if using berkeley style sockets. Otherwise it must be called and set lowat to zero. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_free_cas.30000644000000000000000000000245711271476020023510 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_free_cas" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_free_cas \- Used to free all the CAs from a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_free_cas(gnutls_certificate_credentials_t " sc ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t sc" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .SH "DESCRIPTION" This function will delete all the CAs associated with the given credentials. Servers that do not use \fBgnutls_certificate_verify_peers2()\fP may call this to save some memory. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_dh_get_secret_bits.30000644000000000000000000000244711271476020023216 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_dh_get_secret_bits" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_dh_get_secret_bits \- return the bits used in DH authentication .SH SYNOPSIS .B #include .sp .BI "int gnutls_dh_get_secret_bits(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .SH "DESCRIPTION" This function will return the bits used in the last Diffie\-Hellman authentication with the peer. Should be used for both anonymous and ephemeral Diffie\-Hellman. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_transport_set_ptr2.30000644000000000000000000000300711271476020023245 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_transport_set_ptr2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_transport_set_ptr2 \- Used to set first argument of the transport functions .SH SYNOPSIS .B #include .sp .BI "void gnutls_transport_set_ptr2(gnutls_session_t " session ", gnutls_transport_ptr_t " recv_ptr ", gnutls_transport_ptr_t " send_ptr ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "gnutls_transport_ptr_t recv_ptr" 12 is the value for the pull function .IP "gnutls_transport_ptr_t send_ptr" 12 is the value for the push function .SH "DESCRIPTION" Used to set the first argument of the transport function (like PUSH and PULL). In berkeley style sockets this function will set the connection handle. With this function you can use two different pointers for receiving and sending. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_pk_algorithm.30000644000000000000000000000306511271476020025312 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_pk_algorithm" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_pk_algorithm \- return the key's PublicKey algorithm .SH SYNOPSIS .B #include .sp .BI "gnutls_pk_algorithm_t gnutls_openpgp_crt_get_pk_algorithm(gnutls_openpgp_crt_t " key ", unsigned int * " bits ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 is an OpenPGP key .IP "unsigned int * bits" 12 if bits is non null it will hold the size of the parameters' in bits .SH "DESCRIPTION" This function will return the public key algorithm of an OpenPGP certificate. If bits is non null, it should have enough size to hold the parameters size in bits. For RSA the bits returned is the modulus. For DSA the bits returned are of the public exponent. .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_db_check_entry.30000644000000000000000000000257011271476020022336 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_db_check_entry" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_db_check_entry \- check if the given db entry has expired .SH SYNOPSIS .B #include .sp .BI "int gnutls_db_check_entry(gnutls_session_t " session ", gnutls_datum_t " session_entry ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "gnutls_datum_t session_entry" 12 is the session data (not key) .SH "DESCRIPTION" Check if database entry has expired. This function is to be used when you want to clear unnesessary session which occupy space in your backend. .SH "RETURNS" Returns \fBGNUTLS_E_EXPIRED\fP, if the database entry has expired or 0 otherwise. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_openpgp_keyring_file.30000644000000000000000000000312511271476020027004 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_openpgp_keyring_file" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_openpgp_keyring_file \- Sets a keyring file for OpenPGP .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_openpgp_keyring_file(gnutls_certificate_credentials_t " c ", const char * " file ", gnutls_openpgp_crt_fmt_t " format ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t c" 12 A certificate credentials structure .IP "const char * file" 12 filename of the keyring. .IP "gnutls_openpgp_crt_fmt_t format" 12 format of keyring. .SH "DESCRIPTION" The function is used to set keyrings that will be used internally by various OpenPGP functions. For example to find a key when it is needed for an operations. The keyring will also be used at the verification functions. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_generate.30000644000000000000000000000277311271476020023530 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_generate" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_generate \- generate a private key .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_x509_crl_mem.30000644000000000000000000000327211271476020025013 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_x509_crl_mem" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_x509_crl_mem \- Used to add CRLs in a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_x509_crl_mem(gnutls_certificate_credentials_t " res ", const gnutls_datum_t * " CRL ", gnutls_x509_crt_fmt_t " type ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .IP "const gnutls_datum_t * CRL" 12 is a list of trusted CRLs. They should have been verified before. .IP "gnutls_x509_crt_fmt_t type" 12 is DER or PEM .SH "DESCRIPTION" This function adds the trusted CRLs in order to verify client or server certificates. In case of a client this is not required to be called if the certificates are not verified using \fBgnutls_certificate_verify_peers2()\fP. This function may be called multiple times. .SH "RETURNS" number of CRLs processed, or a negative value on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_extension_info.30000644000000000000000000000414411271476020024712 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_extension_info" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_extension_info \- Get extension id and criticality .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_extension_info(gnutls_x509_crq_t " cert ", int " indx ", void * " oid ", size_t * " sizeof_oid ", int * " critical ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t cert" 12 should contain a \fBgnutls_x509_crq_t\fP structure .IP "int indx" 12 Specifies which extension OID to send. Use zero to get the first one. .IP "void * oid" 12 a pointer to a structure to hold the OID .IP "size_t * sizeof_oid" 12 initially holds the maximum size of \fIoid\fP, on return holds actual size of \fIoid\fP. .IP "int * critical" 12 output variable with critical flag, may be NULL. .SH "DESCRIPTION" This function will return the requested extension OID in the certificate, and the critical flag for it. The extension OID will be stored as a string in the provided buffer. Use \fBgnutls_x509_crq_get_extension_data()\fP to extract the data. If the buffer provided is not long enough to hold the output, then *\fIsizeof_oid\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 value in case of an error. If your have reached the last extension available \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_send_cert.30000644000000000000000000000272311271476020023071 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_send_cert" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_send_cert \- order gnutls to send the openpgp fingerprint instead of the key .SH SYNOPSIS .B #include .sp .BI "void gnutls_openpgp_send_cert(gnutls_session_t " session ", gnutls_openpgp_crt_status_t " status ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a pointer to a \fBgnutls_session_t\fP structure. .IP "gnutls_openpgp_crt_status_t status" 12 is one of GNUTLS_OPENPGP_CERT, or GNUTLS_OPENPGP_CERT_FINGERPRINT .SH "DESCRIPTION" This function will order gnutls to send the key fingerprint instead of the key in the initial handshake procedure. This should be used with care and only when there is indication or knowledge that the server can obtain the client's key. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_raw_issuer_dn.30000644000000000000000000000261111271476020024527 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_raw_issuer_dn" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_raw_issuer_dn \- This function returns the issuer's DN DER encoded .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_raw_issuer_dn(gnutls_x509_crt_t " cert ", gnutls_datum_t * " start ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "gnutls_datum_t * start" 12 will hold the starting point of the DN .SH "DESCRIPTION" This function will return a pointer to the DER encoded DN structure and the length. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value.or a negative value on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_set_recv_key_function.30000644000000000000000000000253111271476020025507 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_set_recv_key_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_set_recv_key_function \- Used to set a key retrieval callback for PGP keys .SH SYNOPSIS .B #include .sp .BI "void gnutls_openpgp_set_recv_key_function(gnutls_session_t " session ", gnutls_openpgp_recv_key_func " func ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 a TLS session .IP "gnutls_openpgp_recv_key_func func" 12 the callback .SH "DESCRIPTION" This funtion will set a key retrieval function for OpenPGP keys. This callback is only useful in server side, and will be used if the peer sent a key fingerprint instead of a full key. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_basic_constraints.30000644000000000000000000000304611271476020025412 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_basic_constraints" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_basic_constraints \- Set the basicConstraints extension .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_basic_constraints(gnutls_x509_crt_t " crt ", unsigned int " ca ", int " pathLenConstraint ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "unsigned int ca" 12 true(1) or false(0). Depending on the Certificate authority status. .IP "int pathLenConstraint" 12 non\-negative values indicate maximum length of path, and negative values indicate that the pathLenConstraints field should not be present. .SH "DESCRIPTION" This function will set the basicConstraints certificate extension. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_get_extension_info.30000644000000000000000000000413211271476020024702 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_get_extension_info" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_get_extension_info \- Get extension id and criticality .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_get_extension_info(gnutls_x509_crl_t " crl ", int " indx ", void * " oid ", size_t * " sizeof_oid ", int * " critical ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a \fBgnutls_x509_crl_t\fP structure .IP "int indx" 12 Specifies which extension OID to send, use zero to get the first one. .IP "void * oid" 12 a pointer to a structure to hold the OID .IP "size_t * sizeof_oid" 12 initially holds the maximum size of \fIoid\fP, on return holds actual size of \fIoid\fP. .IP "int * critical" 12 output variable with critical flag, may be NULL. .SH "DESCRIPTION" This function will return the requested extension OID in the CRL, and the critical flag for it. The extension OID will be stored as a string in the provided buffer. Use \fBgnutls_x509_crl_get_extension_data()\fP to extract the data. If the buffer provided is not long enough to hold the output, then *\fIsizeof_oid\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 value in case of an error. If your have reached the last extension available \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_get_preferred_key_id.30000644000000000000000000000257111271476020027036 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_get_preferred_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_get_preferred_key_id \- Gets the preferred keyID .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_get_preferred_key_id(gnutls_openpgp_privkey_t " key ", gnutls_openpgp_keyid_t " keyid ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 the structure that contains the OpenPGP public key. .IP "gnutls_openpgp_keyid_t keyid" 12 the struct to save the keyid. .SH "DESCRIPTION" Get the preferred key\-id for the key. .SH "RETURNS" the 64\-bit preferred keyID of the OpenPGP key, or if it hasn't been set it returns \fBGNUTLS_E_INVALID_REQUEST\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_raw_dn.30000644000000000000000000000256611271476020023146 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_raw_dn" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_raw_dn \- This function returns the subject's DN DER encoded .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_raw_dn(gnutls_x509_crt_t " cert ", gnutls_datum_t * " start ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "gnutls_datum_t * start" 12 will hold the starting point of the DN .SH "DESCRIPTION" This function will return a pointer to the DER encoded DN structure and the length. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. or a negative value on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_session_get_data.30000644000000000000000000000332011271476020022700 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_session_get_data" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_session_get_data \- Returns all session parameters. .SH SYNOPSIS .B #include .sp .BI "int gnutls_session_get_data(gnutls_session_t " session ", void * " session_data ", size_t * " session_data_size ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "void * session_data" 12 is a pointer to space to hold the session. .IP "size_t * session_data_size" 12 is the session_data's size, or it will be set by the function. .SH "DESCRIPTION" Returns all session parameters, in order to support resuming. The client should call this, and keep the returned session, if he wants to resume that current version later by calling \fBgnutls_session_set_data()\fP This function must be called after a successful handshake. Resuming sessions is really useful and speedups connections after a succesful one. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_import_rsa_raw.30000644000000000000000000000347111271476020024762 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_import_rsa_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_import_rsa_raw \- import a raw RSA key .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_auth_get_type.30000644000000000000000000000304211271476020022227 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_auth_get_type" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_auth_get_type \- Returns the type of credentials for the current authentication schema. .SH SYNOPSIS .B #include .sp .BI "gnutls_credentials_type_t gnutls_auth_get_type(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Returns type of credentials for the current authentication schema. The returned information is to be used to distinguish the function used to access authentication data. Eg. for CERTIFICATE ciphersuites (key exchange algorithms: \fBGNUTLS_KX_RSA\fP, \fBGNUTLS_KX_DHE_RSA\fP), the same function are to be used to access the authentication data. .SH "RETURNS" The type of credentials for the current authentication schema, an \fBgnutls_credentials_type_t\fP type. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_protocol_set_priority.30000644000000000000000000000264311271476020024051 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_protocol_set_priority" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_protocol_set_priority \- Sets the priority on the protocol versions supported by gnutls. .SH SYNOPSIS .B #include .sp .BI "int gnutls_protocol_set_priority(gnutls_session_t " session ", const int * " list ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "const int * list" 12 is a 0 terminated list of gnutls_protocol_t elements. .SH "DESCRIPTION" Sets the priority on the protocol versions supported by gnutls. This function actually enables or disables protocols. Newer protocol versions always have highest priority. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_sign_hash.30000644000000000000000000000306011271476020023667 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_sign_hash" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_sign_hash \- sign hash using the private key .SH SYNOPSIS .B #include .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. Do not use this function directly unless you know what it is. Typical signing requires the data to be hashed and stored in special formats (e.g. BER Digest\-Info for RSA). .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_subject_alt_othername_oid.30000644000000000000000000000444711271476020027070 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_subject_alt_othername_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_subject_alt_othername_oid \- Get SAN otherName OID .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_export_rsa_raw.30000644000000000000000000000350711271476020024771 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_export_rsa_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_export_rsa_raw \- export the RSA private key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_privkey_export_rsa_raw(gnutls_x509_privkey_t " key ", gnutls_datum_t * " m ", gnutls_datum_t * " e ", gnutls_datum_t * " d ", gnutls_datum_t * " p ", gnutls_datum_t * " q ", gnutls_datum_t * " u ");" .SH ARGUMENTS .IP "gnutls_x509_privkey_t key" 12 a structure that holds the rsa parameters .IP "gnutls_datum_t * m" 12 will hold the modulus .IP "gnutls_datum_t * e" 12 will hold the public exponent .IP "gnutls_datum_t * d" 12 will hold the private exponent .IP "gnutls_datum_t * p" 12 will hold the first prime (p) .IP "gnutls_datum_t * q" 12 will hold the second prime (q) .IP "gnutls_datum_t * u" 12 will hold the coefficient .SH "DESCRIPTION" This function will export the RSA private key's parameters found in the given structure. The new parameters will be allocated using \fBgnutls_malloc()\fP and will be stored in the appropriate datum. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_anon_set_params_function.30000644000000000000000000000256711271476020024457 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_anon_set_params_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_anon_set_params_function \- set the DH or RSA parameters callback .SH SYNOPSIS .B #include .sp .BI "void gnutls_anon_set_params_function(gnutls_anon_server_credentials_t " res ", gnutls_params_function * " func ");" .SH ARGUMENTS .IP "gnutls_anon_server_credentials_t res" 12 is a gnutls_anon_server_credentials_t structure .IP "gnutls_params_function * func" 12 is the function to be called .SH "DESCRIPTION" This function will set a callback in order for the server to get the Diffie\-Hellman or RSA parameters for anonymous authentication. The callback should return zero on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_sign_get_name.30000644000000000000000000000240511271476020022167 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_sign_get_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_sign_get_name \- Get name string for a #gnutls_sign_algorithm_t .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_sign_get_name(gnutls_sign_algorithm_t " algorithm ");" .SH ARGUMENTS .IP "gnutls_sign_algorithm_t algorithm" 12 is a public key signature algorithm .SH "DESCRIPTION" Convert a \fBgnutls_sign_algorithm_t\fP value to a string. .SH "RETURNS" a pointer to a string that contains the name of the specified public key signature algorithm, or \fBNULL\fP. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_srp_server_get_username.30000644000000000000000000000242611271476020024323 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_srp_server_get_username" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_srp_server_get_username \- return the username of the peer .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_verify_peers.30000644000000000000000000000302711271476020024435 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_verify_peers" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_verify_peers \- return the peer's certificate verification status .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_verify_peers(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .SH "DESCRIPTION" This function will try to verify the peer's certificate and return its status (trusted, invalid etc.). However you must also check the peer's name in order to check if the verified certificate belongs to the actual peer. This function uses \fBgnutls_x509_crt_list_verify()\fP. .SH "RETURNS" one or more of the \fBgnutls_certificate_status_t\fP enumerated elements bitwise or'd, or a negative value on error. .SH "DEPRECATED" Use \fBgnutls_certificate_verify_peers2()\fP instead. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_server_name_set.30000644000000000000000000000351711271476020022556 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_server_name_set" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_server_name_set \- set a name indicator to be sent as an extension .SH SYNOPSIS .B #include .sp .BI "int gnutls_server_name_set(gnutls_session_t " session ", gnutls_server_name_type_t " type ", const void * " name ", size_t " name_length ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "gnutls_server_name_type_t type" 12 specifies the indicator type .IP "const void * name" 12 is a string that contains the server name. .IP "size_t name_length" 12 holds the length of name .SH "DESCRIPTION" This function is to be used by clients that want to inform (via a TLS extension mechanism) the server of the name they connected to. This should be used by clients that connect to servers that do virtual hosting. The value of \fIname\fP depends on the \fIind\fP type. In case of GNUTLS_NAME_DNS, an ASCII or UTF\-8 null terminated string, without the trailing dot, is expected. IPv4 or IPv6 addresses are not permitted. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_get_subkey_expiration_time.30000644000000000000000000000255711271476020030322 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_get_subkey_expiration_time" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_get_subkey_expiration_time \- Extract the expire date .SH SYNOPSIS .B #include .sp .BI "time_t gnutls_openpgp_privkey_get_subkey_expiration_time(gnutls_openpgp_privkey_t " key ", unsigned int " idx ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 the structure that contains the OpenPGP private key. .IP "unsigned int idx" 12 the subkey index .SH "DESCRIPTION" Get subkey expiration time. A value of '0' means that the key doesn't expire at all. .SH "RETURNS" the time when the OpenPGP key expires. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs7_init.30000644000000000000000000000237511271476020021450 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs7_init" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs7_init \- initialize a #gnutls_pkcs7_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs7_init(gnutls_pkcs7_t * " pkcs7 ");" .SH ARGUMENTS .IP "gnutls_pkcs7_t * pkcs7" 12 The structure to be initialized .SH "DESCRIPTION" This function will initialize a PKCS7 structure. PKCS7 structures usually contain lists of X.509 Certificates and X.509 Certificate revocation lists. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_enable.30000644000000000000000000000406511271476020021273 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_enable" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_enable \- Indicate willingness for TLS/IA application phases .SH SYNOPSIS .B #include .sp .BI "void gnutls_ia_enable(gnutls_session_t " session ", int " allow_skip_on_resume ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "int allow_skip_on_resume" 12 non\-zero if local party allows to skip the TLS/IA application phases for a resumed session. .SH "DESCRIPTION" Specify whether we must advertise support for the TLS/IA extension during the handshake. At the client side, we always advertise TLS/IA if gnutls_ia_enable was called before the handshake; at the server side, we also require that the client has advertised that it wants to run TLS/IA before including the advertisement, as required by the protocol. Similarly, at the client side we always advertise that we allow TLS/IA to be skipped for resumed sessions if \fIallow_skip_on_resume\fP is non\-zero; at the server side, we also require that the session is indeed resumable and that the client has also advertised that it allows TLS/IA to be skipped for resumed sessions. After the TLS handshake, call \fBgnutls_ia_handshake_p()\fP to find out whether both parties agreed to do a TLS/IA handshake, before calling \fBgnutls_ia_handshake()\fP or one of the lower level gnutls_ia_* functions. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_alert_send_appropriate.30000644000000000000000000000307411271476020024121 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_alert_send_appropriate" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_alert_send_appropriate \- send alert to peer depending on error code .SH SYNOPSIS .B #include .sp .BI "int gnutls_alert_send_appropriate(gnutls_session_t " session ", int " err ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "int err" 12 is an integer .SH "DESCRIPTION" Sends an alert to the peer depending on the error code returned by a gnutls function. This function will call \fBgnutls_error_to_alert()\fP to determine the appropriate alert to send. This function may also return \fBGNUTLS_E_AGAIN\fP, or \fBGNUTLS_E_INTERRUPTED\fP. If the return value is \fBGNUTLS_E_INVALID_REQUEST\fP, then no alert has been sent to the peer. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_get_crt_serial.30000644000000000000000000000324211271476020024003 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_get_crt_serial" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_get_crt_serial \- get the serial number of a revoked certificate .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_get_crt_serial(gnutls_x509_crl_t " crl ", int " indx ", unsigned char * " serial ", size_t * " serial_size ", time_t * " t ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a \fBgnutls_x509_crl_t\fP structure .IP "int indx" 12 the index of the certificate to extract (starting from 0) .IP "unsigned char * serial" 12 where the serial number will be copied .IP "size_t * serial_size" 12 initially holds the size of serial .IP "time_t * t" 12 if non null, will hold the time this certificate was revoked .SH "DESCRIPTION" This function will retrieve the serial number of the specified, by the index, revoked 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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_free.30000644000000000000000000000210011271476020020301 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_free" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_free \- Returns a free() like function .SH SYNOPSIS .B #include .sp .BI "void gnutls_free(void * " ptr ");" .SH ARGUMENTS .IP "void * ptr" 12 .SH "DESCRIPTION" This function will free data pointed by ptr. The deallocation function used is the one set by \fBgnutls_global_set_mem_functions()\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_dn_by_oid.30000644000000000000000000000462011271476020023610 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_dn_by_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_dn_by_oid \- This function returns the Certificate request subject's distinguished name .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_dn_by_oid(gnutls_x509_crq_t " crq ", const char * " oid ", int " indx ", unsigned int " raw_flag ", void * " buf ", size_t * " sizeof_buf ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 should contain a gnutls_x509_crq_t structure .IP "const char * oid" 12 holds an Object Identified in null terminated string .IP "int indx" 12 In case multiple same OIDs exist in the RDN, this specifies which to send. Use zero to get the first one. .IP "unsigned int raw_flag" 12 If non zero returns the raw DER data of the DN part. .IP "void * buf" 12 a pointer to a structure to hold the name (may be null) .IP "size_t * sizeof_buf" 12 initially holds the size of \fIbuf\fP .SH "DESCRIPTION" This function will extract the part of the name of the Certificate request subject, specified by the given OID. The output will be encoded as described in RFC2253. The output string will be ASCII or UTF\-8 encoded, depending on the certificate data. Some helper macros with popular OIDs can be found in gnutls/x509.h If raw flag is zero, this function will only return known OIDs as text. Other OIDs will be DER encoded, as described in RFC2253 \-\- in hex format with a '\#' prefix. You can check about known OIDs using \fBgnutls_x509_dn_oid_known()\fP. If \fIbuf\fP is null then only the size will be filled. .SH "RETURNS" GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_buf will be updated with the required size. On success 0 is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs7_deinit.30000644000000000000000000000210011271476020021743 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs7_deinit" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs7_deinit \- deinitializes a #gnutls_pkcs7_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_pkcs7_deinit(gnutls_pkcs7_t " pkcs7 ");" .SH ARGUMENTS .IP "gnutls_pkcs7_t pkcs7" 12 The structure to be initialized .SH "DESCRIPTION" This function will deinitialize a PKCS7 structure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_expiration_time_peers.30000644000000000000000000000241711271476020026333 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_expiration_time_peers" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_expiration_time_peers \- return the peer's certificate expiration time .SH SYNOPSIS .B #include .sp .BI "time_t gnutls_certificate_expiration_time_peers(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .SH "DESCRIPTION" This function will return the peer's certificate expiration time. .SH "RETURNS" (time_t)\-1 on error. .SH "DEPRECATED" \fBgnutls_certificate_verify_peers2()\fP now verifies expiration times. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_name.30000644000000000000000000000302411271476020023545 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_name \- Extracts the userID .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_name(gnutls_openpgp_crt_t " key ", int " idx ", char * " buf ", size_t * " sizeof_buf ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the structure that contains the OpenPGP public key. .IP "int idx" 12 the index of the ID to extract .IP "char * buf" 12 a pointer to a structure to hold the name .IP "size_t * sizeof_buf" 12 holds the maximum size of \fIbuf\fP, on return hold the actual/required size of \fIbuf\fP. .SH "DESCRIPTION" Extracts the userID from the parsed OpenPGP key. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, and if the index of the ID does not exist \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_init.30000644000000000000000000000227611271476020023642 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_init" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_init \- initializes a #gnutls_openpgp_privkey_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_init(gnutls_openpgp_privkey_t * " key ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t * key" 12 The structure to be initialized .SH "DESCRIPTION" This function will initialize an OpenPGP key structure. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_global_set_mem_functions.30000644000000000000000000000423511271476020024434 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_global_set_mem_functions" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_global_set_mem_functions \- set the memory allocation functions .SH SYNOPSIS .B #include .sp .BI "void gnutls_global_set_mem_functions(gnutls_alloc_function " alloc_func ", gnutls_alloc_function " secure_alloc_func ", gnutls_is_secure_function " is_secure_func ", gnutls_realloc_function " realloc_func ", gnutls_free_function " free_func ");" .SH ARGUMENTS .IP "gnutls_alloc_function alloc_func" 12 it's the default memory allocation function. Like \fBmalloc()\fP. .IP "gnutls_alloc_function secure_alloc_func" 12 This is the memory allocation function that will be used for sensitive data. .IP "gnutls_is_secure_function is_secure_func" 12 a function that returns 0 if the memory given is not secure. May be NULL. .IP "gnutls_realloc_function realloc_func" 12 A realloc function .IP "gnutls_free_function free_func" 12 The function that frees allocated data. Must accept a NULL pointer. .SH "DESCRIPTION" This is the function were you set the memory allocation functions gnutls is going to use. By default the libc's allocation functions (\fBmalloc()\fP, \fBfree()\fP), are used by gnutls, to allocate both sensitive and not sensitive data. This function is provided to set the memory allocation functions to something other than the defaults (ie the gcrypt allocation functions). This function must be called before \fBgnutls_global_init()\fP is called. This function is not thread safe. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_mac_get_key_size.30000644000000000000000000000225311271476020022672 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_mac_get_key_size" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_mac_get_key_size \- Returns the length of the MAC's key size .SH SYNOPSIS .B #include .sp .BI "size_t gnutls_mac_get_key_size(gnutls_mac_algorithm_t " algorithm ");" .SH ARGUMENTS .IP "gnutls_mac_algorithm_t algorithm" 12 is an encryption algorithm .SH "DESCRIPTION" Get size of MAC key. .SH "RETURNS" length (in bytes) of the given MAC key size, or 0 if the given MAC algorithm is invalid. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_dh_get_prime_bits.30000644000000000000000000000273711271476020023047 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_dh_get_prime_bits" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_dh_get_prime_bits \- return the bits used in DH authentication .SH SYNOPSIS .B #include .sp .BI "int gnutls_dh_get_prime_bits(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .SH "DESCRIPTION" This function will return the bits of the prime used in the last Diffie\-Hellman authentication with the peer. Should be used for both anonymous and ephemeral Diffie\-Hellman. Note that some ciphers, like RSA and DSA without DHE, does not use a Diffie\-Hellman exchange, and then this function will return 0. .SH "RETURNS" The Diffie\-Hellman bit strength is returned, or 0 if no Diffie\-Hellman exchange was done, or a negative error code on failure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_rsa_params_import_raw.30000644000000000000000000000342711271476020023770 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_rsa_params_import_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_rsa_params_import_raw \- set the RSA parameters .SH SYNOPSIS .B #include .sp .BI "int gnutls_rsa_params_import_raw(gnutls_rsa_params_t " rsa_params ", 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_rsa_params_t rsa_params" 12 Is a structure will hold the parameters .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 replace the parameters in the given structure. The new parameters should be stored in the appropriate gnutls_datum. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an negative error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_revoked_status.30000644000000000000000000000233211271476020025670 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_revoked_status" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_revoked_status \- Gets the revoked status of the key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_revoked_status(gnutls_openpgp_crt_t " key ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the structure that contains the OpenPGP public key. .SH "DESCRIPTION" Get revocation status of key. .SH "RETURNS" true (1) if the key has been revoked, or false (0) if it has not. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_key_usage.30000644000000000000000000000245111271476020023655 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_key_usage" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_key_usage \- Set the keyUsage extension .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_key_usage(gnutls_x509_crt_t " crt ", unsigned int " usage ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "unsigned int usage" 12 an ORed sequence of the GNUTLS_KEY_* elements. .SH "DESCRIPTION" This function will set the keyUsage certificate extension. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_rehandshake.30000644000000000000000000000326611271476020021653 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_rehandshake" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_rehandshake \- renegotiate security parameters .SH SYNOPSIS .B #include .sp .BI "int gnutls_rehandshake(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" This function will renegotiate security parameters with the client. This should only be called in case of a server. This message informs the peer that we want to renegotiate parameters (perform a handshake). If this function succeeds (returns 0), you must call the \fBgnutls_handshake()\fP function in order to negotiate the new parameters. If the client does not wish to renegotiate parameters he will should with an alert message, thus the return code will be \fBGNUTLS_E_WARNING_ALERT_RECEIVED\fP and the alert will be \fBGNUTLS_A_NO_RENEGOTIATION\fP. A client may also choose to ignore this message. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_subject_alt_name2.30000644000000000000000000000464311271476020025253 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_subject_alt_name2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_subject_alt_name2 \- Get certificate's alternative name, if any .SH SYNOPSIS .B #include .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). .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_sign.30000644000000000000000000000251411271476020021763 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_sign" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_sign \- This function will sign a Certificate request with a key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_sign(gnutls_x509_crq_t " crq ", gnutls_x509_privkey_t " key ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 should contain a gnutls_x509_crq_t structure .IP "gnutls_x509_privkey_t key" 12 holds a private key .SH "DESCRIPTION" This function is the same a \fBgnutls_x509_crq_sign2()\fP with no flags, and SHA1 as the hash algorithm. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_basic_constraints.30000644000000000000000000000406411271476020025377 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_basic_constraints" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_basic_constraints \- This function returns the certificate basic constraints .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_basic_constraints(gnutls_x509_crt_t " cert ", unsigned int * " critical ", int * " ca ", int * " pathlen ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "unsigned int * critical" 12 will be non zero if the extension is marked as critical .IP "int * ca" 12 pointer to output integer indicating CA status, may be NULL, value is 1 if the certificate CA flag is set, 0 otherwise. .IP "int * pathlen" 12 pointer to output integer indicating path length (may be NULL), non\-negative values indicate a present pathLenConstraint field and the actual value, \-1 indicate that the field is absent. .SH "DESCRIPTION" This function will read the certificate's basic constraints, and return the certificates CA status. It reads the basicConstraints X.509 extension (2.5.29.19). .SH "RETURN VALUE" If the certificate is a CA a positive value will be returned, or zero if the certificate does not have CA flag set. A negative value may be returned in case of errors. If the certificate does not contain the basicConstraints extension GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_pk_dsa_raw.30000644000000000000000000000310611271476020023775 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_pk_dsa_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_pk_dsa_raw \- This function will export the DSA public key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_pk_dsa_raw(gnutls_x509_crt_t " crt ", gnutls_datum_t * " p ", gnutls_datum_t * " q ", gnutls_datum_t * " g ", gnutls_datum_t * " y ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 Holds the certificate .IP "gnutls_datum_t * p" 12 will hold the p .IP "gnutls_datum_t * q" 12 will hold the q .IP "gnutls_datum_t * g" 12 will hold the g .IP "gnutls_datum_t * y" 12 will hold the y .SH "DESCRIPTION" This function will export the DSA public key's parameters found in the given certificate. The new parameters will be allocated using \fBgnutls_malloc()\fP and will be stored in the appropriate datum. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_subkey_expiration_time.30000644000000000000000000000251011271476020027406 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_subkey_expiration_time" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_subkey_expiration_time \- Extract the expire date .SH SYNOPSIS .B #include .sp .BI "time_t gnutls_openpgp_crt_get_subkey_expiration_time(gnutls_openpgp_crt_t " key ", unsigned int " idx ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the structure that contains the OpenPGP public key. .IP "unsigned int idx" 12 the subkey index .SH "DESCRIPTION" Get subkey expiration time. A value of '0' means that the key doesn't expire at all. .SH "RETURNS" the time when the OpenPGP key expires. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_get_key_id.30000644000000000000000000000351411271476020024033 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_get_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_get_key_id \- Return unique ID of the key's parameters .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_subkey_id.30000644000000000000000000000245411271476020024611 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_subkey_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_subkey_id \- Gets the keyID .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_subkey_id(gnutls_openpgp_crt_t " key ", unsigned int " idx ", gnutls_openpgp_keyid_t " keyid ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the structure that contains the OpenPGP public key. .IP "unsigned int idx" 12 the subkey index .IP "gnutls_openpgp_keyid_t keyid" 12 the buffer to save the keyid. .SH "DESCRIPTION" Get the subkey's key\-id. .SH "RETURNS" the 64\-bit keyID of the OpenPGP key. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_rsa_params_cpy.30000644000000000000000000000243711271476020022400 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_rsa_params_cpy" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_rsa_params_cpy \- copy an RSA parameters structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_rsa_params_cpy(gnutls_rsa_params_t " dst ", gnutls_rsa_params_t " src ");" .SH ARGUMENTS .IP "gnutls_rsa_params_t dst" 12 Is the destination structure, which should be initialized. .IP "gnutls_rsa_params_t src" 12 Is the source structure .SH "DESCRIPTION" This function will copy the RSA parameters structure from source to destination. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an negative error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_bag_set_key_id.30000644000000000000000000000302611271476020023503 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_bag_set_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_bag_set_key_id \- This function sets a key ID into the bag element .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_bag_set_key_id(gnutls_pkcs12_bag_t " bag ", int " indx ", const gnutls_datum_t * " id ");" .SH ARGUMENTS .IP "gnutls_pkcs12_bag_t bag" 12 The bag .IP "int indx" 12 The bag's element to add the id .IP "const gnutls_datum_t * id" 12 the ID .SH "DESCRIPTION" This function will add the given key ID, to the specified, by the index, bag element. The key ID will be encoded as a 'Local key identifier' bag attribute, which is usually used to distinguish the local private key and the certificate pair. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. or a negative value on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_get_peers.30000644000000000000000000000327411271476020023714 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_get_peers" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_get_peers \- return the peer's raw certificate .SH SYNOPSIS .B #include .sp .BI "const gnutls_datum_t * gnutls_certificate_get_peers(gnutls_session_t " session ", unsigned int * " list_size ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .IP "unsigned int * list_size" 12 is the length of the certificate list .SH "DESCRIPTION" Get the peer's raw certificate (chain) as sent by the peer. These certificates are in raw format (DER encoded for X.509). In case of a X.509 then a certificate list may be present. The first certificate in the list is the peer's certificate, following the issuer's certificate, then the issuer's issuer etc. In case of OpenPGP keys a single key will be returned in raw format. .SH "RETURNS" return a pointer to a \fBgnutls_datum_t\fP containing our certificates, or \fBNULL\fP in case of an error or if no certificate was used. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_dn_by_oid.30000644000000000000000000000463311271476020023617 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_dn_by_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_dn_by_oid \- This function returns the Certificate's distinguished name .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_dn_by_oid(gnutls_x509_crt_t " cert ", const char * " oid ", int " indx ", unsigned int " raw_flag ", void * " buf ", size_t * " sizeof_buf ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "const char * oid" 12 holds an Object Identified in null terminated string .IP "int indx" 12 In case multiple same OIDs exist in the RDN, this specifies which to send. Use zero to get the first one. .IP "unsigned int raw_flag" 12 If non zero returns the raw DER data of the DN part. .IP "void * buf" 12 a pointer where the DN part will be copied (may be null). .IP "size_t * sizeof_buf" 12 initially holds the size of \fIbuf\fP .SH "DESCRIPTION" This function will extract the part of the name of the Certificate subject specified by the given OID. The output, if the raw flag is not used, will be encoded as described in RFC2253. Thus a string that is ASCII or UTF\-8 encoded, depending on the certificate data. Some helper macros with popular OIDs can be found in gnutls/x509.h If raw flag is zero, this function will only return known OIDs as text. Other OIDs will be DER encoded, as described in RFC2253 \-\- in hex format with a '\#' prefix. You can check about known OIDs using \fBgnutls_x509_dn_oid_known()\fP. If \fIbuf\fP is null then only the size will be filled. .SH "RETURNS" GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_buf will be updated with the required size. On success 0 is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_dn_init.30000644000000000000000000000235411271476020021604 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_dn_init" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_dn_init \- API function .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_dn_init(gnutls_x509_dn_t * " dn ");" .SH ARGUMENTS .IP "gnutls_x509_dn_t * dn" 12 the object to be initialized .SH "DESCRIPTION" This function initializes a \fBgnutls_x509_dn_t\fP structure. The object returned must be deallocated using \fBgnutls_x509_dn_deinit()\fP. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_set_basic_constraints.30000644000000000000000000000307011271476020025404 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_set_basic_constraints" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_set_basic_constraints \- Set the basicConstraints extension .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_set_basic_constraints(gnutls_x509_crq_t " crq ", unsigned int " ca ", int " pathLenConstraint ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 a certificate of type \fBgnutls_x509_crq_t\fP .IP "unsigned int ca" 12 true(1) or false(0). Depending on the Certificate authority status. .IP "int pathLenConstraint" 12 non\-negative values indicate maximum length of path, and negative values indicate that the pathLenConstraints field should not be present. .SH "DESCRIPTION" This function will set the basicConstraints certificate extension. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_psk_set_client_credentials.30000644000000000000000000000343411271476020024756 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_psk_set_client_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_psk_set_client_credentials \- Used to set the username/password, in a gnutls_psk_client_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_psk_set_client_credentials(gnutls_psk_client_credentials_t " res ", const char * " username ", const gnutls_datum_t * " key ", gnutls_psk_key_flags " flags ");" .SH ARGUMENTS .IP "gnutls_psk_client_credentials_t res" 12 is an \fBgnutls_psk_client_credentials_t\fP structure. .IP "const char * username" 12 is the user's zero\-terminated userid .IP "const gnutls_datum_t * key" 12 is the user's key .IP "gnutls_psk_key_flags flags" 12 .SH "DESCRIPTION" This function sets the username and password, in a gnutls_psk_client_credentials_t structure. Those will be used in PSK authentication. \fIusername\fP should be an ASCII string or UTF\-8 strings prepared using the "SASLprep" profile of "stringprep". The key can be either in raw byte format or in Hex (not with the '0x' prefix). .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_free_crls.30000644000000000000000000000232011271476020023672 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_free_crls" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_free_crls \- Used to free all the CRLs from a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_free_crls(gnutls_certificate_credentials_t " sc ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t sc" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .SH "DESCRIPTION" This function will delete all the CRLs associated with the given credentials. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_dn.30000644000000000000000000000336011271476020022263 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_dn" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_dn \- This function returns the Certificate request subject's distinguished name .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_dn(gnutls_x509_crq_t " crq ", char * " buf ", size_t * " sizeof_buf ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 should contain a gnutls_x509_crq_t structure .IP "char * buf" 12 a pointer to a structure to hold the name (may be null) .IP "size_t * sizeof_buf" 12 initially holds the size of \fIbuf\fP .SH "DESCRIPTION" This function will copy the name of the Certificate request subject in the provided buffer. The name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described in RFC2253. The output string will be ASCII or UTF\-8 encoded, depending on the certificate data. If \fIbuf\fP is null then only the size will be filled. .SH "RETURNS" GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_buf will be updated with the required size. On success 0 is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_handshake.30000644000000000000000000000376511271476020021330 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_handshake" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_handshake \- This is the main function in the handshake protocol. .SH SYNOPSIS .B #include .sp .BI "int gnutls_handshake(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" This function does the handshake of the TLS/SSL protocol, and initializes the TLS connection. This function will fail if any problem is encountered, and will return a negative error code. In case of a client, if the client has asked to resume a session, but the server couldn't, then a full handshake will be performed. The non\-fatal errors such as \fBGNUTLS_E_AGAIN\fP and \fBGNUTLS_E_INTERRUPTED\fP interrupt the handshake procedure, which should be later be resumed. Call this function again, until it returns 0; cf. \fBgnutls_record_get_direction()\fP and \fBgnutls_error_is_fatal()\fP. If this function is called by a server after a rehandshake request then \fBGNUTLS_E_GOT_APPLICATION_DATA\fP or \fBGNUTLS_E_WARNING_ALERT_RECEIVED\fP may be returned. Note that these are non fatal errors, only in the specific case of a rehandshake. Their meaning is that the client rejected the rehandshake request. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_set_this_update.30000644000000000000000000000242611271476020024204 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_set_this_update" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_set_this_update \- This function will set the CRL's issuing time .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_set_this_update(gnutls_x509_crl_t " crl ", time_t " act_time ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a gnutls_x509_crl_t structure .IP "time_t act_time" 12 The actual time .SH "DESCRIPTION" This function will set the time this CRL was issued. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pk_get_name.30000644000000000000000000000235411271476020021644 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pk_get_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pk_get_name \- Get name string with #gnutls_pk_algorithm_t algorithm .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_pk_get_name(gnutls_pk_algorithm_t " algorithm ");" .SH ARGUMENTS .IP "gnutls_pk_algorithm_t algorithm" 12 is a public key algorithm .SH "DESCRIPTION" Convert a \fBgnutls_pk_algorithm_t\fP value to a string. .SH "RETURNS" a pointer to a string that contains the name of the specified public key algorithm, or \fBNULL\fP. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_compression_set_priority.30000644000000000000000000000335411271476020024551 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_compression_set_priority" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_compression_set_priority \- Sets the priority on the compression algorithms supported by gnutls. .SH SYNOPSIS .B #include .sp .BI "int gnutls_compression_set_priority(gnutls_session_t " session ", const int * " list ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "const int * list" 12 is a 0 terminated list of gnutls_compression_method_t elements. .SH "DESCRIPTION" Sets the priority on the compression algorithms supported by gnutls. Priority is higher for elements specified before others. After specifying the algorithms you want, you must append a 0. Note that the priority is set on the client. The server does not use the algorithm's priority except for disabling algorithms that were not specified. TLS 1.0 does not define any compression algorithms except NULL. Other compression algorithms are to be considered as gnutls extensions. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_check_issuer.30000644000000000000000000000257611271476020023475 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_check_issuer" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_check_issuer \- checks if CRL has given issuer .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_check_issuer(gnutls_x509_crl_t " cert ", gnutls_x509_crt_t " issuer ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t cert" 12 .IP "gnutls_x509_crt_t issuer" 12 is the certificate of a possible issuer .SH "DESCRIPTION" This function will check if the given CRL was issued by the given issuer certificate. It will return true (1) if the given CRL was issued by the given issuer, and false (0) if not. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_send_x509_rdn_sequence.30000644000000000000000000000310511271476020026201 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_send_x509_rdn_sequence" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_send_x509_rdn_sequence \- order gnutls to send or not the x.509 rdn sequence .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_send_x509_rdn_sequence(gnutls_session_t " session ", int " status ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a pointer to a \fBgnutls_session_t\fP structure. .IP "int status" 12 is 0 or 1 .SH "DESCRIPTION" If status is non zero, this function will order gnutls not to send the rdnSequence in the certificate request message. That is the server will not advertize it's trusted CAs to the peer. If status is zero then the default behaviour will take effect, which is to advertize the server's trusted CAs. This function has no effect in clients, and in authentication methods other than certificate with X.509 certificates. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_crl_dist_points2.30000644000000000000000000000315511271476020025164 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_crl_dist_points2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_crl_dist_points2 \- Set the CRL dist points .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_crl_dist_points2(gnutls_x509_crt_t " crt ", gnutls_x509_subject_alt_name_t " type ", const void * " data ", unsigned int " data_size ", unsigned int " reason_flags ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "gnutls_x509_subject_alt_name_t type" 12 is one of the gnutls_x509_subject_alt_name_t enumerations .IP "const void * data" 12 The data to be set .IP "unsigned int data_size" 12 The data size .IP "unsigned int reason_flags" 12 revocation reasons .SH "DESCRIPTION" This function will set the CRL distribution points certificate extension. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_get_extension_oid.30000644000000000000000000000332611271476020024526 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_get_extension_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_get_extension_oid \- get the specified extension OID .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_get_extension_oid(gnutls_x509_crl_t " crl ", int " indx ", void * " oid ", size_t * " sizeof_oid ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a \fBgnutls_x509_crl_t\fP structure .IP "int indx" 12 Specifies which extension OID to send, use zero to get the first one. .IP "void * oid" 12 a pointer to a structure to hold the OID (may be null) .IP "size_t * sizeof_oid" 12 initially holds the size of \fIoid\fP .SH "DESCRIPTION" This function will return the requested extension OID in the CRL. The extension OID will be stored as a string in the provided buffer. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative value in case of an error. If your have reached the last extension available \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_set_key_rsa_raw.30000644000000000000000000000274111271476020024206 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_set_key_rsa_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_set_key_rsa_raw \- associate Certificate request with a key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_set_key_rsa_raw(gnutls_x509_crq_t " crq ", const gnutls_datum_t * " m ", const gnutls_datum_t * " e ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 should contain a \fBgnutls_x509_crq_t\fP structure .IP "const gnutls_datum_t * m" 12 holds the modulus .IP "const gnutls_datum_t * e" 12 holds the public exponent .SH "DESCRIPTION" This function will set the public parameters from the given private key to the request. Only RSA keys are currently supported. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_get_openpgp_keyring.30000644000000000000000000000257311271476020025777 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_get_openpgp_keyring" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_get_openpgp_keyring \- export keyring from a #gnutls_certificate_credentials_t .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_get_openpgp_keyring(gnutls_certificate_credentials_t " sc ", gnutls_openpgp_keyring_t * " keyring ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t sc" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .IP "gnutls_openpgp_keyring_t * keyring" 12 the exported keyring. Should be treated as constant .SH "DESCRIPTION" This function will export the OpenPGP keyring associated with the given credentials. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_openpgp_key_mem.30000644000000000000000000000317611271476020025771 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_openpgp_key_mem" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_openpgp_key_mem \- Used to set OpenPGP keys .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_openpgp_key_mem(gnutls_certificate_credentials_t " res ", const gnutls_datum_t * " cert ", const gnutls_datum_t * " key ", gnutls_openpgp_crt_fmt_t " format ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 the destination context to save the data. .IP "const gnutls_datum_t * cert" 12 the datum that contains the public key. .IP "const gnutls_datum_t * key" 12 the datum that contains the secret key. .IP "gnutls_openpgp_crt_fmt_t format" 12 the format of the keys .SH "DESCRIPTION" This funtion is used to load OpenPGP keys into the GnuTLS credential structure. The files should contain non encrypted keys. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_x509_trust.30000644000000000000000000000351511271476020024556 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_x509_trust" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_x509_trust \- Used to add trusted CAs in a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_x509_trust(gnutls_certificate_credentials_t " res ", gnutls_x509_crt_t * " ca_list ", int " ca_list_size ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .IP "gnutls_x509_crt_t * ca_list" 12 is a list of trusted CAs .IP "int ca_list_size" 12 holds the size of the CA list .SH "DESCRIPTION" This function adds the trusted CAs in order to verify client or server certificates. In case of a client this is not required to be called if the certificates are not verified using \fBgnutls_certificate_verify_peers2()\fP. This function may be called multiple times. In case of a server the CAs set here will be sent to the client if a certificate request is sent. This can be disabled using \fBgnutls_certificate_send_x509_rdn_sequence()\fP. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_transport_set_pull_function.30000644000000000000000000000267311271476020025247 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_transport_set_pull_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_transport_set_pull_function \- set a read like function .SH SYNOPSIS .B #include .sp .BI "void gnutls_transport_set_pull_function(gnutls_session_t " session ", gnutls_pull_func " pull_func ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 gnutls session .IP "gnutls_pull_func pull_func" 12 a callback function similar to \fBread()\fP .SH "DESCRIPTION" This is the function where you set a function for gnutls to receive data. Normally, if you use berkeley style sockets, do not need to use this function since the default (recv(2)) will probably be ok. PULL_FUNC is of the form, ssize_t (*gnutls_pull_func)(gnutls_transport_ptr_t, void*, size_t); .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_key_purpose_oid.30000644000000000000000000000321011271476020025073 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_key_purpose_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_key_purpose_oid \- Sets the Certificate's key purpose OIDs .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_key_purpose_oid(gnutls_x509_crt_t " cert ", const void * " oid ", unsigned int " critical ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "const void * oid" 12 a pointer to a null terminated string that holds the OID .IP "unsigned int critical" 12 Whether this extension will be critical or not .SH "DESCRIPTION" This function will set the key purpose OIDs of the Certificate. These are stored in the Extended Key Usage extension (2.5.29.37) See the GNUTLS_KP_* definitions for human readable names. Subsequent calls to this function will append OIDs to the OID list. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_rsa_export_params.30000644000000000000000000000263711271476020026345 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_rsa_export_params" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_rsa_export_params \- set the RSA parameters for a server to use .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_set_rsa_export_params(gnutls_certificate_credentials_t " res ", gnutls_rsa_params_t " rsa_params ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is a gnutls_certificate_credentials_t structure .IP "gnutls_rsa_params_t rsa_params" 12 is a structure that holds temporary RSA parameters. .SH "DESCRIPTION" This function will set the temporary RSA parameters for a certificate server to use. These parameters will be used in RSA\-EXPORT cipher suites. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_list_import.30000644000000000000000000000365511271476020023402 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_list_import" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_list_import \- This function will import a PEM encoded certificate list .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_list_import(gnutls_x509_crt_t * " certs ", unsigned int * " cert_max ", const gnutls_datum_t * " data ", gnutls_x509_crt_fmt_t " format ", unsigned int " flags ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t * certs" 12 The structures to store the parsed certificate. Must not be initialized. .IP "unsigned int * cert_max" 12 Initially must hold the maximum number of certs. It will be updated with the number of certs available. .IP "const gnutls_datum_t * data" 12 The PEM encoded certificate. .IP "gnutls_x509_crt_fmt_t format" 12 One of DER or PEM. .IP "unsigned int flags" 12 must be zero or an OR'd sequence of gnutls_certificate_import_flags. .SH "DESCRIPTION" This function will convert the given PEM encoded certificate list to the native gnutls_x509_crt_t format. The output will be stored in \fIcerts\fP. They will be automatically initialized. If the Certificate is PEM encoded it should have a header of "X509 CERTIFICATE", or "CERTIFICATE". .SH "RETURNS" the number of certificates read or a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_expiration_time.30000644000000000000000000000233211271476020025063 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_expiration_time" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_expiration_time \- returns the Certificate's expiration time .SH SYNOPSIS .B #include .sp .BI "time_t gnutls_x509_crt_get_expiration_time(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 time this Certificate was or will be expired. .SH "RETURNS" expiration time, or (time_t)\-1 on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs7_get_crt_count.30000644000000000000000000000240111271476020023332 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs7_get_crt_count" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs7_get_crt_count \- return the number of certificates in a PKCS7 certificate set .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs7_get_crt_count(gnutls_pkcs7_t " pkcs7 ");" .SH ARGUMENTS .IP "gnutls_pkcs7_t pkcs7" 12 should contain a \fBgnutls_pkcs7_t\fP structure .SH "DESCRIPTION" This function will return the number of certifcates in the PKCS7 or RFC2630 certificate set. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_x509_key.30000644000000000000000000000335111271476020024163 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_x509_key" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_x509_key \- Used to set keys in a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_x509_key(gnutls_certificate_credentials_t " res ", gnutls_x509_crt_t * " cert_list ", int " cert_list_size ", gnutls_x509_privkey_t " key ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .IP "gnutls_x509_crt_t * cert_list" 12 contains a certificate list (path) for the specified private key .IP "int cert_list_size" 12 holds the size of the certificate list .IP "gnutls_x509_privkey_t key" 12 is a gnutls_x509_privkey_t key .SH "DESCRIPTION" This function sets a certificate/private key pair in the gnutls_certificate_credentials_t structure. This function may be called more than once (in case multiple keys/certificates exist for the server). .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_deinit.30000644000000000000000000000211411271476020022266 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_deinit" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_deinit \- deinitializes a #gnutls_x509_crl_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_x509_crl_deinit(gnutls_x509_crl_t " crl ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 The structure to be initialized .SH "DESCRIPTION" This function will deinitialize a CRL structure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_global_init_extra.30000644000000000000000000000265411271476020023064 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_global_init_extra" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_global_init_extra \- initializes the global state of gnutls-extra .SH SYNOPSIS .B #include .sp .BI "int gnutls_global_init_extra( " void ");" .SH ARGUMENTS .IP " void" 12 .SH "DESCRIPTION" This function initializes the global state of gnutls\-extra library to defaults. Note that \fBgnutls_global_init()\fP has to be called before this function. If this function is not called then the gnutls\-extra library will not be usable. This function is not thread safe, see the discussion for \fBgnutls_global_init()\fP on how to deal with that. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_allocate_client_credentials.30000644000000000000000000000312211271476020025535 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_allocate_client_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_allocate_client_credentials \- Used to allocate an gnutls_ia_server_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_ia_allocate_client_credentials(gnutls_ia_client_credentials_t * " sc ");" .SH ARGUMENTS .IP "gnutls_ia_client_credentials_t * sc" 12 is a pointer to an \fBgnutls_ia_server_credentials_t\fP structure. .SH "DESCRIPTION" This structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. Adding this credential to a session will enable TLS/IA, and will require an Application Phase after the TLS handshake (if the server support TLS/IA). Use \fBgnutls_ia_require_inner_phase()\fP to toggle the TLS/IA mode. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_srp_base64_decode_alloc.30000644000000000000000000000302411271476020024013 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_srp_base64_decode_alloc" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_srp_base64_decode_alloc \- decode SRP-base64 encoded data .SH SYNOPSIS .B #include .sp .BI "int gnutls_srp_base64_decode_alloc(const gnutls_datum_t * " b64_data ", gnutls_datum_t * " result ");" .SH ARGUMENTS .IP "const gnutls_datum_t * b64_data" 12 contains the encoded data .IP "gnutls_datum_t * result" 12 the place where decoded data lie .SH "DESCRIPTION" This function will decode the given encoded data. The decoded data will be allocated, and stored into result. It will decode using the base64 algorithm as used in libsrp. 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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_extract_inner_secret.30000644000000000000000000000325511271476020024257 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_extract_inner_secret" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_extract_inner_secret \- API function .SH SYNOPSIS .B #include .sp .BI "void gnutls_ia_extract_inner_secret(gnutls_session_t " session ", char * " buffer ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "char * buffer" 12 pre\-allocated buffer to hold 48 bytes of inner secret. .SH "DESCRIPTION" Copy the 48 bytes large inner secret into the specified buffer This function is typically used after the TLS/IA handshake has concluded. The TLS/IA inner secret can be used as input to a PRF to derive session keys. Do not use the inner secret directly as a session key, because for a resumed session that does not include an application phase, the inner secret will be identical to the inner secret in the original session. It is important to include, for example, the client and server randomness when deriving a sesssion key from the inner secret. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_generate_challenge.30000644000000000000000000000260611271476020023640 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_generate_challenge" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_generate_challenge \- API function .SH SYNOPSIS .B #include .sp .BI "int gnutls_ia_generate_challenge(gnutls_session_t " session ", size_t " buffer_size ", char * " buffer ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "size_t buffer_size" 12 size of output buffer. .IP "char * buffer" 12 pre\-allocated buffer to contain \fIbuffer_size\fP bytes of output. .SH "DESCRIPTION" Generate an application challenge that the client cannot control or predict, based on the TLS/IA inner secret. .SH "RETURN VALUE" Returns 0 on success, or an negative error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs7_set_crl_raw.30000644000000000000000000000244011271476020023002 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs7_set_crl_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs7_set_crl_raw \- add a crl in a PKCS7 crl set .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs7_set_crl_raw(gnutls_pkcs7_t " pkcs7 ", const gnutls_datum_t * " crl ");" .SH ARGUMENTS .IP "gnutls_pkcs7_t pkcs7" 12 should contain a \fBgnutls_pkcs7_t\fP structure .IP "const gnutls_datum_t * crl" 12 the DER encoded crl to be added .SH "DESCRIPTION" This function will add a crl to the PKCS7 or RFC2630 crl set. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_crypto_single_digest_register2.30000644000000000000000000000360311271476020025577 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_crypto_single_digest_register2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_crypto_single_digest_register2 \- register a digest algorithm .SH SYNOPSIS .B #include .sp .BI "int gnutls_crypto_single_digest_register2(gnutls_digest_algorithm_t " algorithm ", int " priority ", int " version ", gnutls_crypto_single_digest_st * " s ");" .SH ARGUMENTS .IP "gnutls_digest_algorithm_t algorithm" 12 is the gnutls algorithm identifier .IP "int priority" 12 is the priority of the algorithm .IP "int version" 12 should be set to \fBGNUTLS_CRYPTO_API_VERSION\fP .IP "gnutls_crypto_single_digest_st * s" 12 is a structure holding new algorithms's data .SH "DESCRIPTION" This function will register a digest (hash) algorithm to be used by gnutls. Any algorithm registered will override the included algorithms and by convention kernel implemented algorithms have priority of 90. The algorithm with the lowest priority will be used by gnutls. This function should be called before \fBgnutls_global_init()\fP. For simplicity you can use the convenience \fBgnutls_crypto_single_digest_register()\fP macro. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_get_x509_crls.30000644000000000000000000000271511271476020024325 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_get_x509_crls" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_get_x509_crls \- Used to export all the CRLs from a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_get_x509_crls(gnutls_certificate_credentials_t " sc ", gnutls_x509_crl_t ** " x509_crl_list ", unsigned int * " ncrls ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t sc" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .IP "gnutls_x509_crl_t ** x509_crl_list" 12 the exported CRL list. Should be treated as constant .IP "unsigned int * ncrls" 12 the number of exported CRLs .SH "DESCRIPTION" This function will export all the CRLs associated with the given credentials. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_crypto_cipher_register2.30000644000000000000000000000334011271476020024227 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_crypto_cipher_register2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_crypto_cipher_register2 \- register a cipher interface .SH SYNOPSIS .B #include .sp .BI "int gnutls_crypto_cipher_register2(int " priority ", int " version ", gnutls_crypto_cipher_st * " s ");" .SH ARGUMENTS .IP "int priority" 12 is the priority of the cipher interface .IP "int version" 12 should be set to \fBGNUTLS_CRYPTO_API_VERSION\fP .IP "gnutls_crypto_cipher_st * s" 12 is a structure holding new interface's data .SH "DESCRIPTION" This function will register a cipher interface to be used by gnutls. Any interface registered will override the included engine and by convention kernel implemented interfaces should have priority of 90. The interface with the lowest priority will be used by gnutls. This function should be called before \fBgnutls_global_init()\fP. For simplicity you can use the convenience \fBgnutls_crypto_cipher_register()\fP macro. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_subject_key_id.30000644000000000000000000000257011271476020024666 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_subject_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_subject_key_id \- Set the certificate's subject key id .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_subject_key_id(gnutls_x509_crt_t " cert ", const void * " id ", size_t " id_size ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "const void * id" 12 The key ID .IP "size_t id_size" 12 Holds the size of the serial field. .SH "DESCRIPTION" This function will set the X.509 certificate's subject key ID extension. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_dh_params_export_pkcs3.30000644000000000000000000000356211271476020024037 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_dh_params_export_pkcs3" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_dh_params_export_pkcs3 \- export DH params to a pkcs3 structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_dh_params_export_pkcs3(gnutls_dh_params_t " params ", gnutls_x509_crt_fmt_t " format ", unsigned char * " params_data ", size_t * " params_data_size ");" .SH ARGUMENTS .IP "gnutls_dh_params_t params" 12 Holds the DH parameters .IP "gnutls_x509_crt_fmt_t format" 12 the format of output params. One of PEM or DER. .IP "unsigned char * params_data" 12 will contain a PKCS3 DHParams structure PEM or DER encoded .IP "size_t * params_data_size" 12 holds the size of params_data (and will be replaced by the actual size of parameters) .SH "DESCRIPTION" This function will export the given dh parameters to a PKCS3 DHParams structure. This is the format generated by "openssl dhparam" tool. If the buffer provided is not long enough to hold the output, then GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. If the structure is PEM encoded, it will have a header of "BEGIN DH PARAMETERS". .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_init.30000644000000000000000000000224511271476020022735 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_init" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_init \- initialize a #gnutls_openpgp_crt_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_init(gnutls_openpgp_crt_t * " key ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t * key" 12 The structure to be initialized .SH "DESCRIPTION" This function will initialize an OpenPGP key structure. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_verify.30000644000000000000000000000344111271476020022322 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_verify" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_verify \- This function verifies the given crl against a given trusted one .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_verify(gnutls_x509_crl_t " crl ", const gnutls_x509_crt_t * " CA_list ", int " CA_list_length ", unsigned int " flags ", unsigned int * " verify ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 is the crl to be verified .IP "const gnutls_x509_crt_t * CA_list" 12 is a certificate list that is considered to be trusted one .IP "int CA_list_length" 12 holds the number of CA certificates in CA_list .IP "unsigned int flags" 12 Flags that may be used to change the verification algorithm. Use OR of the gnutls_certificate_verify_flags enumerations. .IP "unsigned int * verify" 12 will hold the crl verification output. .SH "DESCRIPTION" This function will try to verify the given crl and return its status. See \fBgnutls_x509_crt_list_verify()\fP for a detailed description of return values. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_handshake_get_last_in.30000644000000000000000000000272311271476020023671 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_handshake_get_last_in" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_handshake_get_last_in \- Returns the last handshake message received. .SH SYNOPSIS .B #include .sp .BI "gnutls_handshake_description_t gnutls_handshake_get_last_in(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" This function is only useful to check where the last performed handshake failed. If the previous handshake succeed or was not performed at all then no meaningful value will be returned. Check \fBgnutls_handshake_description_t\fP in gnutls.h for the available handshake descriptions. .SH "RETURNS" the last handshake message type received, a \fBgnutls_handshake_description_t\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_anon_free_client_credentials.30000644000000000000000000000242011271476020025234 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_anon_free_client_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_anon_free_client_credentials \- Used to free an allocated gnutls_anon_client_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_anon_free_client_credentials(gnutls_anon_client_credentials_t " sc ");" .SH ARGUMENTS .IP "gnutls_anon_client_credentials_t sc" 12 is an \fBgnutls_anon_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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_srp_set_server_credentials_file.30000644000000000000000000000322011271476020026005 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_srp_set_server_credentials_file" 3 "2.8.1" "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 .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_register_md5_handler.30000644000000000000000000000236711271476020023465 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_register_md5_handler" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_register_md5_handler \- API function .SH SYNOPSIS .B #include .sp .BI "int gnutls_register_md5_handler( " void ");" .SH ARGUMENTS .IP " void" 12 .SH "DESCRIPTION" Register a non\-libgcrypt based MD5 and HMAC\-MD5 handler. This is useful if you run Libgcrypt in FIPS\-mode. Normally TLS requires use of MD5, so without this you cannot use GnuTLS with libgcrypt in FIPS mode. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_psk_set_server_params_function.30000644000000000000000000000257211271476020025703 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_psk_set_server_params_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_psk_set_server_params_function \- set the DH parameters callback .SH SYNOPSIS .B #include .sp .BI "void gnutls_psk_set_server_params_function(gnutls_psk_server_credentials_t " res ", gnutls_params_function * " func ");" .SH ARGUMENTS .IP "gnutls_psk_server_credentials_t res" 12 is a \fBgnutls_certificate_credentials_t\fP structure .IP "gnutls_params_function * func" 12 is the function to be called .SH "DESCRIPTION" This function will set a callback in order for the server to get the Diffie\-Hellman parameters for PSK authentication. The callback should return zero on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_extra_check_version.30000644000000000000000000000274611271476020023425 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_extra_check_version" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_extra_check_version \- checks the libgnutls-extra version .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_extra_check_version(const char * " req_version ");" .SH ARGUMENTS .IP "const char * req_version" 12 version string to compare with, or \fBNULL\fP. .SH "DESCRIPTION" Check GnuTLS Extra Library version. See \fBGNUTLS_EXTRA_VERSION\fP for a suitable \fIreq_version\fP string. .SH "RETURN VALUE" Check that the version of the library is at minimum the one given as a string in \fIreq_version\fP and return the actual version string of the library; return \fBNULL\fP if the condition is not met. If \fBNULL\fP is passed to this function no check is done and only the version string is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_attribute_by_oid.30000644000000000000000000000337411271476020025217 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_attribute_by_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_attribute_by_oid \- This function will get an attribute of the request .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_attribute_by_oid(gnutls_x509_crq_t " crq ", const char * " oid ", int " indx ", void * " buf ", size_t * " sizeof_buf ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 should contain a gnutls_x509_crq_t structure .IP "const char * oid" 12 holds an Object Identified in null terminated string .IP "int indx" 12 In case multiple same OIDs exist in the attribute list, this specifies which to send. Use zero to get the first one. .IP "void * buf" 12 a pointer to a structure to hold the attribute data (may be null) .IP "size_t * sizeof_buf" 12 initially holds the size of \fIbuf\fP .SH "DESCRIPTION" This function will return the attribute in the certificate request specified by the given Object ID. The attribute will be DER encoded. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs7_get_crl_count.30000644000000000000000000000234411271476020023330 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs7_get_crl_count" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs7_get_crl_count \- returns the number of CRLs in a PKCS7 crl set .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs7_get_crl_count(gnutls_pkcs7_t " pkcs7 ");" .SH ARGUMENTS .IP "gnutls_pkcs7_t pkcs7" 12 should contain a gnutls_pkcs7_t structure .SH "DESCRIPTION" This function will return the number of certifcates in the PKCS7 or RFC2630 crl set. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_keyring_get_crt_count.30000644000000000000000000000234111271476020025506 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_keyring_get_crt_count" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_keyring_get_crt_count \- return the number of certificates .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_keyring_get_crt_count(gnutls_openpgp_keyring_t " ring ");" .SH ARGUMENTS .IP "gnutls_openpgp_keyring_t ring" 12 is an OpenPGP key ring .SH "DESCRIPTION" This function will return the number of OpenPGP certificates present in the given keyring. .SH "RETURNS" the number of subkeys, or a negative value on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_cipher_get_id.30000644000000000000000000000235111271476020022155 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_cipher_get_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_cipher_get_id \- Returns the gnutls id of the specified in string algorithm .SH SYNOPSIS .B #include .sp .BI "gnutls_cipher_algorithm_t gnutls_cipher_get_id(const char * " name ");" .SH ARGUMENTS .IP "const char * name" 12 is a MAC algorithm name .SH "DESCRIPTION" The names are compared in a case insensitive way. .SH "RETURNS" return a \fBgnutls_cipher_algorithm_t\fP value corresponding to the specified cipher, or \fBGNUTLS_CIPHER_UNKNOWN\fP on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_get_bag.30000644000000000000000000000275211271476020022150 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_get_bag" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_get_bag \- This function returns a Bag from a PKCS12 structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_get_bag(gnutls_pkcs12_t " pkcs12 ", int " indx ", gnutls_pkcs12_bag_t " bag ");" .SH ARGUMENTS .IP "gnutls_pkcs12_t pkcs12" 12 should contain a gnutls_pkcs12_t structure .IP "int indx" 12 contains the index of the bag to extract .IP "gnutls_pkcs12_bag_t bag" 12 An initialized bag, where the contents of the bag will be copied .SH "DESCRIPTION" This function will return a Bag from the PKCS12 structure. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. After the last Bag has been read GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_check_hostname.30000644000000000000000000000300411271476020023774 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_check_hostname" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_check_hostname \- compares the hostname with certificate's hostname .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_check_hostname(gnutls_x509_crt_t " cert ", const char * " hostname ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain an gnutls_x509_crt_t structure .IP "const char * hostname" 12 A null terminated string that contains a DNS name .SH "DESCRIPTION" This function will check if the given certificate's subject matches the given hostname. This is a basic implementation of the matching described in RFC2818 (HTTPS), which takes into account wildcards, and the DNSName/IPAddress subject alternative name PKIX extension. .SH "RETURNS" non zero for a successful match, and zero on failure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_openpgp_key_file2.30000644000000000000000000000356311271476020026214 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_openpgp_key_file2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_openpgp_key_file2 \- Used to set OpenPGP keys .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_openpgp_key_file2(gnutls_certificate_credentials_t " res ", const char * " certfile ", const char * " keyfile ", const char * " subkey_id ", gnutls_openpgp_crt_fmt_t " format ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 the destination context to save the data. .IP "const char * certfile" 12 the file that contains the public key. .IP "const char * keyfile" 12 the file that contains the secret key. .IP "const char * subkey_id" 12 a hex encoded subkey id .IP "gnutls_openpgp_crt_fmt_t format" 12 the format of the keys .SH "DESCRIPTION" This funtion is used to load OpenPGP keys into the GnuTLS credential structure. The files should contain non encrypted keys. The special keyword "auto" is also accepted as \fIsubkey_id\fP. In that case the \fBgnutls_openpgp_crt_get_auth_subkey()\fP will be used to retrieve the subkey. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_psk_set_client_credentials_function.30000644000000000000000000000354711271476020026670 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_psk_set_client_credentials_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_psk_set_client_credentials_function \- Used to set a callback to retrieve the username and key .SH SYNOPSIS .B #include .sp .BI "void gnutls_psk_set_client_credentials_function(gnutls_psk_client_credentials_t " cred ", gnutls_psk_client_credentials_function * " func ");" .SH ARGUMENTS .IP "gnutls_psk_client_credentials_t cred" 12 is a \fBgnutls_psk_server_credentials_t\fP structure. .IP "gnutls_psk_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 PSK authentication. The callback's function form is: int (*callback)(gnutls_session_t, char** username, gnutls_datum_t* key); The \fIusername\fP and \fIkey\fP\->data must be allocated using \fBgnutls_malloc()\fP. \fIusername\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. The callback function should return 0 on success. \-1 indicates an error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_dn_get_rdn_ava.30000644000000000000000000000312211271476020023104 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_dn_get_rdn_ava" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_dn_get_rdn_ava \- API function .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_dn_get_rdn_ava(gnutls_x509_dn_t " dn ", int " irdn ", int " iava ", gnutls_x509_ava_st * " ava ");" .SH ARGUMENTS .IP "gnutls_x509_dn_t dn" 12 input variable with opaque DN pointer .IP "int irdn" 12 index of RDN .IP "int iava" 12 index of AVA. .IP "gnutls_x509_ava_st * ava" 12 Pointer to structure which will hold output information. .SH "DESCRIPTION" Get pointers to data within the DN. Note that \fIava\fP will contain pointers into the \fIdn\fP structure, so you should not modify any data or deallocate it. Note also that the DN in turn points into the original certificate structure, and thus you may not deallocate the certificate and continue to access \fIdn\fP. .SH "RETURNS" Returns 0 on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_verify_algorithm.30000644000000000000000000000303311271476020025234 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_verify_algorithm" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_verify_algorithm \- get hash algorithm used to verify signature. .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_verify_algorithm(gnutls_x509_crt_t " crt ", const gnutls_datum_t * " signature ", gnutls_digest_algorithm_t * " hash ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 Holds the certificate .IP "const gnutls_datum_t * signature" 12 contains the signature .IP "gnutls_digest_algorithm_t * hash" 12 The result of the call with the hash algorithm used for signature .SH "DESCRIPTION" This function will read the certifcate and the signed data to determine the hash algorithm used to generate the signature. .SH "RETURNS" the 0 if the hash algorithm is found. A negative value is returned on error. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_expiration_time.30000644000000000000000000000244611271476020025105 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_expiration_time" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_expiration_time \- Set the Certificate's expiration time .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_expiration_time(gnutls_x509_crt_t " cert ", time_t " exp_time ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "time_t exp_time" 12 The actual time .SH "DESCRIPTION" This function will set the time this Certificate will expire. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_crl_dist_points.30000644000000000000000000000524211271476020025065 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_crl_dist_points" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_crl_dist_points \- This function returns the CRL distribution points .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_crl_dist_points(gnutls_x509_crt_t " cert ", unsigned int " seq ", void * " ret ", size_t * " ret_size ", unsigned int * " reason_flags ", 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 distribution point (0 for the first one, 1 for the second etc.) .IP "void * ret" 12 is the place where the distribution point will be copied to .IP "size_t * ret_size" 12 holds the size of ret. .IP "unsigned int * reason_flags" 12 Revocation reasons flags. .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 CRL distribution points (2.5.29.31), contained in the given certificate. \fIreason_flags\fP should be an ORed sequence of GNUTLS_CRL_REASON_UNUSED, GNUTLS_CRL_REASON_KEY_COMPROMISE, GNUTLS_CRL_REASON_CA_COMPROMISE, GNUTLS_CRL_REASON_AFFILIATION_CHANGED, GNUTLS_CRL_REASON_SUPERSEEDED, GNUTLS_CRL_REASON_CESSATION_OF_OPERATION, GNUTLS_CRL_REASON_CERTIFICATE_HOLD, GNUTLS_CRL_REASON_PRIVILEGE_WITHDRAWN, GNUTLS_CRL_REASON_AA_COMPROMISE, or zero for all possible reasons. This is specified in X509v3 Certificate Extensions. GNUTLS will return the distribution point type, or a negative error code on error. .SH "RETURNS" \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP and updates &\fIret_size\fP if &\fIret_size\fP is not enough to hold the distribution point, or the type of the distribution point if everything was ok. The type is one of the enumerated \fBgnutls_x509_subject_alt_name_t\fP. 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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_dn_oid.30000644000000000000000000000332511271476020023117 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_dn_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_dn_oid \- This function returns the Certificate request subject's distinguished name OIDs .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_dn_oid(gnutls_x509_crq_t " crq ", int " indx ", void * " oid ", size_t * " sizeof_oid ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 should contain a gnutls_x509_crq_t structure .IP "int indx" 12 Specifies which DN OID to send. Use zero to get the first one. .IP "void * oid" 12 a pointer to a structure to hold the name (may be null) .IP "size_t * sizeof_oid" 12 initially holds the size of \fIoid\fP .SH "DESCRIPTION" This function will extract the requested OID of the name of the Certificate request subject, specified by the given index. If oid is null then only the size will be filled. .SH "RETURNS" GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_oid will be updated with the required size. On success 0 is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_dh_get_group.30000644000000000000000000000311511271476020022035 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_dh_get_group" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_dh_get_group \- return the group of the DH authentication .SH SYNOPSIS .B #include .sp .BI "int gnutls_dh_get_group(gnutls_session_t " session ", gnutls_datum_t * " raw_gen ", gnutls_datum_t * " raw_prime ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .IP "gnutls_datum_t * raw_gen" 12 will hold the generator. .IP "gnutls_datum_t * raw_prime" 12 will hold the prime. .SH "DESCRIPTION" This function will return the group parameters used in the last Diffie\-Hellman authentication with the peer. These are the prime and the generator used. This function should be used for both anonymous and ephemeral Diffie\-Hellman. The output parameters must be freed with \fBgnutls_free()\fP. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_init.30000644000000000000000000000310411271476020020330 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_init" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_init \- initialize the session to null (null encryption etc...). .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_db_set_store_function.30000644000000000000000000000260311271476020023751 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_db_set_store_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_db_set_store_function \- Set the function that will be used to put data .SH SYNOPSIS .B #include .sp .BI "void gnutls_db_set_store_function(gnutls_session_t " session ", gnutls_db_store_func " store_func ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "gnutls_db_store_func store_func" 12 is the function .SH "DESCRIPTION" Sets the function that will be used to store data from the resumed sessions database. This function must remove 0 on success. The first argument to \fBstore_func()\fP will be null unless \fBgnutls_db_set_ptr()\fP has been called. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_auth_subkey.30000644000000000000000000000346511271476020025161 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_auth_subkey" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_auth_subkey \- Gets the keyID of an authentication subkey .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_auth_subkey(gnutls_openpgp_crt_t " crt ", gnutls_openpgp_keyid_t " keyid ", unsigned int " flag ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t crt" 12 the structure that contains the OpenPGP public key. .IP "gnutls_openpgp_keyid_t keyid" 12 the struct to save the keyid. .IP "unsigned int flag" 12 Non zero indicates that a valid subkey is always returned. .SH "DESCRIPTION" Returns the 64\-bit keyID of the first valid OpenPGP subkey marked for authentication. If flag is non zero and no authentication subkey exists, then a valid subkey will be returned even if it is not marked for authentication. Returns the 64\-bit keyID of the first valid OpenPGP subkey marked for authentication. If flag is non zero and no authentication subkey exists, then a valid subkey will be returned even if it is not marked for authentication. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_recv.30000644000000000000000000000445611271476020021010 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_recv" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_recv \- read data from the TLS/IA protocol .SH SYNOPSIS .B #include .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 it 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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_bag_get_data.30000644000000000000000000000274111271476020023137 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_bag_get_data" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_bag_get_data \- This function returns the bag's data .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_bag_get_data(gnutls_pkcs12_bag_t " bag ", int " indx ", gnutls_datum_t * " data ");" .SH ARGUMENTS .IP "gnutls_pkcs12_bag_t bag" 12 The bag .IP "int indx" 12 The element of the bag to get the data from .IP "gnutls_datum_t * data" 12 where the bag's data will be. Should be treated as constant. .SH "DESCRIPTION" This function will return the bag's data. The data is a constant that is stored into the bag. Should not be accessed after the bag is deleted. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value.and a negative error code on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_get_x509_cas.30000644000000000000000000000267711271476020024137 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_get_x509_cas" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_get_x509_cas \- Used to export all the CAs from a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_get_x509_cas(gnutls_certificate_credentials_t " sc ", gnutls_x509_crt_t ** " x509_ca_list ", unsigned int * " ncas ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t sc" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .IP "gnutls_x509_crt_t ** x509_ca_list" 12 will point to the CA list. Should be treated as constant .IP "unsigned int * ncas" 12 the number of CAs .SH "DESCRIPTION" This function will export all the CAs associated with the given credentials. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_sign_callback_get.30000644000000000000000000000243011271476020023001 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_sign_callback_get" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_sign_callback_get \- API function .SH SYNOPSIS .B #include .sp .BI "gnutls_sign_func gnutls_sign_callback_get(gnutls_session_t " session ", void ** " userdata ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .IP "void ** userdata" 12 if non\-\fBNULL\fP, will be set to abstract callback pointer. .SH "DESCRIPTION" Retrieve the callback function, and its userdata pointer. .SH "RETURNS" The function pointer set by \fBgnutls_sign_callback_set()\fP, or if not set, \fBNULL\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_hex_encode.30000644000000000000000000000261211271476020021471 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_hex_encode" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_hex_encode \- convert raw data to hex encoded .SH SYNOPSIS .B #include .sp .BI "int gnutls_hex_encode(const gnutls_datum_t * " data ", char * " result ", size_t * " result_size ");" .SH ARGUMENTS .IP "const gnutls_datum_t * data" 12 contain the raw data .IP "char * result" 12 the place where hex data will be copied .IP "size_t * result_size" 12 holds the size of the result .SH "DESCRIPTION" This function will convert the given data to printable data, using the hex encoding, as used in the PSK password files. .SH "RETURNS" \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP if the buffer given is not long enough, or 0 on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_priority_set_direct.30000644000000000000000000000326511271476020023463 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_priority_set_direct" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_priority_set_direct \- Sets priorities for the cipher suites supported by gnutls. .SH SYNOPSIS .B #include .sp .BI "int gnutls_priority_set_direct(gnutls_session_t " session ", const char * " priorities ", const char ** " err_pos ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "const char * priorities" 12 is a string describing priorities .IP "const char ** err_pos" 12 In case of an error this will have the position in the string the error occured .SH "DESCRIPTION" Sets the priorities to use on the ciphers, key exchange methods, macs and compression methods. This function avoids keeping a priority cache and is used to directly set string priorities to a TLS session. For documentation check the \fBgnutls_priority_init()\fP. .SH "RETURNS" On syntax error \fBGNUTLS_E_INVALID_REQUEST\fP is returned, \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_subject_alt_name.30000644000000000000000000000463311271476020025165 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_subject_alt_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_subject_alt_name \- Get certificate's alternative name .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_subject_alt_name(gnutls_x509_crq_t " cert ", unsigned int " seq ", void * " ret ", size_t * " ret_size ", unsigned int * " ret_type ", unsigned int * " critical ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t cert" 12 should contain a \fBgnutls_x509_crq_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 \fBgnutls_x509_subject_alt_name_t\fP name type .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_crq_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). .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 request does not have an Alternative name with the specified sequence number then \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP is returned. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_activation_time.30000644000000000000000000000233411271476020025044 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_activation_time" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_activation_time \- returns the Certificate's activation time .SH SYNOPSIS .B #include .sp .BI "time_t gnutls_x509_crt_get_activation_time(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 time this Certificate was or will be activated. .SH "RETURNS" activation time, or (time_t)\-1 on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs7_get_crl_raw.30000644000000000000000000000323411271476020022770 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs7_get_crl_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs7_get_crl_raw \- returns a crl in a PKCS7 crl set .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs7_get_crl_raw(gnutls_pkcs7_t " pkcs7 ", int " indx ", void * " crl ", size_t * " crl_size ");" .SH ARGUMENTS .IP "gnutls_pkcs7_t pkcs7" 12 should contain a \fBgnutls_pkcs7_t\fP structure .IP "int indx" 12 contains the index of the crl to extract .IP "void * crl" 12 the contents of the crl will be copied there (may be null) .IP "size_t * crl_size" 12 should hold the size of the crl .SH "DESCRIPTION" This function will return a crl of the PKCS7 or RFC2630 crl set. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. If the provided buffer is not long enough, then \fIcrl_size\fP is updated and \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP is returned. After the last crl has been read \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_oprfi_enable_server.30000644000000000000000000000351211271476020023403 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_oprfi_enable_server" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_oprfi_enable_server \- API function .SH SYNOPSIS .B #include .sp .BI "void gnutls_oprfi_enable_server(gnutls_session_t " session ", gnutls_oprfi_callback_func " cb ", void * " userdata ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "gnutls_oprfi_callback_func cb" 12 function pointer to Opaque PRF extension server callback. .IP "void * userdata" 12 hook passed to callback function for passing application state. .SH "DESCRIPTION" Request that the server should attempt to accept the Opaque PRF Input TLS extension. If the client requests the extension, the provided callback \fIcb\fP will be invoked. The callback must have the following prototype: int callback (gnutls_session_t session, void *userdata, size_t oprfi_len, const unsigned char *in_oprfi, unsigned char *out_oprfi); The callback can inspect the client\-provided data in the input parameters, and specify its own opaque prf input data in the output variable. The function must return 0 on success, otherwise the handshake will be aborted. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_bag_get_friendly_name.30000644000000000000000000000300111271476020025030 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_bag_get_friendly_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_bag_get_friendly_name \- This function returns the friendly name of the bag element .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_bag_get_friendly_name(gnutls_pkcs12_bag_t " bag ", int " indx ", char ** " name ");" .SH ARGUMENTS .IP "gnutls_pkcs12_bag_t bag" 12 The bag .IP "int indx" 12 The bag's element to add the id .IP "char ** name" 12 will hold a pointer to the name (to be treated as const) .SH "DESCRIPTION" This function will return the friendly name, of the specified bag element. The key ID is usually used to distinguish the local private key and the certificate pair. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. or a negative value on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_rsa_params_deinit.30000644000000000000000000000215711271476020023060 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_rsa_params_deinit" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_rsa_params_deinit \- deinitialize the RSA parameters .SH SYNOPSIS .B #include .sp .BI "void gnutls_rsa_params_deinit(gnutls_rsa_params_t " rsa_params ");" .SH ARGUMENTS .IP "gnutls_rsa_params_t rsa_params" 12 Is a structure that holds the parameters .SH "DESCRIPTION" This function will deinitialize the RSA parameters structure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_crypto_digest_register2.30000644000000000000000000000334011271476020024234 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_crypto_digest_register2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_crypto_digest_register2 \- register a digest interface .SH SYNOPSIS .B #include .sp .BI "int gnutls_crypto_digest_register2(int " priority ", int " version ", gnutls_crypto_digest_st * " s ");" .SH ARGUMENTS .IP "int priority" 12 is the priority of the digest interface .IP "int version" 12 should be set to \fBGNUTLS_CRYPTO_API_VERSION\fP .IP "gnutls_crypto_digest_st * s" 12 is a structure holding new interface's data .SH "DESCRIPTION" This function will register a digest interface to be used by gnutls. Any interface registered will override the included engine and by convention kernel implemented interfaces should have priority of 90. The interface with the lowest priority will be used by gnutls. This function should be called before \fBgnutls_global_init()\fP. For simplicity you can use the convenience \fBgnutls_crypto_digest_register()\fP macro. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_session_get_id.30000644000000000000000000000327211271476020022371 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_session_get_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_session_get_id \- Returns session id. .SH SYNOPSIS .B #include .sp .BI "int gnutls_session_get_id(gnutls_session_t " session ", void * " session_id ", size_t * " session_id_size ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "void * session_id" 12 is a pointer to space to hold the session id. .IP "size_t * session_id_size" 12 is the session id's size, or it will be set by the function. .SH "DESCRIPTION" Returns the current session id. This can be used if you want to check if the next session you tried to resume was actually resumed. This is because resumed sessions have the same sessionID with the original session. Session id is some data set by the server, that identify the current session. In TLS 1.0 and SSL 3.0 session id is always less than 32 bytes. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_issuer_dn.30000644000000000000000000000337311271476020023664 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_issuer_dn" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_issuer_dn \- This function returns the Certificate's issuer distinguished name .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_issuer_dn(gnutls_x509_crt_t " cert ", char * " buf ", size_t * " sizeof_buf ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "char * buf" 12 a pointer to a structure to hold the name (may be null) .IP "size_t * sizeof_buf" 12 initially holds the size of \fIbuf\fP .SH "DESCRIPTION" This function will copy the name of the Certificate issuer in the provided buffer. The name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described in RFC2253. The output string will be ASCII or UTF\-8 encoded, depending on the certificate data. If \fIbuf\fP is null then only the size will be filled. .SH "RETURNS" GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_buf will be updated with the required size. On success 0 is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_get_subkey_count.30000644000000000000000000000235711271476020026250 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_get_subkey_count" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_get_subkey_count \- return the number of subkeys .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_get_subkey_count(gnutls_openpgp_privkey_t " key ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 is an OpenPGP key .SH "DESCRIPTION" This function will return the number of subkeys present in the given OpenPGP certificate. .SH "RETURNS" the number of subkeys, or a negative value on error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_dn_export.30000644000000000000000000000335311271476020022162 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_dn_export" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_dn_export \- This function will export the DN .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_dn_export(gnutls_x509_dn_t " dn ", gnutls_x509_crt_fmt_t " format ", void * " output_data ", size_t * " output_data_size ");" .SH ARGUMENTS .IP "gnutls_x509_dn_t dn" 12 Holds the opaque DN object .IP "gnutls_x509_crt_fmt_t format" 12 the format of output params. One of PEM or DER. .IP "void * output_data" 12 will contain a DN PEM or DER encoded .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 export the DN to DER or PEM format. 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. If the structure is PEM encoded, it will have a header of "BEGIN NAME". .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_type_get_name.30000644000000000000000000000242411271476020024553 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_type_get_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_type_get_name \- Returns a string with the name of the specified certificate type .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_certificate_type_get_name(gnutls_certificate_type_t " type ");" .SH ARGUMENTS .IP "gnutls_certificate_type_t type" 12 is a certificate type .SH "DESCRIPTION" Convert a \fBgnutls_certificate_type_t\fP type to a string. .SH "RETURNS" a string that contains the name of the specified certificate type, or \fBNULL\fP in case of unknown types. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_session_is_resumed.30000644000000000000000000000226111271476020023272 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_session_is_resumed" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_session_is_resumed \- check whether this session is a resumed one .SH SYNOPSIS .B #include .sp .BI "int gnutls_session_is_resumed(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Check whether session is resumed or not. .SH "RETURNS" non zero if this session is resumed, or a zero if this is a new session. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_psk_server_get_username.30000644000000000000000000000230711271476020024312 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_psk_server_get_username" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_psk_server_get_username \- return the username of the peer .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_psk_server_get_username(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .SH "DESCRIPTION" This should only be called in case of PSK authentication and in case of a server. .SH "RETURNS" the username of the peer, or \fBNULL\fP in case of an error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_activation_time_peers.30000644000000000000000000000247311271476020026314 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_activation_time_peers" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_activation_time_peers \- return the peer's certificate activation time .SH SYNOPSIS .B #include .sp .BI "time_t gnutls_certificate_activation_time_peers(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .SH "DESCRIPTION" This function will return the peer's certificate activation time. This is the creation time for openpgp keys. .SH "RETURNS" (time_t)\-1 on error. .SH "DEPRECATED" \fBgnutls_certificate_verify_peers2()\fP now verifies activation times. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_issuer_dn_by_oid.30000644000000000000000000000422011271476020025215 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_issuer_dn_by_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_issuer_dn_by_oid \- Set the Certificate request issuer's distinguished name .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_issuer_dn_by_oid(gnutls_x509_crt_t " crt ", const char * " oid ", unsigned int " raw_flag ", const void * " name ", unsigned int " sizeof_name ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "const char * oid" 12 holds an Object Identifier in a null terminated string .IP "unsigned int raw_flag" 12 must be 0, or 1 if the data are DER encoded .IP "const void * name" 12 a pointer to the name .IP "unsigned int sizeof_name" 12 holds the size of \fIname\fP .SH "DESCRIPTION" This function will set the part of the name of the Certificate issuer, specified by the given OID. The input string should be ASCII or UTF\-8 encoded. Some helper macros with popular OIDs can be found in gnutls/x509.h With this function you can only set the known OIDs. You can test for known OIDs using \fBgnutls_x509_dn_oid_known()\fP. For OIDs that are not known (by gnutls) you should properly DER encode your data, and call this function with \fIraw_flag\fP set. Normally you do not need to call this function, since the signing operation will copy the signer's name as the issuer of the certificate. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_session_enable_compatibility_mode.30000644000000000000000000000265711271476020026327 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_session_enable_compatibility_mode" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_session_enable_compatibility_mode \- disable certain features in TLS in order to honour compatibility .SH SYNOPSIS .B #include .sp .BI "void gnutls_session_enable_compatibility_mode(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" This function can be used to disable certain (security) features in TLS in order to maintain maximum compatibility with buggy clients. It is equivalent to calling: \fBgnutls_record_disable_padding()\fP Normally only servers that require maximum compatibility with everything out there, need to call this function. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_db_set_remove_function.30000644000000000000000000000260711271476020024116 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_db_set_remove_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_db_set_remove_function \- Set the function that will be used to remove data .SH SYNOPSIS .B #include .sp .BI "void gnutls_db_set_remove_function(gnutls_session_t " session ", gnutls_db_remove_func " rem_func ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "gnutls_db_remove_func rem_func" 12 is the function. .SH "DESCRIPTION" Sets the function that will be used to remove data from the resumed sessions database. This function must return 0 on success. The first argument to \fBrem_func()\fP will be null unless \fBgnutls_db_set_ptr()\fP has been called. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_creation_time.30000644000000000000000000000224211271476020025450 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_creation_time" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_creation_time \- Extract the timestamp .SH SYNOPSIS .B #include .sp .BI "time_t gnutls_openpgp_crt_get_creation_time(gnutls_openpgp_crt_t " key ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the structure that contains the OpenPGP public key. .SH "DESCRIPTION" Get key creation time. .SH "RETURNS" the timestamp when the OpenPGP key was created. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_issuer_dn_by_oid.30000644000000000000000000000466411271476020025215 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_issuer_dn_by_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_issuer_dn_by_oid \- This function returns the Certificate's issuer distinguished name .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_issuer_dn_by_oid(gnutls_x509_crt_t " cert ", const char * " oid ", int " indx ", unsigned int " raw_flag ", void * " buf ", size_t * " sizeof_buf ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "const char * oid" 12 holds an Object Identified in null terminated string .IP "int indx" 12 In case multiple same OIDs exist in the RDN, this specifies which to send. Use zero to get the first one. .IP "unsigned int raw_flag" 12 If non zero returns the raw DER data of the DN part. .IP "void * buf" 12 a pointer to a structure to hold the name (may be null) .IP "size_t * sizeof_buf" 12 initially holds the size of \fIbuf\fP .SH "DESCRIPTION" This function will extract the part of the name of the Certificate issuer specified by the given OID. The output, if the raw flag is not used, will be encoded as described in RFC2253. Thus a string that is ASCII or UTF\-8 encoded, depending on the certificate data. Some helper macros with popular OIDs can be found in gnutls/x509.h If raw flag is zero, this function will only return known OIDs as text. Other OIDs will be DER encoded, as described in RFC2253 \-\- in hex format with a '\#' prefix. You can check about known OIDs using \fBgnutls_x509_dn_oid_known()\fP. If \fIbuf\fP is null then only the size will be filled. .SH "RETURNS" GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_buf will be updated with the required size. On success 0 is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_get_subkey_id.30000644000000000000000000000253011271476020025505 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_get_subkey_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_get_subkey_id \- Gets the keyID .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_get_subkey_id(gnutls_openpgp_privkey_t " key ", unsigned int " idx ", gnutls_openpgp_keyid_t " keyid ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 the structure that contains the OpenPGP secret key. .IP "unsigned int idx" 12 the subkey index .IP "gnutls_openpgp_keyid_t keyid" 12 the buffer to save the keyid. .SH "DESCRIPTION" Get the key\-id for the subkey. .SH "RETURNS" the 64\-bit keyID of the OpenPGP key. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_version.30000644000000000000000000000323611271476020023370 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_version" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_version \- Set the Certificate request version .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_version(gnutls_x509_crt_t " crt ", unsigned int " version ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "unsigned int version" 12 holds the version number. For X.509v1 certificates must be 1. .SH "DESCRIPTION" This function will set the version of the certificate. This must be one for X.509 version 1, and so on. Plain certificates without extensions must have version set to one. To create well\-formed certificates, you must specify version 3 if you use any certificate extensions. Extensions are created by functions such as \fBgnutls_x509_crt_set_subject_alt_name()\fP or \fBgnutls_x509_crt_set_key_usage()\fP. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_attribute_data.30000644000000000000000000000367511271476020024667 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_attribute_data" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_attribute_data \- Get the specified attribute data .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_attribute_data(gnutls_x509_crq_t " cert ", int " indx ", void * " data ", size_t * " sizeof_data ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t cert" 12 should contain a \fBgnutls_x509_crq_t\fP structure .IP "int indx" 12 Specifies which attribute OID to send. Use zero to get the first one. .IP "void * data" 12 a pointer to a structure to hold the data (may be null) .IP "size_t * sizeof_data" 12 initially holds the size of \fIoid\fP .SH "DESCRIPTION" This function will return the requested attribute data in the certificate request. The attribute data will be stored as a string in the provided buffer. Use \fBgnutls_x509_crq_get_attribute_info()\fP to extract the OID. Use \fBgnutls_x509_crq_get_attribute_by_oid()\fP instead, if you want to get data indexed by the attribute OID rather than sequence. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative value in case of an error. If your have reached the last extension available \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_bag_get_key_id.30000644000000000000000000000274711271476020023500 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_bag_get_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_bag_get_key_id \- This function gets the key ID from the bag element .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_bag_get_key_id(gnutls_pkcs12_bag_t " bag ", int " indx ", gnutls_datum_t * " id ");" .SH ARGUMENTS .IP "gnutls_pkcs12_bag_t bag" 12 The bag .IP "int indx" 12 The bag's element to add the id .IP "gnutls_datum_t * id" 12 where the ID will be copied (to be treated as const) .SH "DESCRIPTION" This function will return the key ID, of the specified bag element. The key ID is usually used to distinguish the local private key and the certificate pair. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. or a negative value on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_set_challenge_password.30000644000000000000000000000253411271476020025544 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_set_challenge_password" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_set_challenge_password \- This function will set a challenge password .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_set_challenge_password(gnutls_x509_crq_t " crq ", const char * " pass ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 should contain a gnutls_x509_crq_t structure .IP "const char * pass" 12 holds a null terminated password .SH "DESCRIPTION" This function will set a challenge password to be used when revoking the request. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_session_get_server_random.30000644000000000000000000000260711271476020024644 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_session_get_server_random" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_session_get_server_random \- get the session's server random value .SH SYNOPSIS .B #include .sp .BI "const void * gnutls_session_get_server_random(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Return a pointer to the 32\-byte server random field used in the session. The pointer must not be modified or deallocated. If a server random value has not yet been established, the output will be garbage; in particular, a \fBNULL\fP return value should not be expected. .SH "RETURNS" pointer to server random data. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_rsa_export_get_modulus_bits.30000644000000000000000000000234011271476020025204 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_rsa_export_get_modulus_bits" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_rsa_export_get_modulus_bits \- return the bits used in RSA-export key exchange .SH SYNOPSIS .B #include .sp .BI "int gnutls_rsa_export_get_modulus_bits(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .SH "DESCRIPTION" Get the export RSA parameter's modulus size. .SH "RETURNS" the bits used in the last RSA\-EXPORT key exchange with the peer, or a negative value in case of error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_init.30000644000000000000000000000242711271476020021522 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_init" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_init \- This function initializes a gnutls_pkcs12_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_init(gnutls_pkcs12_t * " pkcs12 ");" .SH ARGUMENTS .IP "gnutls_pkcs12_t * pkcs12" 12 The structure to be initialized .SH "DESCRIPTION" This function will initialize a PKCS12 structure. PKCS12 structures usually contain lists of X.509 Certificates and X.509 Certificate revocation lists. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_dn_oid_known.30000644000000000000000000000275411271476020022634 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_dn_oid_known" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_dn_oid_known \- return true if the given OID is known .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_dn_oid_known(const char * " oid ");" .SH ARGUMENTS .IP "const char * oid" 12 holds an Object Identifier in a null terminated string .SH "DESCRIPTION" This function will inform about known DN OIDs. This is useful since functions like \fBgnutls_x509_crt_set_dn_by_oid()\fP use the information on known OIDs to properly encode their input. Object Identifiers that are not known are not encoded by these functions, and their input is stored directly into the ASN.1 structure. In that case of unknown OIDs, you have the responsibility of DER encoding your data. .SH "RETURNS" 1 on known OIDs and 0 otherwise. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_client_get_request_status.30000644000000000000000000000240611271476020027223 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_client_get_request_status" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_client_get_request_status \- return the certificate request status .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_client_get_request_status(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a gnutls session .SH "DESCRIPTION" Get whether client certificate is requested or not. .SH "RETURNS" 0 if the peer (server) did not request client authentication or 1 otherwise, or a negative value in case of error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_x509_crl_file.30000644000000000000000000000325611271476020025156 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_x509_crl_file" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_x509_crl_file \- Used to add CRLs in a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_x509_crl_file(gnutls_certificate_credentials_t " res ", const char * " crlfile ", gnutls_x509_crt_fmt_t " type ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .IP "const char * crlfile" 12 is a file containing the list of verified CRLs (DER or PEM list) .IP "gnutls_x509_crt_fmt_t type" 12 is PEM or DER .SH "DESCRIPTION" This function adds the trusted CRLs in order to verify client or server certificates. In case of a client this is not required to be called if the certificates are not verified using \fBgnutls_certificate_verify_peers2()\fP. This function may be called multiple times. .SH "RETURNS" number of CRLs processed or a negative value on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_prf.30000644000000000000000000000474611271476020020171 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_prf" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_prf \- derive pseudo-random data using the TLS PRF .SH SYNOPSIS .B #include .sp .BI "int gnutls_prf(gnutls_session_t " session ", size_t " label_size ", const char * " label ", int " server_random_first ", size_t " extra_size ", const char * " extra ", size_t " outsize ", char * " out ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "size_t label_size" 12 length of the \fIlabel\fP variable. .IP "const char * label" 12 label used in PRF computation, typically a short string. .IP "int server_random_first" 12 non\-0 if server random field should be first in seed .IP "size_t extra_size" 12 length of the \fIextra\fP variable. .IP "const char * extra" 12 optional extra data to seed the PRF with. .IP "size_t outsize" 12 size of pre\-allocated output buffer to hold the output. .IP "char * out" 12 pre\-allocate buffer to hold the generated data. .SH "DESCRIPTION" Apply the TLS Pseudo\-Random\-Function (PRF) using the master secret on some data, seeded with the client and server random fields. The \fIlabel\fP variable usually contain a string denoting the purpose for the generated data. The \fIserver_random_first\fP indicate whether the client random field or the server random field should be first in the seed. Non\-0 indicate that the server random field is first, 0 that the client random field is first. The \fIextra\fP variable can be used to add more data to the seed, after the random variables. It can be used to tie make sure the generated output is strongly connected to some additional data (e.g., a string used in user authentication). The output is placed in *\fIOUT\fP, which must be pre\-allocated. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_get_server_avp_ptr.30000644000000000000000000000237211271476020023744 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_get_server_avp_ptr" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_get_server_avp_ptr \- Returns the pointer which is sent to TLS/IA callback .SH SYNOPSIS .B #include .sp .BI "void * gnutls_ia_get_server_avp_ptr(gnutls_ia_server_credentials_t " cred ");" .SH ARGUMENTS .IP "gnutls_ia_server_credentials_t cred" 12 is a \fBgnutls_ia_client_credentials_t\fP structure. .SH "DESCRIPTION" Returns the pointer that will be provided to the TLS/IA callback function as the first argument. .SH "RETURNS" The server callback data pointer. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_dn_oid.30000644000000000000000000000330311271476020023116 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_dn_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_dn_oid \- This function returns the Certificate's subject distinguished name OIDs .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_dn_oid(gnutls_x509_crt_t " cert ", int " indx ", void * " oid ", size_t * " sizeof_oid ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "int indx" 12 This specifies which OID to return. Use zero to get the first one. .IP "void * oid" 12 a pointer to a buffer to hold the OID (may be null) .IP "size_t * sizeof_oid" 12 initially holds the size of \fIoid\fP .SH "DESCRIPTION" This function will extract the OIDs of the name of the Certificate subject specified by the given index. If oid is null then only the size will be filled. .SH "RETURNS" GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_oid will be updated with the required size. On success 0 is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_session_set_ptr.30000644000000000000000000000241711271476020022616 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_session_set_ptr" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_session_set_ptr \- Used to set the user pointer to the session structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_session_set_ptr(gnutls_session_t " session ", void * " ptr ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "void * ptr" 12 is the user pointer .SH "DESCRIPTION" This function will set (associate) the user given pointer \fIptr\fP to the session structure. This is pointer can be accessed with \fBgnutls_session_get_ptr()\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_version.30000644000000000000000000000230111271476020023344 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_version" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_version \- return the Certificate's version number .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_fingerprint.30000644000000000000000000000351711271476020021724 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_fingerprint" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_fingerprint \- calculate the fingerprint of the given data .SH SYNOPSIS .B #include .sp .BI "int gnutls_fingerprint(gnutls_digest_algorithm_t " algo ", const gnutls_datum_t * " data ", void * " result ", size_t * " result_size ");" .SH ARGUMENTS .IP "gnutls_digest_algorithm_t algo" 12 is a digest algorithm .IP "const gnutls_datum_t * data" 12 is the data .IP "void * result" 12 is the place where the result will be copied (may be null). .IP "size_t * result_size" 12 should hold the size of the result. The actual size of the returned result will also be copied there. .SH "DESCRIPTION" This function will calculate a fingerprint (actually a hash), of the given data. The result is not printable data. You should convert it to hex, or to something else printable. This is the usual way to calculate a fingerprint of an X.509 DER encoded certificate. Note however that the fingerprint of an OpenPGP is not just a hash and cannot be calculated with this function. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_bag_set_data.30000644000000000000000000000254211271476020023152 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_bag_set_data" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_bag_set_data \- This function inserts data into the bag .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_bag_set_data(gnutls_pkcs12_bag_t " bag ", gnutls_pkcs12_bag_type_t " type ", const gnutls_datum_t * " data ");" .SH ARGUMENTS .IP "gnutls_pkcs12_bag_t bag" 12 The bag .IP "gnutls_pkcs12_bag_type_t type" 12 The data's type .IP "const gnutls_datum_t * data" 12 the data to be copied. .SH "DESCRIPTION" This function will insert the given data of the given type into the bag. .SH "RETURNS" the index of the added bag on success, or a negative value on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pem_base64_encode_alloc.30000644000000000000000000000314611271476020024007 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pem_base64_encode_alloc" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pem_base64_encode_alloc \- convert raw data to Base64 encoded .SH SYNOPSIS .B #include .sp .BI "int gnutls_pem_base64_encode_alloc(const char * " msg ", const gnutls_datum_t * " data ", gnutls_datum_t * " result ");" .SH ARGUMENTS .IP "const char * msg" 12 is a message to be put in the encoded header .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 PEM messages. This function will allocate the required memory to hold the encoded data. You should use \fBgnutls_free()\fP to free the returned data. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_subkey_fingerprint.30000644000000000000000000000304511271476020026541 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_subkey_fingerprint" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_subkey_fingerprint \- Gets the fingerprint of a subkey .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_subkey_fingerprint(gnutls_openpgp_crt_t " key ", unsigned int " idx ", void * " fpr ", size_t * " fprlen ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the raw data that contains the OpenPGP public key. .IP "unsigned int idx" 12 the subkey index .IP "void * fpr" 12 the buffer to save the fingerprint, must hold at least 20 bytes. .IP "size_t * fprlen" 12 the integer to save the length of the fingerprint. .SH "DESCRIPTION" Get key fingerprint of a subkey. Depending on the algorithm, the fingerprint can be 16 or 20 bytes. .SH "RETURNS" On success, 0 is returned. Otherwise, an error code. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs7_set_crt.30000644000000000000000000000257211271476020022147 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs7_set_crt" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs7_set_crt \- add a parsed certificate in a PKCS7 certificate set .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs7_set_crt(gnutls_pkcs7_t " pkcs7 ", gnutls_x509_crt_t " crt ");" .SH ARGUMENTS .IP "gnutls_pkcs7_t pkcs7" 12 should contain a \fBgnutls_pkcs7_t\fP structure .IP "gnutls_x509_crt_t crt" 12 the certificate to be copied. .SH "DESCRIPTION" This function will add a parsed certificate to the PKCS7 or RFC2630 certificate set. This is a wrapper function over \fBgnutls_pkcs7_set_crt_raw()\fP . .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_subject_alt_othername_oid.30000644000000000000000000000447111271476020027062 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_subject_alt_othername_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_subject_alt_othername_oid \- Get SAN otherName OID .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_subject_alt_othername_oid(gnutls_x509_crq_t " cert ", unsigned int " seq ", void * " ret ", size_t * " ret_size ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t cert" 12 should contain a \fBgnutls_x509_crq_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_crq_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 "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_free_server_credentials.30000644000000000000000000000240211271476020024722 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_free_server_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_free_server_credentials \- Used to free an allocated #gnutls_ia_server_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_ia_free_server_credentials(gnutls_ia_server_credentials_t " sc ");" .SH ARGUMENTS .IP "gnutls_ia_server_credentials_t sc" 12 is an \fBgnutls_ia_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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_sign.30000644000000000000000000000267011271476020021771 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_sign" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_sign \- Sign a certificate with a key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_sign(gnutls_x509_crt_t " crt ", gnutls_x509_crt_t " issuer ", gnutls_x509_privkey_t " issuer_key ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "gnutls_x509_crt_t issuer" 12 is the certificate of the certificate issuer .IP "gnutls_x509_privkey_t issuer_key" 12 holds the issuer's private key .SH "DESCRIPTION" This function is the same a \fBgnutls_x509_crt_sign2()\fP with no flags, and SHA1 as the hash algorithm. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_psk_set_server_credentials_function.30000644000000000000000000000356211271476020026715 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_psk_set_server_credentials_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_psk_set_server_credentials_function \- Used to set a callback to retrieve the user's PSK credentials .SH SYNOPSIS .B #include .sp .BI "void gnutls_psk_set_server_credentials_function(gnutls_psk_server_credentials_t " cred ", gnutls_psk_server_credentials_function * " func ");" .SH ARGUMENTS .IP "gnutls_psk_server_credentials_t cred" 12 is a \fBgnutls_psk_server_credentials_t\fP structure. .IP "gnutls_psk_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 PSK credentials. The callback's function form is: int (*callback)(gnutls_session_t, const char* username, gnutls_datum_t* key); \fIusername\fP contains the actual username. The \fIkey\fP must be filled in using the \fBgnutls_malloc()\fP. In case the callback returned a negative number then gnutls will assume that the username does not exist. 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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_psk_allocate_server_credentials.30000644000000000000000000000253111271476020025774 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_psk_allocate_server_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_psk_allocate_server_credentials \- Used to allocate an gnutls_psk_server_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_psk_allocate_server_credentials(gnutls_psk_server_credentials_t * " sc ");" .SH ARGUMENTS .IP "gnutls_psk_server_credentials_t * sc" 12 is a pointer to an \fBgnutls_psk_server_credentials_t\fP structure. .SH "DESCRIPTION" This structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_version.30000644000000000000000000000234011271476020023344 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_version" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_version \- This function returns the Certificate request's version number .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_version(gnutls_x509_crq_t " crq ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 should contain a gnutls_x509_crq_t structure .SH "DESCRIPTION" This function will return the version of the specified Certificate request. .SH "RETURNS" version of certificate request, or a negative value on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_generate_mac.30000644000000000000000000000244711271476020023173 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_generate_mac" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_generate_mac \- This function generates the MAC of the PKCS12 structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_generate_mac(gnutls_pkcs12_t " pkcs12 ", const char * " pass ");" .SH ARGUMENTS .IP "gnutls_pkcs12_t pkcs12" 12 should contain a gnutls_pkcs12_t structure .IP "const char * pass" 12 The password for the MAC .SH "DESCRIPTION" This function will generate a MAC for the PKCS12 structure. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_serial.30000644000000000000000000000276011271476020023163 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_serial" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_serial \- Set the certificate's serial number .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_serial(gnutls_x509_crt_t " cert ", const void * " serial ", size_t " serial_size ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "const void * serial" 12 The serial number .IP "size_t serial_size" 12 Holds the size of the serial field. .SH "DESCRIPTION" This function will set the X.509 certificate's serial number. 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. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_subkey_pk_rsa_raw.30000644000000000000000000000307211271476020026342 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_subkey_pk_rsa_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_subkey_pk_rsa_raw \- export the RSA public key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_subkey_pk_rsa_raw(gnutls_openpgp_crt_t " crt ", unsigned int " idx ", gnutls_datum_t * " m ", gnutls_datum_t * " e ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t crt" 12 Holds the certificate .IP "unsigned int idx" 12 Is the subkey index .IP "gnutls_datum_t * m" 12 will hold the modulus .IP "gnutls_datum_t * e" 12 will hold the public exponent .SH "DESCRIPTION" This function will export the RSA public key's parameters found in the given structure. The new parameters will be allocated using \fBgnutls_malloc()\fP and will be stored in the appropriate datum. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_verify_flags.30000644000000000000000000000255411271476020025272 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_verify_flags" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_verify_flags \- set the flags to be used at certificate verification .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_set_verify_flags(gnutls_certificate_credentials_t " res ", unsigned int " flags ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is a gnutls_certificate_credentials_t structure .IP "unsigned int flags" 12 are the flags .SH "DESCRIPTION" This function will set the flags to be used at verification of the certificates. Flags must be OR of the \fBgnutls_certificate_verify_flags\fP enumerations. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_export_dsa_raw.30000644000000000000000000000330611271476020025713 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_export_dsa_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_export_dsa_raw \- This function will export the DSA private key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_export_dsa_raw(gnutls_openpgp_privkey_t " pkey ", gnutls_datum_t * " p ", gnutls_datum_t * " q ", gnutls_datum_t * " g ", gnutls_datum_t * " y ", gnutls_datum_t * " x ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t pkey" 12 Holds the certificate .IP "gnutls_datum_t * p" 12 will hold the p .IP "gnutls_datum_t * q" 12 will hold the q .IP "gnutls_datum_t * g" 12 will hold the g .IP "gnutls_datum_t * y" 12 will hold the y .IP "gnutls_datum_t * x" 12 will hold the x .SH "DESCRIPTION" This function will export the DSA private key's parameters found in the given certificate. The new parameters will be allocated using \fBgnutls_malloc()\fP and will be stored in the appropriate datum. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs7_import.30000644000000000000000000000277411271476020022022 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs7_import" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs7_import \- import a DER or PEM encoded PKCS7 .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs7_import(gnutls_pkcs7_t " pkcs7 ", const gnutls_datum_t * " data ", gnutls_x509_crt_fmt_t " format ");" .SH ARGUMENTS .IP "gnutls_pkcs7_t pkcs7" 12 The structure to store the parsed PKCS7. .IP "const gnutls_datum_t * data" 12 The DER or PEM encoded PKCS7. .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 PKCS7 to the native \fBgnutls_pkcs7_t\fP format. The output will be stored in 'pkcs7'. If the PKCS7 is PEM encoded it should have a header of "PKCS7". .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_bag_decrypt.30000644000000000000000000000245111271476020023037 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_bag_decrypt" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_bag_decrypt \- This function will decrypt an encrypted bag .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_bag_decrypt(gnutls_pkcs12_bag_t " bag ", const char * " pass ");" .SH ARGUMENTS .IP "gnutls_pkcs12_bag_t bag" 12 The bag .IP "const char * pass" 12 The password used for encryption, must be ASCII. .SH "DESCRIPTION" This function will decrypt the given encrypted bag and return 0 on success. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_priority_init.30000644000000000000000000001013211271476020022270 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_priority_init" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_priority_init \- Sets priorities for the cipher suites supported by gnutls. .SH SYNOPSIS .B #include .sp .BI "int gnutls_priority_init(gnutls_priority_t * " priority_cache ", const char * " priorities ", const char ** " err_pos ");" .SH ARGUMENTS .IP "gnutls_priority_t * priority_cache" 12 is a \fBgnutls_prioritity_t\fP structure. .IP "const char * priorities" 12 is a string describing priorities .IP "const char ** err_pos" 12 In case of an error this will have the position in the string the error occured .SH "DESCRIPTION" Sets priorities for the ciphers, key exchange methods, macs and compression methods. This is to avoid using the gnutls_*\fB_priority()\fP functions. The \fBpriorities\fP option allows you to specify a semi\-colon separated list of the cipher priorities to enable. Unless the first keyword is "NONE" the defaults (in preference order) are for TLS protocols TLS1.1, TLS1.0, SSL3.0; for compression NULL; for certificate types X.509, OpenPGP. For key exchange algorithms when in NORMAL or SECURE levels the perfect forward secrecy algorithms take precendence of the other protocols. In all cases all the supported key exchange algorithms are enabled (except for the RSA\-EXPORT which is only enabled in EXPORT level). Note that although one can select very long key sizes (such as 256 bits) for symmetric algorithms, to actually increase security the public key algorithms have to use longer key sizes as well. For all the current available algorithms and protocols use "gnutls\-cli \-l" to get a listing. .SH "COMMON KEYWORDS" Some keywords are defined to provide quick access to common preferences. "PERFORMANCE" means all the "secure" ciphersuites are enabled, limited to 128 bit ciphers and sorted by terms of speed performance. "NORMAL" means all "secure" ciphersuites. The 256\-bit ciphers are included as a fallback only. The ciphers are sorted by security margin. "SECURE128" means all "secure" ciphersuites with ciphers up to 128 bits, sorted by security margin. "SECURE256" means all "secure" ciphersuites including the 256 bit ciphers, sorted by security margin. "EXPORT" means all ciphersuites are enabled, including the low\-security 40 bit ciphers. "NONE" means nothing is enabled. This disables even protocols and compression methods. .SH "SPECIAL KEYWORDS" "!" or "\-" appended with an algorithm will remove this algorithm. "+" appended with an algorithm will add this algorithm. "%COMPAT" will enable compatibility features for a server. "%SSL3_RECORD_VERSION" will use SSL3.0 record version in client hello. "%VERIFY_ALLOW_SIGN_RSA_MD5" will allow RSA\-MD5 signatures in certificate chains. "%VERIFY_ALLOW_X509_V1_CA_CRT" will allow V1 CAs in chains. .SH "NAMESPACE CONCERN" To avoid collisions in order to specify a compression algorithm in this string you have to prefix it with "COMP\-", protocol versions with "VERS\-" and certificate types with "CTYPE\-". All other algorithms don't need a prefix. .SH "EXAMPLES" "NORMAL:!AES\-128\-CBC" means normal ciphers except for AES\-128. "EXPORT:!VERS\-TLS1.0:+COMP\-DEFLATE" means that export ciphers are enabled, TLS 1.0 is disabled, and libz compression enabled. "NONE:+VERS\-TLS1.0:+AES\-128\-CBC:+RSA:+SHA1:+COMP\-NULL", "NORMAL", "%COMPAT". .SH "RETURNS" On syntax error \fBGNUTLS_E_INVALID_REQUEST\fP is returned, \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_strerror_name.30000644000000000000000000000237511271476020022260 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_strerror_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_strerror_name \- API function .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_strerror_name(int " error ");" .SH ARGUMENTS .IP "int error" 12 is an error returned by a gnutls function. .SH "DESCRIPTION" Return the GnuTLS error code define as a string. For example, gnutls_strerror_name (GNUTLS_E_DH_PRIME_UNACCEPTABLE) will return the string "GNUTLS_E_DH_PRIME_UNACCEPTABLE". .SH "RETURNS" A string corresponding to the symbol name of the error code. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_keyring_import.30000644000000000000000000000302711271476020024163 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_keyring_import" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_keyring_import \- Import a raw- or Base64-encoded keyring .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_keyring_import(gnutls_openpgp_keyring_t " keyring ", const gnutls_datum_t * " data ", gnutls_openpgp_crt_fmt_t " format ");" .SH ARGUMENTS .IP "gnutls_openpgp_keyring_t keyring" 12 The structure to store the parsed key. .IP "const gnutls_datum_t * data" 12 The RAW or BASE64 encoded keyring. .IP "gnutls_openpgp_crt_fmt_t format" 12 One of \fBgnutls_openpgp_keyring_fmt\fP elements. .SH "DESCRIPTION" This function will convert the given RAW or Base64 encoded keyring to the native \fBgnutls_openpgp_keyring_t\fP format. The output will be stored in 'keyring'. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_transport_set_errno.30000644000000000000000000000351611271476020023510 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_transport_set_errno" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_transport_set_errno \- API function .SH SYNOPSIS .B #include .sp .BI "void gnutls_transport_set_errno(gnutls_session_t " session ", int " err ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "int err" 12 error value to store in session\-specific errno variable. .SH "DESCRIPTION" Store \fIerr\fP in the session\-specific errno variable. Useful values for \fIerr\fP is EAGAIN and EINTR, other values are treated will be treated as real errors in the push/pull function. This function is useful in replacement push/pull functions set by gnutls_transport_set_push_function and gnutls_transport_set_pullpush_function under Windows, where the replacement push/pull may not have access to the same \fIerrno\fP variable that is used by GnuTLS (e.g., the application is linked to msvcr71.dll and gnutls is linked to msvcrt.dll). If you don't have the \fIsession\fP variable easily accessible from the push/pull function, and don't worry about thread conflicts, you can also use \fBgnutls_transport_set_global_errno()\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_mac_list.30000644000000000000000000000252411271476020021165 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_mac_list" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_mac_list \- Get a list of supported MAC algorithms .SH SYNOPSIS .B #include .sp .BI "const gnutls_mac_algorithm_t * gnutls_mac_list( " void ");" .SH ARGUMENTS .IP " void" 12 .SH "DESCRIPTION" Get a list of hash algorithms for use as MACs. Note that not necessarily all MACs are supported in TLS cipher suites. For example, MD2 is not supported as a cipher suite, but is supported for other purposes (e.g., X.509 signature verification or similar). .SH "RETURNS" Return a zero\-terminated list of \fBgnutls_mac_algorithm_t\fP integers indicating the available MACs. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_db_set_ptr.30000644000000000000000000000226411271476020021520 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_db_set_ptr" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_db_set_ptr \- Set a pointer to be sent to db functions .SH SYNOPSIS .B #include .sp .BI "void gnutls_db_set_ptr(gnutls_session_t " session ", void * " ptr ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "void * ptr" 12 is the pointer .SH "DESCRIPTION" Sets the pointer that will be provided to db store, retrieve and delete functions, as the first argument. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_global_set_log_function.30000644000000000000000000000250211271476020024247 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_global_set_log_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_global_set_log_function \- set the logging function .SH SYNOPSIS .B #include .sp .BI "void gnutls_global_set_log_function(gnutls_log_func " log_func ");" .SH ARGUMENTS .IP "gnutls_log_func log_func" 12 it's a log function .SH "DESCRIPTION" This is the function where you set the logging function gnutls is going to use. This function only accepts a character array. Normally you may not use this function since it is only used for debugging purposes. gnutls_log_func is of the form, void (*gnutls_log_func)( int level, const char*); .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_allocate_credentials.30000644000000000000000000000255511271476020026101 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_allocate_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_allocate_credentials \- Used to allocate a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_allocate_credentials(gnutls_certificate_credentials_t * " res ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t * res" 12 is a pointer to an \fBgnutls_certificate_credentials_t\fP structure. .SH "DESCRIPTION" This structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_malloc.30000644000000000000000000000222111271476020020633 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_malloc" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_malloc \- Allocates and returns data .SH SYNOPSIS .B #include .sp .BI "void * gnutls_malloc(size_t " s ");" .SH ARGUMENTS .IP "size_t s" 12 .SH "DESCRIPTION" This function will allocate 's' bytes data, and return a pointer to memory. This function is supposed to be used by callbacks. The allocation function used is the one set by \fBgnutls_global_set_mem_functions()\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_psk_set_server_dh_params.30000644000000000000000000000260611271476020024447 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_psk_set_server_dh_params" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_psk_set_server_dh_params \- set the DH parameters for a server to use .SH SYNOPSIS .B #include .sp .BI "void gnutls_psk_set_server_dh_params(gnutls_psk_server_credentials_t " res ", gnutls_dh_params_t " dh_params ");" .SH ARGUMENTS .IP "gnutls_psk_server_credentials_t res" 12 is a gnutls_psk_server_credentials_t structure .IP "gnutls_dh_params_t dh_params" 12 is a structure that holds Diffie\-Hellman parameters. .SH "DESCRIPTION" This function will set the Diffie\-Hellman parameters for an anonymous server to use. These parameters will be used in Diffie\-Hellman exchange with PSK cipher suites. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_pk_dsa_raw.30000644000000000000000000000312711271476020024743 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_pk_dsa_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_pk_dsa_raw \- export the DSA public key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_pk_dsa_raw(gnutls_openpgp_crt_t " crt ", gnutls_datum_t * " p ", gnutls_datum_t * " q ", gnutls_datum_t * " g ", gnutls_datum_t * " y ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t crt" 12 Holds the certificate .IP "gnutls_datum_t * p" 12 will hold the p .IP "gnutls_datum_t * q" 12 will hold the q .IP "gnutls_datum_t * g" 12 will hold the g .IP "gnutls_datum_t * y" 12 will hold the y .SH "DESCRIPTION" This function will export the DSA public key's parameters found in the given certificate. The new parameters will be allocated using \fBgnutls_malloc()\fP and will be stored in the appropriate datum. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pk_list.30000644000000000000000000000222111271476020021031 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pk_list" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pk_list \- Get a list of supported public key algorithms .SH SYNOPSIS .B #include .sp .BI "const gnutls_pk_algorithm_t * gnutls_pk_list( " void ");" .SH ARGUMENTS .IP " void" 12 .SH "DESCRIPTION" Get a list of supported public key algorithms. .SH "RETURNS" a zero\-terminated list of \fBgnutls_pk_algorithm_t\fP integers indicating the available ciphers. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_protocol_get_id.30000644000000000000000000000225511271476020022547 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_protocol_get_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_protocol_get_id \- Returns the gnutls id of the specified in string protocol .SH SYNOPSIS .B #include .sp .BI "gnutls_protocol_t gnutls_protocol_get_id(const char * " name ");" .SH ARGUMENTS .IP "const char * name" 12 is a protocol name .SH "DESCRIPTION" The names are compared in a case insensitive way. .SH "RETURNS" an id of the specified protocol, or \fBGNUTLS_VERSION_UNKNOWN\fP on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_crq.30000644000000000000000000000261411271476020022467 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_crq" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_crq \- Associate the Certificate with a request .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_crq(gnutls_x509_crt_t " crt ", gnutls_x509_crq_t " crq ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "gnutls_x509_crq_t crq" 12 holds a certificate request .SH "DESCRIPTION" This function will set the name and public parameters as well as the extensions from the given certificate request to the certificate. Only RSA keys are currently supported. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_import_pkcs8.30000644000000000000000000000426411271476020024355 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_import_pkcs8" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_import_pkcs8 \- This function will import a DER or PEM PKCS8 encoded key .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_export.30000644000000000000000000000342011271476020022341 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_export" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_export \- Export the generated certificate request .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_export(gnutls_x509_crq_t " crq ", gnutls_x509_crt_fmt_t " format ", void * " output_data ", size_t * " output_data_size ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 Holds the request .IP "gnutls_x509_crt_fmt_t format" 12 the format of output params. One of PEM or DER. .IP "void * output_data" 12 will contain a certificate request PEM or DER encoded .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 export the certificate request to a PKCS10 If the buffer provided is not long enough to hold the output, then GNUTLS_E_SHORT_MEMORY_BUFFER will be returned and *output_data_size will be updated. If the structure is PEM encoded, it will have a header of "BEGIN NEW CERTIFICATE REQUEST". .SH "RETURN VALUE" In case of failure a negative value will be returned, and 0 on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_free_ca_names.30000644000000000000000000000257411271476020024510 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_free_ca_names" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_free_ca_names \- Used to free all the CA names from a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_free_ca_names(gnutls_certificate_credentials_t " sc ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t sc" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .SH "DESCRIPTION" This function will delete all the CA name in the given credentials. Clients may call this to save some memory since in client side the CA names are not used. CA names are used by servers to advertize the CAs they support to clients. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_dh_params.30000644000000000000000000000314211271476020024542 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_dh_params" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_dh_params \- set the DH parameters for a server to use .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_set_dh_params(gnutls_certificate_credentials_t " res ", gnutls_dh_params_t " dh_params ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is a gnutls_certificate_credentials_t structure .IP "gnutls_dh_params_t dh_params" 12 is a structure that holds Diffie\-Hellman parameters. .SH "DESCRIPTION" This function will set the Diffie\-Hellman parameters for a certificate server to use. These parameters will be used in Ephemeral Diffie\-Hellman cipher suites. Note that only a pointer to the parameters are stored in the certificate handle, so if you deallocate the parameters before the certificate is deallocated, you must change the parameters stored in the certificate first. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_set_bag.30000644000000000000000000000243111271476020022156 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_set_bag" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_set_bag \- This function inserts a Bag into a PKCS12 structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_set_bag(gnutls_pkcs12_t " pkcs12 ", gnutls_pkcs12_bag_t " bag ");" .SH ARGUMENTS .IP "gnutls_pkcs12_t pkcs12" 12 should contain a gnutls_pkcs12_t structure .IP "gnutls_pkcs12_bag_t bag" 12 An initialized bag .SH "DESCRIPTION" This function will insert a Bag into the PKCS12 structure. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_rsa_params_generate2.30000644000000000000000000000315511271476020023457 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_rsa_params_generate2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_rsa_params_generate2 \- generate temporary RSA parameters .SH SYNOPSIS .B #include .sp .BI "int gnutls_rsa_params_generate2(gnutls_rsa_params_t " params ", unsigned int " bits ");" .SH ARGUMENTS .IP "gnutls_rsa_params_t params" 12 The structure where the parameters will be stored .IP "unsigned int bits" 12 is the prime's number of bits .SH "DESCRIPTION" This function will generate new temporary RSA parameters for use in RSA\-EXPORT ciphersuites. This function is normally slow. Note that if the parameters are to be used in export cipher suites the bits value should be 512 or less. Also note that the generation of new RSA parameters is only useful to servers. Clients use the parameters sent by the server, thus it's no use calling this in client side. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an negative error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_ca_status.30000644000000000000000000000266211271476020023673 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_ca_status" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_ca_status \- Set the basicConstraints extension .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_ca_status(gnutls_x509_crt_t " crt ", unsigned int " ca ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "unsigned int ca" 12 true(1) or false(0). Depending on the Certificate authority status. .SH "DESCRIPTION" This function will set the basicConstraints certificate extension. Use \fBgnutls_x509_crt_set_basic_constraints()\fP if you want to control the pathLenConstraint field too. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_key.30000644000000000000000000000255711271476020022500 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_key" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_key \- This function will associate the Certificate with a key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_key(gnutls_x509_crt_t " crt ", gnutls_x509_privkey_t " key ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "gnutls_x509_privkey_t key" 12 holds a private key .SH "DESCRIPTION" This function will set the public parameters from the given private key to the certificate. Only RSA keys are currently supported. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_protocol_get_name.30000644000000000000000000000234411271476020023072 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_protocol_get_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_protocol_get_name \- Returns a string with the name of the specified SSL/TLS version .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_protocol_get_name(gnutls_protocol_t " version ");" .SH ARGUMENTS .IP "gnutls_protocol_t version" 12 is a (gnutls) version number .SH "DESCRIPTION" Convert a \fBgnutls_protocol_t\fP value to a string. .SH "RETURNS" a string that contains the name of the specified TLS version (e.g., "TLS1.0"), or \fBNULL\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_export.30000644000000000000000000000361011271476020023246 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_export" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_export \- export the private key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_privkey_export(gnutls_x509_privkey_t " key ", gnutls_x509_crt_fmt_t " format ", void * " output_data ", size_t * " output_data_size ");" .SH ARGUMENTS .IP "gnutls_x509_privkey_t key" 12 Holds the key .IP "gnutls_x509_crt_fmt_t format" 12 the format of output params. One of PEM or DER. .IP "void * output_data" 12 will contain a private key PEM or DER encoded .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 export the private key to a PKCS1 structure for RSA keys, or an integer sequence for DSA keys. The DSA keys are in the same format with the parameters used by openssl. 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. If the structure is PEM encoded, it will have a header of "BEGIN RSA PRIVATE KEY". .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_rsa_params_init.30000644000000000000000000000231411271476020022542 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_rsa_params_init" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_rsa_params_init \- initialize the temporary RSA parameters .SH SYNOPSIS .B #include .sp .BI "int gnutls_rsa_params_init(gnutls_rsa_params_t * " rsa_params ");" .SH ARGUMENTS .IP "gnutls_rsa_params_t * rsa_params" 12 Is a structure that will hold the parameters .SH "DESCRIPTION" This function will initialize the temporary RSA parameters structure. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an negative error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_handshake_p.30000644000000000000000000000234511271476020022311 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_handshake_p" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_handshake_p \- API function .SH SYNOPSIS .B #include .sp .BI "int gnutls_ia_handshake_p(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Predicate to be used after \fBgnutls_handshake()\fP to decide whether to invoke \fBgnutls_ia_handshake()\fP. Usable by both clients and servers. .SH "RETURN VALUE" non\-zero if TLS/IA handshake is expected, zero otherwise. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_prf_raw.30000644000000000000000000000467311271476020021041 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_prf_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_prf_raw \- access the TLS PRF directly .SH SYNOPSIS .B #include .sp .BI "int gnutls_prf_raw(gnutls_session_t " session ", size_t " label_size ", const char * " label ", size_t " seed_size ", const char * " seed ", size_t " outsize ", char * " out ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "size_t label_size" 12 length of the \fIlabel\fP variable. .IP "const char * label" 12 label used in PRF computation, typically a short string. .IP "size_t seed_size" 12 length of the \fIseed\fP variable. .IP "const char * seed" 12 optional extra data to seed the PRF with. .IP "size_t outsize" 12 size of pre\-allocated output buffer to hold the output. .IP "char * out" 12 pre\-allocate buffer to hold the generated data. .SH "DESCRIPTION" Apply the TLS Pseudo\-Random\-Function (PRF) using the master secret on some data. The \fIlabel\fP variable usually contain a string denoting the purpose for the generated data. The \fIseed\fP usually contain data such as the client and server random, perhaps together with some additional data that is added to guarantee uniqueness of the output for a particular purpose. Because the output is not guaranteed to be unique for a particular session unless \fIseed\fP include the client random and server random fields (the PRF would output the same data on another connection resumed from the first one), it is not recommended to use this function directly. The \fBgnutls_prf()\fP function seed the PRF with the client and server random fields directly, and is recommended if you want to generate pseudo random data unique for each session. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_fingerprint.30000644000000000000000000000331011271476020024207 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_fingerprint" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_fingerprint \- This function returns the Certificate's fingerprint .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_fingerprint(gnutls_x509_crt_t " cert ", gnutls_digest_algorithm_t " algo ", void * " buf ", size_t * " sizeof_buf ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "gnutls_digest_algorithm_t algo" 12 is a digest algorithm .IP "void * buf" 12 a pointer to a structure to hold the fingerprint (may be null) .IP "size_t * sizeof_buf" 12 initially holds the size of \fIbuf\fP .SH "DESCRIPTION" This function will calculate and copy the certificate's fingerprint in the provided buffer. If the buffer is null then only the size will be filled. .SH "RETURNS" \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP if the provided buffer is not long enough, and in that case the *sizeof_buf will be updated with the required size. On success 0 is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_send.30000644000000000000000000000416011271476020020772 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_send" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_send \- API function .SH SYNOPSIS .B #include .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 it 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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_subject_alternative_name.30000644000000000000000000000331011271476020026731 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_subject_alternative_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_subject_alternative_name \- Set the subject Alternative Name .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_subject_alternative_name(gnutls_x509_crt_t " crt ", gnutls_x509_subject_alt_name_t " type ", const char * " data_string ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "gnutls_x509_subject_alt_name_t type" 12 is one of the gnutls_x509_subject_alt_name_t enumerations .IP "const char * data_string" 12 The data to be set, a zero terminated string .SH "DESCRIPTION" This function will set the subject alternative name certificate extension. This function assumes that data can be expressed as a null terminated string. The name of the function is unfortunate since it is incosistent with \fBgnutls_x509_crt_get_subject_alt_name()\fP. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_get_revoked_status.30000644000000000000000000000242611271476020026575 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_get_revoked_status" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_get_revoked_status \- Get the revoked status of the key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_get_revoked_status(gnutls_openpgp_privkey_t " key ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 the structure that contains the OpenPGP private key. .SH "DESCRIPTION" Get revocation status of key. .SH "RETURNS" true (1) if the key has been revoked, or false (0) if it has not, or a negative value indicates an error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_dh_params_import_raw.30000644000000000000000000000301511271476020023567 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_dh_params_import_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_dh_params_import_raw \- import DH parameters .SH SYNOPSIS .B #include .sp .BI "int gnutls_dh_params_import_raw(gnutls_dh_params_t " dh_params ", const gnutls_datum_t * " prime ", const gnutls_datum_t * " generator ");" .SH ARGUMENTS .IP "gnutls_dh_params_t dh_params" 12 Is a structure that will hold the prime numbers .IP "const gnutls_datum_t * prime" 12 holds the new prime .IP "const gnutls_datum_t * generator" 12 holds the new generator .SH "DESCRIPTION" This function will replace the pair of prime and generator for use in the Diffie\-Hellman key exchange. The new parameters should be stored in the appropriate gnutls_datum. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_list_verify.30000644000000000000000000000535711271476020023375 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_list_verify" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_list_verify \- This function verifies the given certificate list .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_list_verify(const gnutls_x509_crt_t * " cert_list ", int " cert_list_length ", const gnutls_x509_crt_t * " CA_list ", int " CA_list_length ", const gnutls_x509_crl_t * " CRL_list ", int " CRL_list_length ", unsigned int " flags ", unsigned int * " verify ");" .SH ARGUMENTS .IP "const gnutls_x509_crt_t * cert_list" 12 is the certificate list to be verified .IP "int cert_list_length" 12 holds the number of certificate in cert_list .IP "const gnutls_x509_crt_t * CA_list" 12 is the CA list which will be used in verification .IP "int CA_list_length" 12 holds the number of CA certificate in CA_list .IP "const gnutls_x509_crl_t * CRL_list" 12 holds a list of CRLs. .IP "int CRL_list_length" 12 the length of CRL list. .IP "unsigned int flags" 12 Flags that may be used to change the verification algorithm. Use OR of the gnutls_certificate_verify_flags enumerations. .IP "unsigned int * verify" 12 will hold the certificate verification output. .SH "DESCRIPTION" This function will try to verify the given certificate list and return its status. If no flags are specified (0), this function will use the basicConstraints (2.5.29.19) PKIX extension. This means that only a certificate authority is allowed to sign a certificate. You must also check the peer's name in order to check if the verified certificate belongs to the actual peer. The certificate verification output will be put in \fIverify\fP and will be one or more of the gnutls_certificate_status_t enumerated elements bitwise or'd. For a more detailed verification status use \fBgnutls_x509_crt_verify()\fP per list element. .SH "GNUTLS_CERT_INVALID" the certificate chain is not valid. .SH "GNUTLS_CERT_REVOKED" a certificate in the chain has been revoked. .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_export.30000644000000000000000000000340011271476020022342 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_export" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_export \- This function will export the certificate .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_export(gnutls_x509_crt_t " cert ", gnutls_x509_crt_fmt_t " format ", void * " output_data ", size_t * " output_data_size ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 Holds the certificate .IP "gnutls_x509_crt_fmt_t format" 12 the format of output params. One of PEM or DER. .IP "void * output_data" 12 will contain a certificate PEM or DER encoded .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 export the certificate to DER or PEM format. If the buffer provided is not long enough to hold the output, then *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. If the structure is PEM encoded, it will have a header of "BEGIN CERTIFICATE". .SH "RETURN VALUE" In case of failure a negative value will be returned, and 0 on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_transport_set_push_function.30000644000000000000000000000306011271476020025241 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_transport_set_push_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_transport_set_push_function \- set the function to send data .SH SYNOPSIS .B #include .sp .BI "void gnutls_transport_set_push_function(gnutls_session_t " session ", gnutls_push_func " push_func ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 gnutls session .IP "gnutls_push_func push_func" 12 a callback function similar to \fBwrite()\fP .SH "DESCRIPTION" This is the function where you set a push function for gnutls to use in order to send data. If you are going to use berkeley style sockets, you do not need to use this function since the default (send(2)) will probably be ok. Otherwise you should specify this function for gnutls to be able to send data. PUSH_FUNC is of the form, ssize_t (*gnutls_push_func)(gnutls_transport_ptr_t, const void*, size_t); .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pem_base64_decode.30000644000000000000000000000332311271476020022620 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pem_base64_decode" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pem_base64_decode \- decode base64 encoded data .SH SYNOPSIS .B #include .sp .BI "int gnutls_pem_base64_decode(const char * " header ", const gnutls_datum_t * " b64_data ", unsigned char * " result ", size_t * " result_size ");" .SH ARGUMENTS .IP "const char * header" 12 A null terminated string with the PEM header (eg. CERTIFICATE) .IP "const gnutls_datum_t * b64_data" 12 contain the encoded data .IP "unsigned char * result" 12 the place where decoded data will be copied .IP "size_t * result_size" 12 holds the size of the result .SH "DESCRIPTION" This function will decode the given encoded data. If the header given is non null this function will search for "\-\-\-\-\-BEGIN header" and decode only this part. Otherwise it will decode the first PEM packet found. .SH "RETURNS" On success \fBGNUTLS_E_SUCCESS\fP (0) is returned, \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP is returned if the buffer given is not long enough, or 0 on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_handshake_set_post_client_hello_function.30000644000000000000000000000370511271476020027670 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_handshake_set_post_client_hello_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_handshake_set_post_client_hello_function \- set callback to be called after the client hello is received .SH SYNOPSIS .B #include .sp .BI "void gnutls_handshake_set_post_client_hello_function(gnutls_session_t " session ", gnutls_handshake_post_client_hello_func " func ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "gnutls_handshake_post_client_hello_func func" 12 is the function to be called .SH "DESCRIPTION" This function will set a callback to be called after the client hello has been received (callback valid in server side only). This allows the server to adjust settings based on received extensions. Those settings could be ciphersuites, requesting certificate, or anything else except for version negotiation (this is done before the hello message is parsed). This callback must return 0 on success or a gnutls error code to terminate the handshake. .SH "WARNING" You should not use this function to terminate the handshake based on client input unless you know what you are doing. Before the handshake is finished there is no way to know if there is a man\-in\-the\-middle attack being performed. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_crl_dist_points.30000644000000000000000000000303411271476020025076 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_crl_dist_points" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_crl_dist_points \- Set the CRL dist points .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_crl_dist_points(gnutls_x509_crt_t " crt ", gnutls_x509_subject_alt_name_t " type ", const void * " data_string ", unsigned int " reason_flags ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "gnutls_x509_subject_alt_name_t type" 12 is one of the gnutls_x509_subject_alt_name_t enumerations .IP "const void * data_string" 12 The data to be set .IP "unsigned int reason_flags" 12 revocation reasons .SH "DESCRIPTION" This function will set the CRL distribution points certificate extension. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_get_issuer_dn_by_oid.30000644000000000000000000000456011271476020025200 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_get_issuer_dn_by_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_get_issuer_dn_by_oid \- return the CRL's issuer distinguished name .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_get_issuer_dn_by_oid(gnutls_x509_crl_t " crl ", const char * " oid ", int " indx ", unsigned int " raw_flag ", void * " buf ", size_t * " sizeof_buf ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a gnutls_x509_crl_t structure .IP "const char * oid" 12 holds an Object Identified in null terminated string .IP "int indx" 12 In case multiple same OIDs exist in the RDN, this specifies which to send. Use zero to get the first one. .IP "unsigned int raw_flag" 12 If non zero returns the raw DER data of the DN part. .IP "void * buf" 12 a pointer to a structure to hold the peer's name (may be null) .IP "size_t * sizeof_buf" 12 initially holds the size of \fIbuf\fP .SH "DESCRIPTION" This function will extract the part of the name of the CRL issuer specified by the given OID. The output will be encoded as described in RFC2253. The output string will be ASCII or UTF\-8 encoded, depending on the certificate data. Some helper macros with popular OIDs can be found in gnutls/x509.h If raw flag is zero, this function will only return known OIDs as text. Other OIDs will be DER encoded, as described in RFC2253 \-\- in hex format with a '\#' prefix. You can check about known OIDs using \fBgnutls_x509_dn_oid_known()\fP. If buf is null then only the size will be filled. .SH "RETURNS" \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP if the provided buffer is not long enough, and in that case the sizeof_buf will be updated with the required size, and 0 on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_bag_get_type.30000644000000000000000000000233011271476020023201 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_bag_get_type" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_bag_get_type \- This function returns the bag's type .SH SYNOPSIS .B #include .sp .BI "gnutls_pkcs12_bag_type_t gnutls_pkcs12_bag_get_type(gnutls_pkcs12_bag_t " bag ", int " indx ");" .SH ARGUMENTS .IP "gnutls_pkcs12_bag_t bag" 12 The bag .IP "int indx" 12 The element of the bag to get the type .SH "DESCRIPTION" This function will return the bag's type. .SH "RETURNS" One of the \fBgnutls_pkcs12_bag_type_t\fP enumerations. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_session_set_finished_function.30000644000000000000000000000370411271476020025507 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_session_set_finished_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_session_set_finished_function \- API function .SH SYNOPSIS .B #include .sp .BI "void gnutls_session_set_finished_function(gnutls_session_t " session ", gnutls_finished_callback_func " func ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "gnutls_finished_callback_func func" 12 a \fBgnutls_finished_callback_func\fP callback. .SH "DESCRIPTION" Register a callback function for the session that will be called when a TLS Finished message has been generated. The function is typically used to copy away the TLS finished message for later use as a channel binding or similar purpose. .SH "THE CALLBACK SHOULD FOLLOW THIS PROTOTYPE" void callback (gnutls_session_t \fIsession\fP, const void *\fIfinished\fP, size_t \fIlen\fP); The \fIfinished\fP parameter will contain the binary TLS finished message, and \fIlen\fP will contains its length. For SSLv3 connections, the \fIlen\fP parameter will be 36 and for TLS connections it will be 12. It is recommended that the function returns quickly in order to not delay the handshake. Use the function to store a copy of the TLS finished message for later use. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_anon_allocate_client_credentials.30000644000000000000000000000252611271476020026106 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_anon_allocate_client_credentials" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_anon_allocate_client_credentials \- Used to allocate a credentials structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_anon_allocate_client_credentials(gnutls_anon_client_credentials_t * " sc ");" .SH ARGUMENTS .IP "gnutls_anon_client_credentials_t * sc" 12 is a pointer to an \fBgnutls_anon_client_credentials_t\fP structure. .SH "DESCRIPTION" This structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_import.30000644000000000000000000000320611271476020022065 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_import" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_import \- This function will import a DER or PEM encoded PKCS12 structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_import(gnutls_pkcs12_t " pkcs12 ", const gnutls_datum_t * " data ", gnutls_x509_crt_fmt_t " format ", unsigned int " flags ");" .SH ARGUMENTS .IP "gnutls_pkcs12_t pkcs12" 12 The structure to store the parsed PKCS12. .IP "const gnutls_datum_t * data" 12 The DER or PEM encoded PKCS12. .IP "gnutls_x509_crt_fmt_t format" 12 One of DER or PEM .IP "unsigned int flags" 12 an ORed sequence of gnutls_privkey_pkcs8_flags .SH "DESCRIPTION" This function will convert the given DER or PEM encoded PKCS12 to the native gnutls_pkcs12_t format. The output will be stored in 'pkcs12'. If the PKCS12 is PEM encoded it should have a header of "PKCS12". .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_crypto_bigint_register2.30000644000000000000000000000351211271476020024232 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_crypto_bigint_register2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_crypto_bigint_register2 \- register a bigint interface .SH SYNOPSIS .B #include .sp .BI "int gnutls_crypto_bigint_register2(int " priority ", int " version ", gnutls_crypto_bigint_st * " s ");" .SH ARGUMENTS .IP "int priority" 12 is the priority of the interface .IP "int version" 12 should be set to \fBGNUTLS_CRYPTO_API_VERSION\fP .IP "gnutls_crypto_bigint_st * s" 12 is a structure holding new interface's data .SH "DESCRIPTION" This function will register an interface for gnutls to operate on big integers. Any interface registered will override the included interface. The interface with the lowest priority will be used by gnutls. Note that the bigint interface must interoperate with the public key interface. Thus if this interface is updated the \fBgnutls_crypto_pk_register()\fP should also be used. This function should be called before \fBgnutls_global_init()\fP. For simplicity you can use the convenience \fBgnutls_crypto_bigint_register()\fP macro. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_alert_get.30000644000000000000000000000301411271476020021333 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_alert_get" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_alert_get \- Returns the last alert number received. .SH SYNOPSIS .B #include .sp .BI "gnutls_alert_description_t gnutls_alert_get(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" This function will return the last alert number received. This function should be called if \fBGNUTLS_E_WARNING_ALERT_RECEIVED\fP or \fBGNUTLS_E_FATAL_ALERT_RECEIVED\fP has been returned by a gnutls function. The peer may send alerts if he thinks some things were not right. Check gnutls.h for the available alert descriptions. If no alert has been received the returned value is undefined. .SH "RETURNS" returns the last alert received, a \fBgnutls_alert_description_t\fP value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_crypto_single_mac_register2.30000644000000000000000000000353411271476020025063 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_crypto_single_mac_register2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_crypto_single_mac_register2 \- register a MAC algorithm .SH SYNOPSIS .B #include .sp .BI "int gnutls_crypto_single_mac_register2(gnutls_mac_algorithm_t " algorithm ", int " priority ", int " version ", gnutls_crypto_single_mac_st * " s ");" .SH ARGUMENTS .IP "gnutls_mac_algorithm_t algorithm" 12 is the gnutls algorithm identifier .IP "int priority" 12 is the priority of the algorithm .IP "int version" 12 should be set to \fBGNUTLS_CRYPTO_API_VERSION\fP .IP "gnutls_crypto_single_mac_st * s" 12 is a structure holding new algorithms's data .SH "DESCRIPTION" This function will register a MAC algorithm to be used by gnutls. Any algorithm registered will override the included algorithms and by convention kernel implemented algorithms have priority of 90. The algorithm with the lowest priority will be used by gnutls. This function should be called before \fBgnutls_global_init()\fP. For simplicity you can use the convenience \fBgnutls_crypto_single_mac_register()\fP macro. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_x509_simple_pkcs12_file.30000644000000000000000000000474211271476020027053 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_x509_simple_pkcs12_file" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_x509_simple_pkcs12_file \- API function .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_x509_simple_pkcs12_file(gnutls_certificate_credentials_t " res ", const char * " pkcs12file ", gnutls_x509_crt_fmt_t " type ", const char * " password ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .IP "const char * pkcs12file" 12 filename of file containing PKCS\fB12\fP blob. .IP "gnutls_x509_crt_fmt_t type" 12 is PEM or DER of the \fIpkcs12file\fP. .IP "const char * password" 12 optional password used to decrypt PKCS\fB12\fP file, bags and keys. .SH "DESCRIPTION" This function sets a certificate/private key pair and/or a CRL in the gnutls_certificate_credentials_t structure. This function may be called more than once (in case multiple keys/certificates exist for the server). .SH "MAC" ed PKCS\fB12\fP files are supported. Encrypted PKCS\fB12\fP bags are supported. Encrypted PKCS\fB8\fP private keys are supported. However, only password based security, and the same password for all operations, are supported. The private keys may be RSA PKCS\fB1\fP or DSA private keys encoded in the OpenSSL way. PKCS\fB12\fP file may contain many keys and/or certificates, and there is no way to identify which key/certificate pair you want. You should make sure the PKCS\fB12\fP file only contain one key/certificate pair and/or one CRL. It is believed that the limitations of this function is acceptable for most usage, and that any more flexibility would introduce complexity that would make it harder to use this functionality at all. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_get_subkey_idx.30000644000000000000000000000244211271476020025677 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_get_subkey_idx" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_get_subkey_idx \- Returns the subkey's index .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_get_subkey_idx(gnutls_openpgp_privkey_t " key ", const gnutls_openpgp_keyid_t " keyid ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 the structure that contains the OpenPGP private key. .IP "const gnutls_openpgp_keyid_t keyid" 12 the keyid. .SH "DESCRIPTION" Get index of subkey. .SH "RETURNS" the index of the subkey or a negative error value. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_get_subkey_fingerprint.30000644000000000000000000000306711271476020027446 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_get_subkey_fingerprint" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_get_subkey_fingerprint \- Gets the fingerprint of a subkey .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_get_subkey_fingerprint(gnutls_openpgp_privkey_t " key ", unsigned int " idx ", void * " fpr ", size_t * " fprlen ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 the raw data that contains the OpenPGP secret key. .IP "unsigned int idx" 12 the subkey index .IP "void * fpr" 12 the buffer to save the fingerprint, must hold at least 20 bytes. .IP "size_t * fprlen" 12 the integer to save the length of the fingerprint. .SH "DESCRIPTION" Get the fingerprint of an OpenPGP subkey. Depends on the algorithm, the fingerprint can be 16 or 20 bytes. .SH "RETURNS" On success, 0 is returned, or an error code. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_cipher_set_priority.30000644000000000000000000000306111271476020023455 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_cipher_set_priority" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_cipher_set_priority \- Sets the priority on the ciphers supported by gnutls. .SH SYNOPSIS .B #include .sp .BI "int gnutls_cipher_set_priority(gnutls_session_t " session ", const int * " list ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "const int * list" 12 is a 0 terminated list of gnutls_cipher_algorithm_t elements. .SH "DESCRIPTION" Sets the priority on the ciphers supported by gnutls. Priority is higher for elements specified before others. After specifying the ciphers you want, you must append a 0. Note that the priority is set on the client. The server does not use the algorithm's priority except for disabling algorithms that were not specified. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_dh_params_cpy.30000644000000000000000000000246311271476020022205 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_dh_params_cpy" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_dh_params_cpy \- copy a DH parameters structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_dh_params_cpy(gnutls_dh_params_t " dst ", gnutls_dh_params_t " src ");" .SH ARGUMENTS .IP "gnutls_dh_params_t dst" 12 Is the destination structure, which should be initialized. .IP "gnutls_dh_params_t src" 12 Is the source structure .SH "DESCRIPTION" This function will copy the DH parameters structure from source to destination. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_mac_get_name.30000644000000000000000000000231511271476020021767 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_mac_get_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_mac_get_name \- Returns a string with the name of the specified mac algorithm .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_mac_get_name(gnutls_mac_algorithm_t " algorithm ");" .SH ARGUMENTS .IP "gnutls_mac_algorithm_t algorithm" 12 is a MAC algorithm .SH "DESCRIPTION" Convert a \fBgnutls_mac_algorithm_t\fP value to a string. .SH "RETURNS" a string that contains the name of the specified MAC algorithm, or \fBNULL\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_check_version.30000644000000000000000000000270311271476020022213 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_check_version" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_check_version \- checks the libgnutls version .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_check_version(const char * " req_version ");" .SH ARGUMENTS .IP "const char * req_version" 12 version string to compare with, or \fBNULL\fP. .SH "DESCRIPTION" Check GnuTLS Library version. See \fBGNUTLS_VERSION\fP for a suitable \fIreq_version\fP string. .SH "RETURN VALUE" Check that the version of the library is at minimum the one given as a string in \fIreq_version\fP and return the actual version string of the library; return \fBNULL\fP if the condition is not met. If \fBNULL\fP is passed to this function no check is done and only the version string is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_record_get_direction.30000644000000000000000000000337711271476020023556 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_record_get_direction" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_record_get_direction \- return the direction of the last interrupted function call .SH SYNOPSIS .B #include .sp .BI "int gnutls_record_get_direction(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" This function provides information about the internals of the record protocol and is only useful if a prior gnutls function call (e.g. \fBgnutls_handshake()\fP) was interrupted for some reason, that is, if a function returned \fBGNUTLS_E_INTERRUPTED\fP or \fBGNUTLS_E_AGAIN\fP. In such a case, you might want to call \fBselect()\fP or \fBpoll()\fP before calling the interrupted gnutls function again. To tell you whether a file descriptor should be selected for either reading or writing, \fBgnutls_record_get_direction()\fP returns 0 if the interrupted function was trying to read data, and 1 if it was trying to write data. .SH "RETURNS" 0 if trying to read data, 1 if trying to write data. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_subkey_usage.30000644000000000000000000000303711271476020025317 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_subkey_usage" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_subkey_usage \- returns the key's usage .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_subkey_usage(gnutls_openpgp_crt_t " key ", unsigned int " idx ", unsigned int * " key_usage ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 should contain a gnutls_openpgp_crt_t structure .IP "unsigned int idx" 12 the subkey index .IP "unsigned int * key_usage" 12 where the key usage bits will be stored .SH "DESCRIPTION" This function will return certificate's key usage, by checking the key algorithm. The key usage value will ORed values of \fBGNUTLS_KEY_DIGITAL_SIGNATURE\fP or \fBGNUTLS_KEY_KEY_ENCIPHERMENT\fP. A negative value may be returned in case of parsing error. .SH "RETURNS" key usage value. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_subkey_pk_dsa_raw.30000644000000000000000000000326011271476020026323 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_subkey_pk_dsa_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_subkey_pk_dsa_raw \- export the DSA public key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_subkey_pk_dsa_raw(gnutls_openpgp_crt_t " crt ", unsigned int " idx ", gnutls_datum_t * " p ", gnutls_datum_t * " q ", gnutls_datum_t * " g ", gnutls_datum_t * " y ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t crt" 12 Holds the certificate .IP "unsigned int idx" 12 Is the subkey index .IP "gnutls_datum_t * p" 12 will hold the p .IP "gnutls_datum_t * q" 12 will hold the q .IP "gnutls_datum_t * g" 12 will hold the g .IP "gnutls_datum_t * y" 12 will hold the y .SH "DESCRIPTION" This function will export the DSA public key's parameters found in the given certificate. The new parameters will be allocated using \fBgnutls_malloc()\fP and will be stored in the appropriate datum. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_set_dn_by_oid.30000644000000000000000000000401311271476020023620 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_set_dn_by_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_set_dn_by_oid \- This function will set the Certificate request subject's distinguished name .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_set_dn_by_oid(gnutls_x509_crq_t " crq ", const char * " oid ", unsigned int " raw_flag ", const void * " data ", unsigned int " sizeof_data ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 should contain a gnutls_x509_crq_t structure .IP "const char * oid" 12 holds an Object Identifier in a null terminated string .IP "unsigned int raw_flag" 12 must be 0, or 1 if the data are DER encoded .IP "const void * data" 12 a pointer to the input data .IP "unsigned int sizeof_data" 12 holds the size of \fIdata\fP .SH "DESCRIPTION" This function will set the part of the name of the Certificate request subject, specified by the given OID. The input string should be ASCII or UTF\-8 encoded. Some helper macros with popular OIDs can be found in gnutls/x509.h With this function you can only set the known OIDs. You can test for known OIDs using \fBgnutls_x509_dn_oid_known()\fP. For OIDs that are not known (by gnutls) you should properly DER encode your data, and call this function with raw_flag set. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_print.30000644000000000000000000000303511271476020023124 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_print" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_print \- Pretty print OpenPGP certificates .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_print(gnutls_openpgp_crt_t " cert ", gnutls_certificate_print_formats_t " format ", gnutls_datum_t * " out ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t cert" 12 The structure to be printed .IP "gnutls_certificate_print_formats_t format" 12 Indicate the format to use .IP "gnutls_datum_t * out" 12 Newly allocated datum with zero terminated string. .SH "DESCRIPTION" This function will pretty print an OpenPGP certificate, suitable for display to a human. The format should be zero for future compatibility. The output \fIout\fP needs to be deallocate using \fBgnutls_free()\fP. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_verify.30000644000000000000000000000353711271476020022340 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_verify" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_verify \- This function verifies the given certificate against a given trusted one .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_verify(gnutls_x509_crt_t " cert ", const gnutls_x509_crt_t * " CA_list ", int " CA_list_length ", unsigned int " flags ", unsigned int * " verify ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 is the certificate to be verified .IP "const gnutls_x509_crt_t * CA_list" 12 is one certificate that is considered to be trusted one .IP "int CA_list_length" 12 holds the number of CA certificate in CA_list .IP "unsigned int flags" 12 Flags that may be used to change the verification algorithm. Use OR of the gnutls_certificate_verify_flags enumerations. .IP "unsigned int * verify" 12 will hold the certificate verification output. .SH "DESCRIPTION" This function will try to verify the given certificate and return its status. The verification output in this functions cannot be GNUTLS_CERT_NOT_VALID. .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_extension_by_oid.30000644000000000000000000000400211271476020025220 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_extension_by_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_extension_by_oid \- This function returns the specified extension .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_extension_by_oid(gnutls_x509_crt_t " cert ", const char * " oid ", int " indx ", void * " buf ", size_t * " sizeof_buf ", unsigned int * " critical ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "const char * oid" 12 holds an Object Identified in null terminated string .IP "int indx" 12 In case multiple same OIDs exist in the extensions, this specifies which to send. Use zero to get the first one. .IP "void * buf" 12 a pointer to a structure to hold the name (may be null) .IP "size_t * sizeof_buf" 12 initially holds the size of \fIbuf\fP .IP "unsigned int * critical" 12 will be non zero if the extension is marked as critical .SH "DESCRIPTION" This function will return the extension specified by the OID in the certificate. The extensions will be returned as binary data DER encoded, in the provided buffer. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. If the certificate does not contain the specified extension GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_sign_data.30000644000000000000000000000376711271476020023673 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_sign_data" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_sign_data \- sign data using the private key .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_record_get_max_size.30000644000000000000000000000233111271476020023402 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_record_get_max_size" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_record_get_max_size \- returns the maximum record size .SH SYNOPSIS .B #include .sp .BI "size_t gnutls_record_get_max_size(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Get the record size. The maximum record size is negotiated by the client after the first handshake message. .SH "RETURNS" The maximum record packet size in this connection. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_challenge_password.30000644000000000000000000000264511271476020025533 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_challenge_password" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_challenge_password \- This function will get the challenge password .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_challenge_password(gnutls_x509_crq_t " crq ", char * " pass ", size_t * " sizeof_pass ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 should contain a gnutls_x509_crq_t structure .IP "char * pass" 12 will hold a null terminated password .IP "size_t * sizeof_pass" 12 Initially holds the size of \fIpass\fP. .SH "DESCRIPTION" This function will return the challenge password in the request. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_sign_algorithm_get_name.30000644000000000000000000000235211271476020024236 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_sign_algorithm_get_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_sign_algorithm_get_name \- Returns a string with the name of the specified sign algorithm .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_sign_algorithm_get_name(gnutls_sign_algorithm_t " sign ");" .SH ARGUMENTS .IP "gnutls_sign_algorithm_t sign" 12 is a sign algorithm .SH "DESCRIPTION" Convert a \fBgnutls_sign_algorithm_t\fP value to a string. .SH "RETURNS" a string that contains the name of the specified sign algorithm, or \fBNULL\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_key_purpose_oid.30000644000000000000000000000367611271476020025077 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_key_purpose_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_key_purpose_oid \- This function returns the Certificate's key purpose OIDs .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_key_purpose_oid(gnutls_x509_crt_t " cert ", int " indx ", void * " oid ", size_t * " sizeof_oid ", unsigned int * " critical ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "int indx" 12 This specifies which OID to return. Use zero to get the first one. .IP "void * oid" 12 a pointer to a buffer to hold the OID (may be null) .IP "size_t * sizeof_oid" 12 initially holds the size of \fIoid\fP .IP "unsigned int * critical" 12 output flag to indicate criticality of extension .SH "DESCRIPTION" This function will extract the key purpose OIDs of the Certificate specified by the given index. These are stored in the Extended Key Usage extension (2.5.29.37) See the GNUTLS_KP_* definitions for human readable names. If \fIoid\fP is null then only the size will be filled. .SH "RETURNS" \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP if the provided buffer is not long enough, and in that case the *sizeof_oid will be updated with the required size. On success 0 is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_kx_set_priority.30000644000000000000000000000310411271476020022623 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_kx_set_priority" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_kx_set_priority \- Sets the priority on the key exchange algorithms supported by gnutls. .SH SYNOPSIS .B #include .sp .BI "int gnutls_kx_set_priority(gnutls_session_t " session ", const int * " list ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "const int * list" 12 is a 0 terminated list of gnutls_kx_algorithm_t elements. .SH "DESCRIPTION" Sets the priority on the key exchange algorithms supported by gnutls. Priority is higher for elements specified before others. After specifying the algorithms you want, you must append a 0. Note that the priority is set on the client. The server does not use the algorithm's priority except for disabling algorithms that were not specified. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_pk_algorithm.30000644000000000000000000000307411271476020024347 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_pk_algorithm" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_pk_algorithm \- return the certificate's PublicKey algorithm .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_pk_algorithm(gnutls_x509_crt_t " cert ", unsigned int * " bits ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "unsigned int * bits" 12 if bits is non null it will hold the size of the parameters' in bits .SH "DESCRIPTION" This function will return the public key algorithm of an X.509 certificate. If bits is non null, it should have enough size to hold the parameters size in bits. For RSA the bits returned is the modulus. For DSA the bits returned are of the public exponent. .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_dh_params_deinit.30000644000000000000000000000215111271476020022660 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_dh_params_deinit" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_dh_params_deinit \- deinitialize the DH parameters .SH SYNOPSIS .B #include .sp .BI "void gnutls_dh_params_deinit(gnutls_dh_params_t " dh_params ");" .SH ARGUMENTS .IP "gnutls_dh_params_t dh_params" 12 Is a structure that holds the prime numbers .SH "DESCRIPTION" This function will deinitialize the DH parameters structure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_subject.30000644000000000000000000000273311271476020023327 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_subject" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_subject \- API function .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_oprfi_enable_client.30000644000000000000000000000272111271476020023354 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_oprfi_enable_client" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_oprfi_enable_client \- API function .SH SYNOPSIS .B #include .sp .BI "void gnutls_oprfi_enable_client(gnutls_session_t " session ", size_t " len ", unsigned char * " data ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "size_t len" 12 length of Opaque PRF data to use in client. .IP "unsigned char * data" 12 Opaque PRF data to use in client. .SH "DESCRIPTION" Request that the client should attempt to negotiate the Opaque PRF Input TLS extension, using the given data as the client's Opaque PRF input. The data is copied into the session context after this call, so you may de\-allocate it immediately after calling this function. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_set_client_avp_function.30000644000000000000000000000455611271476020024756 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_set_client_avp_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_set_client_avp_function \- Used to set a AVP callback .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_session_get_client_random.30000644000000000000000000000260711271476020024614 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_session_get_client_random" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_session_get_client_random \- get the session's client random value .SH SYNOPSIS .B #include .sp .BI "const void * gnutls_session_get_client_random(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Return a pointer to the 32\-byte client random field used in the session. The pointer must not be modified or deallocated. If a client random value has not yet been established, the output will be garbage; in particular, a \fBNULL\fP return value should not be expected. .SH "RETURNS" pointer to client random data. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_key_purpose_oid.30000644000000000000000000000367411271476020025072 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_key_purpose_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_key_purpose_oid \- get Certificate's key purpose OIDs .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_key_purpose_oid(gnutls_x509_crq_t " cert ", int " indx ", void * " oid ", size_t * " sizeof_oid ", unsigned int * " critical ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t cert" 12 should contain a \fBgnutls_x509_crq_t\fP structure .IP "int indx" 12 This specifies which OID to return. Use zero to get the first one. .IP "void * oid" 12 a pointer to a buffer to hold the OID (may be null) .IP "size_t * sizeof_oid" 12 initially holds the size of \fIoid\fP .IP "unsigned int * critical" 12 output variable with critical flag, may be NULL. .SH "DESCRIPTION" This function will extract the key purpose OIDs of the Certificate specified by the given index. These are stored in the Extended Key Usage extension (2.5.29.37). See the GNUTLS_KP_* definitions for human readable names. If \fIoid\fP is null then only the size will be filled. .SH "RETURNS" \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP if the provided buffer is not long enough, and in that case the *sizeof_oid will be updated with the required size. On success 0 is returned. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_set_crt.30000644000000000000000000000271311271476020022462 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_set_crt" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_set_crt \- This function will set a revoked certificate's serial number .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_set_crt(gnutls_x509_crl_t " crl ", gnutls_x509_crt_t " crt ", time_t " revocation_time ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a gnutls_x509_crl_t structure .IP "gnutls_x509_crt_t crt" 12 a certificate of type \fBgnutls_x509_crt_t\fP with the revoked certificate .IP "time_t revocation_time" 12 The time this certificate was revoked .SH "DESCRIPTION" This function will set a revoked certificate's serial number to the CRL. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_bag_set_friendly_name.30000644000000000000000000000305511271476020025055 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_bag_set_friendly_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_bag_set_friendly_name \- This function sets a friendly name into the bag element .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_bag_set_friendly_name(gnutls_pkcs12_bag_t " bag ", int " indx ", const char * " name ");" .SH ARGUMENTS .IP "gnutls_pkcs12_bag_t bag" 12 The bag .IP "int indx" 12 The bag's element to add the id .IP "const char * name" 12 the name .SH "DESCRIPTION" This function will add the given key friendly name, to the specified, by the index, bag element. The name will be encoded as a 'Friendly name' bag attribute, which is usually used to set a user name to the local private key and the certificate pair. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. or a negative value on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_error_is_fatal.30000644000000000000000000000300411271476020022357 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_error_is_fatal" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_error_is_fatal \- Returns non-zero in case of a fatal error .SH SYNOPSIS .B #include .sp .BI "int gnutls_error_is_fatal(int " error ");" .SH ARGUMENTS .IP "int error" 12 is a GnuTLS error code, a negative value .SH "DESCRIPTION" If a GnuTLS function returns a negative value you may feed that value to this function to see if the error condition is fatal. Note that you may want to check the error code manually, since some non\-fatal errors to the protocol may be fatal for you program. This function is only useful if you are dealing with errors from the record layer or the handshake layer. .SH "RETURNS" 1 if the error code is fatal, for positive \fIerror\fP values, 0 is returned. For unknown \fIerror\fP values, \-1 is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_verify_hash.30000644000000000000000000000273211271476020023337 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_verify_hash" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_verify_hash \- verify the given signed digest .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_verify_hash(gnutls_x509_crt_t " crt ", unsigned int " flags ", const gnutls_datum_t * " hash ", const gnutls_datum_t * " signature ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t crt" 12 Holds the certificate .IP "unsigned int flags" 12 should be 0 for now .IP "const gnutls_datum_t * hash" 12 holds the hash digest to be verified .IP "const gnutls_datum_t * signature" 12 contains the signature .SH "DESCRIPTION" This function will verify the given signed digest, using the parameters from the certificate. .SH "RETURNS" In case of a verification failure 0 is returned, and 1 on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_crypto_mac_register2.30000644000000000000000000000330511271476020023516 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_crypto_mac_register2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_crypto_mac_register2 \- register a mac interface .SH SYNOPSIS .B #include .sp .BI "int gnutls_crypto_mac_register2(int " priority ", int " version ", gnutls_crypto_mac_st * " s ");" .SH ARGUMENTS .IP "int priority" 12 is the priority of the mac interface .IP "int version" 12 should be set to \fBGNUTLS_CRYPTO_API_VERSION\fP .IP "gnutls_crypto_mac_st * s" 12 is a structure holding new interface's data .SH "DESCRIPTION" This function will register a mac interface to be used by gnutls. Any interface registered will override the included engine and by convention kernel implemented interfaces should have priority of 90. The interface with the lowest priority will be used by gnutls. This function should be called before \fBgnutls_global_init()\fP. For simplicity you can use the convenience \fBgnutls_crypto_mac_register()\fP macro. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_psk_set_server_credentials_file.30000644000000000000000000000301211271476020025775 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_psk_set_server_credentials_file" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_psk_set_server_credentials_file \- Used to set the password files, in a gnutls_psk_server_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_psk_set_server_credentials_file(gnutls_psk_server_credentials_t " res ", const char * " password_file ");" .SH ARGUMENTS .IP "gnutls_psk_server_credentials_t res" 12 is an \fBgnutls_psk_server_credentials_t\fP structure. .IP "const char * password_file" 12 is the PSK password file (passwd.psk) .SH "DESCRIPTION" This function sets the password file, in a \fBgnutls_psk_server_credentials_t\fP structure. This password file holds usernames and keys and will be used for PSK authentication. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_export_dsa_raw.30000644000000000000000000000327111271476020024751 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_export_dsa_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_export_dsa_raw \- export the DSA private key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_privkey_export_dsa_raw(gnutls_x509_privkey_t " key ", gnutls_datum_t * " p ", gnutls_datum_t * " q ", gnutls_datum_t * " g ", gnutls_datum_t * " y ", gnutls_datum_t * " x ");" .SH ARGUMENTS .IP "gnutls_x509_privkey_t key" 12 a structure that holds the DSA parameters .IP "gnutls_datum_t * p" 12 will hold the p .IP "gnutls_datum_t * q" 12 will hold the q .IP "gnutls_datum_t * g" 12 will hold the g .IP "gnutls_datum_t * y" 12 will hold the y .IP "gnutls_datum_t * x" 12 will hold the x .SH "DESCRIPTION" This function will export the DSA private key's parameters found in the given structure. The new parameters will be allocated using \fBgnutls_malloc()\fP and will be stored in the appropriate datum. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_type_get.30000644000000000000000000000236711271476020023561 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_type_get" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_type_get \- Returns the currently used certificate type. .SH SYNOPSIS .B #include .sp .BI "gnutls_certificate_type_t gnutls_certificate_type_get(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" The certificate type is by default X.509, unless it is negotiated as a TLS extension. .SH "RETURNS" the currently used \fBgnutls_certificate_type_t\fP certificate type. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_get_extension_data.30000644000000000000000000000367511271476020024673 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_get_extension_data" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_get_extension_data \- Get the specified extension data .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_get_extension_data(gnutls_x509_crl_t " crl ", int " indx ", void * " data ", size_t * " sizeof_data ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a \fBgnutls_x509_crl_t\fP structure .IP "int indx" 12 Specifies which extension OID to send. Use zero to get the first one. .IP "void * data" 12 a pointer to a structure to hold the data (may be null) .IP "size_t * sizeof_data" 12 initially holds the size of \fIoid\fP .SH "DESCRIPTION" This function will return the requested extension data in the CRL. The extension data will be stored as a string in the provided buffer. Use \fBgnutls_x509_crl_get_extension_info()\fP to extract the OID and critical flag. Use \fBgnutls_x509_crl_get_extension_by_oid()\fP instead, if you want to get data indexed by the extension OID rather than sequence. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative value in case of an error. If your have reached the last extension available \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_issuer_dn_oid.30000644000000000000000000000333411271476020024514 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_issuer_dn_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_issuer_dn_oid \- This function returns the Certificate's issuer distinguished name OIDs .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_issuer_dn_oid(gnutls_x509_crt_t " cert ", int " indx ", void * " oid ", size_t * " sizeof_oid ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 should contain a \fBgnutls_x509_crt_t\fP structure .IP "int indx" 12 This specifies which OID to return. Use zero to get the first one. .IP "void * oid" 12 a pointer to a buffer to hold the OID (may be null) .IP "size_t * sizeof_oid" 12 initially holds the size of \fIoid\fP .SH "DESCRIPTION" This function will extract the OIDs of the name of the Certificate issuer specified by the given index. If \fIoid\fP is null then only the size will be filled. .SH "RETURNS" GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_oid will be updated with the required size. On success 0 is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_set_version.30000644000000000000000000000263211271476020023357 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_set_version" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_set_version \- This function will set the CRL version .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_set_version(gnutls_x509_crl_t " crl ", unsigned int " version ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a gnutls_x509_crl_t structure .IP "unsigned int version" 12 holds the version number. For CRLv1 crls must be 1. .SH "DESCRIPTION" This function will set the version of the CRL. This must be one for CRL version 1, and so on. The CRLs generated by gnutls should have a version number of 2. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_subkey_count.30000644000000000000000000000233311271476020025341 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_subkey_count" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_subkey_count \- return the number of subkeys .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_subkey_count(gnutls_openpgp_crt_t " key ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 is an OpenPGP key .SH "DESCRIPTION" This function will return the number of subkeys present in the given OpenPGP certificate. .SH "RETURNS" the number of subkeys, or a negative value on error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_handshake_set_private_extensions.30000644000000000000000000000322511271476020026203 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_handshake_set_private_extensions" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_handshake_set_private_extensions \- Used to enable the private cipher suites .SH SYNOPSIS .B #include .sp .BI "void gnutls_handshake_set_private_extensions(gnutls_session_t " session ", int " allow ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "int allow" 12 is an integer (0 or 1) .SH "DESCRIPTION" This function will enable or disable the use of private cipher suites (the ones that start with 0xFF). By default or if \fIallow\fP is 0 then these cipher suites will not be advertized nor used. Unless this function is called with the option to allow (1), then no compression algorithms, like LZO. That is because these algorithms are not yet defined in any RFC or even internet draft. Enabling the private ciphersuites when talking to other than gnutls servers and clients may cause interoperability problems. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_subkey_idx.30000644000000000000000000000241411271476020024775 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_subkey_idx" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_subkey_idx \- Returns the subkey's index .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_subkey_idx(gnutls_openpgp_crt_t " key ", const gnutls_openpgp_keyid_t " keyid ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the structure that contains the OpenPGP public key. .IP "const gnutls_openpgp_keyid_t keyid" 12 the keyid. .SH "DESCRIPTION" Get subkey's index. .SH "RETURNS" the index of the subkey or a negative error value. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_subkey_pk_algorithm.30000644000000000000000000000326011271476020026671 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_subkey_pk_algorithm" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_subkey_pk_algorithm \- return the subkey's PublicKey algorithm .SH SYNOPSIS .B #include .sp .BI "gnutls_pk_algorithm_t gnutls_openpgp_crt_get_subkey_pk_algorithm(gnutls_openpgp_crt_t " key ", unsigned int " idx ", unsigned int * " bits ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 is an OpenPGP key .IP "unsigned int idx" 12 is the subkey index .IP "unsigned int * bits" 12 if bits is non null it will hold the size of the parameters' in bits .SH "DESCRIPTION" This function will return the public key algorithm of a subkey of an OpenPGP certificate. If bits is non null, it should have enough size to hold the parameters size in bits. For RSA the bits returned is the modulus. For DSA the bits returned are of the public exponent. .SH "RETURNS" a member of the \fBgnutls_pk_algorithm_t\fP enumeration on success, or a negative value on error. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_cipher_list.30000644000000000000000000000250611271476020021677 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_cipher_list" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_cipher_list \- Get a list of supported ciphers .SH SYNOPSIS .B #include .sp .BI "const gnutls_cipher_algorithm_t * gnutls_cipher_list( " void ");" .SH ARGUMENTS .IP " void" 12 .SH "DESCRIPTION" Get a list of supported cipher algorithms. Note that not necessarily all ciphers are supported as TLS cipher suites. For example, DES is not supported as a cipher suite, but is supported for other purposes (e.g., PKCS\fB8\fP or similar). .SH "RETURNS" a zero\-terminated list of \fBgnutls_cipher_algorithm_t\fP integers indicating the available ciphers. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_sign.30000644000000000000000000000270211271476020021755 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_sign" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_sign \- This function will sign a CRL with a key .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_sign(gnutls_x509_crl_t " crl ", gnutls_x509_crt_t " issuer ", gnutls_x509_privkey_t " issuer_key ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a gnutls_x509_crl_t structure .IP "gnutls_x509_crt_t issuer" 12 is the certificate of the certificate issuer .IP "gnutls_x509_privkey_t issuer_key" 12 holds the issuer's private key .SH "DESCRIPTION" This function is the same a \fBgnutls_x509_crl_sign2()\fP with no flags, and SHA1 as the hash algorithm. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_init.30000644000000000000000000000230011271476020022663 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_init" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_init \- initialize a #gnutls_privkey_t structure .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_crypto_pk_register2.30000644000000000000000000000347711271476020023402 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_crypto_pk_register2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_crypto_pk_register2 \- register a public key interface .SH SYNOPSIS .B #include .sp .BI "int gnutls_crypto_pk_register2(int " priority ", int " version ", gnutls_crypto_pk_st * " s ");" .SH ARGUMENTS .IP "int priority" 12 is the priority of the interface .IP "int version" 12 should be set to \fBGNUTLS_CRYPTO_API_VERSION\fP .IP "gnutls_crypto_pk_st * s" 12 is a structure holding new interface's data .SH "DESCRIPTION" This function will register an interface for gnutls to operate on public key operations. Any interface registered will override the included interface. The interface with the lowest priority will be used by gnutls. Note that the bigint interface must interoperate with the bigint interface. Thus if this interface is updated the \fBgnutls_crypto_bigint_register()\fP should also be used. This function should be called before \fBgnutls_global_init()\fP. For simplicity you can use the convenience \fBgnutls_crypto_pk_register()\fP macro. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_rdn_get_by_oid.30000644000000000000000000000357211271476020023132 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_rdn_get_by_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_rdn_get_by_oid \- parse an RDN sequence and returns a string .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_rdn_get_by_oid(const gnutls_datum_t * " idn ", const char * " oid ", int " indx ", unsigned int " raw_flag ", void * " buf ", size_t * " sizeof_buf ");" .SH ARGUMENTS .IP "const gnutls_datum_t * idn" 12 should contain a DER encoded RDN sequence .IP "const char * oid" 12 an Object Identifier .IP "int indx" 12 In case multiple same OIDs exist in the RDN indicates which to send. Use 0 for the first one. .IP "unsigned int raw_flag" 12 If non zero then the raw DER data are returned. .IP "void * buf" 12 a pointer to a structure to hold the peer's name .IP "size_t * sizeof_buf" 12 holds the size of \fIbuf\fP .SH "DESCRIPTION" This function will return the name of the given Object identifier, of the RDN sequence. The name will be encoded using the rules from RFC2253. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, or \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP is returned and *\fIsizeof_buf\fP is updated if the provided buffer is not long enough, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_get_client_avp_ptr.30000644000000000000000000000237211271476020023714 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_get_client_avp_ptr" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_get_client_avp_ptr \- Returns the pointer which is sent to TLS/IA callback .SH SYNOPSIS .B #include .sp .BI "void * gnutls_ia_get_client_avp_ptr(gnutls_ia_client_credentials_t " cred ");" .SH ARGUMENTS .IP "gnutls_ia_client_credentials_t cred" 12 is a \fBgnutls_ia_client_credentials_t\fP structure. .SH "DESCRIPTION" Returns the pointer that will be provided to the TLS/IA callback function as the first argument. .SH "RETURNS" The client callback data pointer. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_cipher_get_name.30000644000000000000000000000235711271476020022507 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_cipher_get_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_cipher_get_name \- Returns a string with the name of the specified cipher algorithm .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_cipher_get_name(gnutls_cipher_algorithm_t " algorithm ");" .SH ARGUMENTS .IP "gnutls_cipher_algorithm_t algorithm" 12 is an encryption algorithm .SH "DESCRIPTION" Convert a \fBgnutls_cipher_algorithm_t\fP type to a string. .SH "RETURNS" a pointer to a string that contains the name of the specified cipher, or \fBNULL\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_ia_set_server_avp_ptr.30000644000000000000000000000236011271476020023755 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_ia_set_server_avp_ptr" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_ia_set_server_avp_ptr \- Sets a pointer to be sent to TLS/IA callback .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_server_set_retrieve_function.30000644000000000000000000000354611271476020027734 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_server_set_retrieve_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_server_set_retrieve_function \- Used to set a callback to retrieve the certificate .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_server_set_retrieve_function(gnutls_certificate_credentials_t " cred ", gnutls_certificate_server_retrieve_function * " func ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t cred" 12 is a \fBgnutls_certificate_credentials_t\fP structure. .IP "gnutls_certificate_server_retrieve_function * func" 12 is the callback function .SH "DESCRIPTION" This function sets a callback to be called in order to retrieve the certificate to be used in the handshake. The callback's function prototype is: int (*callback)(gnutls_session_t, gnutls_retr_st* st); \fIst\fP should contain the certificates and private keys. If the callback function is provided then gnutls will call it, in the handshake, after the certificate request message has been received. The callback function should set the certificate list to be sent, and return 0 on success. The value (\-1) indicates error and the handshake will be terminated. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_verify_mac.30000644000000000000000000000244011271476020022676 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_verify_mac" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_verify_mac \- This function verifies the MAC of the PKCS12 structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_verify_mac(gnutls_pkcs12_t " pkcs12 ", const char * " pass ");" .SH ARGUMENTS .IP "gnutls_pkcs12_t pkcs12" 12 should contain a gnutls_pkcs12_t structure .IP "const char * pass" 12 The password for the MAC .SH "DESCRIPTION" This function will verify the MAC for the PKCS12 structure. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_crypto_rnd_register2.30000644000000000000000000000330511271476020023541 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_crypto_rnd_register2" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_crypto_rnd_register2 \- register a random generator .SH SYNOPSIS .B #include .sp .BI "int gnutls_crypto_rnd_register2(int " priority ", int " version ", gnutls_crypto_rnd_st * " s ");" .SH ARGUMENTS .IP "int priority" 12 is the priority of the generator .IP "int version" 12 should be set to \fBGNUTLS_CRYPTO_API_VERSION\fP .IP "gnutls_crypto_rnd_st * s" 12 is a structure holding new generator's data .SH "DESCRIPTION" This function will register a random generator to be used by gnutls. Any generator registered will override the included generator and by convention kernel implemented generators have priority of 90. The generator with the lowest priority will be used by gnutls. This function should be called before \fBgnutls_global_init()\fP. For simplicity you can use the convenience \fBgnutls_crypto_rnd_register()\fP macro. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, otherwise an error. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_perror.30000644000000000000000000000217311271476020020703 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_perror" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_perror \- prints a string to stderr with a description of an error .SH SYNOPSIS .B #include .sp .BI "void gnutls_perror(int " error ");" .SH ARGUMENTS .IP "int error" 12 is a GnuTLS error code, a negative value .SH "DESCRIPTION" This function is like \fBperror()\fP. The only difference is that it accepts an error number returned by a gnutls function. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_handshake_get_last_out.30000644000000000000000000000271611271476020024074 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_handshake_get_last_out" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_handshake_get_last_out \- Returns the last handshake message sent. .SH SYNOPSIS .B #include .sp .BI "gnutls_handshake_description_t gnutls_handshake_get_last_out(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" This function is only useful to check where the last performed handshake failed. If the previous handshake succeed or was not performed at all then no meaningful value will be returned. Check \fBgnutls_handshake_description_t\fP in gnutls.h for the available handshake descriptions. .SH "RETURNS" the last handshake message type sent, a \fBgnutls_handshake_description_t\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs7_set_crl.30000644000000000000000000000243011271476020022130 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs7_set_crl" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs7_set_crl \- add a parsed crl in a PKCS7 crl set .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs7_set_crl(gnutls_pkcs7_t " pkcs7 ", gnutls_x509_crl_t " crl ");" .SH ARGUMENTS .IP "gnutls_pkcs7_t pkcs7" 12 should contain a \fBgnutls_pkcs7_t\fP structure .IP "gnutls_x509_crl_t crl" 12 the DER encoded crl to be added .SH "DESCRIPTION" This function will add a parsed CRL to the PKCS7 or RFC2630 crl set. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_free_keys.30000644000000000000000000000250711271476020023711 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_free_keys" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_free_keys \- Used to free all the keys from a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "void gnutls_certificate_free_keys(gnutls_certificate_credentials_t " sc ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t sc" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .SH "DESCRIPTION" This function will delete all the keys and the certificates associated with the given credentials. This function must not be called when a TLS negotiation that uses the credentials is in progress. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_subject_alt_name.30000644000000000000000000000524711271476020025172 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_subject_alt_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_subject_alt_name \- Get certificate's alternative name, if any .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_auth_client_get_type.30000644000000000000000000000261511271476020023572 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_auth_client_get_type" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_auth_client_get_type \- Returns the type of credentials for the client authentication schema. .SH SYNOPSIS .B #include .sp .BI "gnutls_credentials_type_t gnutls_auth_client_get_type(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Returns the type of credentials that were used for client authentication. The returned information is to be used to distinguish the function used to access authentication data. .SH "RETURNS" The type of credentials for the client authentication schema, an \fBgnutls_credentials_type_t\fP type. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_mac_get_id.30000644000000000000000000000242011271476020021440 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_mac_get_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_mac_get_id \- Returns the gnutls id of the specified in string algorithm .SH SYNOPSIS .B #include .sp .BI "gnutls_mac_algorithm_t gnutls_mac_get_id(const char * " name ");" .SH ARGUMENTS .IP "const char * name" 12 is a MAC algorithm name .SH "DESCRIPTION" Convert a string to a \fBgnutls_mac_algorithm_t\fP value. The names are compared in a case insensitive way. .SH "RETURNS" an \fBgnutls_mac_algorithm_tid\fP of the specified in a string MAC algorithm, or \fBGNUTLS_MAC_UNKNOWN\fP on failures. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_kx_get_name.30000644000000000000000000000235711271476020021657 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_kx_get_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_kx_get_name \- Returns a string with the name of the specified key exchange algorithm .SH SYNOPSIS .B #include .sp .BI "const char * gnutls_kx_get_name(gnutls_kx_algorithm_t " algorithm ");" .SH ARGUMENTS .IP "gnutls_kx_algorithm_t algorithm" 12 is a key exchange algorithm .SH "DESCRIPTION" Convert a \fBgnutls_kx_algorithm_t\fP value to a string. .SH "RETURNS" a pointer to a string that contains the name of the specified key exchange algorithm, or \fBNULL\fP. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_credentials_set.30000644000000000000000000000436511271476020022547 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_credentials_set" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_credentials_set \- Sets the needed credentials for the specified authentication algorithm. .SH SYNOPSIS .B #include .sp .BI "int gnutls_credentials_set(gnutls_session_t " session ", gnutls_credentials_type_t " type ", void * " cred ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "gnutls_credentials_type_t type" 12 is the type of the credentials .IP "void * cred" 12 is a pointer to a structure. .SH "DESCRIPTION" Sets the needed credentials for the specified type. Eg username, password \- or public and private keys etc. The \fIcred\fP parameter is a structure that depends on the specified type and on the current session (client or server). In order to minimize memory usage, and share credentials between several threads gnutls keeps a pointer to cred, and not the whole cred structure. Thus you will have to keep the structure allocated until you call \fBgnutls_deinit()\fP. For \fBGNUTLS_CRD_ANON\fP, \fIcred\fP should be \fBgnutls_anon_client_credentials_t\fP in case of a client. In case of a server it should be \fBgnutls_anon_server_credentials_t\fP. For \fBGNUTLS_CRD_SRP\fP, \fIcred\fP should be \fBgnutls_srp_client_credentials_t\fP in case of a client, and \fBgnutls_srp_server_credentials_t\fP, in case of a server. For \fBGNUTLS_CRD_CERTIFICATE\fP, \fIcred\fP should be \fBgnutls_certificate_credentials_t\fP. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_priority_set.30000644000000000000000000000247411271476020022132 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_priority_set" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_priority_set \- Sets priorities for the cipher suites supported by gnutls. .SH SYNOPSIS .B #include .sp .BI "int gnutls_priority_set(gnutls_session_t " session ", gnutls_priority_t " priority ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "gnutls_priority_t priority" 12 is a \fBgnutls_priority_t\fP structure. .SH "DESCRIPTION" Sets the priorities to use on the ciphers, key exchange methods, macs and compression methods. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_attribute_info.30000644000000000000000000000376711271476020024713 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_attribute_info" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_attribute_info \- Get attribute id .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_attribute_info(gnutls_x509_crq_t " cert ", int " indx ", void * " oid ", size_t * " sizeof_oid ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t cert" 12 should contain a \fBgnutls_x509_crq_t\fP structure .IP "int indx" 12 Specifies which attribute OID to send. Use zero to get the first one. .IP "void * oid" 12 a pointer to a structure to hold the OID .IP "size_t * sizeof_oid" 12 initially holds the maximum size of \fIoid\fP, on return holds actual size of \fIoid\fP. .SH "DESCRIPTION" This function will return the requested attribute OID in the certificate, and the critical flag for it. The attribute OID will be stored as a string in the provided buffer. Use \fBgnutls_x509_crq_get_attribute_data()\fP to extract the data. If the buffer provided is not long enough to hold the output, then *\fIsizeof_oid\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 value in case of an error. If your have reached the last extension available \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_auth_server_get_type.30000644000000000000000000000261511271476020023622 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_auth_server_get_type" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_auth_server_get_type \- Returns the type of credentials for the server authentication schema. .SH SYNOPSIS .B #include .sp .BI "gnutls_credentials_type_t gnutls_auth_server_get_type(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Returns the type of credentials that were used for server authentication. The returned information is to be used to distinguish the function used to access authentication data. .SH "RETURNS" The type of credentials for the server authentication schema, an \fBgnutls_credentials_type_t\fP type. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_kx_get_id.30000644000000000000000000000232311271476020021324 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_kx_get_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_kx_get_id \- Returns the gnutls id of the specified in string algorithm .SH SYNOPSIS .B #include .sp .BI "gnutls_kx_algorithm_t gnutls_kx_get_id(const char * " name ");" .SH ARGUMENTS .IP "const char * name" 12 is a KX name .SH "DESCRIPTION" Convert a string to a \fBgnutls_kx_algorithm_t\fP value. The names are compared in a case insensitive way. .SH "RETURNS" an id of the specified KX algorithm, or \fBGNUTLS_KX_UNKNOWN\fP on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_set_preferred_key_id.30000644000000000000000000000264611271476020026154 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_set_preferred_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_set_preferred_key_id \- Sets the prefered keyID .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_set_preferred_key_id(gnutls_openpgp_crt_t " key ", const gnutls_openpgp_keyid_t " keyid ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the structure that contains the OpenPGP public key. .IP "const gnutls_openpgp_keyid_t keyid" 12 the selected keyid .SH "DESCRIPTION" This allows setting a preferred key id for the given certificate. This key will be used by functions that involve key handling. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_set_crt_serial.30000644000000000000000000000302111271476020024012 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_set_crt_serial" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_set_crt_serial \- This function will set a revoked certificate's serial number .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_set_crt_serial(gnutls_x509_crl_t " crl ", const void * " serial ", size_t " serial_size ", time_t " revocation_time ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a gnutls_x509_crl_t structure .IP "const void * serial" 12 The revoked certificate's serial number .IP "size_t serial_size" 12 Holds the size of the serial field. .IP "time_t revocation_time" 12 The time this certificate was revoked .SH "DESCRIPTION" This function will set a revoked certificate's serial number to the CRL. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_expiration_time.30000644000000000000000000000233511271476020026031 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_expiration_time" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_expiration_time \- Extract the expire date .SH SYNOPSIS .B #include .sp .BI "time_t gnutls_openpgp_crt_get_expiration_time(gnutls_openpgp_crt_t " key ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the structure that contains the OpenPGP public key. .SH "DESCRIPTION" Get key expiration time. A value of '0' means that the key doesn't expire at all. .SH "RETURNS" the time when the OpenPGP key expires. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_anon_set_server_params_function.30000644000000000000000000000257711271476020026046 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_anon_set_server_params_function" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_anon_set_server_params_function \- set the DH parameters callback .SH SYNOPSIS .B #include .sp .BI "void gnutls_anon_set_server_params_function(gnutls_anon_server_credentials_t " res ", gnutls_params_function * " func ");" .SH ARGUMENTS .IP "gnutls_anon_server_credentials_t res" 12 is a gnutls_certificate_credentials_t structure .IP "gnutls_params_function * func" 12 is the function to be called .SH "DESCRIPTION" This function will set a callback in order for the server to get the Diffie\-Hellman parameters for anonymous authentication. The callback should return zero on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_get_extension_by_oid.30000644000000000000000000000401511271476020025221 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_get_extension_by_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_get_extension_by_oid \- get the specified extension .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_get_extension_by_oid(gnutls_x509_crq_t " cert ", const char * " oid ", int " indx ", void * " buf ", size_t * " sizeof_buf ", unsigned int * " critical ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t cert" 12 should contain a \fBgnutls_x509_crq_t\fP structure .IP "const char * oid" 12 holds an Object Identified in null terminated string .IP "int indx" 12 In case multiple same OIDs exist in the extensions, this specifies which to send. Use zero to get the first one. .IP "void * buf" 12 a pointer to a structure to hold the name (may be null) .IP "size_t * sizeof_buf" 12 initially holds the size of \fIbuf\fP .IP "unsigned int * critical" 12 will be non zero if the extension is marked as critical .SH "DESCRIPTION" This function will return the extension specified by the OID in the certificate. The extensions will be returned as binary data DER encoded, in the provided buffer. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative value in case of an error. If the certificate does not contain the specified extension \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be returned. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_fix.30000644000000000000000000000235211271476020022515 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_fix" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_fix \- recalculate some parameters of the key. .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_privkey_fix(gnutls_x509_privkey_t " key ");" .SH ARGUMENTS .IP "gnutls_x509_privkey_t key" 12 Holds the key .SH "DESCRIPTION" This function will recalculate the secondary parameters in a key. In RSA keys, this can be the coefficient and exponent1,2. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_x509_trust_file.30000644000000000000000000000357511271476020025563 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_x509_trust_file" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_x509_trust_file \- Used to add trusted CAs in a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_x509_trust_file(gnutls_certificate_credentials_t " res ", const char * " cafile ", gnutls_x509_crt_fmt_t " type ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .IP "const char * cafile" 12 is a file containing the list of trusted CAs (DER or PEM list) .IP "gnutls_x509_crt_fmt_t type" 12 is PEM or DER .SH "DESCRIPTION" This function adds the trusted CAs in order to verify client or server certificates. In case of a client this is not required to be called if the certificates are not verified using \fBgnutls_certificate_verify_peers2()\fP. This function may be called multiple times. In case of a server the names of the CAs set here will be sent to the client if a certificate request is sent. This can be disabled using \fBgnutls_certificate_send_x509_rdn_sequence()\fP. .SH "RETURNS" number of certificates processed, or a negative value on error. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_deinit.30000644000000000000000000000230211271476020020640 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_deinit" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_deinit \- clear all buffers associated with a session .SH SYNOPSIS .B #include .sp .BI "void gnutls_deinit(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" This function clears all buffers associated with the \fIsession\fP. This function will also remove session data from the session database if the session was terminated abnormally. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_import.30000644000000000000000000000313111271476020022331 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_import" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_import \- This function will import a DER or PEM encoded Certificate request .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_import(gnutls_x509_crq_t " crq ", const gnutls_datum_t * " data ", gnutls_x509_crt_fmt_t " format ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 The structure to store the parsed certificate request. .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_crq_t format. The output will be stored in \fIcert\fP. If the Certificate is PEM encoded it should have a header of "NEW CERTIFICATE REQUEST". .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_dh_params_export_raw.30000644000000000000000000000317111271476020023601 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_dh_params_export_raw" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_dh_params_export_raw \- export the raw DH parameters .SH SYNOPSIS .B #include .sp .BI "int gnutls_dh_params_export_raw(gnutls_dh_params_t " params ", gnutls_datum_t * " prime ", gnutls_datum_t * " generator ", unsigned int * " bits ");" .SH ARGUMENTS .IP "gnutls_dh_params_t params" 12 Holds the DH parameters .IP "gnutls_datum_t * prime" 12 will hold the new prime .IP "gnutls_datum_t * generator" 12 will hold the new generator .IP "unsigned int * bits" 12 if non null will hold is the prime's number of bits .SH "DESCRIPTION" This function will export the pair of prime and generator for use in the Diffie\-Hellman key exchange. The new parameters will be allocated using \fBgnutls_malloc()\fP and will be stored in the appropriate datum. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP (zero) is returned, otherwise an error code is returned. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_session_get_master_secret.30000644000000000000000000000275311271476020024640 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_session_get_master_secret" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_session_get_master_secret \- get the session's master secret value .SH SYNOPSIS .B #include .sp .BI "const void * gnutls_session_get_master_secret(gnutls_session_t " session ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .SH "DESCRIPTION" Return a pointer to the 48\-byte master secret in the session. The pointer must not be modified or deallocated. If a master secret value has not yet been established, the output will be garbage; in particular, a \fBNULL\fP return value should not be expected. Consider using \fBgnutls_prf()\fP rather than extracting the master secret and use it to derive further data. .SH "RETURNS" pointer to master secret data. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs7_delete_crt.30000644000000000000000000000251711271476020022615 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs7_delete_crt" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs7_delete_crt \- deletes a certificate from a PKCS7 certificate set .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs7_delete_crt(gnutls_pkcs7_t " pkcs7 ", int " indx ");" .SH ARGUMENTS .IP "gnutls_pkcs7_t pkcs7" 12 should contain a gnutls_pkcs7_t structure .IP "int indx" 12 the index of the certificate to delete .SH "DESCRIPTION" This function will delete a certificate from a PKCS7 or RFC2630 certificate set. Index starts from 0. Returns 0 on success. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_psk_set_server_credentials_hint.30000644000000000000000000000300111271476020026016 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_psk_set_server_credentials_hint" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_psk_set_server_credentials_hint \- Set a identity hint, in a %gnutls_psk_server_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_psk_set_server_credentials_hint(gnutls_psk_server_credentials_t " res ", const char * " hint ");" .SH ARGUMENTS .IP "gnutls_psk_server_credentials_t res" 12 is an \fBgnutls_psk_server_credentials_t\fP structure. .IP "const char * hint" 12 is the PSK identity hint string .SH "DESCRIPTION" This function sets the identity hint, in a \fBgnutls_psk_server_credentials_t\fP structure. This hint is sent to the client to help it chose a good PSK credential (i.e., username and password). .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_signature_algorithm.30000644000000000000000000000247011271476020025735 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_signature_algorithm" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_signature_algorithm \- This function returns the Certificate's signature algorithm .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_compression_list.30000644000000000000000000000243711271476020022771 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_compression_list" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_compression_list \- Get a list of supported compression methods .SH SYNOPSIS .B #include .sp .BI "const gnutls_compression_method_t * gnutls_compression_list( " void ");" .SH ARGUMENTS .IP " void" 12 .SH "DESCRIPTION" Get a list of compression methods. Note that to be able to use LZO compression, you must link to libgnutls\-extra and call \fBgnutls_global_init_extra()\fP. .SH "RETURNS" a zero\-terminated list of \fBgnutls_compression_method_t\fP integers indicating the available compression methods. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_set_number.30000644000000000000000000000251411271476020023161 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_set_number" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_set_number \- Set the CRL's number extension .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_set_number(gnutls_x509_crl_t " crl ", const void * " nr ", size_t " nr_size ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 a CRL of type \fBgnutls_x509_crl_t\fP .IP "const void * nr" 12 The CRL number .IP "size_t nr_size" 12 Holds the size of the nr field. .SH "DESCRIPTION" This function will set the CRL's number extension. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_get_authority_key_id.30000644000000000000000000000342011271476020025236 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_get_authority_key_id" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_get_authority_key_id \- This function returns the certificate authority's identifier .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_get_authority_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 authority's key identifier. This is obtained by the X.509 Authority Key identifier extension field (2.5.29.35). Note that this function only returns the keyIdentifier field of the extension. .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_set_activation_time.30000644000000000000000000000246311271476020025063 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_set_activation_time" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_set_activation_time \- Set the Certificate's activation time .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_set_activation_time(gnutls_x509_crt_t " cert ", time_t " act_time ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t cert" 12 a certificate of type \fBgnutls_x509_crt_t\fP .IP "time_t act_time" 12 The actual time .SH "DESCRIPTION" This function will set the time this Certificate was or will be activated. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_srp_set_prime_bits.30000644000000000000000000000300011271476020023254 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_srp_set_prime_bits" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_srp_set_prime_bits \- set the minimum bits for a SRP ciphersuite .SH SYNOPSIS .B #include .sp .BI "void gnutls_srp_set_prime_bits(gnutls_session_t " session ", unsigned int " bits ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "unsigned int bits" 12 is the number of bits .SH "DESCRIPTION" This function sets the minimum accepted number of bits, for use in an SRP key exchange. If zero, the default 2048 bits will be used. In the client side it sets the minimum accepted number of bits. If a server sends a prime with less bits than that \fBGNUTLS_E_RECEIVED_ILLEGAL_PARAMETER\fP will be returned by the handshake. This function has no effect in server side. .SH "SINCE" 2.6.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_db_set_cache_expiration.30000644000000000000000000000235211271476020024216 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_db_set_cache_expiration" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_db_set_cache_expiration \- Set the expiration time for resumed sessions. .SH SYNOPSIS .B #include .sp .BI "void gnutls_db_set_cache_expiration(gnutls_session_t " session ", int " seconds ");" .SH ARGUMENTS .IP "gnutls_session_t session" 12 is a \fBgnutls_session_t\fP structure. .IP "int seconds" 12 is the number of seconds. .SH "DESCRIPTION" Set the expiration time for resumed sessions. The default is 3600 (one hour) at the time writing this. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_subkey_creation_time.30000644000000000000000000000242211271476020027032 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_subkey_creation_time" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_subkey_creation_time \- Extract the timestamp .SH SYNOPSIS .B #include .sp .BI "time_t gnutls_openpgp_crt_get_subkey_creation_time(gnutls_openpgp_crt_t " key ", unsigned int " idx ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the structure that contains the OpenPGP public key. .IP "unsigned int idx" 12 the subkey index .SH "DESCRIPTION" Get subkey creation time. .SH "RETURNS" the timestamp when the OpenPGP sub\-key was created. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_get_signature.30000644000000000000000000000264411271476020023662 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_get_signature" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_get_signature \- Returns the CRL's signature .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_get_signature(gnutls_x509_crl_t " crl ", char * " sig ", size_t * " sizeof_sig ");" .SH ARGUMENTS .IP "gnutls_x509_crl_t crl" 12 should contain a gnutls_x509_crl_t 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 CRL. .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_crt_get_fingerprint.30000644000000000000000000000264511271476020025164 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_crt_get_fingerprint" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_crt_get_fingerprint \- Gets the fingerprint .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_crt_get_fingerprint(gnutls_openpgp_crt_t " key ", void * " fpr ", size_t * " fprlen ");" .SH ARGUMENTS .IP "gnutls_openpgp_crt_t key" 12 the raw data that contains the OpenPGP public key. .IP "void * fpr" 12 the buffer to save the fingerprint, must hold at least 20 bytes. .IP "size_t * fprlen" 12 the integer to save the length of the fingerprint. .SH "DESCRIPTION" Get key fingerprint. Depending on the algorithm, the fingerprint can be 16 or 20 bytes. .SH "RETURNS" On success, 0 is returned. Otherwise, an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_sign_hash.30000644000000000000000000000302711271476020024635 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_sign_hash" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_sign_hash \- sign the given data using the private key params .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_sign_hash(gnutls_openpgp_privkey_t " key ", const gnutls_datum_t * " hash ", gnutls_datum_t * " signature ");" .SH ARGUMENTS .IP "gnutls_openpgp_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. You should use \fBgnutls_openpgp_privkey_set_subkey()\fP before calling this function to set the subkey to use. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_openpgp_keyring_mem.30000644000000000000000000000323011271476020026640 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_openpgp_keyring_mem" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_openpgp_keyring_mem \- Add keyring data for OpenPGP .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_openpgp_keyring_mem(gnutls_certificate_credentials_t " c ", const opaque * " data ", size_t " dlen ", gnutls_openpgp_crt_fmt_t " format ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t c" 12 A certificate credentials structure .IP "const opaque * data" 12 buffer with keyring data. .IP "size_t dlen" 12 length of data buffer. .IP "gnutls_openpgp_crt_fmt_t format" 12 the format of the keyring .SH "DESCRIPTION" The function is used to set keyrings that will be used internally by various OpenPGP functions. For example to find a key when it is needed for an operations. The keyring will also be used at the verification functions. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_openpgp_privkey_import.30000644000000000000000000000320411271476020024201 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_openpgp_privkey_import" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_openpgp_privkey_import \- import a RAW or BASE64 encoded key .SH SYNOPSIS .B #include .sp .BI "int gnutls_openpgp_privkey_import(gnutls_openpgp_privkey_t " key ", const gnutls_datum_t * " data ", gnutls_openpgp_crt_fmt_t " format ", const char * " password ", unsigned int " flags ");" .SH ARGUMENTS .IP "gnutls_openpgp_privkey_t key" 12 The structure to store the parsed key. .IP "const gnutls_datum_t * data" 12 The RAW or BASE64 encoded key. .IP "gnutls_openpgp_crt_fmt_t format" 12 One of \fBgnutls_openpgp_crt_fmt_t\fP elements. .IP "const char * password" 12 not used for now .IP "unsigned int flags" 12 should be zero .SH "DESCRIPTION" This function will convert the given RAW or Base64 encoded key to the native gnutls_openpgp_privkey_t format. The output will be stored in 'key'. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_anon_set_server_dh_params.30000644000000000000000000000260511271476020024604 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_anon_set_server_dh_params" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_anon_set_server_dh_params \- set the DH parameters for a server to use .SH SYNOPSIS .B #include .sp .BI "void gnutls_anon_set_server_dh_params(gnutls_anon_server_credentials_t " res ", gnutls_dh_params_t " dh_params ");" .SH ARGUMENTS .IP "gnutls_anon_server_credentials_t res" 12 is a gnutls_anon_server_credentials_t structure .IP "gnutls_dh_params_t dh_params" 12 is a structure that holds Diffie\-Hellman parameters. .SH "DESCRIPTION" This function will set the Diffie\-Hellman parameters for an anonymous server to use. These parameters will be used in Anonymous Diffie\-Hellman cipher suites. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_set_subject_alt_name.30000644000000000000000000000372411271476020025201 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_set_subject_alt_name" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_set_subject_alt_name \- Set the subject Alternative Name .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_set_subject_alt_name(gnutls_x509_crq_t " crq ", gnutls_x509_subject_alt_name_t " nt ", const void * " data ", unsigned int " data_size ", unsigned int " flags ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 a certificate of type \fBgnutls_x509_crq_t\fP .IP "gnutls_x509_subject_alt_name_t nt" 12 is one of the \fBgnutls_x509_subject_alt_name_t\fP enumerations .IP "const void * data" 12 The data to be set .IP "unsigned int data_size" 12 The size of data to be set .IP "unsigned int flags" 12 \fBGNUTLS_FSAN_SET\fP to clear previous data or \fBGNUTLS_FSAN_APPEND\fP to append. .SH "DESCRIPTION" This function will set the subject alternative name certificate extension. It can set the following types: &GNUTLS_SAN_DNSNAME: as a text string &GNUTLS_SAN_RFC822NAME: as a text string &GNUTLS_SAN_URI: as a text string &GNUTLS_SAN_IPADDRESS: as a binary IP address (4 or 16 bytes) Other values can be set as binary values with the proper DER encoding. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "SINCE" 2.8.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_pkcs12_bag_set_crt.30000644000000000000000000000250011271476020023023 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_pkcs12_bag_set_crt" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_pkcs12_bag_set_crt \- This function inserts a certificate into the bag .SH SYNOPSIS .B #include .sp .BI "int gnutls_pkcs12_bag_set_crt(gnutls_pkcs12_bag_t " bag ", gnutls_x509_crt_t " crt ");" .SH ARGUMENTS .IP "gnutls_pkcs12_bag_t bag" 12 The bag .IP "gnutls_x509_crt_t crt" 12 the certificate to be copied. .SH "DESCRIPTION" This function will insert the given certificate into the bag. This is just a wrapper over \fBgnutls_pkcs12_bag_set_data()\fP. .SH "RETURNS" the index of the added bag on success, or a negative value on failure. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_certificate_set_x509_crl.30000644000000000000000000000330011271476020024145 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_certificate_set_x509_crl" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_certificate_set_x509_crl \- Used to add CRLs in a gnutls_certificate_credentials_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_certificate_set_x509_crl(gnutls_certificate_credentials_t " res ", gnutls_x509_crl_t * " crl_list ", int " crl_list_size ");" .SH ARGUMENTS .IP "gnutls_certificate_credentials_t res" 12 is an \fBgnutls_certificate_credentials_t\fP structure. .IP "gnutls_x509_crl_t * crl_list" 12 is a list of trusted CRLs. They should have been verified before. .IP "int crl_list_size" 12 holds the size of the crl_list .SH "DESCRIPTION" This function adds the trusted CRLs in order to verify client or server certificates. In case of a client this is not required to be called if the certificates are not verified using \fBgnutls_certificate_verify_peers2()\fP. This function may be called multiple times. .SH "RETURNS" \fBGNUTLS_E_SUCCESS\fP on success, or an error code. .SH "SINCE" 2.4.0 .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crq_set_attribute_by_oid.30000644000000000000000000000311511271476020025224 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crq_set_attribute_by_oid" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crq_set_attribute_by_oid \- This function will set an attribute in the request .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crq_set_attribute_by_oid(gnutls_x509_crq_t " crq ", const char * " oid ", void * " buf ", size_t " sizeof_buf ");" .SH ARGUMENTS .IP "gnutls_x509_crq_t crq" 12 should contain a gnutls_x509_crq_t structure .IP "const char * oid" 12 holds an Object Identified in null terminated string .IP "void * buf" 12 a pointer to a structure that holds the attribute data .IP "size_t sizeof_buf" 12 holds the size of \fIbuf\fP .SH "DESCRIPTION" This function will set the attribute in the certificate request specified by the given Object ID. The attribute must be be DER encoded. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crl_get_issuer_dn.30000644000000000000000000000334411271476020023652 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crl_get_issuer_dn" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crl_get_issuer_dn \- returns the CRL's issuer distinguished name .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crl_get_issuer_dn(const gnutls_x509_crl_t " crl ", char * " buf ", size_t * " sizeof_buf ");" .SH ARGUMENTS .IP "const gnutls_x509_crl_t crl" 12 should contain a gnutls_x509_crl_t structure .IP "char * buf" 12 a pointer to a structure to hold the peer's name (may be null) .IP "size_t * sizeof_buf" 12 initially holds the size of \fIbuf\fP .SH "DESCRIPTION" This function will copy the name of the CRL issuer in the provided buffer. The name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described in RFC2253. The output string will be ASCII or UTF\-8 encoded, depending on the certificate data. If buf is \fBNULL\fP then only the size will be filled. .SH "RETURNS" \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP if the provided buffer is not long enough, and in that case the sizeof_buf will be updated with the required size, and 0 on success. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_crt_init.30000644000000000000000000000230311271476020021765 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_crt_init" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_crt_init \- This function initializes a gnutls_x509_crt_t structure .SH SYNOPSIS .B #include .sp .BI "int gnutls_x509_crt_init(gnutls_x509_crt_t * " cert ");" .SH ARGUMENTS .IP "gnutls_x509_crt_t * cert" 12 The structure to be initialized .SH "DESCRIPTION" This function will initialize an X.509 certificate structure. .SH "RETURNS" On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a negative error value. .SH "REPORTING BUGS" Report bugs to . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/man/man3/gnutls_x509_privkey_get_pk_algorithm.30000644000000000000000000000242111271476020025243 0ustar rootroot.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_x509_privkey_get_pk_algorithm" 3 "2.8.1" "gnutls" "gnutls" .SH NAME gnutls_x509_privkey_get_pk_algorithm \- returns the key's PublicKey algorithm .SH SYNOPSIS .B #include .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 . GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/ .SH COPYRIGHT Copyright \(co 2008 Free Software Foundation. .br Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. .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. ./gnutls-2.8.1-i686/usr/share/info/0000755000000000000000000000000011271476233015237 5ustar rootroot./gnutls-2.8.1-i686/usr/share/info/gnutls-handshake-state.png0000644000000000000000000001224011271476021022315 0ustar rootrootPNG  IHDR.t~2sBITO pHYsCIDATxPq'v8 2M&F &mX38㠉#Q5IǾYYTZ/+K4cedY:E~/w?jo{urYt(%". /1`X.@;ȉ|9 '^?+铁>=OQx 5^WW7iҤAZJ; X, cϞ=JYT o߾GFFm߾]G?s̔)SLr?uԨGrnGp ͆ Ζ!DssC=}]wB|_tIΟ?y}eeeUUՆ .]g_ڥn̚5kݺu/^o>Įgee-[);;%Kϻ\nG| !wW_ #˗矨(cuvV^˖-n{ͽ@Fڵk󛛛53fX|yKKKeeeaaaO}mmwvwmO?MLL߶m_XsN[ol~_oV\\nW߇lYSS?^ '̚5K]nmm-,,1b۵- b2s;ѣG766"5C?[ 7{!q||_M7߇ g@>Q/s`r"@N;ȉ|9 'Dwr"@N;ȉ|9 'Dwr"@N;ȉ|9 'Dwr"@N;ȉ|9 'Dwr"@N;ȉ|9 'Dwztf̘o9ȝh=W  <8;;ɓFW$oH?C{{{dd#Gُ m0~̙33g4!~C|߱cٳ wء=z'UUU555B'N=Zq̙ӧ<8***''A}?[,Ҵ;_~Q׻\ٳg 6lӦMΒ>O1^okk{ꩧƍLKK۶m[=z4%%e֭BW.[p 4h̙O V\-˖-[RSSm6vϝ;wСC}駵j\reʼnv^RWSu%ܿ:ِo."nw||_uxۭ(JQQѫ(+k)RRR`EQƎ{K.]p׆Xnmm]zĉ/~կEx=S,Y2mڴlmݻwۛ3gNU?LLLԕk֬2eJuuussO>9|3b F mpܹ+Vdddh Ν;>,..ͭZx~SNjjjZpDxz_-Rvl{ɓ'YYY|({}E}EyGK&&&jy,t]ب=fÇ?}|)_ SN:.X[l rЍ7>\`ȑǏW꒒co`滛?C[_SSm|IuĉrJJʟO_u}@'Kɲ{^^o.;ӦMSҥKFjmmݠZ[[\.(G{bbb[,m8[vuʕ+^^v[Lc<@BBˆ#>^z 7Xl6jZ7_1ZlY+Wx|7\~f޼ys=}t{{o&Ie ,((PϞ=Y5^Gbԛ(=33^ &x<СC&LPEızBh' {m6ۨQ=ké /zIDkkO<p8֯_?`ax:ƍ;w[l6۸q䠵cƌYf(W^]nȑ# {G1>iK%w5gΜ!C 2dΜ9CEQ._p¸8ݾyfu:N%/\vZdx5*dYږ@'q%U_NaRd Ο?_[[h"1fiڲd':]VEpΜ9rdYO:YcƉVkA"**J_ffg.=~ m5=/n[Ez gі}ɡ&!ܼu͛7755 !233WZit]hKKa+W ^B'%ѷ:_`v朜__ѮBCn:ݞ[....))I]{{ҥK .^߻wرc 0rHNžVVTT<ήW_tpРAIIIkDcլ5xzL.]Op‹/111q =Y+wOga5kz0Ү#}n 󊢨֖VAͬ}ݕ5=i>]s%^=YSvOga5kz0Ү#}n ^/of־YFX͚Lqk̛|{n_7uW~w?kU~ۮ';! ܾnf=uhլHOֻy~>sJ'Nͭ05D<_̔,XTWWdɒӧ]j,dn1cƌ=zȐ!k֬1X\^5*kB* A?~х舶LH!Dyyх Pd]F#ڲ?0u'#322/$SQ'K8Yі;LsEυi_-gN6Gw}qqqǎ+--5tرcqqqwѵ舶$joeeeB؊'PQQ+(++3іӵ 7M+/HOOohhݢ544 !%DhK)'ә.ttt|'99t]QЖ M'&&McccQQѮ]'N:ujFFFFFFjjjUUU߿ѣB_~9!!B@;94o@sYY^s8ᚻ/4B@zdyActn1bz:ydntEF-+ĝw;r"@N;ȉ|9 'Dwr"@N;ȉ|9 'Dwr"@N;ȉ|9 'DwM,C( 'Dwr"@N;ȉ|9 'Dwr"@N;ȉ|9 'Dwr"@N;ȉ|9 'Dwr"@N;ȉ|9 'Dwr"@N;ȉ|9 'Dwr"@N;ȉ|9 'Dwr"@N;ȉ|9yԓ*IENDB`./gnutls-2.8.1-i686/usr/share/info/gnutls.info-30000644000000000000000000052544411271476021017601 0ustar rootrootThis is gnutls.info, produced by makeinfo version 4.13 from gnutls.texi. This manual is last updated 2 June 2009 for version 2.8.1 of GNU TLS. Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License". INFO-DIR-SECTION Software libraries START-INFO-DIR-ENTRY * GnuTLS: (gnutls). GNU Transport Layer Security Library. END-INFO-DIR-ENTRY INFO-DIR-SECTION System Administration START-INFO-DIR-ENTRY * certtool: (gnutls)Invoking certtool. Manipulate certificates and keys. * gnutls-serv: (gnutls)Invoking gnutls-serv. GNU TLS test server. * gnutls-cli: (gnutls)Invoking gnutls-cli. GNU TLS test client. * gnutls-cli-debug: (gnutls)Invoking gnutls-cli-debug. GNU TLS debug client. * psktool: (gnutls)Invoking psktool. Simple TLS-Pre-Shared-Keys manager. * srptool: (gnutls)Invoking srptool. Simple SRP password tool. END-INFO-DIR-ENTRY  File: gnutls.info, Node: GNU Free Documentation License, Next: GNU LGPL, Up: Copying Information A.1 GNU Free Documentation License ================================== Version 1.3, 3 November 2008 Copyright (C) 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc. `http://fsf.org/' Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. 0. PREAMBLE The purpose of this License is to make a manual, textbook, or other functional and useful document "free" in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others. This License is a kind of "copyleft", which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software. We have designed this License in order to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this License is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this License principally for works whose purpose is instruction or reference. 1. APPLICABILITY AND DEFINITIONS This License applies to any manual or other work, in any medium, that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. Such a notice grants a world-wide, royalty-free license, unlimited in duration, to use that work under the conditions stated herein. The "Document", below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as "you". You accept the license if you copy, modify or distribute the work in a way requiring permission under copyright law. A "Modified Version" of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language. A "Secondary Section" is a named appendix or a front-matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (Thus, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them. The "Invariant Sections" are certain Secondary Sections whose titles are designated, as being those of Invariant Sections, in the notice that says that the Document is released under this License. If a section does not fit the above definition of Secondary then it is not allowed to be designated as Invariant. The Document may contain zero Invariant Sections. If the Document does not identify any Invariant Sections then there are none. The "Cover Texts" are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the Document is released under this License. A Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 words. A "Transparent" copy of the Document means a machine-readable copy, represented in a format whose specification is available to the general public, that is suitable for revising the document straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup, or absence of markup, has been arranged to thwart or discourage subsequent modification by readers is not Transparent. An image format is not Transparent if used for any substantial amount of text. A copy that is not "Transparent" is called "Opaque". Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML, PostScript or PDF designed for human modification. Examples of transparent image formats include PNG, XCF and JPG. Opaque formats include proprietary formats that can be read and edited only by proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML, PostScript or PDF produced by some word processors for output purposes only. The "Title Page" means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, "Title Page" means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text. The "publisher" means any person or entity that distributes copies of the Document to the public. A section "Entitled XYZ" means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language. (Here XYZ stands for a specific section name mentioned below, such as "Acknowledgements", "Dedications", "Endorsements", or "History".) To "Preserve the Title" of such a section when you modify the Document means that it remains a section "Entitled XYZ" according to this definition. The Document may include Warranty Disclaimers next to the notice which states that this License applies to the Document. These Warranty Disclaimers are considered to be included by reference in this License, but only as regards disclaiming warranties: any other implication that these Warranty Disclaimers may have is void and has no effect on the meaning of this License. 2. VERBATIM COPYING You may copy and distribute the Document in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in section 3. You may also lend copies, under the same conditions stated above, and you may publicly display copies. 3. COPYING IN QUANTITY If you publish printed copies (or copies in media that commonly have printed covers) of the Document, numbering more than 100, and the Document's license notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the Document and satisfy these conditions, can be treated as verbatim copying in other respects. If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages. If you publish or distribute Opaque copies of the Document numbering more than 100, you must either include a machine-readable Transparent copy along with each Opaque copy, or state in or with each Opaque copy a computer-network location from which the general network-using public has access to download using public-standard network protocols a complete Transparent copy of the Document, free of added material. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public. It is requested, but not required, that you contact the authors of the Document well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document. 4. MODIFICATIONS You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version: A. Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission. B. List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the Modified Version, together with at least five of the principal authors of the Document (all of its principal authors, if it has fewer than five), unless they release you from this requirement. C. State on the Title page the name of the publisher of the Modified Version, as the publisher. D. Preserve all the copyright notices of the Document. E. Add an appropriate copyright notice for your modifications adjacent to the other copyright notices. F. Include, immediately after the copyright notices, a license notice giving the public permission to use the Modified Version under the terms of this License, in the form shown in the Addendum below. G. Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document's license notice. H. Include an unaltered copy of this License. I. Preserve the section Entitled "History", Preserve its Title, and add to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title Page. If there is no section Entitled "History" in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence. J. Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the "History" section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission. K. For any section Entitled "Acknowledgements" or "Dedications", Preserve the Title of the section, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein. L. Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles. M. Delete any section Entitled "Endorsements". Such a section may not be included in the Modified Version. N. Do not retitle any existing section to be Entitled "Endorsements" or to conflict in title with any Invariant Section. O. Preserve any Warranty Disclaimers. If the Modified Version includes new front-matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the Modified Version's license notice. These titles must be distinct from any other section titles. You may add a section Entitled "Endorsements", provided it contains nothing but endorsements of your Modified Version by various parties--for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard. You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the Document already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one. The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version. 5. COMBINING DOCUMENTS You may combine the Document with other documents released under this License, under the terms defined in section 4 above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice, and that you preserve all their Warranty Disclaimers. The combined work need only contain one copy of this License, and multiple identical Invariant Sections may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work. In the combination, you must combine any sections Entitled "History" in the various original documents, forming one section Entitled "History"; likewise combine any sections Entitled "Acknowledgements", and any sections Entitled "Dedications". You must delete all sections Entitled "Endorsements." 6. COLLECTIONS OF DOCUMENTS You may make a collection consisting of the Document and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects. You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document. 7. AGGREGATION WITH INDEPENDENT WORKS A compilation of the Document or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, is called an "aggregate" if the copyright resulting from the compilation is not used to limit the legal rights of the compilation's users beyond what the individual works permit. When the Document is included in an aggregate, this License does not apply to the other works in the aggregate which are not themselves derivative works of the Document. If the Cover Text requirement of section 3 is applicable to these copies of the Document, then if the Document is less than one half of the entire aggregate, the Document's Cover Texts may be placed on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the Document is in electronic form. Otherwise they must appear on printed covers that bracket the whole aggregate. 8. TRANSLATION Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section 4. Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License, and all the license notices in the Document, and any Warranty Disclaimers, provided that you also include the original English version of this License and the original versions of those notices and disclaimers. In case of a disagreement between the translation and the original version of this License or a notice or disclaimer, the original version will prevail. If a section in the Document is Entitled "Acknowledgements", "Dedications", or "History", the requirement (section 4) to Preserve its Title (section 1) will typically require changing the actual title. 9. TERMINATION You may not copy, modify, sublicense, or distribute the Document except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense, or distribute it is void, and will automatically terminate your rights under this License. However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice. Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, receipt of a copy of some or all of the same material does not give you any rights to use it. 10. FUTURE REVISIONS OF THIS LICENSE The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See `http://www.gnu.org/copyleft/'. Each version of the License is given a distinguishing version number. If the Document specifies that a particular numbered version of this License "or any later version" applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation. If the Document specifies that a proxy can decide which future versions of this License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Document. 11. RELICENSING "Massive Multiauthor Collaboration Site" (or "MMC Site") means any World Wide Web server that publishes copyrightable works and also provides prominent facilities for anybody to edit those works. A public wiki that anybody can edit is an example of such a server. A "Massive Multiauthor Collaboration" (or "MMC") contained in the site means any set of copyrightable works thus published on the MMC site. "CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0 license published by Creative Commons Corporation, a not-for-profit corporation with a principal place of business in San Francisco, California, as well as future copyleft versions of that license published by that same organization. "Incorporate" means to publish or republish a Document, in whole or in part, as part of another Document. An MMC is "eligible for relicensing" if it is licensed under this License, and if all works that were first published under this License somewhere other than this MMC, and subsequently incorporated in whole or in part into the MMC, (1) had no cover texts or invariant sections, and (2) were thus incorporated prior to November 1, 2008. The operator of an MMC Site may republish an MMC contained in the site under CC-BY-SA on the same site at any time before August 1, 2009, provided the MMC is eligible for relicensing. ADDENDUM: How to use this License for your documents ==================================================== To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page: Copyright (C) YEAR YOUR NAME. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled ``GNU Free Documentation License''. If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the "with...Texts." line with this: with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. If you have Invariant Sections without Cover Texts, or some other combination of the three, merge those two alternatives to suit the situation. If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software.  File: gnutls.info, Node: GNU LGPL, Next: GNU GPL, Prev: GNU Free Documentation License, Up: Copying Information A.2 GNU Lesser General Public License ===================================== Version 2.1, February 1999 Copyright (C) 1991, 1999 Free Software Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. [This is the first released version of the Lesser GPL. It also counts as the successor of the GNU Library Public License, version 2, hence the version number 2.1.] Preamble -------- The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public Licenses are intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This license, the Lesser General Public License, applies to some specially designated software--typically libraries--of the Free Software Foundation and other authors who decide to use it. You can use it too, but we suggest you first think carefully about whether this license or the ordinary General Public License is the better strategy to use in any particular case, based on the explanations below. When we speak of free software, we are referring to freedom of use, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish); that you receive source code or can get it if you want it; that you can change the software and use pieces of it in new free programs; and that you are informed that you can do these things. To protect your rights, we need to make restrictions that forbid distributors to deny you these rights or to ask you to surrender these rights. These restrictions translate to certain responsibilities for you if you distribute copies of the library or if you modify it. For example, if you distribute copies of the library, whether gratis or for a fee, you must give the recipients all the rights that we gave you. You must make sure that they, too, receive or can get the source code. If you link other code with the library, you must provide complete object files to the recipients, so that they can relink them with the library after making changes to the library and recompiling it. And you must show them these terms so they know their rights. We protect your rights with a two-step method: (1) we copyright the library, and (2) we offer you this license, which gives you legal permission to copy, distribute and/or modify the library. To protect each distributor, we want to make it very clear that there is no warranty for the free library. Also, if the library is modified by someone else and passed on, the recipients should know that what they have is not the original version, so that the original author's reputation will not be affected by problems that might be introduced by others. Finally, software patents pose a constant threat to the existence of any free program. We wish to make sure that a company cannot effectively restrict the users of a free program by obtaining a restrictive license from a patent holder. Therefore, we insist that any patent license obtained for a version of the library must be consistent with the full freedom of use specified in this license. Most GNU software, including some libraries, is covered by the ordinary GNU General Public License. This license, the GNU Lesser General Public License, applies to certain designated libraries, and is quite different from the ordinary General Public License. We use this license for certain libraries in order to permit linking those libraries into non-free programs. When a program is linked with a library, whether statically or using a shared library, the combination of the two is legally speaking a combined work, a derivative of the original library. The ordinary General Public License therefore permits such linking only if the entire combination fits its criteria of freedom. The Lesser General Public License permits more lax criteria for linking other code with the library. We call this license the "Lesser" General Public License because it does _Less_ to protect the user's freedom than the ordinary General Public License. It also provides other free software developers Less of an advantage over competing non-free programs. These disadvantages are the reason we use the ordinary General Public License for many libraries. However, the Lesser license provides advantages in certain special circumstances. For example, on rare occasions, there may be a special need to encourage the widest possible use of a certain library, so that it becomes a de-facto standard. To achieve this, non-free programs must be allowed to use the library. A more frequent case is that a free library does the same job as widely used non-free libraries. In this case, there is little to gain by limiting the free library to free software only, so we use the Lesser General Public License. In other cases, permission to use a particular library in non-free programs enables a greater number of people to use a large body of free software. For example, permission to use the GNU C Library in non-free programs enables many more people to use the whole GNU operating system, as well as its variant, the GNU/Linux operating system. Although the Lesser General Public License is Less protective of the users' freedom, it does ensure that the user of a program that is linked with the Library has the freedom and the wherewithal to run that program using a modified version of the Library. The precise terms and conditions for copying, distribution and modification follow. Pay close attention to the difference between a "work based on the library" and a "work that uses the library". The former contains code derived from the library, whereas the latter must be combined with the library in order to run. TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION --------------------------------------------------------------- 0. This License Agreement applies to any software library or other program which contains a notice placed by the copyright holder or other authorized party saying it may be distributed under the terms of this Lesser General Public License (also called "this License"). Each licensee is addressed as "you". A "library" means a collection of software functions and/or data prepared so as to be conveniently linked with application programs (which use some of those functions and data) to form executables. The "Library", below, refers to any such software library or work which has been distributed under these terms. A "work based on the Library" means either the Library or any derivative work under copyright law: that is to say, a work containing the Library or a portion of it, either verbatim or with modifications and/or translated straightforwardly into another language. (Hereinafter, translation is included without limitation in the term "modification".) "Source code" for a work means the preferred form of the work for making modifications to it. For a library, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the library. Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running a program using the Library is not restricted, and output from such a program is covered only if its contents constitute a work based on the Library (independent of the use of the Library in a tool for writing it). Whether that is true depends on what the Library does and what the program that uses the Library does. 1. You may copy and distribute verbatim copies of the Library's complete source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and distribute a copy of this License along with the Library. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Library or any portion of it, thus forming a work based on the Library, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a. The modified work must itself be a software library. b. You must cause the files modified to carry prominent notices stating that you changed the files and the date of any change. c. You must cause the whole of the work to be licensed at no charge to all third parties under the terms of this License. d. If a facility in the modified Library refers to a function or a table of data to be supplied by an application program that uses the facility, other than as an argument passed when the facility is invoked, then you must make a good faith effort to ensure that, in the event an application does not supply such function or table, the facility still operates, and performs whatever part of its purpose remains meaningful. (For example, a function in a library to compute square roots has a purpose that is entirely well-defined independent of the application. Therefore, Subsection 2d requires that any application-supplied function or table used by this function must be optional: if the application does not supply it, the square root function must still compute square roots.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Library, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Library, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Library. In addition, mere aggregation of another work not based on the Library with the Library (or with a work based on the Library) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may opt to apply the terms of the ordinary GNU General Public License instead of this License to a given copy of the Library. To do this, you must alter all the notices that refer to this License, so that they refer to the ordinary GNU General Public License, version 2, instead of to this License. (If a newer version than version 2 of the ordinary GNU General Public License has appeared, then you can specify that version instead if you wish.) Do not make any other change in these notices. Once this change is made in a given copy, it is irreversible for that copy, so the ordinary GNU General Public License applies to all subsequent copies and derivative works made from that copy. This option is useful when you wish to copy part of the code of the Library into a program that is not a library. 4. You may copy and distribute the Library (or a portion or derivative of it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange. If distribution of object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place satisfies the requirement to distribute the source code, even though third parties are not compelled to copy the source along with the object code. 5. A program that contains no derivative of any portion of the Library, but is designed to work with the Library by being compiled or linked with it, is called a "work that uses the Library". Such a work, in isolation, is not a derivative work of the Library, and therefore falls outside the scope of this License. However, linking a "work that uses the Library" with the Library creates an executable that is a derivative of the Library (because it contains portions of the Library), rather than a "work that uses the library". The executable is therefore covered by this License. Section 6 states terms for distribution of such executables. When a "work that uses the Library" uses material from a header file that is part of the Library, the object code for the work may be a derivative work of the Library even though the source code is not. Whether this is true is especially significant if the work can be linked without the Library, or if the work is itself a library. The threshold for this to be true is not precisely defined by law. If such an object file uses only numerical parameters, data structure layouts and accessors, and small macros and small inline functions (ten lines or less in length), then the use of the object file is unrestricted, regardless of whether it is legally a derivative work. (Executables containing this object code plus portions of the Library will still fall under Section 6.) Otherwise, if the work is a derivative of the Library, you may distribute the object code for the work under the terms of Section 6. Any executables containing that work also fall under Section 6, whether or not they are linked directly with the Library itself. 6. As an exception to the Sections above, you may also combine or link a "work that uses the Library" with the Library to produce a work containing portions of the Library, and distribute that work under terms of your choice, provided that the terms permit modification of the work for the customer's own use and reverse engineering for debugging such modifications. You must give prominent notice with each copy of the work that the Library is used in it and that the Library and its use are covered by this License. You must supply a copy of this License. If the work during execution displays copyright notices, you must include the copyright notice for the Library among them, as well as a reference directing the user to the copy of this License. Also, you must do one of these things: a. Accompany the work with the complete corresponding machine-readable source code for the Library including whatever changes were used in the work (which must be distributed under Sections 1 and 2 above); and, if the work is an executable linked with the Library, with the complete machine-readable "work that uses the Library", as object code and/or source code, so that the user can modify the Library and then relink to produce a modified executable containing the modified Library. (It is understood that the user who changes the contents of definitions files in the Library will not necessarily be able to recompile the application to use the modified definitions.) b. Use a suitable shared library mechanism for linking with the Library. A suitable mechanism is one that (1) uses at run time a copy of the library already present on the user's computer system, rather than copying library functions into the executable, and (2) will operate properly with a modified version of the library, if the user installs one, as long as the modified version is interface-compatible with the version that the work was made with. c. Accompany the work with a written offer, valid for at least three years, to give the same user the materials specified in Subsection 6a, above, for a charge no more than the cost of performing this distribution. d. If distribution of the work is made by offering access to copy from a designated place, offer equivalent access to copy the above specified materials from the same place. e. Verify that the user has already received a copy of these materials or that you have already sent this user a copy. For an executable, the required form of the "work that uses the Library" must include any data and utility programs needed for reproducing the executable from it. However, as a special exception, the materials to be distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. It may happen that this requirement contradicts the license restrictions of other proprietary libraries that do not normally accompany the operating system. Such a contradiction means you cannot use both them and the Library together in an executable that you distribute. 7. You may place library facilities that are a work based on the Library side-by-side in a single library together with other library facilities not covered by this License, and distribute such a combined library, provided that the separate distribution of the work based on the Library and of the other library facilities is otherwise permitted, and provided that you do these two things: a. Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities. This must be distributed under the terms of the Sections above. b. Give prominent notice with the combined library of the fact that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work. 8. You may not copy, modify, sublicense, link with, or distribute the Library except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense, link with, or distribute the Library is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 9. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Library or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Library (or any work based on the Library), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Library or works based on it. 10. Each time you redistribute the Library (or any work based on the Library), the recipient automatically receives a license from the original licensor to copy, distribute, link with or modify the Library subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties with this License. 11. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Library at all. For example, if a patent license would not permit royalty-free redistribution of the Library by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Library. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply, and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 12. If the distribution and/or use of the Library is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Library under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 13. The Free Software Foundation may publish revised and/or new versions of the Lesser General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Library specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Library does not specify a license version number, you may choose any version ever published by the Free Software Foundation. 14. If you wish to incorporate parts of the Library into other free programs whose distribution conditions are incompatible with these, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Libraries ---------------------------------------------- If you develop a new library, and you want it to be of the greatest possible use to the public, we recommend making it free software that everyone can redistribute and change. You can do so by permitting redistribution under these terms (or, alternatively, under the terms of the ordinary General Public License). To apply these terms, attach the following notices to the library. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. ONE LINE TO GIVE THE LIBRARY'S NAME AND AN IDEA OF WHAT IT DOES. Copyright (C) YEAR NAME OF AUTHOR This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. Also add information on how to contact you by electronic and paper mail. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the library, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the library `Frob' (a library for tweaking knobs) written by James Random Hacker. SIGNATURE OF TY COON, 1 April 1990 Ty Coon, President of Vice That's all there is to it!  File: gnutls.info, Node: GNU GPL, Prev: GNU LGPL, Up: Copying Information A.3 GNU General Public License ============================== Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. `http://fsf.org/' Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble ======== The GNU General Public License is a free, copyleft license for software and other kinds of works. The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things. To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others. For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it. For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions. Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users. Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free. The precise terms and conditions for copying, distribution and modification follow. TERMS AND CONDITIONS ==================== 0. Definitions. "This License" refers to version 3 of the GNU General Public License. "Copyright" also means copyright-like laws that apply to other kinds of works, such as semiconductor masks. "The Program" refers to any copyrightable work licensed under this License. Each licensee is addressed as "you". "Licensees" and "recipients" may be individuals or organizations. To "modify" a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a "modified version" of the earlier work or a work "based on" the earlier work. A "covered work" means either the unmodified Program or a work based on the Program. To "propagate" a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well. To "convey" a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying. An interactive user interface displays "Appropriate Legal Notices" to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion. 1. Source Code. The "source code" for a work means the preferred form of the work for making modifications to it. "Object code" means any non-source form of a work. A "Standard Interface" means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language. The "System Libraries" of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A "Major Component", in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it. The "Corresponding Source" for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work. The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source. The Corresponding Source for a work in source code form is that same work. 2. Basic Permissions. All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law. You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you. Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary. 3. Protecting Users' Legal Rights From Anti-Circumvention Law. No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures. When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures. 4. Conveying Verbatim Copies. You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program. You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee. 5. Conveying Modified Source Versions. You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions: a. The work must carry prominent notices stating that you modified it, and giving a relevant date. b. The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to "keep intact all notices". c. You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it. d. If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so. A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an "aggregate" if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate. 6. Conveying Non-Source Forms. You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways: a. Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange. b. Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge. c. Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b. d. Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements. e. Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d. A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work. A "User Product" is either (1) a "consumer product", which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, "normally used" refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product. "Installation Information" for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made. If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM). The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network. Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying. 7. Additional Terms. "Additional permissions" are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions. When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission. Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms: a. Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or b. Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or c. Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or d. Limiting the use for publicity purposes of names of licensors or authors of the material; or e. Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or f. Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors. All other non-permissive additional terms are considered "further restrictions" within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying. If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms. Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way. 8. Termination. You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11). However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice. Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10. 9. Acceptance Not Required for Having Copies. You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so. 10. Automatic Licensing of Downstream Recipients. Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License. An "entity transaction" is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts. You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it. 11. Patents. A "contributor" is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's "contributor version". A contributor's "essential patent claims" are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, "control" includes the right to grant patent sublicenses in a manner consistent with the requirements of this License. Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version. In the following three paragraphs, a "patent license" is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To "grant" such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party. If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. "Knowingly relying" means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid. If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it. A patent license is "discriminatory" if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007. Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law. 12. No Surrender of Others' Freedom. If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program. 13. Use with the GNU Affero General Public License. Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such. 14. Revised Versions of this License. The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation. If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program. Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version. 15. Disclaimer of Warranty. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. Limitation of Liability. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 17. Interpretation of Sections 15 and 16. If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee. END OF TERMS AND CONDITIONS =========================== How to Apply These Terms to Your New Programs ============================================= If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. ONE LINE TO GIVE THE PROGRAM'S NAME AND A BRIEF IDEA OF WHAT IT DOES. Copyright (C) YEAR NAME OF AUTHOR This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see `http://www.gnu.org/licenses/'. Also add information on how to contact you by electronic and paper mail. If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode: PROGRAM Copyright (C) YEAR NAME OF AUTHOR This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, your program's commands might be different; for a GUI interface, you would use an "about box". You should also get your employer (if you work as a programmer) or school, if any, to sign a "copyright disclaimer" for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see `http://www.gnu.org/licenses/'. The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read `http://www.gnu.org/philosophy/why-not-lgpl.html'.  File: gnutls.info, Node: Bibliography, Prev: Function and Data Index, Up: Top Bibliography ************ [CBCATT] Bodo Moeller, "Security of CBC Ciphersuites in SSL/TLS: Problems and Countermeasures", 2002, available from `http://www.openssl.org/~bodo/tls-cbc.txt'. [GPGH] Mike Ashley, "The GNU Privacy Handbook", 2002, available from `http://www.gnupg.org/gph/en/manual.pdf'. [GUTPKI] Peter Gutmann, "Everything you never wanted to know about PKI but were forced to find out", Available from `http://www.cs.auckland.ac.nz/~pgut001/'. [NISTSP80057] NIST Special Publication 800-57, "Recommendation for Key Management - Part 1: General (Revised)", March 2007, available from `http://csrc.nist.gov/publications/nistpubs/800-57/sp800-57-Part1-revised2_Mar08-2007.pdf'. [RFC2246] Tim Dierks and Christopher Allen, "The TLS Protocol Version 1.0", January 1999, Available from `http://www.ietf.org/rfc/rfc2246.txt'. [RFC4346] Tim Dierks and Eric Rescorla, "The TLS Protocol Version 1.1", Match 2006, Available from `http://www.ietf.org/rfc/rfc4346.txt'. [RFC2440] Jon Callas, Lutz Donnerhacke, Hal Finney and Rodney Thayer, "OpenPGP Message Format", November 1998, Available from `http://www.ietf.org/rfc/rfc2440.txt'. [RFC4880] Jon Callas, Lutz Donnerhacke, Hal Finney, David Shaw and Rodney Thayer, "OpenPGP Message Format", November 2007, Available from `http://www.ietf.org/rfc/rfc4880.txt'. [RFC4211] J. Schaad, "Internet X.509 Public Key Infrastructure Certificate Request Message Format (CRMF)", September 2005, Available from `http://www.ietf.org/rfc/rfc4211.txt'. [RFC2817] Rohit Khare and Scott Lawrence, "Upgrading to TLS Within HTTP/1.1", May 2000, Available from `http://www.ietf.org/rfc/rfc2817.txt' [RFC2818] Eric Rescorla, "HTTP Over TLS", May 2000, Available from `http://www.ietf/rfc/rfc2818.txt'. [RFC2945] Tom Wu, "The SRP Authentication and Key Exchange System", September 2000, Available from `http://www.ietf.org/rfc/rfc2945.txt'. [RFC2986] Magnus Nystrom and Burt Kaliski, "PKCS 10 v1.7: Certification Request Syntax Specification", November 2000, Available from `http://www.ietf.org/rfc/rfc2986.txt'. [RFC3280] Russell Housley, Tim Polk, Warwick Ford and David Solo, "Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile", April 2002, Available from `http://www.ietf.org/rfc/rfc3280.txt'. [RFC3749] Scott Hollenbeck, "Transport Layer Security Protocol Compression Methods", May 2004, Available from `http://www.ietf.org/rfc/rfc3749.txt'. [RFC3820] Steven Tuecke, Von Welch, Doug Engert, Laura Pearlman, and Mary Thompson, "Internet X.509 Public Key Infrastructure (PKI) Proxy Certificate Profile", June 2004, available from `http://www.ietf.org/rfc3820'. [PKCS12] RSA Laboratories, "PKCS 12 v1.0: Personal Information Exchange Syntax", June 1999, Available from `http://www.rsa.com'. [RESCORLA] Eric Rescorla, "SSL and TLS: Designing and Building Secure Systems", 2001 [SELKEY] Arjen Lenstra and Eric Verheul, "Selecting Cryptographic Key Sizes", 2003, available from `http://www.win.tue.nl/~klenstra/key.pdf'. [SSL3] Alan Freier, Philip Karlton and Paul Kocher, "The SSL Protocol Version 3.0", November 1996, Available from `http://wp.netscape.com/eng/ssl3/draft302.txt'. [STEVENS] Richard Stevens, "UNIX Network Programming, Volume 1", Prentice Hall PTR, January 1998 [TLSEXT] Simon Blake-Wilson, Magnus Nystrom, David Hopwood, Jan Mikkelsen and Tim Wright, "Transport Layer Security (TLS) Extensions", June 2003, Available from `http://www.ietf.org/rfc/rfc3546.txt'. [TLSPGP] Nikos Mavrogiannopoulos, "Using OpenPGP keys for TLS authentication", April 2004, November 2007. Available from `http://www.ietf.org/rfc/rfc5081.txt'. [TLSSRP] David Taylor, Trevor Perrin, Tom Wu and Nikos Mavrogiannopoulos, "Using SRP for TLS Authentication", November 2007. Available from `http://www.ietf.org/rfc/rfc5054.txt'. [TLSPSK] Pasi Eronen and Hannes Tschofenig, "Pre-shared key Ciphersuites for TLS", December 2005, Available from `http://www.ietf.org/rfc/rfc4279.txt'. [TOMSRP] Tom Wu, "The Stanford SRP Authentication Project", Available at `http://srp.stanford.edu/'. [WEGER] Arjen Lenstra and Xiaoyun Wang and Benne de Weger, "Colliding X.509 Certificates", Cryptology ePrint Archive, Report 2005/067, Available at `http://eprint.iacr.org/'.  File: gnutls.info, Node: Function and Data Index, Next: Bibliography, Prev: Concept Index, Up: Top Function and Data Index *********************** [index] * Menu: * alert-description->string: Core Interface. (line 420) * alert-get: Core Interface. (line 319) * alert-level->string: Core Interface. (line 423) * alert-send: Core Interface. (line 316) * anonymous-client-credentials?: Core Interface. (line 369) * anonymous-server-credentials?: Core Interface. (line 366) * bye: Core Interface. (line 328) * certificate-credentials?: Core Interface. (line 357) * certificate-request->string: Core Interface. (line 410) * certificate-status->string: Core Interface. (line 413) * certificate-type->string: Core Interface. (line 401) * certificate-verify->string: Core Interface. (line 378) * cipher->string: Core Interface. (line 447) * cipher-suite->string: Core Interface. (line 237) * close-request->string: Core Interface. (line 407) * compression-method->string: Core Interface. (line 429) * connection-end->string: Core Interface. (line 426) * credentials->string: Core Interface. (line 438) * dh-parameters?: Core Interface. (line 363) * digest->string: Core Interface. (line 432) * error->string <1>: Core Interface. (line 375) * error->string: Exception Handling. (line 6) * gnutls-version: Core Interface. (line 335) * gnutls_alert_get: Core functions. (line 26) * gnutls_alert_get_name: Core functions. (line 13) * gnutls_alert_send: Core functions. (line 67) * gnutls_alert_send_appropriate: Core functions. (line 44) * gnutls_anon_allocate_client_credentials: Core functions. (line 91) * gnutls_anon_allocate_server_credentials: Core functions. (line 104) * gnutls_anon_free_client_credentials: Core functions. (line 117) * gnutls_anon_free_server_credentials: Core functions. (line 127) * gnutls_anon_set_params_function: Core functions. (line 138) * gnutls_anon_set_server_dh_params: Core functions. (line 152) * gnutls_anon_set_server_params_function: Core functions. (line 166) * gnutls_auth_client_get_type: Core functions. (line 179) * gnutls_auth_get_type: Core functions. (line 193) * gnutls_auth_server_get_type: Core functions. (line 211) * gnutls_bye: Core functions. (line 225) * gnutls_certificate_activation_time_peers: Core functions. (line 262) * gnutls_certificate_allocate_credentials: Core functions. (line 277) * gnutls_certificate_client_get_request_status: Core functions. (line 290) * gnutls_certificate_client_set_retrieve_function: Core functions. (line 304) * gnutls_certificate_expiration_time_peers: Core functions. (line 340) * gnutls_certificate_free_ca_names: Core functions. (line 354) * gnutls_certificate_free_cas: Core functions. (line 368) * gnutls_certificate_free_credentials: Core functions. (line 380) * gnutls_certificate_free_crls: Core functions. (line 394) * gnutls_certificate_free_keys: Core functions. (line 404) * gnutls_certificate_get_openpgp_keyring: Core functions. (line 417) * gnutls_certificate_get_ours: Core functions. (line 431) * gnutls_certificate_get_peers: Core functions. (line 446) * gnutls_certificate_get_x509_cas: Core functions. (line 469) * gnutls_certificate_get_x509_crls: Core functions. (line 487) * gnutls_certificate_send_x509_rdn_sequence: Core functions. (line 503) * gnutls_certificate_server_set_request: Core functions. (line 521) * gnutls_certificate_server_set_retrieve_function: Core functions. (line 537) * gnutls_certificate_set_dh_params: Core functions. (line 562) * gnutls_certificate_set_openpgp_key: OpenPGP functions. (line 158) * gnutls_certificate_set_openpgp_key_file: OpenPGP functions. (line 44) * gnutls_certificate_set_openpgp_key_file2: OpenPGP functions. (line 16) * gnutls_certificate_set_openpgp_key_mem: OpenPGP functions. (line 96) * gnutls_certificate_set_openpgp_key_mem2: OpenPGP functions. (line 66) * gnutls_certificate_set_openpgp_keyring_file: OpenPGP functions. (line 116) * gnutls_certificate_set_openpgp_keyring_mem: OpenPGP functions. (line 136) * gnutls_certificate_set_params_function: Core functions. (line 579) * gnutls_certificate_set_rsa_export_params: Core functions. (line 593) * gnutls_certificate_set_verify_flags: Core functions. (line 606) * gnutls_certificate_set_verify_limits: Core functions. (line 620) * gnutls_certificate_set_x509_crl: Core functions. (line 681) * gnutls_certificate_set_x509_crl_file: Core functions. (line 639) * gnutls_certificate_set_x509_crl_mem: Core functions. (line 660) * gnutls_certificate_set_x509_key: Core functions. (line 769) * gnutls_certificate_set_x509_key_file: Core functions. (line 704) * gnutls_certificate_set_x509_key_mem: Core functions. (line 730) * gnutls_certificate_set_x509_simple_pkcs12_file: Core functions. (line 793) * gnutls_certificate_set_x509_simple_pkcs12_mem: Core functions. (line 833) * gnutls_certificate_set_x509_trust: Core functions. (line 926) * gnutls_certificate_set_x509_trust_file: Core functions. (line 875) * gnutls_certificate_set_x509_trust_mem: Core functions. (line 901) * gnutls_certificate_type_get: Core functions. (line 975) * gnutls_certificate_type_get_id: Core functions. (line 951) * gnutls_certificate_type_get_name: Core functions. (line 963) * gnutls_certificate_type_list: Core functions. (line 988) * gnutls_certificate_type_set_priority: Core functions. (line 1000) * gnutls_certificate_verify_flags: Verifying X.509 certificate paths. (line 44) * gnutls_certificate_verify_peers: Core functions. (line 1048) * gnutls_certificate_verify_peers2: Core functions. (line 1018) * gnutls_check_version: Core functions. (line 1067) * gnutls_cipher_get: Core functions. (line 1121) * gnutls_cipher_get_id: Core functions. (line 1084) * gnutls_cipher_get_key_size: Core functions. (line 1097) * gnutls_cipher_get_name: Core functions. (line 1109) * gnutls_cipher_list: Core functions. (line 1133) * gnutls_cipher_set_priority: Core functions. (line 1146) * gnutls_cipher_suite_get_name: Core functions. (line 1165) * gnutls_cipher_suite_info: Core functions. (line 1184) * gnutls_compression_get: Core functions. (line 1236) * gnutls_compression_get_id: Core functions. (line 1212) * gnutls_compression_get_name: Core functions. (line 1224) * gnutls_compression_list: Core functions. (line 1248) * gnutls_compression_set_priority: Core functions. (line 1260) * gnutls_credentials_clear: Core functions. (line 1282) * gnutls_credentials_set: Core functions. (line 1291) * gnutls_crypto_bigint_register2: Core functions. (line 1326) * gnutls_crypto_cipher_register2: Core functions. (line 1355) * gnutls_crypto_digest_register2: Core functions. (line 1381) * gnutls_crypto_mac_register2: Core functions. (line 1407) * gnutls_crypto_pk_register2: Core functions. (line 1432) * gnutls_crypto_rnd_register2: Core functions. (line 1461) * gnutls_crypto_single_cipher_register2: Core functions. (line 1488) * gnutls_crypto_single_digest_register2: Core functions. (line 1517) * gnutls_crypto_single_mac_register2: Core functions. (line 1546) * gnutls_db_check_entry: Core functions. (line 1573) * gnutls_db_get_ptr: Core functions. (line 1588) * gnutls_db_remove_session: Core functions. (line 1599) * gnutls_db_set_cache_expiration: Core functions. (line 1614) * gnutls_db_set_ptr: Core functions. (line 1626) * gnutls_db_set_remove_function: Core functions. (line 1638) * gnutls_db_set_retrieve_function: Core functions. (line 1653) * gnutls_db_set_store_function: Core functions. (line 1673) * gnutls_deinit: Core functions. (line 1687) * gnutls_dh_get_group: Core functions. (line 1698) * gnutls_dh_get_peers_public_bits: Core functions. (line 1718) * gnutls_dh_get_prime_bits: Core functions. (line 1730) * gnutls_dh_get_pubkey: Core functions. (line 1747) * gnutls_dh_get_secret_bits: Core functions. (line 1763) * gnutls_dh_params_cpy: Core functions. (line 1777) * gnutls_dh_params_deinit: Core functions. (line 1792) * gnutls_dh_params_export_pkcs3: Core functions. (line 1802) * gnutls_dh_params_export_raw: Core functions. (line 1829) * gnutls_dh_params_generate2: Core functions. (line 1850) * gnutls_dh_params_import_pkcs3: Core functions. (line 1873) * gnutls_dh_params_import_raw: Core functions. (line 1895) * gnutls_dh_params_init: Core functions. (line 1912) * gnutls_dh_set_prime_bits: Core functions. (line 1924) * gnutls_error_is_fatal: Core functions. (line 1943) * gnutls_error_to_alert: Core functions. (line 1961) * gnutls_ext_register: Core functions. (line 1982) * gnutls_extra_check_version: GnuTLS-extra functions. (line 15) * gnutls_fingerprint: Core functions. (line 2004) * gnutls_free: Core functions. (line 2029) * gnutls_global_deinit: Core functions. (line 2038) * gnutls_global_init: Core functions. (line 2048) * gnutls_global_init_extra: GnuTLS-extra functions. (line 31) * gnutls_global_set_log_function: Core functions. (line 2082) * gnutls_global_set_log_level: Core functions. (line 2096) * gnutls_global_set_mem_functions: Core functions. (line 2113) * gnutls_handshake: Core functions. (line 2239) * gnutls_handshake_get_last_in: Core functions. (line 2142) * gnutls_handshake_get_last_out: Core functions. (line 2159) * gnutls_handshake_set_max_packet_length: Core functions. (line 2176) * gnutls_handshake_set_post_client_hello_function: Core functions. (line 2195) * gnutls_handshake_set_private_extensions: Core functions. (line 2220) * gnutls_hex2bin: Core functions. (line 2268) * gnutls_hex_decode: Core functions. (line 2288) * gnutls_hex_encode: Core functions. (line 2307) * gnutls_ia_allocate_client_credentials: TLS Inner Application (TLS/IA) functions. (line 59) * gnutls_ia_allocate_server_credentials: TLS Inner Application (TLS/IA) functions. (line 77) * gnutls_ia_enable: TLS Inner Application (TLS/IA) functions. (line 95) * gnutls_ia_endphase_send: TLS Inner Application (TLS/IA) functions. (line 124) * gnutls_ia_extract_inner_secret: TLS Inner Application (TLS/IA) functions. (line 143) * gnutls_ia_free_client_credentials: TLS Inner Application (TLS/IA) functions. (line 163) * gnutls_ia_free_server_credentials: TLS Inner Application (TLS/IA) functions. (line 173) * gnutls_ia_generate_challenge: TLS Inner Application (TLS/IA) functions. (line 183) * gnutls_ia_get_client_avp_ptr: TLS Inner Application (TLS/IA) functions. (line 200) * gnutls_ia_get_server_avp_ptr: TLS Inner Application (TLS/IA) functions. (line 212) * gnutls_ia_handshake: TLS Inner Application (TLS/IA) functions. (line 236) * gnutls_ia_handshake_p: TLS Inner Application (TLS/IA) functions. (line 223) * gnutls_ia_permute_inner_secret: TLS Inner Application (TLS/IA) functions. (line 249) * gnutls_ia_recv: TLS Inner Application (TLS/IA) functions. (line 268) * gnutls_ia_send: TLS Inner Application (TLS/IA) functions. (line 302) * gnutls_ia_set_client_avp_function: TLS Inner Application (TLS/IA) functions. (line 335) * gnutls_ia_set_client_avp_ptr: TLS Inner Application (TLS/IA) functions. (line 371) * gnutls_ia_set_server_avp_function: TLS Inner Application (TLS/IA) functions. (line 384) * gnutls_ia_set_server_avp_ptr: TLS Inner Application (TLS/IA) functions. (line 426) * gnutls_ia_verify_endphase: TLS Inner Application (TLS/IA) functions. (line 438) * gnutls_init: Core functions. (line 2324) * gnutls_kx_get: Core functions. (line 2367) * gnutls_kx_get_id: Core functions. (line 2342) * gnutls_kx_get_name: Core functions. (line 2355) * gnutls_kx_list: Core functions. (line 2378) * gnutls_kx_set_priority: Core functions. (line 2388) * gnutls_mac_get: Core functions. (line 2443) * gnutls_mac_get_id: Core functions. (line 2406) * gnutls_mac_get_key_size: Core functions. (line 2419) * gnutls_mac_get_name: Core functions. (line 2431) * gnutls_mac_list: Core functions. (line 2454) * gnutls_mac_set_priority: Core functions. (line 2467) * gnutls_malloc: Core functions. (line 2484) * gnutls_openpgp_crt_check_hostname: OpenPGP functions. (line 177) * gnutls_openpgp_crt_deinit: OpenPGP functions. (line 191) * gnutls_openpgp_crt_export: OpenPGP functions. (line 201) * gnutls_openpgp_crt_get_auth_subkey: OpenPGP functions. (line 222) * gnutls_openpgp_crt_get_creation_time: OpenPGP functions. (line 243) * gnutls_openpgp_crt_get_expiration_time: OpenPGP functions. (line 254) * gnutls_openpgp_crt_get_fingerprint: OpenPGP functions. (line 266) * gnutls_openpgp_crt_get_key_id: OpenPGP functions. (line 283) * gnutls_openpgp_crt_get_key_usage: OpenPGP functions. (line 298) * gnutls_openpgp_crt_get_name: OpenPGP functions. (line 313) * gnutls_openpgp_crt_get_pk_algorithm: OpenPGP functions. (line 333) * gnutls_openpgp_crt_get_pk_dsa_raw: OpenPGP functions. (line 354) * gnutls_openpgp_crt_get_pk_rsa_raw: OpenPGP functions. (line 378) * gnutls_openpgp_crt_get_preferred_key_id: OpenPGP functions. (line 397) * gnutls_openpgp_crt_get_revoked_status: OpenPGP functions. (line 411) * gnutls_openpgp_crt_get_subkey_count: OpenPGP functions. (line 425) * gnutls_openpgp_crt_get_subkey_creation_time: OpenPGP functions. (line 439) * gnutls_openpgp_crt_get_subkey_expiration_time: OpenPGP functions. (line 454) * gnutls_openpgp_crt_get_subkey_fingerprint: OpenPGP functions. (line 471) * gnutls_openpgp_crt_get_subkey_id: OpenPGP functions. (line 508) * gnutls_openpgp_crt_get_subkey_idx: OpenPGP functions. (line 492) * gnutls_openpgp_crt_get_subkey_pk_algorithm: OpenPGP functions. (line 524) * gnutls_openpgp_crt_get_subkey_pk_dsa_raw: OpenPGP functions. (line 549) * gnutls_openpgp_crt_get_subkey_pk_rsa_raw: OpenPGP functions. (line 575) * gnutls_openpgp_crt_get_subkey_revoked_status: OpenPGP functions. (line 596) * gnutls_openpgp_crt_get_subkey_usage: OpenPGP functions. (line 613) * gnutls_openpgp_crt_get_version: OpenPGP functions. (line 634) * gnutls_openpgp_crt_import: OpenPGP functions. (line 646) * gnutls_openpgp_crt_init: OpenPGP functions. (line 662) * gnutls_openpgp_crt_print: OpenPGP functions. (line 674) * gnutls_openpgp_crt_set_preferred_key_id: OpenPGP functions. (line 694) * gnutls_openpgp_crt_verify_ring: OpenPGP functions. (line 710) * gnutls_openpgp_crt_verify_self: OpenPGP functions. (line 732) * gnutls_openpgp_keyring_check_id: OpenPGP functions. (line 750) * gnutls_openpgp_keyring_deinit: OpenPGP functions. (line 766) * gnutls_openpgp_keyring_get_crt: OpenPGP functions. (line 788) * gnutls_openpgp_keyring_get_crt_count: OpenPGP functions. (line 775) * gnutls_openpgp_keyring_import: OpenPGP functions. (line 807) * gnutls_openpgp_keyring_init: OpenPGP functions. (line 824) * gnutls_openpgp_privkey_deinit: OpenPGP functions. (line 835) * gnutls_openpgp_privkey_export: OpenPGP functions. (line 963) * gnutls_openpgp_privkey_export_dsa_raw: OpenPGP functions. (line 846) * gnutls_openpgp_privkey_export_rsa_raw: OpenPGP functions. (line 873) * gnutls_openpgp_privkey_export_subkey_dsa_raw: OpenPGP functions. (line 902) * gnutls_openpgp_privkey_export_subkey_rsa_raw: OpenPGP functions. (line 932) * gnutls_openpgp_privkey_get_fingerprint: OpenPGP functions. (line 990) * gnutls_openpgp_privkey_get_key_id: OpenPGP functions. (line 1009) * gnutls_openpgp_privkey_get_pk_algorithm: OpenPGP functions. (line 1025) * gnutls_openpgp_privkey_get_preferred_key_id: OpenPGP functions. (line 1047) * gnutls_openpgp_privkey_get_revoked_status: OpenPGP functions. (line 1061) * gnutls_openpgp_privkey_get_subkey_count: OpenPGP functions. (line 1075) * gnutls_openpgp_privkey_get_subkey_creation_time: OpenPGP functions. (line 1089) * gnutls_openpgp_privkey_get_subkey_expiration_time: OpenPGP functions. (line 1104) * gnutls_openpgp_privkey_get_subkey_fingerprint: OpenPGP functions. (line 1121) * gnutls_openpgp_privkey_get_subkey_id: OpenPGP functions. (line 1159) * gnutls_openpgp_privkey_get_subkey_idx: OpenPGP functions. (line 1143) * gnutls_openpgp_privkey_get_subkey_pk_algorithm: OpenPGP functions. (line 1178) * gnutls_openpgp_privkey_get_subkey_revoked_status: OpenPGP functions. (line 1202) * gnutls_openpgp_privkey_import: OpenPGP functions. (line 1220) * gnutls_openpgp_privkey_init: OpenPGP functions. (line 1241) * gnutls_openpgp_privkey_set_preferred_key_id: OpenPGP functions. (line 1253) * gnutls_openpgp_privkey_sign_hash: OpenPGP functions. (line 1268) * gnutls_openpgp_send_cert: Core functions. (line 2495) * gnutls_openpgp_set_recv_key_function: OpenPGP functions. (line 1286) * gnutls_oprfi_enable_client: Core functions. (line 2510) * gnutls_oprfi_enable_server: Core functions. (line 2528) * gnutls_pem_base64_decode: Core functions. (line 2577) * gnutls_pem_base64_decode_alloc: Core functions. (line 2554) * gnutls_pem_base64_encode: Core functions. (line 2621) * gnutls_pem_base64_encode_alloc: Core functions. (line 2600) * gnutls_perror: Core functions. (line 2643) * gnutls_pk_algorithm_get_name: Core functions. (line 2653) * gnutls_pk_get_id: Core functions. (line 2664) * gnutls_pk_get_name: Core functions. (line 2680) * gnutls_pk_list: Core functions. (line 2693) * gnutls_pkcs12_bag_decrypt: X.509 certificate functions. (line 14) * gnutls_pkcs12_bag_deinit: X.509 certificate functions. (line 28) * gnutls_pkcs12_bag_encrypt: X.509 certificate functions. (line 37) * gnutls_pkcs12_bag_get_count: X.509 certificate functions. (line 53) * gnutls_pkcs12_bag_get_data: X.509 certificate functions. (line 66) * gnutls_pkcs12_bag_get_friendly_name: X.509 certificate functions. (line 84) * gnutls_pkcs12_bag_get_key_id: X.509 certificate functions. (line 102) * gnutls_pkcs12_bag_get_type: X.509 certificate functions. (line 120) * gnutls_pkcs12_bag_init: X.509 certificate functions. (line 132) * gnutls_pkcs12_bag_set_crl: X.509 certificate functions. (line 146) * gnutls_pkcs12_bag_set_crt: X.509 certificate functions. (line 161) * gnutls_pkcs12_bag_set_data: X.509 certificate functions. (line 176) * gnutls_pkcs12_bag_set_friendly_name: X.509 certificate functions. (line 193) * gnutls_pkcs12_bag_set_key_id: X.509 certificate functions. (line 212) * gnutls_pkcs12_deinit: X.509 certificate functions. (line 230) * gnutls_pkcs12_export: X.509 certificate functions. (line 240) * gnutls_pkcs12_generate_mac: X.509 certificate functions. (line 267) * gnutls_pkcs12_get_bag: X.509 certificate functions. (line 281) * gnutls_pkcs12_import: X.509 certificate functions. (line 302) * gnutls_pkcs12_init: X.509 certificate functions. (line 323) * gnutls_pkcs12_set_bag: X.509 certificate functions. (line 337) * gnutls_pkcs12_verify_mac: X.509 certificate functions. (line 351) * gnutls_pkcs7_deinit: X.509 certificate functions. (line 364) * gnutls_pkcs7_delete_crl: X.509 certificate functions. (line 373) * gnutls_pkcs7_delete_crt: X.509 certificate functions. (line 388) * gnutls_pkcs7_export: X.509 certificate functions. (line 404) * gnutls_pkcs7_get_crl_count: X.509 certificate functions. (line 429) * gnutls_pkcs7_get_crl_raw: X.509 certificate functions. (line 442) * gnutls_pkcs7_get_crt_count: X.509 certificate functions. (line 462) * gnutls_pkcs7_get_crt_raw: X.509 certificate functions. (line 475) * gnutls_pkcs7_import: X.509 certificate functions. (line 500) * gnutls_pkcs7_init: X.509 certificate functions. (line 519) * gnutls_pkcs7_set_crl: X.509 certificate functions. (line 547) * gnutls_pkcs7_set_crl_raw: X.509 certificate functions. (line 533) * gnutls_pkcs7_set_crt: X.509 certificate functions. (line 577) * gnutls_pkcs7_set_crt_raw: X.509 certificate functions. (line 562) * gnutls_prf: Core functions. (line 2746) * gnutls_prf_raw: Core functions. (line 2706) * gnutls_priority_deinit: Core functions. (line 2786) * gnutls_priority_init: Core functions. (line 2796) * gnutls_priority_set: Core functions. (line 2907) * gnutls_priority_set_direct: Core functions. (line 2887) * gnutls_protocol_get_id: Core functions. (line 2921) * gnutls_protocol_get_name: Core functions. (line 2933) * gnutls_protocol_get_version: Core functions. (line 2945) * gnutls_protocol_list: Core functions. (line 2955) * gnutls_protocol_set_priority: Core functions. (line 2965) * gnutls_psk_allocate_client_credentials: Core functions. (line 2980) * gnutls_psk_allocate_server_credentials: Core functions. (line 2992) * gnutls_psk_client_get_hint: Core functions. (line 3004) * gnutls_psk_free_client_credentials: Core functions. (line 3020) * gnutls_psk_free_server_credentials: Core functions. (line 3030) * gnutls_psk_netconf_derive_key: Core functions. (line 3041) * gnutls_psk_server_get_username: Core functions. (line 3062) * gnutls_psk_set_client_credentials: Core functions. (line 3099) * gnutls_psk_set_client_credentials_function: Core functions. (line 3075) * gnutls_psk_set_params_function: Core functions. (line 3120) * gnutls_psk_set_server_credentials_file: Core functions. (line 3134) * gnutls_psk_set_server_credentials_function: Core functions. (line 3150) * gnutls_psk_set_server_credentials_hint: Core functions. (line 3174) * gnutls_psk_set_server_dh_params: Core functions. (line 3193) * gnutls_psk_set_server_params_function: Core functions. (line 3207) * gnutls_record_check_pending: Core functions. (line 3220) * gnutls_record_disable_padding: Core functions. (line 3236) * gnutls_record_get_direction: Core functions. (line 3250) * gnutls_record_get_max_size: Core functions. (line 3271) * gnutls_record_recv: Core functions. (line 3283) * gnutls_record_send: Core functions. (line 3318) * gnutls_record_set_max_size: Core functions. (line 3351) * gnutls_rehandshake: Core functions. (line 3374) * gnutls_rsa_export_get_modulus_bits: Core functions. (line 3399) * gnutls_rsa_export_get_pubkey: Core functions. (line 3411) * gnutls_rsa_params_cpy: Core functions. (line 3429) * gnutls_rsa_params_deinit: Core functions. (line 3444) * gnutls_rsa_params_export_pkcs1: Core functions. (line 3454) * gnutls_rsa_params_export_raw: Core functions. (line 3482) * gnutls_rsa_params_generate2: Core functions. (line 3510) * gnutls_rsa_params_import_pkcs1: Core functions. (line 3532) * gnutls_rsa_params_import_raw: Core functions. (line 3555) * gnutls_rsa_params_init: Core functions. (line 3581) * gnutls_server_name_get: Core functions. (line 3595) * gnutls_server_name_set: Core functions. (line 3632) * gnutls_session_enable_compatibility_mode: Core functions. (line 3658) * gnutls_session_get_client_random: Core functions. (line 3672) * gnutls_session_get_data: Core functions. (line 3710) * gnutls_session_get_data2: Core functions. (line 3688) * gnutls_session_get_id: Core functions. (line 3734) * gnutls_session_get_master_secret: Core functions. (line 3758) * gnutls_session_get_ptr: Core functions. (line 3776) * gnutls_session_get_server_random: Core functions. (line 3789) * gnutls_session_is_resumed: Core functions. (line 3804) * gnutls_session_set_data: Core functions. (line 3816) * gnutls_session_set_finished_function: Core functions. (line 3839) * gnutls_session_set_ptr: Core functions. (line 3867) * gnutls_set_default_export_priority: Core functions. (line 3880) * gnutls_set_default_priority: Core functions. (line 3901) * gnutls_sign_algorithm_get_name: Core functions. (line 3922) * gnutls_sign_callback_get: Core functions. (line 3934) * gnutls_sign_callback_set: Core functions. (line 3948) * gnutls_sign_get_id: Core functions. (line 3970) * gnutls_sign_get_name: Core functions. (line 3982) * gnutls_sign_list: Core functions. (line 3995) * gnutls_srp_allocate_client_credentials: Core functions. (line 4005) * gnutls_srp_allocate_server_credentials: Core functions. (line 4018) * gnutls_srp_base64_decode: Core functions. (line 4051) * gnutls_srp_base64_decode_alloc: Core functions. (line 4031) * gnutls_srp_base64_encode: Core functions. (line 4094) * gnutls_srp_base64_encode_alloc: Core functions. (line 4073) * gnutls_srp_free_client_credentials: Core functions. (line 4116) * gnutls_srp_free_server_credentials: Core functions. (line 4126) * gnutls_srp_server_get_username: Core functions. (line 4136) * gnutls_srp_set_client_credentials: Core functions. (line 4181) * gnutls_srp_set_client_credentials_function: Core functions. (line 4150) * gnutls_srp_set_prime_bits: Core functions. (line 4201) * gnutls_srp_set_server_credentials_file: Core functions. (line 4223) * gnutls_srp_set_server_credentials_function: Core functions. (line 4243) * gnutls_srp_verifier: Core functions. (line 4277) * gnutls_strerror: Core functions. (line 4320) * gnutls_strerror_name: Core functions. (line 4305) * gnutls_transport_get_ptr: Core functions. (line 4351) * gnutls_transport_get_ptr2: Core functions. (line 4336) * gnutls_transport_set_errno: Core functions. (line 4364) * gnutls_transport_set_global_errno: Core functions. (line 4387) * gnutls_transport_set_lowat: Core functions. (line 4410) * gnutls_transport_set_ptr: Core functions. (line 4443) * gnutls_transport_set_ptr2: Core functions. (line 4427) * gnutls_transport_set_pull_function: Core functions. (line 4456) * gnutls_transport_set_push_function: Core functions. (line 4472) * gnutls_x509_crl_check_issuer: X.509 certificate functions. (line 593) * gnutls_x509_crl_deinit: X.509 certificate functions. (line 606) * gnutls_x509_crl_export: X.509 certificate functions. (line 616) * gnutls_x509_crl_get_authority_key_id: X.509 certificate functions. (line 642) * gnutls_x509_crl_get_crt_count: X.509 certificate functions. (line 665) * gnutls_x509_crl_get_crt_serial: X.509 certificate functions. (line 678) * gnutls_x509_crl_get_dn_oid: X.509 certificate functions. (line 699) * gnutls_x509_crl_get_extension_data: X.509 certificate functions. (line 722) * gnutls_x509_crl_get_extension_info: X.509 certificate functions. (line 753) * gnutls_x509_crl_get_extension_oid: X.509 certificate functions. (line 786) * gnutls_x509_crl_get_issuer_dn: X.509 certificate functions. (line 847) * gnutls_x509_crl_get_issuer_dn_by_oid: X.509 certificate functions. (line 812) * gnutls_x509_crl_get_next_update: X.509 certificate functions. (line 869) * gnutls_x509_crl_get_number: X.509 certificate functions. (line 883) * gnutls_x509_crl_get_signature: X.509 certificate functions. (line 918) * gnutls_x509_crl_get_signature_algorithm: X.509 certificate functions. (line 905) * gnutls_x509_crl_get_this_update: X.509 certificate functions. (line 935) * gnutls_x509_crl_get_version: X.509 certificate functions. (line 945) * gnutls_x509_crl_import: X.509 certificate functions. (line 956) * gnutls_x509_crl_init: X.509 certificate functions. (line 975) * gnutls_x509_crl_print: X.509 certificate functions. (line 992) * gnutls_x509_crl_set_authority_key_id: X.509 certificate functions. (line 1011) * gnutls_x509_crl_set_crt: X.509 certificate functions. (line 1050) * gnutls_x509_crl_set_crt_serial: X.509 certificate functions. (line 1031) * gnutls_x509_crl_set_next_update: X.509 certificate functions. (line 1068) * gnutls_x509_crl_set_number: X.509 certificate functions. (line 1082) * gnutls_x509_crl_set_this_update: X.509 certificate functions. (line 1100) * gnutls_x509_crl_set_version: X.509 certificate functions. (line 1114) * gnutls_x509_crl_sign: X.509 certificate functions. (line 1156) * gnutls_x509_crl_sign2: X.509 certificate functions. (line 1131) * gnutls_x509_crl_verify: X.509 certificate functions. (line 1174) * gnutls_x509_crq_deinit: X.509 certificate functions. (line 1197) * gnutls_x509_crq_export: X.509 certificate functions. (line 1207) * gnutls_x509_crq_get_attribute_by_oid: X.509 certificate functions. (line 1234) * gnutls_x509_crq_get_attribute_data: X.509 certificate functions. (line 1258) * gnutls_x509_crq_get_attribute_info: X.509 certificate functions. (line 1287) * gnutls_x509_crq_get_basic_constraints: X.509 certificate functions. (line 1319) * gnutls_x509_crq_get_challenge_password: X.509 certificate functions. (line 1347) * gnutls_x509_crq_get_dn: X.509 certificate functions. (line 1422) * gnutls_x509_crq_get_dn_by_oid: X.509 certificate functions. (line 1364) * gnutls_x509_crq_get_dn_oid: X.509 certificate functions. (line 1399) * gnutls_x509_crq_get_extension_by_oid: X.509 certificate functions. (line 1445) * gnutls_x509_crq_get_extension_data: X.509 certificate functions. (line 1474) * gnutls_x509_crq_get_extension_info: X.509 certificate functions. (line 1505) * gnutls_x509_crq_get_key_id: X.509 certificate functions. (line 1539) * gnutls_x509_crq_get_key_purpose_oid: X.509 certificate functions. (line 1568) * gnutls_x509_crq_get_key_rsa_raw: X.509 certificate functions. (line 1597) * gnutls_x509_crq_get_key_usage: X.509 certificate functions. (line 1617) * gnutls_x509_crq_get_pk_algorithm: X.509 certificate functions. (line 1643) * gnutls_x509_crq_get_subject_alt_name: X.509 certificate functions. (line 1664) * gnutls_x509_crq_get_subject_alt_othername_oid: X.509 certificate functions. (line 1701) * gnutls_x509_crq_get_version: X.509 certificate functions. (line 1735) * gnutls_x509_crq_import: X.509 certificate functions. (line 1748) * gnutls_x509_crq_init: X.509 certificate functions. (line 1768) * gnutls_x509_crq_print: X.509 certificate functions. (line 1782) * gnutls_x509_crq_set_attribute_by_oid: X.509 certificate functions. (line 1804) * gnutls_x509_crq_set_basic_constraints: X.509 certificate functions. (line 1825) * gnutls_x509_crq_set_challenge_password: X.509 certificate functions. (line 1846) * gnutls_x509_crq_set_dn_by_oid: X.509 certificate functions. (line 1862) * gnutls_x509_crq_set_key: X.509 certificate functions. (line 1948) * gnutls_x509_crq_set_key_purpose_oid: X.509 certificate functions. (line 1891) * gnutls_x509_crq_set_key_rsa_raw: X.509 certificate functions. (line 1913) * gnutls_x509_crq_set_key_usage: X.509 certificate functions. (line 1932) * gnutls_x509_crq_set_subject_alt_name: X.509 certificate functions. (line 1964) * gnutls_x509_crq_set_version: X.509 certificate functions. (line 1999) * gnutls_x509_crq_sign: X.509 certificate functions. (line 2042) * gnutls_x509_crq_sign2: X.509 certificate functions. (line 2015) * gnutls_x509_crt_check_hostname: X.509 certificate functions. (line 2057) * gnutls_x509_crt_check_issuer: X.509 certificate functions. (line 2073) * gnutls_x509_crt_check_revocation: X.509 certificate functions. (line 2089) * gnutls_x509_crt_cpy_crl_dist_points: X.509 certificate functions. (line 2106) * gnutls_x509_crt_deinit: X.509 certificate functions. (line 2121) * gnutls_x509_crt_export: X.509 certificate functions. (line 2131) * gnutls_x509_crt_get_activation_time: X.509 certificate functions. (line 2157) * gnutls_x509_crt_get_authority_key_id: X.509 certificate functions. (line 2170) * gnutls_x509_crt_get_basic_constraints: X.509 certificate functions. (line 2193) * gnutls_x509_crt_get_ca_status: X.509 certificate functions. (line 2219) * gnutls_x509_crt_get_crl_dist_points: X.509 certificate functions. (line 2242) * gnutls_x509_crt_get_dn: X.509 certificate functions. (line 2345) * gnutls_x509_crt_get_dn_by_oid: X.509 certificate functions. (line 2287) * gnutls_x509_crt_get_dn_oid: X.509 certificate functions. (line 2322) * gnutls_x509_crt_get_expiration_time: X.509 certificate functions. (line 2367) * gnutls_x509_crt_get_extension_by_oid: X.509 certificate functions. (line 2380) * gnutls_x509_crt_get_extension_data: X.509 certificate functions. (line 2407) * gnutls_x509_crt_get_extension_info: X.509 certificate functions. (line 2436) * gnutls_x509_crt_get_extension_oid: X.509 certificate functions. (line 2467) * gnutls_x509_crt_get_fingerprint: X.509 certificate functions. (line 2491) * gnutls_x509_crt_get_issuer: X.509 certificate functions. (line 2594) * gnutls_x509_crt_get_issuer_dn: X.509 certificate functions. (line 2572) * gnutls_x509_crt_get_issuer_dn_by_oid: X.509 certificate functions. (line 2514) * gnutls_x509_crt_get_issuer_dn_oid: X.509 certificate functions. (line 2549) * gnutls_x509_crt_get_key_id: X.509 certificate functions. (line 2613) * gnutls_x509_crt_get_key_purpose_oid: X.509 certificate functions. (line 2640) * gnutls_x509_crt_get_key_usage: X.509 certificate functions. (line 2667) * gnutls_x509_crt_get_pk_algorithm: X.509 certificate functions. (line 2691) * gnutls_x509_crt_get_pk_dsa_raw: X.509 certificate functions. (line 2712) * gnutls_x509_crt_get_pk_rsa_raw: X.509 certificate functions. (line 2733) * gnutls_x509_crt_get_proxy: X.509 certificate functions. (line 2751) * gnutls_x509_crt_get_raw_dn: X.509 certificate functions. (line 2776) * gnutls_x509_crt_get_raw_issuer_dn: X.509 certificate functions. (line 2791) * gnutls_x509_crt_get_serial: X.509 certificate functions. (line 2806) * gnutls_x509_crt_get_signature: X.509 certificate functions. (line 2839) * gnutls_x509_crt_get_signature_algorithm: X.509 certificate functions. (line 2826) * gnutls_x509_crt_get_subject: X.509 certificate functions. (line 2990) * gnutls_x509_crt_get_subject_alt_name: X.509 certificate functions. (line 2893) * gnutls_x509_crt_get_subject_alt_name2: X.509 certificate functions. (line 2857) * gnutls_x509_crt_get_subject_alt_othername_oid: X.509 certificate functions. (line 2936) * gnutls_x509_crt_get_subject_key_id: X.509 certificate functions. (line 2969) * gnutls_x509_crt_get_verify_algorithm: X.509 certificate functions. (line 3009) * gnutls_x509_crt_get_version: X.509 certificate functions. (line 3028) * gnutls_x509_crt_import: X.509 certificate functions. (line 3039) * gnutls_x509_crt_init: X.509 certificate functions. (line 3059) * gnutls_x509_crt_list_import: X.509 certificate functions. (line 3072) * gnutls_x509_crt_list_verify: X.509 certificate functions. (line 3103) * gnutls_x509_crt_print: X.509 certificate functions. (line 3148) * gnutls_x509_crt_set_activation_time: X.509 certificate functions. (line 3172) * gnutls_x509_crt_set_authority_key_id: X.509 certificate functions. (line 3187) * gnutls_x509_crt_set_basic_constraints: X.509 certificate functions. (line 3206) * gnutls_x509_crt_set_ca_status: X.509 certificate functions. (line 3225) * gnutls_x509_crt_set_crl_dist_points: X.509 certificate functions. (line 3268) * gnutls_x509_crt_set_crl_dist_points2: X.509 certificate functions. (line 3244) * gnutls_x509_crt_set_crq: X.509 certificate functions. (line 3304) * gnutls_x509_crt_set_crq_extensions: X.509 certificate functions. (line 3287) * gnutls_x509_crt_set_dn_by_oid: X.509 certificate functions. (line 3321) * gnutls_x509_crt_set_expiration_time: X.509 certificate functions. (line 3349) * gnutls_x509_crt_set_extension_by_oid: X.509 certificate functions. (line 3364) * gnutls_x509_crt_set_issuer_dn_by_oid: X.509 certificate functions. (line 3388) * gnutls_x509_crt_set_key: X.509 certificate functions. (line 3455) * gnutls_x509_crt_set_key_purpose_oid: X.509 certificate functions. (line 3421) * gnutls_x509_crt_set_key_usage: X.509 certificate functions. (line 3441) * gnutls_x509_crt_set_proxy: X.509 certificate functions. (line 3498) * gnutls_x509_crt_set_proxy_dn: X.509 certificate functions. (line 3472) * gnutls_x509_crt_set_serial: X.509 certificate functions. (line 3520) * gnutls_x509_crt_set_subject_alt_name: X.509 certificate functions. (line 3540) * gnutls_x509_crt_set_subject_alternative_name: X.509 certificate functions. (line 3576) * gnutls_x509_crt_set_subject_key_id: X.509 certificate functions. (line 3597) * gnutls_x509_crt_set_version: X.509 certificate functions. (line 3614) * gnutls_x509_crt_sign: X.509 certificate functions. (line 3661) * gnutls_x509_crt_sign2: X.509 certificate functions. (line 3637) * gnutls_x509_crt_verify: X.509 certificate functions. (line 3719) * gnutls_x509_crt_verify_data: X.509 certificate functions. (line 3679) * gnutls_x509_crt_verify_hash: X.509 certificate functions. (line 3699) * gnutls_x509_dn_deinit: X.509 certificate functions. (line 3742) * gnutls_x509_dn_export: X.509 certificate functions. (line 3755) * gnutls_x509_dn_get_rdn_ava: X.509 certificate functions. (line 3781) * gnutls_x509_dn_import: X.509 certificate functions. (line 3804) * gnutls_x509_dn_init: X.509 certificate functions. (line 3822) * gnutls_x509_dn_oid_known: X.509 certificate functions. (line 3838) * gnutls_x509_privkey_cpy: X.509 certificate functions. (line 3855) * gnutls_x509_privkey_deinit: X.509 certificate functions. (line 3870) * gnutls_x509_privkey_export: X.509 certificate functions. (line 3973) * gnutls_x509_privkey_export_dsa_raw: X.509 certificate functions. (line 3881) * gnutls_x509_privkey_export_pkcs8: X.509 certificate functions. (line 3907) * gnutls_x509_privkey_export_rsa_raw: X.509 certificate functions. (line 3946) * gnutls_x509_privkey_fix: X.509 certificate functions. (line 4000) * gnutls_x509_privkey_generate: X.509 certificate functions. (line 4014) * gnutls_x509_privkey_get_key_id: X.509 certificate functions. (line 4034) * gnutls_x509_privkey_get_pk_algorithm: X.509 certificate functions. (line 4060) * gnutls_x509_privkey_import: X.509 certificate functions. (line 4163) * gnutls_x509_privkey_import_dsa_raw: X.509 certificate functions. (line 4075) * gnutls_x509_privkey_import_pkcs8: X.509 certificate functions. (line 4101) * gnutls_x509_privkey_import_rsa_raw: X.509 certificate functions. (line 4136) * gnutls_x509_privkey_init: X.509 certificate functions. (line 4183) * gnutls_x509_privkey_sign_data: X.509 certificate functions. (line 4197) * gnutls_x509_privkey_sign_hash: X.509 certificate functions. (line 4227) * gnutls_x509_privkey_verify_data: X.509 certificate functions. (line 4247) * gnutls_x509_rdn_get: X.509 certificate functions. (line 4317) * gnutls_x509_rdn_get_by_oid: X.509 certificate functions. (line 4267) * gnutls_x509_rdn_get_oid: X.509 certificate functions. (line 4294) * handshake: Core Interface. (line 325) * handshake-description->string: Core Interface. (line 416) * import-openpgp-certificate: Extra Interface. (line 59) * import-openpgp-keyring: Extra Interface. (line 19) * import-openpgp-private-key: Extra Interface. (line 54) * import-x509-certificate: Core Interface. (line 87) * import-x509-private-key: Core Interface. (line 83) * key-usage->string: Core Interface. (line 381) * kx->string: Core Interface. (line 444) * mac->string: Core Interface. (line 435) * make-anonymous-client-credentials: Core Interface. (line 194) * make-anonymous-server-credentials: Core Interface. (line 197) * make-certificate-credentials: Core Interface. (line 173) * make-dh-parameters: Core Interface. (line 213) * make-psk-client-credentials: Core Interface. (line 99) * make-psk-server-credentials: Core Interface. (line 105) * make-rsa-parameters <1>: Core Interface. (line 187) * make-rsa-parameters: Representation of Binary Data. (line 19) * make-session: Core Interface. (line 331) * openpgp-certificate-algorithm: Extra Interface. (line 30) * openpgp-certificate-fingerprint: Extra Interface. (line 40) * openpgp-certificate-fingerprint!: Extra Interface. (line 43) * openpgp-certificate-format->string: Extra Interface. (line 63) * openpgp-certificate-id: Extra Interface. (line 51) * openpgp-certificate-id!: Extra Interface. (line 47) * openpgp-certificate-name: Extra Interface. (line 37) * openpgp-certificate-names: Extra Interface. (line 34) * openpgp-certificate-usage: Extra Interface. (line 23) * openpgp-certificate-version: Extra Interface. (line 26) * openpgp-certificate?: Extra Interface. (line 73) * openpgp-keyring-contains-key-id?: Extra Interface. (line 16) * openpgp-keyring?: Extra Interface. (line 67) * openpgp-private-key?: Extra Interface. (line 70) * params->string: Core Interface. (line 441) * peer-certificate-status: Core Interface. (line 108) * pk-algorithm->string: Core Interface. (line 390) * pkcs1-export-rsa-parameters <1>: Core Interface. (line 177) * pkcs1-export-rsa-parameters: Representation of Binary Data. (line 19) * pkcs1-import-rsa-parameters: Core Interface. (line 182) * pkcs3-export-dh-parameters: Core Interface. (line 203) * pkcs3-import-dh-parameters: Core Interface. (line 208) * pkcs8-import-x509-private-key: Core Interface. (line 76) * protocol->string: Core Interface. (line 404) * psk-client-credentials?: Core Interface. (line 345) * psk-key-format->string: Core Interface. (line 384) * psk-server-credentials?: Core Interface. (line 348) * record-receive! <1>: Core Interface. (line 227) * record-receive!: Input and Output. (line 48) * record-send <1>: Core Interface. (line 231) * record-send: Input and Output. (line 48) * rehandshake: Core Interface. (line 322) * rsa-parameters?: Core Interface. (line 360) * server-session-psk-username: Core Interface. (line 91) * session-authentication-type: Core Interface. (line 294) * session-certificate-type: Core Interface. (line 301) * session-cipher <1>: Core Interface. (line 313) * session-cipher: Enumerates and Constants. (line 51) * session-client-authentication-type: Core Interface. (line 286) * session-compression-method: Core Interface. (line 304) * session-kx: Core Interface. (line 310) * session-mac: Core Interface. (line 307) * session-our-certificate-chain: Core Interface. (line 274) * session-peer-certificate-chain: Core Interface. (line 279) * session-protocol: Core Interface. (line 298) * session-record-port <1>: Core Interface. (line 222) * session-record-port: Input and Output. (line 29) * session-server-authentication-type: Core Interface. (line 290) * session?: Core Interface. (line 372) * set-anonymous-server-dh-parameters!: Core Interface. (line 190) * set-certificate-credentials-dh-parameters!: Core Interface. (line 169) * set-certificate-credentials-openpgp-keys!: Extra Interface. (line 12) * set-certificate-credentials-rsa-export-parameters!: Core Interface. (line 165) * set-certificate-credentials-verify-flags!: Core Interface. (line 115) * set-certificate-credentials-verify-limits!: Core Interface. (line 120) * set-certificate-credentials-x509-crl-data!: Core Interface. (line 138) * set-certificate-credentials-x509-crl-file!: Core Interface. (line 149) * set-certificate-credentials-x509-key-data!: Core Interface. (line 132) * set-certificate-credentials-x509-key-files!: Core Interface. (line 160) * set-certificate-credentials-x509-keys!: Core Interface. (line 127) * set-certificate-credentials-x509-trust-data!: Core Interface. (line 144) * set-certificate-credentials-x509-trust-file!: Core Interface. (line 155) * set-log-level!: Core Interface. (line 12) * set-log-procedure!: Core Interface. (line 15) * set-psk-client-credentials!: Core Interface. (line 95) * set-psk-server-credentials-file!: Core Interface. (line 102) * set-server-session-certificate-request!: Core Interface. (line 269) * set-session-certificate-type-priority!: Core Interface. (line 247) * set-session-cipher-priority!: Core Interface. (line 265) * set-session-compression-method-priority!: Core Interface. (line 258) * set-session-credentials!: Core Interface. (line 234) * set-session-default-export-priority!: Core Interface. (line 240) * set-session-default-priority!: Core Interface. (line 243) * set-session-dh-prime-bits!: Core Interface. (line 200) * set-session-kx-priority!: Core Interface. (line 254) * set-session-mac-priority!: Core Interface. (line 262) * set-session-protocol-priority!: Core Interface. (line 251) * set-session-transport-fd! <1>: Core Interface. (line 219) * set-session-transport-fd!: Input and Output. (line 6) * set-session-transport-port! <1>: Core Interface. (line 216) * set-session-transport-port!: Input and Output. (line 6) * sign-algorithm->string: Core Interface. (line 387) * srp-client-credentials?: Core Interface. (line 351) * srp-server-credentials?: Core Interface. (line 354) * x509-certificate-authority-key-id: Core Interface. (line 29) * x509-certificate-dn: Core Interface. (line 70) * x509-certificate-dn-oid: Core Interface. (line 63) * x509-certificate-format->string: Core Interface. (line 397) * x509-certificate-issuer-dn: Core Interface. (line 67) * x509-certificate-issuer-dn-oid: Core Interface. (line 59) * x509-certificate-key-id: Core Interface. (line 33) * x509-certificate-key-usage: Core Interface. (line 41) * x509-certificate-matches-hostname?: Core Interface. (line 54) * x509-certificate-public-key-algorithm: Core Interface. (line 46) * x509-certificate-signature-algorithm: Core Interface. (line 50) * x509-certificate-subject-alternative-name: Core Interface. (line 20) * x509-certificate-subject-key-id: Core Interface. (line 26) * x509-certificate-version: Core Interface. (line 38) * x509-certificate?: Core Interface. (line 342) * x509-private-key?: Core Interface. (line 339) * x509-subject-alternative-name->string: Core Interface. (line 393)  File: gnutls.info, Node: Concept Index, Next: Function and Data Index, Prev: Copying Information, Up: Top Concept Index ************* [index] * Menu: * Alert protocol: The TLS Alert Protocol. (line 6) * Anonymous authentication: Anonymous authentication. (line 6) * Bad record MAC: On Record Padding. (line 6) * Callback functions: Callback functions. (line 6) * Certificate authentication: More on certificate authentication. (line 6) * Certificate requests: PKCS #10 certificate requests. (line 6) * certtool: Invoking certtool. (line 6) * Ciphersuites: All the supported ciphersuites in GnuTLS. (line 6) * Client Certificate authentication: The TLS Handshake Protocol. (line 65) * Compression algorithms: Compression algorithms used in the record layer. (line 6) * constant: Enumerates and Constants. (line 6) * Contributing: Contributing. (line 7) * debug server: Invoking gnutls-serv. (line 61) * Digital signatures: Digital signatures. (line 6) * Download: Downloading and Installing. (line 6) * enumerate: Enumerates and Constants. (line 6) * Error codes: Error codes and descriptions. (line 6) * errors: Exception Handling. (line 6) * Example programs: How to use GnuTLS in applications. (line 6) * exceptions: Exception Handling. (line 6) * Exporting Keying Material: Keying Material Exporters. (line 6) * FDL, GNU Free Documentation License: GNU Free Documentation License. (line 6) * Function reference: Function reference. (line 6) * gnutls-cli: Invoking gnutls-cli. (line 6) * gnutls-cli-debug: Invoking gnutls-cli-debug. (line 6) * gnutls-error: Exception Handling. (line 6) * GnuTLS-extra functions: GnuTLS-extra functions. (line 6) * gnutls-serv: Invoking gnutls-serv. (line 6) * GPL, GNU General Public License: GNU GPL. (line 6) * Hacking: Contributing. (line 7) * Handshake protocol: The TLS Handshake Protocol. (line 6) * homogeneous vector: Representation of Binary Data. (line 11) * HTTPS server: Invoking gnutls-serv. (line 61) * Inner Application (TLS/IA) functions: TLS Inner Application (TLS/IA) functions. (line 6) * Installation: Downloading and Installing. (line 6) * Internal architecture: Internal architecture of GnuTLS. (line 6) * key sizes: Selecting cryptographic key sizes. (line 6) * Keying Material Exporters: Keying Material Exporters. (line 6) * LGPL, GNU Lesser General Public License: GNU LGPL. (line 6) * License, GNU GPL: GNU GPL. (line 6) * License, GNU LGPL: GNU LGPL. (line 6) * Maximum fragment length: TLS Extensions. (line 18) * Netconf: Example client PSK connection. (line 29) * Opaque PRF Input: Opaque PRF Input TLS Extension. (line 6) * OpenPGP functions: OpenPGP functions. (line 6) * OpenPGP Keys <1>: The OpenPGP trust model. (line 6) * OpenPGP Keys: Certificate authentication. (line 17) * OpenPGP Server: Echo Server with OpenPGP authentication. (line 6) * OpenSSL: Compatibility with the OpenSSL library. (line 6) * PCT: On SSL 2 and older protocols. (line 38) * PKCS #10: PKCS #10 certificate requests. (line 6) * PKCS #12: PKCS #12 structures. (line 6) * PSK authentication: Authentication using PSK. (line 6) * PSK client: Example client PSK connection. (line 6) * PSK server: Example server PSK connection. (line 6) * psktool: Invoking psktool. (line 6) * Record padding: On Record Padding. (line 6) * Record protocol: The TLS record protocol. (line 6) * Reporting Bugs: Bug Reports. (line 6) * Resuming sessions: The TLS Handshake Protocol. (line 85) * Server name indication: TLS Extensions. (line 27) * SRFI-4: Representation of Binary Data. (line 11) * SRP authentication: Authentication using SRP. (line 6) * srptool: Invoking srptool. (line 6) * SSL 2: On SSL 2 and older protocols. (line 6) * Symmetric encryption algorithms: Encryption algorithms used in the record layer. (line 6) * TLS Extensions: TLS Extensions. (line 6) * TLS Inner Application (TLS/IA) functions: TLS Inner Application (TLS/IA) functions. (line 6) * TLS Layers: TLS layers. (line 6) * Transport protocol: The transport layer. (line 6) * Verifying certificate paths: Verifying X.509 certificate paths. (line 6) * X.509 certificates <1>: The X.509 trust model. (line 6) * X.509 certificates: Certificate authentication. (line 9) * X.509 Functions: X.509 certificate functions. (line 6) ./gnutls-2.8.1-i686/usr/share/info/gnutls-logo.png0000644000000000000000000000223711271476021020216 0ustar rootrootPNG  IHDR93_ pHYs&?QIDATxK P,]KagORKa!CD v*yѪN]mbѡb;'菕r nL+[$|ݑ*;GPخ:NPN 4EF&#atDl&5tGdGP H GCm4NuLg1}PS(@qPL{ T jlduUA|yͅ`,A;%;P4՚9njMMh 0[50}X$09 gHQP4&5 yT]*t!](+z0݅93C^,Ƃ|EP!,M' @EuU}~KG%|W!W~CZC><gt=?K/%\c޳IGphVz\٢? M9~δjA$ZjQ.mȪumAӀ iuoA[A֮W[Htr5{Z1ބeN{¯4tއԶ/)4i݂iŢKnBAՂqנpxp4!4T'0;{ Q7(R`|ր%;EQ3 7Kd<[xV{\nY$[=QG]l-$ ,mlg{YVJI!{(|n IJ?ghh ,uȿ|KHޛtId1?֘ӧS Y8Mñ\]'rSY@,V?I*V' p,CC|L3zeB|HIAv?yΫ` SXk^W* Z@?6@vPFH?Y߹1^:p}.oCsmY 1ކ `8*hby(>0Vx (>0E(SKH #"$N9(OP!]ASꡁtOLFh!PP1{ A C={2t.{xqkR&UAIENDB`./gnutls-2.8.1-i686/usr/share/info/gnutls-certificate-user-use-case.png0000644000000000000000000035010111271476021024213 0ustar rootrootPNG  IHDR/sBITO pHYs IDATxyXS8B&%!)Wĝ?/ōEZAb-J- BkުmuE|+`7$,B,sҐ$@NNx?9̼9I̜ anӦM?L&#:0 FTT'|Nt,D_YYYJJ/T*B,+<<|ƌ<lGGGc&jooH$ gΜ9~T*Eh |F":FBHKKKII666oի'L@t\`D]v8pӓt:q7\paaa!BYfG}LtPLZ[[?㌌ 9"  @͛T*x}HHVWWX܀# }hR.ӧOf2DG={gB, /cƌ ;v.{޼y'Otpp())&:"DPDGGwttL:5++ rb2YYYSN舎V(DG/ x<^VV :`) Ʊcx<^AAAZZG?3!t9 z͝6mB͛D5}OJJJZj.@UVTcBϏFbGT޽{LJp//Jett4sLCPafxbRcca\.W"=pLA̜|XTT4n8c PNNB@#FPscSRRT*l}TTTGG^Bddd||7A˗{=HjHW<Ī1bf `jjjBl60\]]g̘q ܪ RĿ p_~e~~K/5KshmhWQTx  ^>}ё@P\\w}w޸8ʕ+߿P(ʢ -00aÆ oF.Y߮iiiIHH09wֆ:;; ]UUՊ+tܗ?p d֡*EJ J>ecc3nܸGO0 ;~d2YBBСC]]]Ӎjn֭WZBp5늇p}y]m{O>@f)@گI&?ݝX~fYП]HBh;wB`c+Od }@\n3L3Л]C#E=h=UH CJMM-,,D L&sÆ {%Jsss @D mtlK322_]`ذa^  /_2e#Bqpphllx4444x{{>>>rss뗨jkkǎKi4UGR__/ cuX'N)~gN7A`sNXXX,&:t`e`@NSSS}}#""@H_7rH___''-[00x`4bA H /dffr8"|sɓ'.cZD0zu~s_q,99}QRJ/]7XH= tHb r|ݺu,uǎIRf::: %##t{B èTz2dY {׬+SN0 @~uZ+߳g@ `0&L())www/]n߾]yV\\>>%%%]]]+VQ\+2A0͛KKKE"X,~!~255P$5440 6_zU$) :D"H=zנ+͛7]vZ?GKKKDDR877WMS;… x\WW1clڴ޽{UUU|AuR,@D C~xzz޽{W㤗Wii)~\__p_ZꩣbiYW<|>?##_t:~-5nv\hѮ]0 swww~Ν;q_*Juo@,!tzWW>_R(JBϚ7gc ]|Dxtsڵ;;3nR(v53cknn bð#FTVVhTngg'xgtEة0 qssE[UUBP*5`իWԨTV]ߚy糳R7|jժXφ*++cw38p0Y9QU9 K,ykjjZZZ+WB(++z >brC ήjŊjOdd[d2JR*U.QQQk֬JD~b611Q]yddd sP,! d2YBBСC]]]J255fܸqGUWڭ[:::^S^/ZBp5СC~~~t:= ̙3_$vvvl6>z4NMTx<@Rԕ/_i坝}3=#ZW |bcF  d }@$ H՗ͮ@`HԩS C |Q(=ef bbb6o֖w5g N2 QsD644ￗd,+..mmmDbY***>bd2###ʌnnnʁyoΖJ|ͪUL.cb1c! }S()))Ǐ?|0J~D"ٻw… aPCwpp… +H_GR333ǏP( _Ddy-LRJ%~ݻ *G@ X, DQ(k׶]( !:]*/OP!222 t!w@ X>>Jݻ>>>D/}P(SNʂe0̬SvttDGG3|Lfl۶M&-Xr@,}HIIy<^II XcVWWoٲ%99YOɲ1c Ν;cyiӦ!n޼Ot8`P|G:Y] σ0<斒RVZلZJR/\]]=w\LfdͫNJJ":%3.aV5`pz_Y}J2::ڊsLciϔzzz.^XTرCIoouٳgwww'B`gϞ}Iue]`>6BgXi?|~ffɓMܨ`EA_`>[庮L&88X%=z4ϗH$ņrJ```uuuhhhbbbkk511144:00ʕ+ 0.K,qppr۷oWw(ʤ$6mooсJP%TVVFDD 2v֬Yw\n:UPFFϧ齛V0J!YW.]BHNNnnn*))SOMM-,,D L&sÆ Ͼ |U'$$H$Dػ͛KKKE"X,~𡞶pW^D BWӺkmHkk@LL͛]7# Aӓ^uJo߾'e˖9r@,X@bȑ#˖-c'NܷoJZhQQQQrr2N':Lz  P~~2ǏQ//R~;::X,V󞞞w8:u1Q{kmHW5Ggddڐ5jڵkRRR ꫈]bĈBP,*a999 xdZmpT*ˋf{xx;Ҟ@ 'L`¿qww񪫫{lnnVTSezwؖ"{_tEQxz;y$S !D z@` 0|@GGG=e-ZvFTsʕ+߿P(ʢ...wZUgg'Zb2K,ykjjZZZAO6+BOdd[d2JR*zoگӛ D {#ٱ촴4|0Recc3nܸGn݊%*;;LJN ݻwk-#ꚞ-4}XkC"ԨYWnGΝ;aaa&Z. Z~ƍcbb~ch#`qy睦C= ` }oȑNNN[l!:0]z~ƌD#gիW&: 0eggTӧ @ }MYYYF`0uL.BO9C\\\wwbzPJZ䴷O0r,/|k=??hiiX|9~299$//O]855P$5440 6tUH6(//ѣG~bzsoנ'9`P(VzĨ)Jcc#>ӧr! ߿닗Gjhh;vl}}=^O]]#F ݻRSS06xTQQ1bP[1hT*ܤRiii),p8BZW?Eboo!T[[;vX:NѸ\D"QHB!~i/f]tT*  0@pcBͭJP(J T*/G,s?.R+@yBDE]Q*&&&ϯ\2>> ,**JW k֬H$$!!aŦr]Ӯ5 ~7_ H_"Ν;Gt IIIqvv'Ooܸqʔ)UÔ)SF- \͛M w 4ÓG9997hqFee[PPѱ0 GRRR2zhtΝ0洚sy1clv}}=<͛?7|sϞ=Dx}CP!222/NSSS}}{Czz:Bhh_ 2@EEFDBvڲeӧOgϞ78::~-z_jjj||Y\ IDAT|JݻwAObY"0 <?L&KKK#:YzuCCC[[]߶mL&[`.Z]/aaa@ X1c Ν;Bt8BnniB7o':K4eʔ;|… lmԨQ7oVT---DccccU*͛!wJ"3Yf $%%WWWϝ;W&5dͫNJJ": uqR:dc@:O?988\xqܹꍚA;wŋ~'ةQ,@*0͛T*>}zvv6$:"={gϲX܀#Pmmml6[.nPŒ=,ٳBbӧOwuuM<rH@ѣG_r%00:44411ȭ511144:00ʕ+#G )\ncco^z„ DE2"h׮]ocrrrRRwO&֊ ooo `)RRR~RbX3fxfukooH$ gΜ9~T*Eh |F":F8s̙3njS\\Lt,#@,K]]ݦM~gxX #**O>qww':Xj՞={>#w `0 +..)((mhhhnni1=9;;:f{xx;b4J|QQQѸq`H_0ϝ;o͞=X@_LX%+})++ۺuѣGJ%BbϘ1q86Ht.HϜ9sqT8p`ɣF":ƁwٳO>4i.U(\ncc[oM0踬H$ڵkׁ;D[arpvvhO<$$ӧOJf00#g'I&utt;v &"X&=o޼'OT?t0 3*}0('' ֱ8ɤR\.f{xxL|{?t\.yB!/L5&ݭq`DGG'\.0  x<ޱc w4 #++N?:tWGGǽ{D'w)))Y`r9Y|#G ***B_TTdUXXdHMMU(DN$N_-ZZz5сgx뭷B:с-[ }]v]СCe2Y㓙(ʺuZ[[hnnNHH;_*K_H~STӦM뙻ŋwvvN6 &0Bdggw^z=&&FR!e 5#F |||JJJJeRRͶ P( >O n *JPX,z +\fRiN:`0~?\dݾ}₏1/fҘl&L }T999mmm&LRy1 ,mk"=Jt 9/+J'T*Ljj͸q=nEQ?奮C􀀀3gh\mggflll+X>LU&;;LJN ݻwoݺ63y?rz bٲe˗/#|}} @?J7uѱ@ι/-k׮ܾ}[(K<̢޸?َ?,B,o޼>uVЪU\Ә{{{3W(7ndXvvvyпoO?|zz:ǣh9s8::2̙3g644`_[OFE2bĈ۷oc R[[a۷|'@RY֝;w^ڴy睦$2rH[[ۊVc/H|}}' YvAעzY0jE \@Om=ɬY.^:qWc=O7!tu=Z@" F-v(COz/U[OFErI|{^0l…Nugt_U!w~ Z=k}D_aҥK=O#\kcY0MkӆDSP}zZZڬYԃw=x(l"7NKRydӧt:Nuf/'1 !d2_kQcY0MkFaqBHV@̀_qߞ K0|~ffɓMLYiѣKKK^OĪvvvH$=;ZmmmL&5l;wZz10@}}_QMMMppI`0Ţ#GaaaE p֙޹s!C*ZWWs环/@ߞ+sٳG 0 &ˑd%J2))fGEEiG.[bرC %##a`FR{@] UVVFDD 2v֬YD | 9uT@@~ouHDt ?ӗ~~~#GurrڲeK֙kU(c'.1d͛7D"Xg^^JkPWRټys[[[^^޵k״XDr%&~Wnhhhkk;xi۫ͩPό\rL7FZW|(c%,0y]s;Z/+e詿gH!C]ss3BD2}w?}7XL_/Ǥ'}O.1d)u45}PuÇx/S#N?Iok!|@`9sȄ! L~/+S wCR?-JUVOZZH Ə,A{{{NNJ ':effr8SXg [IcU(Cx! L-Y߮iiiIHH0Bc#Py-LRJ!ܼyO"XSNuuuM<N ޅٻi5`͈1!YI}ƪPȀ#/1d)L0tPWWWv9s+ mHkCR֡Ctz@@3gzL _N<:u*с jxk}EP83l[ ֹ/2o.pNNG!\\\rn2)tww;;;#Ek} FےdÇwqq/ bƍ,.22?JOOx4_*MݐX,3g#ɜ9sfCCCcNH_#`֬YJMM%:~rZZZ`V\pu̘14 \.d}l  _˫Hr':~/,uʕ+B~2>e ֭[!??>@A 07ggիW#҈RTBhܹzc2}#ooocǎŗr=[qssdž._6g  oر+Ӑ4r]1Z򱿿q555L&F'J>s=xb/_F9X(*"nݺ՗zK3.r|}=u0* ƭX?O\\޽{ ?\pĉ*ѱ "n5jzJ%jnn=q@c, 3ذaN駟!p BF͛7!}vsDfEB , :/(ʧ~p⺻5]R.[bرCO ׮]ꫯBJ2))fGEEutt477X,S rܢYpL&/H_믿"&}]*744 p\֣666k׮%:"i"BDJJJ*++=zWy UvرW_}uϞ=ҶDkdd={򹹹AAAƿ_,ɤ$ wN N_uu=Ξǜ9s>쳁j*H>Ot, 9T("낛 걏ݻw=<<5XPB>7ui]J,xhr\ޛ6my_FQT^ .\xRik^xA+WBNNN̈́&M%:"$$!O?uզMBB_7؈/m6c/<ꯅ?#!:olz3u* Ç{ѵD^zֈׯt-x /L6ɓ'_5q?bNMMMyyy666>GVVVΟ?_.Pxdѣ)S_p )ӗZx֬YxbرcoZ|{ӺPOO}޽t-QaÆ7x^,x#K|C8HDt ‰' ԩS gccsA;;s-X8Z?ĻuDwBO?ş􉍍UˈDt(/z i]JiѣG#Gܲe wǏ{yyT gi)رQ k׮!dPw8ڽ{iDaÆ!º76RG\.S,)W?0 ~dDAv][['@iiѣY,VCCƃGEE4{Ȑ!*ɓ'Dc͞>}b:;;kjjLވhڴi??Ô)S7H2:{ҥK\nnnȑ#M P(G.kmmݹs'3QwjZsPXXظqjkkLR,))!:+w٧O }Dp/_?~|UUԩS}'OcҲf͚3g]rr`1UEEFc0D@h&wA?~aH!66aDhɒ%dt:!`0?J IDATu tZ%K A uYhBhD᭷B) ???d/Dj"i+w:ϟp/_~ȑjpO<~~~~ffҥKdxb,ӗ2*JRϟ?Ot,@\mR/Ǿ}BFŸ&|h% 'Nf@!}euٳgCc gϞ}IUPPcvvvk׮EX[O_!4grW_ճ_,H rssY,ٳg}}}-a3… gϞeXϟ7a]UV.]z_ەð{"-[6aP@@+WCCC[[[jimmMLL|W\bښNNN֤ӗ7ng%ݻw=<l߿o߾✜ZDbՕxxx;$uww_t={m۶<ᣁRO`%0iC0Ю瞣P(^^^DczyyX,DBt,c̙gΜٿ?/37յvU}VF(FFF۷)|aäRiMM ѱX .p/^/^ `6nHRW__Ot,_ɓ'e2/5L]]]D-_|C/GDDtvv) }_#ӆ?s8v؁ `nK#755~ui 2g/IX+H_8q3ھkc1Ϸ?yb…  }$w|W[ustt|ǏΝk`T;;;d\@H`ʔ)/ǏHJ.Jevv62xR` }wرXG"??_"1" Oy^~偎 `~r9s =zDx!}sA,/(JRRBh pK0jKCCÉ'lllbbb8.1 }1o޼?3ѱaԨQ ޽{wl9b1˝4i!G\ꫯr܁ @ݲX*qm۶EGGSH ƨQ_|E!%eنe Êrrr._hBU@?|Ky.f=<<&O)`!߯lll{=PZZѱEee7BBB )wh4())Y`G8ˏ9RPPPQQQ['Oܿ????33sҥÇd􌎎}``N777dҥK)ر!h"C S(R^&%''t/**[O ,Y~GRSSE/|oߎz嗉PT*`tww L2!iHa|aÐC c eݺu}愄|.((DG,0:~0M[[@ hjj#ˢd#Gs'L@t,d"JtT*2d3˿ ׮];x`TTEEEӦM{@ $ Xg.]9舀/| ; RSSP04JW^1$w)..v횫yT.aaaw܁2M>"$$>$$€ }o2ׯ_':@b'.^VO{⋏?3gNVV_=qĴi_xR:tʕ+yAnj }1J{{{NNJ={3 wuu +.^2fg޿J?2wlmmt:СC>$:@4w>۷Tm]]6Vvv6BW^!:rXjB?|fIBǕV\1,^!f, ,9p_su֙]cUWW# Ft $T*B"虅O8zT*2 !TQQяq_ɾ(,,Dyxx ؠF$ 6 !$}Lv޺u˜MD" hvMfBUUUDb a )hO|2B׷H_ORq\Kcs_`yM p}Ϝ92[ dju 'NS,''!jHJ2))fGEEutt O~Eum?P(|>Q2dY$ ^L.[bR' g@`0&LPRRꊏwvvvvv^bEWW=A3>%B\Sq'4# - T@,5%Wr_54 D&oo>5s9g̙{='--ѣiiigϞղ!>;w+^Ӝ0sɒ%aÆ/^M`EK_2b'L5~1B999>T*Hϟn:RaȄ:999R"""*+++++u떘,_999EEE(U(EΟ?I&Qy ߿_RRtR@/P ̘1C <~8%%%))I W\Ѧ3jaj ⰰ0LVDCd2Ej3?@DDӆX4w77#ryHH8q'JxMm }6ڮh;::zݺuk׮]`jQzFwwwSPPԁi hcc#A^^^G^^^Qkϟ$FMm6eCLU S`Krr2@]33OOO/̙ͦ3d6mCzRRR`֬Y-x"=[ttP`Vii6p86fY,8Э[7{UEqիC qpp@ߊ6-Hһ/jwl6uz[Ec6nSU{.hcXN =ztXXXEEŶṃQڷo*  |ALl6IUUUA,))Jh~kghڴis-++#_TTz|~qq1.**ҦZ Hq%HjhôLN8Ϗya!Cӧ6By1ZG(Z]]=A-E3<OKRRRƎ[XX(Hn߾E䯿ڥKT*J郊f899S'*=Q]]]>,ONMNN=ztiiiMMD)("""*++رcϟO_6h#Pv 1UP666tX+P***R\\p\2dnݺͣQ --iC, 6ob͛7#Zv2,55ߟ$I:Å ƌCUվI<~xPP ܸq#uT,'$$8;;`UQhz ¸۷o>..N(WD }1TUt:ݗ6^s߾}԰%`vsF Ď;7d eȑk׮{bO2 Ő$IV7}(kjj>|K/1k 3Xj/##W_[q yfXXwYYd#JCBB?m4(Չ[nݻsθj*|> JTQyyy}qvv.//lkkkccCj ŀU}ήܹ3㾋٠*52HhhǓ'O̖Ŏ᠂| ҵkW[[[Ti[,LT:|pz ڍnw`0V/ڤ2&fϞ܌:$ngTRa-ZHdX."@U%kԩS=zx[l;3366+77ԩSfS=\.Gr<77i[,-D={Y0a65̪:_x֭[O>Q#MI*&IISmKi)VSZEjJdOLL_xq7nϏiccr}MNܻjijj:s A=9R]]ֻwo؆`,sؘmkUmP hH*ݤfdXWH|J5~zm1ŋnnnoSE(3gd 0`@=QxM#= |C1U<&NY5&4<ڬ KﾨU)dM\~=""ȑ#d.?ʕ+`f֫ q^6IJ9s&hÇ,޾VK ,m1u i}\.rA477tU 4ܰa\im{yy}Q;(0C|||222jjjP>Ph8y򤇇MgϞ@pp0MSP]]-_~̪[fs\*F" 4QS:D34Kj'ٸB|5`H+ % x4H;wpϟ~:'(F$!!%2Ī*VSAAC3g裏jkkQ*3M$VKEBٕ̙3GdMDEEݽ{W,rLF 4>ҥ ʴ-¥K?޵k.]td(qd 0+>&7粖I$i2izְŪn(nU)dM۷/$$̙34?5Ivvv, ߱f̘[laKᣏ>ŋw`\p-D777''kעFTh"www;;֭U*D%5G֫UTTThcc3vX@*E ppܹ &h/6mڄ}C'O޽;߇d||CR{ijE0Mei}avw޼y͈v֮] m21Zr\v'e|m攗,Y2zǏWWW'$$ƕ+W5>66vܹ]EQ_ju=++.11UɞK"޽{Z S666X_~"ѣGqqqJ'&&?^ TTT'%%!M-LMIc, k{7c`}yp8-V33YYY*@vv6ЏTTTp\.S]UhߪjGJ-/ٳgmJ+)43`, k{7c`r<$$N8qX HGJmNXW *<۶mӧX=ֶQ"88xԩ(rwwqvv6lM˗/W rDteРA4Ѫ*J=+BQZJSGTva22c;Khi Z 6aД;C %KNNO Jعsg>z1"گR8h/Q:Lzir{>AZ}\Hfڊb!w$"""33sҥ_|f(r &kCVϠA\rС)ShS__) "kjj>|vj[%7o .++c ɣQ[SrӧOW!Lޮ]QFz3wرo~AQ©S,%K~[__ϴ-<_<}?3f M}555k.f{zj$`,TLwڴiLa I7nڱc@ 0DAJJJ~g.駟2m iL93zGZ&RF*aÆHԞ"fUԜR$|d \.E;vލv;6w\=`,!q9رccc#Ӷ;v,l߾tvv6DzZ/c+ݗQz7kJIsJyyC֮\}hoV` &TVVVTTު_~E;z)ryhh(oRۙq_H߿?|7L_pNmm-p8!ըy טblK 13O&f'ô/JfM)#iNQJͤvK˫*jUz{{+W Vi$ɉ':tСC&LP^m@wb]5:G___f0~x a{iB5R2E <<{Km8Z IDATX}w4kJt\./,,2dUhU2#O>ګW/RLo}]]5:rGuVm!I|!xzz2m3~z> 3RXRcA$ <*ɘ6c`_TG_Ԧ9eÆ 'OV{H)=|R-oR>>>ڌhj\.ѣ}gKرCӍΞ={sΖ_.;99E|Z;"]vAt9r$lڴɈ 22B04455#_ Mݗqrrϧv"""*++رcϟz zd 6(t Ŕ)STKû>|X$M>Ee…(jDE4PG`oo*HN:}1|p_6dff@hh(MX,{{ZjquuE3w"ȸ1FD(1<<ߩSΝ;hJwF{/]yPT(1gΜ-[(5n߾}#GϤXbϞ=ѿNhcYf555M6*d…FZ@•6[:!M4rԩS;t`\}=wɓ'trEgeeeyxxdeeuڕi0u.R4665]vo!fE*vhFR)M(,,D#AIII8rIHH@_S xa,`Lo׮lܸYPW^yY3H}6KLbV.]:ufr,˖-C</>>A0Evv̙3;j aj /ӢtG222nvv6V5444$IDbggGDMM DPOFR̥SXLqqqzÇU1ƢW\Ș5kl6;::`h ƴ700AP#G2hbp 1h˗5ur\.(kRiVVVbbb\ {-eب6xٳgx]sv~Ϛ5d.xvܹ:t8kט/rrr5lܺucܹS"L0p7bĈvy{{O7oLOO#f899͝;755555رc؀hk9:5YIFшNII9"AvVK@@O?DĒ%KOO83e=%ӗ/_F"ǍgQFEb*.\xLF')""bdUUUOdZZ# zr B!f$(BC/l6@uEEE}Zz0ESQVVF3!C>C:t3gU $Axxx=z4--ٳqqIڵkgkk;nܸJgE1aSzTS{p222:vxYMIMOLLL&KOOgDۙ?B/43Gkjjzׂ uڵۣUf ƚ6q\D"4T(充/))Yt)999R Ҕ3fǏ$%% ݺuC3t@LL_xq7njzyyٳfyM/}޹sgYY#@q_0#2~)ދ` s6=^^^PZZʬv~~է\ϟJlFwwwU]$I_Bl߽{BBBhX:vXVVf6F$@XXS䚌7NS\pvv :t¥0F_RA+@ @y ((H6OOOŞ...O6'j[&СC pppxZu</B ],)Xtѣ+++(sxb ~C۷% #׈7Ѷ(H$-˗oQ 2B9EEEL/|>m|L6mܹeeer}S֯_ǏWUU}|F t#А&X,ݻ}||.]l.gϞMMMׯ7vh߾}PPH$w#sαX_]mHg3P͛ to( cX2h bڐJLLLHH@Sz  y<]IIɜ9sv''Euwra t#^}Un\.w'N0iÒ%Kﾫ3v@yҬ8"h#GTWWEuuu+Wt`+t_FLŁeժU|>SN;w{,X8raÆQ VEFFN2aѢEw6 IFyРA$IΜ9/ 9rd]]ݷ~kfrݴgϞ 6L0ML^SSC*7o rQI'O>vX~.])59r{II9U3gƎ;tPkeH$;>x@袢Ν;ږwAoE=ҥKss 0X4V8fL8&[Me vK/ݸqZ.n6F+TUU1,Z\pgϞl߾].O:.]*X9L.{2cXLv)..p8\.W%h%##Dilf$Iz{{ޚ@!˖-S{T*,!Z?~II!r0c/ХKHHW_1mK%55U*FEEt/mCĉ{UVVO?S/Z_HD55>},88xȐ!(Z`\.5I`0eXl6ҥKL9}4Al6@? h}VϞ=k=N:IRs%Irٲeh"355W^\rk тFjjj `Z9{^xL&gڜg͚EdJJJpp~BlҥK{ܹ5iӦu?9Fk&M4@ r111zJ},[Io9 dBb1 LVDCd2CDuVc ho=4\cǎTjBBB… jI&bӦMйsgF0f$ɂ;;;53ԄR8::%|Š.MK}}}ѣfS@"d P+777qr97'N[E}}=JwA,`0 [666vvv 2eʚ5kLnڊBX,^l*/jdggϜ9IQ:pr5Pary4DMIAx G7o #F[>ʏ q(++rJc<j+~xٳg?}X7 ӖiC "//oԩ,g|~\\^/^0mR__+Wddd̚5ew51<ԺK.'GIR-25#G]ׯٳGo(NO?["`\b`6 X·Tss`ĉrpp "2*fh"?r\nuu\pvv ?u`f̓9k1VOu_xz[{,d&ѣG_G㧟~ ӧO7:$QիWMعs'=Gy.J{ k֬1Fāqf r@v_0_~bq8iIYY!t~Fip8.kQff̠Dt/W{nڴI?+V@L_ܖtc֟c}p8{zxx?LJPP%իM x<^nd2Y^^ԙ侠#%.\`ooӧOэXzޱ$::Z(8p'c vvv'N znp#G$G?v@IQ}V `)SN6M$NYvmss@w_TL$uVxwu) Q̔E?kjj:wK/-(++8pR%ɓ{1m 0mOz!z{{tA۶muVNNΧ~i&)7n\>}rssw{H ڵӅovvv6lҡ˗/x{{7NW֭+-- } 1Eό5Oqq~zyDkO;vDhѢ;wJe˖%&&jjdK.ݺukCCäI~TEԩS ,ג%KP6g褂 u}2 ZHD-6EG*Rk 5Ce"5jݻϝ;׵kWn.TЍ%-[_]vL mo={LeK/I$iGGGLf:-F端3f9s&$''*S o 4yNӽ{hԾdɒѣG?~:!!qʕF*--;w.jwss;pH$zQ\\M":*jWQNmUP/b۶m`"V6L&;tW_}P8;;wja6KbUVV*+-@s̲e˖{&zݺu+((صk׌3Li1. rx zOOOPXXX̹snܸqĉ(!777͛hpE*++J 6/ݻw@лw OLL|!C\x'ä= :6m!Sr}bT͛7#ty=pܹc#}ëW2@i$lxFfl6r) ׯ_pssEV[vAZE~ %ɚh2)޽ !!!4}0Ml0a'ԩ͛B!FzN:ٳgԭ[7xwLB,K>|T$|rX`T䣼몇"j=&{n\.rAgȨuuu{G5!F___zɓ4E5$x.ٳg4L[/+*J0mU!ɶlق0Ν;eo ,,DI}:NNN=ztiiiMMLӘ2vBDr([oݹs933ݝQT(yNNN.V_CI&{(ZL P6664}0/p8^VVƴ9VKqqСCѣ'33Ycv )755%gΜ1|$KKKDK]]cT(G}I\.Gc6_|Q,DKǏq87R/lXn:FLrCE ۷/$$уQۨN*ܗUV!?^ZE"MdMPxZ& w1O6\.7ox0hasNjkkM!?== f ^UP߷o >\](: ܳgx{{766B^lۄ+w_2e˖1mK[A.'bO- hoazggg0dѣѣ&oD|MX~R޽{e j[6a&&&$+W2mN[%Ί3fhhh`[[;99:to1vڡiT GܻͧN"Bʴ~v7lPRRҫW/=#a06 AfT*eږ6Gsss>} >>YK>Lǻzх?{ё  'I2##4(~ Uj!ŲiٳgNNN`츢j}hՎdffڵ۵k1'<oݶ?˗dɟ~X,>}ύ+5 }1p#U~SNE/3f ;3 2쭷Bƒ`iTdT<Vّ IDATXGf Xꫯq㌞h֖bݻwϸId(1`eeх L֭[R~wLJ di Xb}M4=?vss `̙FL!C˳ ҥKԞ :MO:fϞmD w܉^ܷoJ8MgMŋXڵk`޼yJUO >o95QiYtGw׮],?GЌ… 9޽{KJJ+ZC.9ln"E!ajcprrKӧO+-+%E%/_XQQr\?\.Gsl{ sz 0Ó&Xr9PPI!tJ#FÇם{.Ų5c2[l <JAE_}L4I{QG/bP(߿?bXˢ:!ܜ֮]K鍋k߾}R 9;H޴iJz۷o߼<%;>YsTh"www;;(j bcc|>ɓݻwrR\4%V8yܗp>)Aiii...GMKKsuu8{,!==;88̞=D:taΜ9Ɉ_Ϗ -AH$III԰L&[xqǎ~FmR-$IX,jFQqqIڵkgkk;nܸJE9Թ9uT=x<^@@-[ȨQ_fl޽{===?܈v:ydHdnݺ˗kkk'Md'(RSSsrrg}te˪JJJ򲲲˗xŋ7nT=d*FtLȑ#_~ ?ݣG+**رc.\Ǐ/***ÓQQQԼ/dɒѣG?~:!!5\rԨQsF6UԽ{h5vHѣ8'yN&~p8,ɓF ڵ{Œ$/ŋ+(_ŋ׺u{[z58::*`BIZFU߿󽼼6 Cml-;H*766r8US>o߾+**|RooB]PP@_,޽ !!!F2}ѣ*o퍶i#媊TQyЈw_*R$Y=:=Pޗj<qˍ($I1k8о}{H>sLHNNRNuu+N֩Sl6AVlGo޼i-$IlDH9ar&{-*nk#YuF al6 \T#""|}}QD@C 1LUb rWQQAG}^$>Z|jz*z!CYiGAZ&LW^yXbѨK}}d$*QQ@C&JauuuAJڻb CƍzziE76UwiRQ;BqIU zm6?* Fks_d2YhhN69PkiB苏OFFFMM\.S+ m^z9ϟO>ĈbQիWQիWwFi SlܼyNHQQ 2Jr:ujU>0\"99yѥ5551jLJJD3G톻/HVݥ2vBDr( .0aj뭷ܹܜI3fXX#Ұ6EEw:/&L>CZ>GڠDXQ"R+Y=:=,v%kx<A4SN'*pl6UaJ6mccSWWޯ_?سgrP.T]@R)zGm?:wl.X,NHHpqqqvvr|+S\Dd]2,55-Yӧ5.166ήcǎ+pzaĜr޽k,k/-?PқXysdժUh j|->MԊ?p܄Zɚe Iu4A7n4@$uFi hmѸq2oggg-k׮aggcMBP%%%j;HRgggx0FſS m}XBiK<b(I-[KDDDRΏ>͛4׶xb*ЗXBk}5b;7|.Zw3v_, w_Pbxd]v;vE Ik֬1nІxTL' ]\\ 77W!GA%JOzp5[[[ؼy3}{S\\p\)cc+L[D8`gg?ڵp,kѢE_rU>:sH$8p T@9r:,,w-JH$WӾ}{C)//G9?{s.]"##E"XR4**Ϗi[0'#cmVqS~GpppD" ѭ&JG +-B#7mڤoBBB bS ),f_t#ri l6}* /Zn JֵkWAѡV@Н;w"b1JCeoo_[[ۢ:gҔhU%99ep={ _~%Ӷ`Z }rSQ~piB=U`ʔ){nH3TgϞQyCh  <<܈=DFJ?1hKFFW[Iъik׫+h׮޽{Q5CMLLTcXgA/(vҤITL&۱chWtAxd9}EعsgϞ=u:ٳܹsӦM3bGNˆ˗/;::ܹS'LOFF}__?tfߖxyy![@:::9sjo1cP4v*-=y$Rk}A۷lmm Tʇ~)dffkf(C𿕃m̔*~TОtƏoQ)BpĈat/A+"A-u.ɞ&JScUUՒ%K^~ׯbí}!I?^z@Q+V1cnՓ'O٤-+1ydHOOo7oX,bm `/%gΜAя((u|}}QittSSS|#GRSS]\\|ڜJ 6DFF=HTEFF:::،;V Pnڴ ۷/Um[$|ńߚ B.ۢIIITƱcΝkeH$B&M2vځ|(**2\ޠ TKEEr9`4"zbe]),,DsA$%%`^SSSS `-/Jr(jBbbAEEExxxRR-!!tpp{A/$r777TO]reUt=++.111:::wԩ+Vׯj_`*VQQXnMުdmF_z)ryhh(*(3չ/$Ik׮5P… `ʔ)[ &:tpQz=.\@ xҤI-\]]6z -[p+NbEvv̙3%za(Lk/$S^^^G^^^TϟS*m4fC#$IDpCbJ(ZZollj%gϨvJ7}{EkN$'NxСCM0Az@ھ};EYǎ#&S;;;ex<Ӓ%K`ҥћwD"A-r94'N?W"MT-=в2~M:qqqzÇMQ__+Wddd̚5 l6;::Oa /ʯ^6M}(ڜ\ՠ1I.2}^:d BLjWZ1UӧOܹs4 """E gSYYi4;hρVQ͚5jx"x{{@PPPss~ڵ `eee111\.W} tF͞=[IF ERjj: 6l0ydJ=TȨuuu#"|||}iv\LMi@7WW}$ H1fC2Rp\c`ʃ4?(cǨ/99/^z!~ r͛'O߿@@5x;;L2e͚5yyyFc (z"""*++رcCMf@&oذ5''j)Sj$zaHTTT4}th}Yp!}ABc:#RVV7`ԩi;ʕ+  ::tF_KKK ppphjjB-uuuA̔H$Æ CuVF4pBLtIWQQQ2l(/'#G_,"֮]kgg~~~h%er%CD9N4qepvv;D"#V? ]hW(@nn.YgΜ'''=XX}mnʽ{ >C$7(E=(/CozKЕ&{[ZZZ aaa4gI^zիuh GK.GJJ ݸqc޽/]ĴQj?믿^]]=}tX9wݺuBP?QNN~ٳgZѻKsO?t֭>HW-:}ѣG< CSqNp8K,qF߾}>|8|D& ;v^~=))I Gׯ@ @?ѣ0i$[TTt{{(M455}6+ vZf ;x𠿿c0#c9G X矣]t?Mjܸqg=N?|0闁ڵkV)H$(,U/МrJׯa+ `Z;q_0[/ݻ^hH$2yw@ t=W&K۶m8áߚ . ?JR4DS4ӧڵ3W`0~X,޽{׮]5Ci|K1o||b&u9Ϝ9EFF:::،;V "IɓݻwȑP( ۷'D>f@Ϟ=o޼i 歷^zF޽BBBZt={k8WW>cXh`H F{}!I<7662kHbbAEEExx8w<?:88P4AݳUu$vHѣ8_jKTTTUs[W\ \.wbG+{gϞ䥗^{)&&<+rEPSx(JzzSܹp\n~~N,2hDpFIB^j,@>ϧ*@yy)ϟ?'m،C_ѣGƼb5X,F4nݺeoo۷o}ݺu{zܼy(.Mȉ'ܹsuRxeq!<oٌXV辠:,{Kf9DpT(ݾz!CuAs777__#GܹsEaЈMZZ~.Fg`oo{W$y{{@ffJ7ׯ' ҥ"QPڛI&iyh߾=f+M:9Շx&Y }N'644 .2TKaa!8;;x/ *'},3 Q .у2`˙ƴ"}{.xxx0#(h-|[Z>P(1b`0z` *+C`1#G4oaF(4*X]]Y-ԩS0l0LԚOX,;;;4.yf:|4ksfb0ӕLae[1(++C L@mK^^"><վtSPU^zlЋ/"w+i4ɼw{f3Ly%2~Un*0 +W*Q/YDVHII $'Fc0#醨|!Owx=U|E=ӳE bff(yl߾6o*F444 E"R2*P@Q???h9PgB̙3A|ۛ*Ξ=I U}^[q.[ ҁƑ#Gp@ ߿f$SEdggJ߂kVE@%e":tпM!Fk_CH$266n!_E0ggg% cA$ݸqӠhʗQB088mFr*  `̘1ly(֮] AAAm h+55U tf?7o*6Haeݻwe˚홓3m4---N8@}}}Ç+h6m200"/9::ޞbYZZ*hEC@pp0e0 y+N9̻!mY?J^#G4ӝ.q5 }8wNΞ='K,)իWNNNHf?QH:&T,|1cF|ܿ qJX_z56k6DpWUU_lAAA&M˫^bjoll|FqZ4"t[<Yd$nHXI)ٳgP1 O5TUU:uȑ#(i)FsttMMM 455t:nvFBa}}}IIIIIIaaaTTTjj*:dnn燢L:3BСC~-dz駟>쳎ѣGǏW^6mqqq&M244|-|/_4o߾([k׮=t萧իW8a>ك Ϟ=:tk˂ l[;'$%%}ʟU__߷oߒrqqqd67** :}XZZΘ1m&@ll4%CoſɷkɻeJ_?~رh[>#*u4558pՕd IW8Gb}Rrop!--mذa@:zÇnNNNG M MMMpX,%^hbSTU%UyBBرc555'= `0MMMe62LB-<~xʔ)\.ի [=ȯ`O47"s ywC²<HL ^xvvvtg௿JLL,((()).//کN J obbbhhhjj:zcv]Դw={455ڞ;wٹ#b̙W^6lÇ8ӦMrYYY(ZFJHHCNm!--mȐ!FFFްaӯ^*'!!a_FeRXX8bĈ˗TAL.{!77޽{ݛ?9!ѣGhP&7oC-Bt[g_ ^r)Ǐmmm333P$0Ng cÆ  UQQ6!D+e$/_:vw ~~~"~cGm۶)Caeif+ӹO>999( jߺuk^^^EEŪU4ٳ͛7MMM^^^}Μ9<ƍ i:::^"߂ɻCeJٞ /Ncc͛2'O:n$믿*r߿م~Z^Q&| DEE333ѯ\FFFRX@$_|FFFZ[[3L++'OƜ===]]`Bp޽,ё c2dFqZ4|ٽ{7E8*SHݐ,f/S0,_0 ܾ}{>}^|@ @DiF޾}KѴ.\Rgx<rIf^ +? OQ,_0>00:::>Bi i!C(N2؈’ژU%$$fϞ]UUճgO&Qȑ#H'IxP[@&Y22`{6{}z… x<lGGGxQ[BЄ ďVTTG:Fj+? OQ,_0IjkkWXA_WG$/OOOGQ'''-Z'Nh?uUUՈ#ŋ֯_Y2L./e۷---G k"O]]}m= 3s矧nCCy۷=zO>yzg @ 8<*~#Lg2`ȥj7f̘7o޴}TUUUٳGz)Gذadʔ)+W?:w\?;CePxE4n/~v-|(/L3DEElǎkǕWy֬YTVVujkk544tznnO=yFݻw2OGHl6[ .]4h.666Ν®/eirTMÛ7o:QP"`˖-0evPV5 %>|QһqFv"(<<Μ9®# iwa FY^jddzkhl6;11QfY^nٳp)N8Q"˵k@__RĂTNh]DC ABH;0%? U.fW^*/9sY8pth> t:gϞRijjB;&}"D"ѵkpSNxСs"1"D뇇766{Fl%ȴ&2Si >|:u*z|N6߽{$޽{ev@۔/^,hii)ZjoTq˖-(E~[UUehh2RX͛hLLL=*[&h+//OAssLI+SSS<!_3 %;(\VV^1LiW---뢢"###z޼y^~=iM jaa"Ml%ȴ&/^]=1,_0s9gV__mMәLݻwy`<3X"mBlmmɹ/,s:H+s"Jΰ`0ȢMMMdU=le,KE0L`0P  diiIӒ8]މ})S\իWx 2ݻ0vX}0,_06憞_}UWRn݊&dN+Vy. jģ8(fƌpԞAѤ) 7ft :\9HWBG '33 n|QƲ[˕94zرc-y4::ظ.AܚLPٳg+`HګW/4+ڔ@ &L ڒh={K nӦMbX,ևP;8-P}ewh{nXl>[nuuu˫ ڵkLRRRR\\n:ve鷈={y󦩩)==ˋ ۷o0@ GGG+'*tΜ9<ƍmd)H%X`0ENNуvضmiӦ͛XhcҥK`199%ݛ0a}ٻwoMMMLI+tuuQ___5䉭/X~ {E[{ѬҸq\:ܹs͍ ݻwkiiFd`а0;;;& u Ӛ4":Fi7B#Gz fff7ol;wi 7[ZMQ(9˗/2@)Rғ&Mr# *<|vRPTA^Nb:O>T;`3_5j 󫮮nTH___:P=w-}>ȋ`޽BZUTT镗wVMeD2HGGgǎ2Tjҥb q̛7V^M#/L#;Mo߾qqq-  'O iW㑲^qqqk׮)3~hn݊FyTAe'Omm۷K6K:ޣGoqto߾e2,K՘n/LGRh+W4^֬Y#q&C4H6l;vhx~~>F_~:2@RRҔ)Sh4k˖-R*00#cH|8A(.)+dee-\RK*!L߾};4 F111hS.V C uuuh1e͞`4hѣ0bOrr23r5[N:rġp ツ ZdIg[x xE֮]yUIEEE@@#GY^0 JA8 ]QZ{{{?>j722vxNh"ٳgyy9D.62@nnBe:|>䐟kyVS {*c0%K_FRŋhoez(/ O?MPa짟~KKK޿tRdz{{o<|֬Yh |}}V׉Q]]ѣK.-Z1y#L[(ȑ# ^x<{ *TÇsQsܹA#Km b L_5U_`4JL+@ lχc쳻wRs xŠh+VHII3fLaao]]ݯjjj3++ꆆ@Q1#4STTG7n2X__С~mڴlرqqqw(H Q }`0A$l۶̙3l6{ĉ^R^jjj&LpU===P-_hhh8}`ԨQ;w4i`0́ ӵy… ?~Lі-[fll70L@zzz!!!(.F#b񱱱B߿?%3rȝ;wQ|1 X`0]@wܹ[[[?|tH$OXYY=xի+((ÇܹsT^,_05!55;99NkiiUWWv$b@SS300ܹsyyy駟ر/@11 ӅQv޽o߾&T$~cǎiӦa`(X`0FRR… 322 %;;ʕ+l6{TnlڴfgggS `0j$_>, ϟoffF/ꆹyB_}4BF*t`5/Azj}QիׯvOZZڀO>ٝ?-((/uuu{1f̘ׯk֬+WV55/JD%$ 麨|yyIIA۷o 6w\ݛ1c/;wg϶ʪ :y򤂱XVV%ʕ+K,w-,,JJJ?ކ+t,W>|wV^-!4+++]]]322qpj` L6MKKḻv>sa`ӦM^^^=::ޞbYZZ*hG744X,/^1usI[`XܟLggg ֬Ysy}+0TfD UX,033{ITE$))j1 |>}:\xQA{{y-[< @AcPPФI򪫫WX߽{뫠QRnݺuذadӧ K"Ŗ8NNNׯQpaaak׮-ZH .\ӧOW C9twQj"_F =R]]zmnn)Afezz:z]TTddd^[XXH<d6C>T455]\\^|I= @ cbb3w܂yc-\022_~2;_B3= x9Rq7Lg@$]~} `5/}l}ƎDFC IF&`0 N)Sl őrgΜ155MKKC-})))Qpi>|Xjѣuׯ_yyyLLFGGO2E}DVVXYY5IhllC# Ψ|100}/]TQQ!H S0Dtt2BB >}Jȏ}&MXXxgg(ODMM ۷ٞN/ F]QG 3Q:ICCbpBʀK.^!///^|H$ 4*_}Q77nܸqͱ|>?;;{ѢE_|_566߿QA/^DPFAĜ9soߦhhA1Z0 ig(O2immd2ctuu4 ½{ZZZX,GGpfggd2bbb4J,Zn݊:t(Ͷ!gbnܸ1vX_dee4K7n7t QWhZd!CZ:3> ףGp8$0 3&G `x}Z),ΎT3= QW|i7.]lPW?P(JKK#MNND^z+M_}}}ܝ+Xf,ȷ.]5jtYn)m/}f?| D|zfРAmw#/ F]5cN ¶EeyvL|z&## a03666 ws|`0jKgS->sa(6md``U[[KrT(9(oiӦiiiq8wwbi p,244Te>J.HgϞ9s888X,ưa.\xСŴ1 Yw1&Elٲ1((hҤIyyy+V@UZZJ7%- _>>>*00p޼y2-Gፍ޽iYff鸒</^ܴiP>}|g+W }aUUU~``5Y<ׯ2\n\\xc߾}xСEEE@ MLLP7y/kS__߷oߒiGztKK3fXXXHwC,666VVV999ʟ:222虴r4ҒqppG F]Q?zYL&G>EoB$h4H[E@6lxY]],s y#='OvڕqӧK[٧YF5rDe/ 6l14x6/ FmQLO/^TyffD#˓ rV$ނ#_tB$UUUɴfGGDGG;*ݧY.\ӧOW"^z7xzzߟN,७dɒcǎݹsjU ^<`0ꊚl=z4+…qҥ~~~YYY ##cܹ2l@ l6[CC#77wɒ%,+^^^/^"̿"aYffAja0vvvfڹs뚚'O={600ظ:!!ojjnݺs%%%I`0 @~jB|>? @OOOWW7885 ½{ZZZX,GGp.qvޭR kE@L&ɓdg Gz0;;;&#Ӳ>͂eO9Gsrrիć`Μ9sǎW\T{ݞ I A%%%5$--mȐ!EEE]4 \ 4_njj1h zdvWǾ`0uEM*Nh3g:u*$$̙3TYvfeeeee5uT_z%.h򒒒ȳ#fqm F&A$''߾};11jtcccCCC33QF <~vd FNNB033ښjw:t-N27l ;;;{> D;# ߼y#>=-G[[A\Ӈo|tMMMvڷo@ ` .\|#~u;vEtwرa\MyJ].C;]Cm߾jw:#HР#UAdee}W4-00o1arǎG%bȑ[wgMq%$$?>&&go |>ݻݓGiiLzzzmmxacc#.h;W/ 99Ǐ}ǍGG]E$eP7999C =`6.|;v_KccG|||aaa!]~ѱaڴin_Ѝu떖Vzz%unT)O5j>SNW"..AZZt *++ϟ??fr.==6;/MMO?t޼ywQ16|rqqq̘10n8PH;/Al4m͚5T{٩\f ;|=RADDhQQQmjhh@kjj _|E9+V@1:ڎ2WX,===nz…ڶ$lݺE)++CO/u/A455b,'))j:#III>>> jjj)5t}V f̘999/_Z$xRR'|۷o=zt̙uyxxOz-N? >>G=~U hMMM{ѣG듓۷Ϛ5^f-[v[n]Za:$v ,ڑK/oook&6]PP@_Iijjrg}9Nx𠧧ȑ#ۻwoUB޽Fyd÷C)--ݷoJ[[; >Ёf߼yS O<. 'N|egϞU$P?ƍ#ѣǐ!CfϞcǎ˗/644xbXt)Վt/͛WڑNJ/*INN!׉ pht:=,,-}Z=<<:⻴޽{Wvss.2M2eÆ ?Sbb"#h.dggS틲---77726ۦݾ}͛l6FGg͚pFj$E"utttuu7mڤ@?}Z:t7 ijjȵ:_t,3+ghZͅ Pfppp}tgfff6i$'O޹s/p/пih(--ݲe˰a$/kkǏ'$$</++u=z-[ 7`Ҹ9s΅NNN?<"~җލiOJJJcnnNӭY͛7:hKZǴ///tNNNÃeV=zÇ߾}Shݻweə6mqww/..F|>?00P___GG M 444,244TA8⢡bGDD M0usI[`XJJtvv&b͚5ϟW ٙLE7zhϟGQƓ/LO8}mU$swR{quxk_P}ƍ8;;V뵚? 7oj߲eϧƠI&UWW{{{X뇇766{WA8/[n}9}rssISiWB¤?izEZhkk+::: 8{,̞=[An /L.]=z4N4eʔXDC:Dnjҥ(r!11}7Kaaa\\WX1a^-8:: ksss%2---麢"###"$$DbFqe˗/v:.`\111љ;w] .ׯLO$Zt:9(  <Aܽ{ƎO ڵ }Q2ݻwhuu̼666/_Xf ⠢k(k3*%cǒuh4jg0 0e62L`0߅)SsܫW*hGZ4  IDATgΜ155%'SRR>|j*K<+//?2hŋ`ggO _uvvFS cڴioVeG H(//QN'Mcc#lؘ3{luVWW׼UV)hܳg7oӽP9s222x<ލ75)(/A\tO>ʕG`0N?~z+AgϞ믿'O&NXSSҎDO޼ysuuÇ)BmmWMvv@ CLMM%U>+ ~|R EEEO.**===__˗[ZZRlذn"Cpڑ8}vOlٲ(pqq miN捸Dq I -QԂ|`|2dܹsZ'۸q#;v횻{W_ “'O.[FADz2MMݻwjH$͕Xu覩igg'.hlllX,%>~|R xǎ{10iӦgT9s挟Fx9sfҀ;>|4>|blllaOj_X`/ЧO??e˖YXXP?PB53=$7nX|y^^޲e͛e`TVVJ\H$އN[XXH:u?I-+Lw$!!رcW\ijjGGG///Ee(tt7nD~Ǒ#Gv]LqA)155m{Lt~|^t) %եڗVҥG ._|رOɜ1cرcvM6 $${~`Zj׮]*[%BqAիnʪE]* HtҨQβ*|t N>ߗePΉjr(r(aΝ 4i /TZZ*ѭG₦dttǧ<#?/&`T΃fϞMOϞ= 2ttYGyt:{^BA`0lllLaÆ~)11&PYW>sa(6md``E`.+1D%9|2ə6mqww/..gU/᧟~Oѷꫯ߿O_r:DCW|*u:3555O<9͛OKfff6i$'OƪeWWߗƠI&UWW{{{XWii)Vܔx-s {{yɴ,ϟ`Q7lB֦144ܺuk~~>~ WGUUrZACʙ3g~7(3z]Oe---뢢"### n-/2,)aY?/ /ǎz*>l09sp8]ô3iH d666JX,B$h4\^[v́7lٳ:Y@8p"(MLQ__GGGfXsy!~aړ{xx? U徻*/sRr싹K***D"QUUL 8:Qq rС3g:99YYY0rׯ̙3:B[^^͛-,,/^bdd}ܰ0[6p7n\pA__֭[  Ti.\_YY.]痕%222Ν+\̶ f544rss,Y"ϲ`T m f{{{Pl7޽;sLrxĈϟoll/LSRRNNNd,#PΣ===]]`( kiibQ;ɵ{n---2Y/2f2VVV'O$;KXOǁg_yc_222vu`ʔ)nnn\.}0֖\~e`0_~mۺnY_رcϟ?6=k,''']è\g@5 j_T'455D,'))j6III>>>- jjjکq>}ϭ~+ݨZt)FD=RCj_N$4m͚5T{>TVVY}>?޹sӓO5r .x* lmmU6b⯳e˖n`-Z˗/ow"(&&/>1c._ y"F1Qޱc|$J PҒTEEEFFF赙ٛ7okTX<]šb;!!!޽y>*ŋ`ggqT~D"4JЊ}rQKK͍,.n*557otttdٶ?3:?k,3zV֖355 1± ׉-Zٳߙg@gO&S 0܊8-*"\*jqT@q<G ZѪmm-PZVq2d $!r>+Y|>?""ޞl߾]K˞ZRԣr?,((Se%+GEWgA srԧd2 @"  M/ܺu+88ޞ9rD{ŋ_o[t_߿AEs_Ҩ}J_tcǎnݺ~˩SrrrBCCqx<^jjjPPuݺu+--MMMUZJwww~Ldggm/\.7..: 6_|Y^^ή}JS?U}3fȕڥ~{hpȜf1j(te O˕{&d|Q."%%Y rԩSaH%>>ΝdO]]ݬYd۷ÇM/mk}}=Œ\?|pNoor}.n[KKK׮]+yvboo/W^|bBBCjѣG̙DX,`„ ʷɥoڵ+j;w:`0NkE.ԯr_oeeo"EQg*ݻw{"cƍйsgi¸8)΁CCC-,,%onݻ׻wo&rwM+еkW&ٳgӧOMݣkD"v\]Z4%{\]]rlä> e2MWt_m+bee5bĈORt:ʕ+N$aaa...g酅rųg>vXuuun0`@iii|YYY˖-`e-0Y(:}-11B$UUUɕISH ..\\\/C[dt466bc\Cۢ cǝ;wІ)|===PYUrl߾=5Nyׯ-[6x`E:tP^^~3g>D>^^^MB0%%eԨQThС Ɖve˖ᢢkԩrE";;Çx<$W"{$Qt/,]?O~kC[d\̝;.\hhCa2c X| 1R ~;88@MM=۷{YkU"<H[*{FJ, {^\X,OOO۪vչsgeii9|*Ljvر]K}TN/r;vcǎL&k޽f)ɊD9ܳt@PӧOtyQQmQHγgϘL&vK7^.---)) xZmUD;;W^vRGcƌxb}}}iiu<):A222={A>QmJޑ%Kiyzznݺ͛7* '/_3?#FPyfRL8""" m0|5k 1^}9s&&gm޼:P>MZmm}Ň={'zf;uD?~fرZↄ9s͛7rs }\d Ǐ9r$vˠhÆ ;riNh9Nx<{C  6ǨiݻO<ϗ!Tȟ >&z#%%G(Juj.h}iEA HeaaǏ7qgNՍ1`E7%++ &tʶmۨB>L+29$kEA PܻwF mN롾~ذaLԩq_ߑ۷WVVӢ~֬Yaaa 33$ѣIT2g`<==/]dhsZOwQyG Baa!v|'Z):T@aʕ$Wm***חtyQ!!!Q϶KaH+͛xfbv3mߏ= @z9_~=Gke^pΝٳgS/`\\2l&&1\.ڵkr'YOQ\bGLU;P]-`%ܻwl2ȜÇ'Or͛\~=77[PTWW䤥%&&Ι3 a6Ռ3HH "apMKn }VڶmɡĖxccch]@ P̚5 ?TH2fffl6;,,d_i Ϗp8۷oH Lvr6zT,Q}CDQ^^㭭̂e%(GՐ!%%ۛbyxx|wr%#&5jXpepvvE=ٳgG;`iiŋI ڐ9"ݻ_~ĉ I18fff^^^&MڶmÇM>I_|Y^^111ա/u )--~7ry{{?*""bƌr%+Gv{{dŋyɕ,wz8!]v{_|Z~. Bwww@׮] snh*AȜA}\MzxxPMgxY\E:88ȕw).%Y2Ap8yX,&$sYn|=z˗2ѳi۶#3@ C/Xϙ!L&cBFuEԯr_oeeY)G[ns#Gȕ,wz&BJǨɓ߾}(]t?Pwsrrh4Kȑ#3tRH2g@t_C4"Pʽ}-11B$UUUɕĞ&#)))ΊݣL0A!@ӣE"Ν;M6Ο?S3}Ѓ0_~9d ܹs5vN# IDATe˖blllPPPvv@ HOO uk?̤~UUdggwa r%+GYӦMhhh8~8,wz@||&B0>,/^d2i4kGN;p 2"""!!!CԆ t!ݗ&B|~xxxvlmmw؁B0..Ãb$''㺔i&h'\Ecǎuؑdzyyݻ,%Y=jOHHڵ+ٳӧJG=04.7nn.^^^=/_Ħ#8wֵ14-''L&N_z~`ooI&a3<<>4 t!HN0 =,NR˧E~J`[}}}`ȑXAڴigϦ0sε</88ڵkwΝ;wbEҀ={Z1d cѢEfX3sO?ІW\ɰ/:yW/^ -ҏa.\PbX,nhht4[[[nݼykmmmoZ!sc`%''`삂ZblA:h =%o>|TWWcǏ6H-ΝweXt:bXD}ƍrthh4ڊ+('dE b3^vr#<6m i <}6'@]R={￯O Hjaԩ )S͵kD"W_}84A Kzz:N驩IMM?##жxN8Ѷm[ҿz xWXA-D"oooԡgϞtKKJXЫW/ӱ=7nxxx`f̱cim 4X,.[QQah[Lrlch[Z<[nŮt}dlCC1W!o^AaÆcŋ؈j/\ ߼y3n8 $Z4 4(@CwJ 5FCCСCO0Au갅.N߸qT8O?%%%}|5V,< V0ԡCjP( d<D۶mé~~~ZUa9"sssѣIr=ՇcLnӦlv377}zaa!bXz4bcqdP(7oXXX9sҰEo|룕 s5LVcq_bGpu`` `t ռJ_:t}%o߾z?)SRiΝ }C6M$gDO>O*D\z\]]%S.6n^^^ԢH$4333E$mݺ/Tݠlxɓq$-899͛7?~znn.$NuuuNNNZZZbb9s,1cƌ'O@c\X,ׯVXA +V;!2O#""dɒ%G uTDHGXXXRRRZZ9TNMMMnnnZZZRRRXXqڴiA}[I9;;l x044~Ԇfȥ5qqJ׻woE7=<}ݰpBXd.-UHeL2eJmmmo޼BVUUY[[h4#`R4Ӳ9 ~\/))aOt:=**ʲǷ2M]]݈#z @0 uuuDNoڴIţqȑпz{k6l.muuudC[l.+7};e3_~Er](b '~x |1bilpx<{C  6G@PF~~>~YiFFHptt| "{Xu`֪U}}}`ܹr)2t:zҥKwtt4 ]HPVVlbh[ q_Bǎ<4d*i咚 nnnFUq8;;ZS !IWK_CO(..:~z"3:`0 ©Sh42-/|~'J7|pٮtdddivܩdۤI(c?#P||<\Ʃn߾Fh4:pPqF,֐Ps&NQGPY m @ X|9.]TaIee%vJ1cmL&fO|ᇲ56689s(z]Ѓep`999;wNv63S:nnn^TTk]3&bL q_Cyy9&~AfP >>>ʑuiӴjvxVfffb{Afǎ`NIZDspNTGfs/_nhCq_Ausrrzj S^ F1s۷~->* 14l0#}(رcdq WywdINN޽{}T(<?͛nHMME7ٙd.3)ޝ;w֮X]?FEEWjҥK;vu?uTCCCNNNhh(n}Zh̘1/^/--]n#šC0lРArO|e-ٷoGb̔i5`Zy[TBmmm^`ܸq*9Μ9-Q`JZ[[*-r-]TSXX5L&3..&s}iX[[;sL GG͛7S'B0..+|||_E;ֱcG&w^M6S4>|ٳ'Nիԩusq333cRPR9s͛7%R2ԺH$Zjp81NB0!222:uꄱk׮5ӧOǠreeO0a6Rqxwo۳g899m+EJJ V.ZHɗ@ @RPP* B9j\>}奖! 9vbWt|WЦM3|_x`0ZV>wpp+B$aK4O>ϟdɓh6)nѨ1g@ҥK߼ycǮXBq_VH$KQ?dhf8'8rɒ%ʷ={ l+BqYl|܃)((FL&s˖-h/wvtt>}*mڅ/B롶vڴi@{-|%fFEE,jn>{vvv<O}RRcY H s=*'>g.-zBhͼ|Jb$TfoxW?C6HyГ'OVQK0rƌM'N_.AG9&uQlј;EBի׵Y]$3g% 6w=zt;?E* z*>eڴiMV|EX[@.hr΀I][4&N:^wĈM+++jܻwlmmUhl&G${{{էˏ>Hь >zj $;$Ah}ń -)%7@˖-[˗ޕNWbϝ;w. _6S$ITM'NT?3TWDPEsZEQQkpzNq>-Rc|y ),,tqq>ҒF2ɘ{l~%4ۻsv17n*̋/0*bmFI:Bv@˽(*r2h4c|HOOر#vSaРA0l05Nnplȑ#n<gbs~d3'p=Rc̣1b?W;v@3 wpssʒZfO999 o,E"IjkkJVd! bat:]n?zp͛ն0`@2Z~'h׮*%Kddd`jذa*Vl544X&LP iii(2 0.d0 [h4+W~UtulD"{ q_/m۶=~&\SgϞ1 sss5NF  T)X\]O>m߾= :T~G//[n5W)A {Q{(rƈ5q_*rssKLLDUUUr%(G@h\ruɓ'C{6$& C!O/Uuuz]v@1Eqڵ˖-ؠl@R^̤~UUdggwar%+G@0v{L' !<<I&Mh^ {Qڵݱc. ¸8C r_6mڄC*Utر;2L///<+Y=z/".]q+Vh$l&ݷo_ 1BN3;wnZm۶U/˗:u>}4=[d M9(33h+SWW%&58''FYYYyINNkk뼼}\\\є1b~ȟ?nhs q_ٳg8ח}$D]tJ777HpD(ř3g4ѣnݺC4r<OOK.Xg/]o>9(:J'Iaa!p]jTє"664"ɓ4\_"O>r}`0X`){ 4mʕ$WTTTc6ty/m-ZW]W:???>|@ БlgH~%??`k%OJ|}}D/33ǏkE1ԫW/V_d͞?&] Jsٳ:..N_ q_ZtСx X{xxHEqq08UyC{\TUU;l޼YsiDe˖ѣG";kӦMBBVdP>|8yd:.NNN?_[SSch[999iiis̱ז`̘1dF>|]]]o޼=5(..ƍ;-߿V9sFi2>ZXfҰzڴix]YpN?f$ " {gc/-_aW:__W^G͛7_~ѝF8}h9hX`_5kJNN֖}@޽2E#޽_N8qAE,,,|}}'Mm۶jwl+/D_|]͚5KowEEEXd*]t!JXp!h/u]X"** L#>ܹ3$%%iK,@Pq_SSS3i$`0Zl$|>Ȑ!뾟7nKΝ;!ǏkE6lo-UUU8>SRF ٳg.p8SNS5`: EѬPǎӖ@,a۷ ʢуnqϞ=ӧONN%IBP/bWnݺj']~]׺/_׵V֭[`ҤIXSS#cbb%S lZCG-{nǎm۶Z̰!꾈DO4ӳm۶zajm߿o9{ѣGWVVS{u۷JX«WL&bi4~dJ_N'}ҥKI @:M/l6pxӂfo.|>4`͚5znTVV9ٿ? uuuQ*ٳꫯ@7. ;ＣdA"諯@/cN @C%7FHCCСCO.\)kݻwuNׯ{{{}~_Э[7ocX,UTT]ɵ]tONd2`ݺu Ԯ]GBк.9RQQkBٳƌcF1sSõ޼?~<b ֵk ɼ}օKLdd.yfܸqHZrw t:N\]#'55)ihhO?P(ԅUx.j@KѬI&9r<rJC?DW^[ôD۶mC~~~/^ЅUbxԩxbCChlB:uTK.))1VUUս{w3Yt)|'T3]PD#G`uiLKKsww;;G*0 6n` )((` Cl߿x777=+A$a;[}I^c:XBw7Eׯ_͛7u!_cǎaKȃ)++;v,|^&JfhK HNC-Җd,:{ĪǦMI*۷UCKQgУGz]ȗĉ#F$mݺI&=%Q}Z1#pttkT(_͙3)))ܓX(խ>} a\f.r)v`ݥ]v 3O8#-B+f侈bk8;h1LyQ[[[ kK. 9_5ґ7o2 quٳx\;hHcyF !Q^^㭭̂qGDDs8RbcccddEHHb<<<;%أ} }yxxX޽{Sy?Ҥ*'77Jw-ڦo߾n&L0HL`߰aUV FaaTDFFbu5<iP(@Ґ!Ct#Z555S斘XQQ!/\.7??_gggUأҤZUJqq?XXXﺳY<+h*$''c 9XN<VX;-ܼyIt=*ҥK۷ǒCCP% Zk;;Çxޮ];[[[jWP(Jd\OHHڵ+ٳ'u;"wQ{/6mL=_٩#Tw_sРAJ'ɬYSN冲!==FiHҀZ% ]|N:TD1csP(ܸq#CzJcF AGuaW0wo+++öLR~mh}ˆ#tW^@888@PP_p3Ξ=kuqBܗJKuudܹSo˗Y,FKJJ2mڴh:M@t߻wCH.]ҩ"Y?~G ⢢ $mذ&q_Z*ݗܞ={@vV^mXKك56m襟;vOXÇ!% 14l0 z/-%KjjQu 8 {(㙎$9utY]|>wd*ӧO>hС:HMME955U #/-E7|-"0uر԰\pڷoOFl ʠlv]%++ Rj=h|a`DGGI?'A"444̛7EEEݻw m6T`ܹz^^^9";;F4H?96 (**҃R4$$$`J⚵:2C)KK˄CY7n mbX,TodeeaR|~>}`ѢE%<8p`ee~={ \\\ rD 蓦.K irI3./zYT) ]`C"l̯VlذLbhCL/]=ҹsNϟ{yy@իW؆`lܸ` mѴBT϶ӝ,3"5G[Kbb"vЏXLO,/^ر#͛7Qظ~z $G/gp_@122"$$: 6xPKKK''[R))),ﾓX__?o<c()3$?~YPPU>aoopo䟰c.RzA"W\ e%+G[vZJ7w\],WKxWгgOCbrTUUYZZg8%G IDATA@ ׯxr;w >>>LW?s F۷o.8hErsLLL@@@~~~uuuhhŋ6^z̘1%%%EEE8퓓y<ދ/͛'.""bEEE#FXrx{{?*""bƌ{_|Y^^B}( }Y*RddE(~L_|_ƍ 2khCL3g3h4ڙ3gQnݺ[RRO>~Eƒ@A5*-**rrrJuʢw Eڷoϙ۷5Cr4dO$,E"EJIVd"wi׮Bp] my&p9[,xn>_ѣx{{ R DEEa )((HΓDO4O[.m۶4iR||ɔ{MP}a2 `?F`0dZuVpp==r䈬:'2LY3$~~>(Kd &}Y*RddE((f@JKKb,\ ӌ B!~*V؈3#blݽ{w=Z%0SkEM%666(((;;[ HmXf KL6-##r=+W j*Y3$;|0˛:umk׮ ϯ w) }Y*RddE(ݗUVQ}0l0Cbh4+++}a[LΝ;7vEsAdd$=m%111, X,֜9sֹ{nXXGGG˞" <<<{g񓅰*`qu֧n VbVkuBZZUZ^Vl]@ D}ôM! L2whܙ3yyy8qEpSSS[[[ٝGǎ`ٞ/_nmNvt&%%lWW]vmѣGkkxoi& ^"א"-zVG?~`LT*߿?:u  )ofZ3*C(@ qZ.@61H%###ذanE}v؁[˿@A;ѣGkhVV $?6 㸺jg,(֭[.$=xmx]dJJ 5r322ptt$n/(O׻ﾋ[KK`ƍZ_|888TUUinkG ιZ.WX^'O\^^ewDX4"hĉăQ] D"Cҫ~:l6)**­@Q|6677:^ԠYe7qܹ={SjjiڀЈDI&yNNn9: AeڵA+m'@q54pj9ǏQ~IvR[[(:88(O!={& -$bdw̘13QGhll;v,9t+A@rfupUթP.T*EχZ:4V~?-$[کt+AP̆ pk]tk$N/YYYݻw/9|0x`BaaaaZ+HPٳgkٴ\B W򏤤=zXMx!d2:;D(B@@w/555KHHn-ArK0d2MMMW6;;-!Z6-z___s8/Rs I!!!fY7‡~(2j;MӚ@GT:uT4hPUp=My]gW_@^\& (&==&:ԩS5b8#b^!4qk*uܗ7{.N)>BoZ"y_RH$,ZEC x<EQTssU\ihhh]]ݽ{YJTڧO]` )**j۶m@  066+))ex@Q{nvȐ!ߗ{G-.\0p@###gggڴ&huŋx(ܜ`g BEMeeeizNNڻ{i[Kcc#δ}6.O>E8NBBR)J2,~Ω zzJatq &|2<<}2zСC) ()))..Yljf__ϟWVVLII9s&mts>}z~~P(ܰaQ'NDgϞ%m5X֢ ;ZQNvv6zEۼy3FIHHB Y`\;vYݩoOMG*1""-$%_zz:899u+}( UhOKKӨ}@s9@43D]\\lggGQl!!!;w(ɓ'GѱܒβB"EQ@g l6[8prrJHHhDsssԮF(W_EkY(T+3gpk!(ƍ`ooܬ}R[֩sX7o=z4mmsE垤nݺ5eGv_RSS[V!JokY4\ra *B{.\"@ 'O"@.b844u7_Qnn.*hll}tŎ9yUʧ-[6eʔҒND7hs}&M*---..Uq_QsQ d?ѣG5׻G'7|ƌ t =EX싣ǫRiMMMkGEw}pB^\F?SjԊ"3f%---ť5ͳf k׮aT",YOzaV>@o&ΖnsAvcd_QsM1bD'1<@]Syzyf??lXI]tի茬k׮ϯZt):ٳgӧOD"@L_:沝w} yaccs-L9Y,Бx266-A/ fTp;X(277ǞɓֱQ]ʧ[LN+kUWԬ`Y@T-WDN8Ax...t<ѣu||<:f]]][:i&4'B;;vÃf{zz^|YiOSOl^:?sK. }B^^^n 11H$`ff -:t(ZH]q;moohEZ?юrg_TWԬà1<@ ##Mtk9f^I&.>Ha {$αc`ذa5ݻ6c'H}011@$-^M-̘1Fk>&pɝ})SN2]ˊ+P ۨ8ͯYgPs3$`ѢE]?"\fϞ }UJ 2444}VCC&<01sEL;"&B D"Q@@k@Uk>R333}&Hݱ>:J񞐐[ӽ[(dÆ ȃ9tn-sQѺ;ynrמ . ăD"/JG<7o466Çkh'x"+ҋu.\N< ^^^PZw}[B6o L&sͣG '' ÚK#E.-uڃx$;(E˾KQQDDDhhA>sBgϞ#tk|s߿?a ?SXmdd"tw|GGGkهQR+gʕ0gBer>pn-HHH`0 c?' ۿð{VVEQϞ=c0h+++ݝ U{nTMoȐ!cn(~~~rܭܹs x, }w}#RO>ߗkUVq\SSк:发/rQfffX,ܹ\.OLLLMM:Bmmmnnnjjjbb"G+w(/88X]h?ԲЀjI Ѕl?5(qkQƎ;CB!sBd^d @ڹs ڃk׮KRJO/ 7l0|=80%%&**Jn1WsU;3]@hh(Y2d_qաC*Bptt _|fXȥppñ߹sZ> B0`ʔ)M`` {AC_|[˿8t J .+Vy-ܹ|>Z"tiӦ,Xw<~A'vzllhceevupLMM裏JKKKKK#""fΜO>o߾oQd .X ''Çaaa9vp8vS^^njjd2srrpk!&[[[}6n-S\\"u'Ê=fO>oTEx zڴiڒ܏$7776k.m`˖-hQxx8ZRҿD"x...)BD"A[,If_BܗJm3 ..p !Hhs_69~8tٳgMbb"`VZ[ E0:pt{Q;w\TNJ}Ν4in951x`T7y睓'ON0ʕ+h\eN:*/_ zcdR%JuZ* $"Jrss 9K. >}^' :thee?[sN.{կy3uYnݥK\SLLLp(hw…hе^E/_[NL:ɓnE: y2Ε4͙3g~muʕcA߾}QNQQQs{{{r~aܸqW^Ջ) ."hѢE;wĢ,t BY"YYY.EQ[nSv-Jbsʔ)evikk{nZT" ٳw^pT*ŭ@dQSS㰰0KihhxoF 'Oܯ_,Zӧ~m zj```}}=ϧj ]E\%sAKׂ9s<~x| n9#F 3q޽{?z?_rӗɌ &;w||>_"VD tt-6nܘԣGӧOqV>aٳgҒ۷ڵkzwoر.\8tPxx8`3q9&b.][K@o666tZLaCVgΜsssou BBBbvB5zԻu떃W_}EQTssU\)Q)++Ct2UΞ5kT*ݸqĉqM~oB{0`wMM tSΜ9S(|}YB7x˖Ǐ Z0jirN>=iҤ={,]bbbܹVRRbllrJkk={)))XQrIKKzOR4===...((#Q'AAAqqqXk׮=fY,B[$f̘qaDk͛0b,u Kfffpp0B9ڗ9jkksssSSS|>EwbBBBh_lٲ,--?~s.^[ AۄMp Ϝ9s7ސH$4_vp]>O?h]rR$%%iΊ@z7B:ϥKз (/_~[Kwz45Կ*EQ111͛bqfffhh(7|ׯ]G.E͛7d-B{@ @): FddduuL Ց(kذa x)z4ѿm۶B@ss#\~;wLMMq3##|}}5+==4ѹ?EEE(J"8;;yyy8qnO?9;;cQsZZ.:ܗ xd}y<ZA{z; C A†1Wd2***pk!a͚5_ߕjL͸ Ə/ ޿T*ERFF;;w\f .<@am/хU}D$jƒ5k+3 y1֭MTUU)8Z:BVVZ3f&2J59w\ ͝-h"\t/@|D077UK `aa`-  ./EeԨQp!Brabb[KGx=Z{sssY,Ñ*S=v%X,ʈ54뾈#G"G^[1cȑ#;{5###!۷=BAƎ[2P}\B(*;;k5Fd/VoLJ~(u_QKUUF u|j*uiPÇq !`̌`rjy˖-t\4G >d2L&A*!%%=%AW;t_233ɿvÇ;փH$1b 3>-Y$P*8~˗/%wӧOQÇWVVgV UUUݰan-ݗ`2C^/^ !!!MYޜ3gիq !߹n&Y`ʗjٳgnnn0tP5%466;V]ܗUPP!I~~~cPQ33tMh*bpk!%_NIIE555hN ̝ꐋH$4ia s)eѢE:Ag;w.|*55:z"&&&O?9s?3066V{b'mrAJKKDyă(J$M8У8ЈZqgdd8'_xR5|Gզ}˸t\annUH.\kB@QQрӳX] hBg1SkhdօНBQU\jllD0ƌ׿r9{,JQo~[H|-ulI)..xB]ݒz2ک!cxhdFu:~Μ9fffvvv[n݈UVq\SSP:#$޽2dlX,EQ 00ϯQޛ,r(ӢY;QKasp !7xINNf0GߪKKK jEܹۢsHv|7l`xC# e˖M2dɴ=a„/_{`BpÆ Ço}hh(6p3gdU)ME]#GԩSly011uVl2=B $o5 ɓ' zxךpk( S߾}՛97333$$bF.SSSssskkkh |>A}I~RSS;vqM\\\lgg B6f{E3Bd7Ev^Pooon߾mbb!'"",X[AGAqk׮-mjkkc<*** nnnϞ=So/^GZW ^-v|ŢSbǍ`,b1L`0}Rizzz\\\PPk}tqq KOO'!}A# \'w/*wtt<~xUUT*ڢT骽b55j&}ڻw/ABT*EIծ\[J,Y} ?쬮Z05cE. ,///++/\p999> Sޏ8i^^{GzqzSU{A.//OQ+V/{>qYV`׮]"0w}Pv޽͛7Y,--/_Q'{ f255522B%ILL aES/*OJJrsscٮhD7mڄ彩UP {p87np:ovvv:DPyyyL&T_W&idd[ ?-ЅEE,! gx=333صkUiPГLv&L{-DUPLA ;3f ;++ BWA#Ggҥ˗/G۰ PYYT__QYԩSl6ǭ@LLL߾}3226n܈[077?㋊ƎC܊]u_<<<߷oݻD&sNr4Ⱦ}LRhʙ6m#ZTL&?{.n9j짟~-..7n܃p+"t41իTiXW^ŭ7,XV\[H;@<== ZaCC?p/:u?gى='TPPЯ_qBÇ% n-i&L`6119sɓǏ[!_͝;8"g=EA/^r n-bjjzu۷o㖣O:XQQ1a„;wVD0Xrq;;;kjjMV[[;s̏>͒baa1gZzAU#GFFF677766▣8Ή'|||O܊&V4׳~xtMg(HL^^^BPkqr.\QPPb+**pki } i3f@;\@PϾP#GlqRٸqO?ԳgӧOt/L]]ݡCd%tcǎLLL:ujnLLLKKKeUGDGGXUGyW_}^w `D";wH$-GmÇϚ5$ԅ/ׯLKKϟ?G'cbbܹVRRbllrJ[PjH\CSL(-----0`غ%zԅT*ݼy{AH#B' sNff&n-c Znn-bkHPrHZ@p]:z3ݻT%`e^ln!֭[l6b^D"7oKmp -N,d?AbG\C7o=z9EQ tCCePߧ~[AuRSzxx֢f$ bjjz%r/r'Ex<^~~\s|T}UUURFnJ͍ /^022b?[HD[Jhi崍T*MOO vqqTӲo,--]\\U_pQeڵUUUK.E'7o痝-333CCCisZYY=zHVLf\ChH$t=+ң: q !qqq0m4B:;wl6qkQ?Rtҥ`ll[B 9Gsp86&u_"""zammNJ$ggg###//'NdݴiZ@"PRRvuuEr{VG-t MMM[ (**b'@߾} 2ՓT*DӧqiIfffpp0B\.'&&hh榦&&&|.< K墣 <'NH2A L<p  Z4Ho}A,GGG!a|>ݻEuE޽/"::u|*/:Jyӎ;p !'O///B:HZZɼ~:n-)ǏB aÆƭS]] 6L nCOf_jkk|M@P#C vO彩hKa'_ƍSG@P/eeeE 1|pX|UÎꫯPJ~Fm=|N )))>>>1p@2n/}5^,X@|r&Mjnn>z(n-gРA֭(j޼yh۷ҥK+ڸqT*]h]q-ZH*nܸ_.x<EQTssU\ihhh]]ݽ{TfRO>ohh?~ݻw`aSSSTTնmI@haaallWRR·ŠEݻQ!Cܿ_8p+tgRPPfdKjOOOB:X,:t(,\{n4_hDNNp8ȚQPPpX,VNNFf_6cnݺpbbbܹVRRbllrw_~ASRR v/^dgg?y$//%gff ϟSL(-----0`@TT3;E I:zԩW9̙3gׯ_}rӲG⢊}믿nnn6mZ޽qk!2vvv?fm%yyy(T 'N<|ÇΎY =ݾ;/.((JE EwÇ'%%ݻwѢE_nPVP|[Kꫯ:*)) NLLLwr4ٳ;6~zTBA-շ &؞^a0=zիٳgccc{٫W/`0[l377H$Z`{' NNNl6Ya0r]>}:unݺ)׺L[FF\+I$իWښ B%Oێ^XUUrQcX&}}q_F)))_p 477?|%>o߾o3QQQeeeﾻdɒꈈtᘚ{9++Ǐ_555IRDܴ,ѡh`|[6mlܸB寿KKzZöm޾?x0u_ճ& dΝk֬i%u_(uh;Lee%ϟ?gB:9z(n!A"0gZJJJ 0}wxU!Q]]ݯ_v]qE,9ƌبQ[zMcc1c`ȑvZJJ h ab„ 'O$ZʵkЊƬYEk׮\Enr@@H$Ҵ9}D$F~íХ255e2-*5 лwoou ֧9M@CYweӧ͛7\ z-:1[o]p}H:udh@ԩSRw}[Xdߢ"۴o\|رcaaab"vюvx<K]\p޽{q !˗/!AtiخGZa`DFFVWWkʹR]]` 6L V)P ++:ZqkQ'('d^qk6o߶6,Uq_;ǫO#Ah Ѩzϗ-E{.ϧBttA,X"""p !3ww&O?11155577W\zAmmmnnnjjjbb"G+hbBBBUJUU9PM@>OD)z-ڸq-[} ܦrE2(ھ}{```(oQ H oooKKKm9;(((...==]N"J_y8{,n-¿طo35#JǍ3f>ի?^(n~w"BCCiw0*** gٲet}Ǟrs)))555QQQ3gΤ(jɒ%w(jΝ&&&hî].]Hmuuutt#?˗/oX)z왗WXXسgOkmJnSVFQԋ/lll:DmBA[<ڛ@4555hY>}!++w=m>ŋG{{'OGPH${zuB.KQԅ ) Xbɓ)1cŋӧ|AAݻUXX=ĉcǢcNܦ"-X,fٝW4H`` l޼Ag> {nrh c=z˗/eEO,~]"V7o=z4 zWWWPhmm]UUգGP:&JG:2 4j(q#G&MZ*^xN*Qb/b(AINN.eR `鸵`#;;5jTMM }}vv6:FNKTq_?^UU%Jkjjmݺոٳ޽{SWWgddDQTII ͖a-ګrojӦMkݬJx]Bd޽d(@5ƌ⒗w5Z طo_O<[ݯ]|ƍ'"󄆆FEEFDDvφcjj{ccc}||766_yWNNN#G`ɿH$*//Ͻѣ(fΜ9ZnS*رc֭C';D*z:D"䵨qWv>3={6n!믿h O+++NϾnə?U.{2))͍fڵ'OeGw3"JztСC):wѣw>y䜜/ȶv[m,w3f̸>(QbA[%ő#GfϞ=dȐ4Zwww33"jHPiӦ>}l<|ܸqCr nG>}`#A//-@PF>}|MP?֢~ 7|ciiy̙NNN׮]۷ݻwǏ[Amfn޼immUaA1 </K㖃 GGk׮yxx%a@AS/s533í@hӧwƍٸh>_QQpBZpbooڵBP}!cǎ1EB 9]|!Z4_mee?9r+55 A@P7x=??իhI&UVVʦ!P}!+W丸B xwpx_s x9GA7! Amܹ.\bpk!9sLٳgqk_}|G/Ӌ/̛7}8997SϞ=ު&KHj`lٲܜ766O>:ujnLLLKKK NNN֏f=zիٳgccc{٫W+WdնfffaaaBza0fe\xӓḸL-PsϞ=...^@ΝknnޫW8>sYBP{H$3f̰@h7fϞ==zppk1_ӢO?2eJDDDiiiiinJKKknnVެ$??ͳf*))y͛-[sΝcc+W?yemZƜ9s֯__[[{۷oG%:SΟ?\n]YYY^^SRR:b}A k?pk!:B}}%_h}2?? q"Dee \.n ]hVQQAQH$=fXsff&:.../SI3YNNN Ϟ=S[,//ϳlt X4fP0ap !:ZRYbn!gԩ'Jqk6u_ѱX,7o=b0t{Ui&fX,d2b[nM2Ɔ9smx;G%XBiF-@8(X,ƭEʅ| n-Fs/UUURdtd/Wc'wE*6pB^ZWv菎ڙ}!/rΝ[n3$$9ŋtҫW;ve˞?[G3g 4//OIZp 477?|0,, Bf- 믿RD"ΰ> =h-"t)P[Ybccw-DoZBR[lA[{$7776je/WcDlddu t~ӦMm6k!رcl6˭oSۡ?644nݺUCn0NTTTx>}C tBggg6ŋ=zYJKKX^^wޮ+V@:0 xDohh# pppillqk8(3rn瑢_z͛%%%UUU(XZZZ[[9889r„ V%3N8qyR(`Csn-?~?ΓÀѮŋk~MMME8NXX͛핷<{l```W#tD"}UUUFFƫ[)++,--ݵkעEp8jt_Q}yƍO<’\)S&NlmmQA+--E/_O?Ś>}u[#%/^k׮m۶֢ N:5}t WWWr4 q_ ݗ؍7b##ٳg/^^ӚD.vyaկ[nըF`ܾ}{ĈvvvFFFhıc&''L*q_ lG@ 6ljY]]O]:226l@ @h-DK;pk,híǎ5'[r񒓓)k$''x<rUʝ6mn!`nn[ѐB XXXL8yMFFիW/^p^yCL>xԨQIIIc333333Z,<ƍvQ'IH."Hs H$% PTTfJKKqk(1o)Hpks_AYYٚ5kv֭7oҥK999Q֬YS^^.ׯ_YYYrrrHH}>=#墆((ҵh*Xj)ڊbuՖE/[a˶zvصVSE BU" h@ Ǵr$x>M&s9'g̙yF&=~x۶m3f>`-J! KMM ޜ)""| HPvv6BGkkĉB2X BDOOz~^^|ɒ%Ҷ`mmmH] &w=|0?j(鱵I$&&%%%QmLYәƍxd^Xk3&<<\"hert F͝;W.F"Ν #SN!bV!4zhr׽a;BôfG_nݪ>?uuu8g„ _~?~\ƆZ3޽{...:Tĉ2 ӎ 9vܗj&fJ`fLfuu5Z` D}wt 17+WD͞=[/5KqĉW\4iRAAʣE]xe۶m/Nǎ۴iAfͪT^+d2Lοѧ355522[tz{{b1w #s_n&3֭[GDrrrB/[d...tk1%nBS ϟ?+ f#19slll/^a\\\aaG|}}5sμylmmmmm͛uPף(11Q}呾Ct󽽽Y,;w t6)bĉRRv)#;pss;qĬY=ӧOwrrjnnQƁLKKk}}=^T1o|p%!!!t!u}|P($TÀT&yFFccѣGLfjj˕+WB7;; .tII333oܸ!$͛ׯ_DJQ矓fΜ= LNNJRtʔ))))ڒ***D"X,_p>IuE;w-4x{{GGG+,FVVBke8@;M㑝F X, wyoZ=: IҩGI*z?1x X0 B8qn!PXX`0lllMmςйޯs_Odff[[[0t]`B喗kH4.$lllȠ[Ha9TbbbN<ҭCCClvii {*oߞ?~KK ?tмyVJIIIBBB}}=-..ָ5L?ڵk+>嘆iӦ]v-((>$$$%%>h=%%%$$>((ڵk:e<PBL&t Y ; DT:;;#\BDj @}}}!kkk@pMEDn޼) P3^f`D޽;))/[ m\pa֥ӧO[)ܱcw}7Iraaa|>999𦳳oy]___PPpdFGGo߾}ԩ0 sݻw'Oloo4zhƆ >3f\v QN455mݺoQ(tkq ϯ|2ZhW^INNKHHu:YQVMr PSSݝܼ3-[v pݻwqZtuu!k48BbtH#斓(,<}\\\q湦f[nEZn!s!nJ`anE#b2L& 6/=jmmuppdA0LR#{k&O(Ι3FaڵW^g&~zdd |ӧ)ڎm*1f̘ϕ+WL&*--[ 0RsIJJ"!vȑ#GDDD888 x<^mm->J,x<҂X,0o_x+}K/_[Y,VOON?zhv0<&wٝN[ ̚5kӦMJ2!!A.-龬]6))ZTVVV|@W_}ťH丸8r 6444%''̞6mkk[WWf:{ig|` !wƵkRy*˖-{w[[[[ZZ Q;v<󕕕iiitkFxF==xhTR233ݭO ,ƴ Bmmu+WĔ>f7E /@!}ܫ gDDDp8($x.`TԱRT`ʄL+ڠ3`ecӧOꊈ˳[шF./]ٳ$fJ嫯* Ν[PPfMbrQ(aaa/^ t5g46**jرFZpT*(L??/ɯ Ξ7))~͚5~JmS #'' :JRmٲi]]]8_.ZL8q޽:חr+ k"3@~"Wj0!JrŊ]]]s=}4.cccssvuu[J$fB!t|>}4 YYYt˱x~u_(ngg'EdT*JLb:ovZZZGGǥKJKKov[655ݿn۶m̿~H$*33ƍ"H"l޼o߾D H$jꚟ*y oa)dAg4 СCx]!p!++JX8?@Bj#/nnn999gX8L|~}}v}gEgE $Q?9:9vB(** ^h$=uB†!n:X0}={6B5SOOͶ[f EIu~gBߏÁ#pǯ|JJJKKT*MNNOa !wƵk>k&%%UWW+xi&RzW\aÆ6>"C*w lΓ|'|R/_Ji_tqqYbJOf SN!6mdBa0x{[s)mܺu !F{{{X,OOσ"F_?b pΝ;&zzz{zz4 jaJH$1c~3RTց'O$&$$:99ٳG0B科zmԓBNNN{#!ի}C}!Yq8 #uwwۣGxJ~rmmm:;;q>B>f̘QVV|>d!_{1c؄K$Bk'ݻ##__17x!c¡`o7xcWDQQB($$XD ,x"id!{np\.tBO!ծwLJPO]^^ndp&߿_2)>U'ST+W ϟ?cIo./]DS(..ڢZ^=Ć&>Ettd`8`80sxVGRIOO IBB^$OקP(p`PDDDssD" DBqqq---G}NZRRޞ|r2jYˌ3UEEE/"E-tm1A:u9s 6ر8wŋcfϖ"Dkk+NwuuKV WM Xi$6R0[<+j˗ggg'>A\H8">(\[ ]Knnn\\Ylف(j@ڳg͛7|>_P;|. BYD_|g ?a`y#M e$6Q x*Ŧm<==Bu'ON2Ν;8!3@(\^Ǐ=z (j@ںu!9rDR #1g1;::p,їg ?a`ySx&:::B:c4!>cL&tSNݫfϞW_Z hⴁ(\]_-111999Ե Dٳ]|y6Y5% H"224~ rXKߙ7z{{b1~ ޽Kgm\X4O\___pp0BhܹrME.ϝ;!(0I{(**zJR ī#B-H$x͛HT{=v4%udmYNܹsEEEԵ 666eff>?fͺx櫛Xj.kŊ8>EVV570F0WSS4#""z{{ͯ FDD 8/!Ojëw.\ vލW$$$A EzW:kD|e%YÇ'Oâ9su_Թs玧 }1+۷ϟҲ`|K,),,rӦM[`a:8f*SW.D"с9/۷lقc'ese ܱcw}raaa|>999fىk9s!d2o>uT5 <- p_+cx!Ц[~7 bP5C6L`8Ojuus8ڵkJfM(C.+ͻy&]J6**jرFZpT*.`0v8@ d~NN^I`0|||H' oor``Jڲe BEu:d\.srr2t`xGIT7))I禃l>d2 ůژ1clll% A>>>x0F ܹ{A kdf㴵uwwN֭۱cݻyBC>Ak+`;zVSN-))nooOIIY|Nxg>̏kii!?1c rᢢ_|v?y$!!a:q).{7lذc\ܹs/wR' CCRRR"""$IssshhhjjCԻ7}؆ >3 80jԨ/ nܸQ?/b򽽽Ǐkll?~}WBC9yhjj0aJ(4|_.{CfSSz1 rss}-[vZ4^QQ<O={ܼy@X Aη~l `L8;;WUUݻwu޽CagϞ%""">cbb~1ε8A L4!>>q2BycX+`̙3BW^(# ̙7C,T*qZǏ?zA&QԢab1L&ieeE!k֭sJssU̙3)N@//L&SgFq>ӳQ&7C߿?gΜ|>ܸqٳŋ:t=h"mZAq~G_G,/QQQcǎQquu=qL& Wu P}quu%5DLLLNNNvvv||>>{yꁥAAA/_^z5cǎ! T/:_(P ߳gOHHAvZp!L4I{VGgg5AD#25jnn(/vgUBݗ{"EX}ˢE$ yf2_N;w߿w222߿WQQAҮ/335kŋ)N@ @ݻ @/u=Mjjjdd${H>oݻ ػwjmҥx̢E.^Ҳm۶^z }\R@ طoM}xRrssǏ/W(`˭[Bnnne󽽽Y,'^*Sݻ񺞄 pBR|~Zv܉#œfff[[[s88p3ErPa0˲0zO_m [_~bWV^__֭S<z`YbYsjjjLX,vqqK[ ]n2^^^*޽{7)V(YYY6b B RI  Ett4.`-XF^ӧ#Ο??o裏pfdddrrT*JSLIII!_~]$)Jb>##cŊ_~HMMfff޸qC$I$͛7ߦŴeiii.]*--n#-***11gn߾lpxzz trW^-5XDիWsl. ===50dLAjt囚t(# z{{L&pwwfGn 77d d>ib"66db\.W |W^"訩z~+\.nɌ%90T*q쿅B9s8/! CLX,&d2(X둑&LOn!?2L2dLcccBB0^Jfly0iq}PUUB|>kXX}GG=Kc !tܮ^ꪭGݾH~@C|C~.\ O (+++** D&Y{{{GGGKi&<)$99y8fխYF߱fڵIIIJ2>>;8854 EJ2^g||MZZZi1]4`0{SNOmmmo 0V>$# p_Hp_|Q;K^#Gp8@k׮g^p}窫qh8}L<$..̌5kVcccCC̙3-[}`CCCppm@ 00GTOOz~^^?LĒ%K:mںېݻLĻ{a2ԨQ[[[mOڞD;;;;;$2^0B(;;ݭBxӧOgff7ybk6fpD]@ q`s4֝;wN>/?M<!tՅ j/~ǵO8`0B!~w4{ioookk۽{v-ںukSSmF~H$R*D"XbD"_222RSS񷑑xק)She$2q\M`A!T]]mkᄆ޹s̷|2Yd*Jm `ҤI񍍍Zre~~'O4,aMMM:uigg窪*{3YFXУGUO \v]FRSS0A0909prrBIRSďQ?:88<~XpΝ;&LW˗_yP8k,|@rJL&ɖ/_@-X"xyyᴷ4izq!lll?ӫ:fpZ[[Xd0D{`:zI{vÇ;99ݸq?ENr5m?QbccC8}=mQ3z LގlFm ǎCEEE }̞=!TRRbz]re[l),,T(555Ve/^u׮]v8vئM5kVee%A SfeeڵߟZU\\\JJJKKT*MNNV_Ll[[ۺ5k֐M em#[n!LbM߳K=?//׿l9ϙ3n&>zW;w̛7v޼ywޥ֣(11Q}呾Ct󽽽Y,'^w9f<[no  01qDTZ^^>m4z6m˕H$ #Feggӭ_h] `&bs=d2kjj\]]蠱KRݻwۛn9}Lxyy b׮]tktk.B 0ā?'?~޼yt~Dž BBBBSN[P/)S'$$d2+WC}(W_}U(Ν;fӭ@ ",,ŋ.]bXt+ F,O>+"""//GB./]ٳ f<xyyO\.ٳK,t+%K={ B]Kh߿g3@ .rb'X@׮]  IIIf=%%eAAA׮],}6<==Bazz:r@$ѭk8#V^rY,VzzP([<0uܹsɓ'U*BFFF|7#NT*H Μ9҂b2۷o5Ҁ C[~7 n-6L8x[IENDB`./gnutls-2.8.1-i686/usr/share/info/gnutls-extensions_st.png0000644000000000000000000001341011271476021022156 0ustar rootrootPNG  IHDRje0\sBITO pHYsIDATx_Lﲀ,KZ46Q[@P`EqqiD Z7F*1iTAbmյ-#] ILL4|cVVVqq1q%%%YYY_jϨRPP0cƌУGܹsgdddxxxaa!o޹s;w[t+R}sl,..j:b`0\rEjHd]ի 5kٳgF0 $dXz}pp^tOպxbF駟C'd"G4CǾ:>^jȩN?>{ůzu ( 6.޽;99ٳgIII{qhq߾}n v#bй=vҞ={Һm6иbŊ{(# `=N$ghhh;--M0h޽K.E Kh=UO<^V+>|8==СCNW(~oM$[YYqhYl];qZX tjHdGsAZj8S9S=**ZЁA/FʈDm@WTPddԜfh4,.9W{#"goZQQQt:iI Υ-[Bfs^^SodͿjZVy !ߗfŐZIM07,,U[rWZt?vH]]ݚ5kO>~4 $ 9bɕ"CaHH  (=|oVK^tI(G0 Id' w̙v]ڞyfׯ_xbhwN ImjǏ顗IAC.NL&SDDK%)"]]]䩁ON>JAd3DRay!n(**JSpu%0N$go9vOZ\r>2fgg8p=ڼy3X___VVvƍ۷o;O4֭[,Y mڴiǎVg>{,$$oJ n8q`08uLɵrʂv)zGJS[[+\oC}x,**텅Bntt("?%JYr!~EEEFiI % .Mz~͛Ǐ?cƌRh4/--5ǎ?~SR۵Zĉ?.B~وmUUUt:V{iB}q\ww0|n Ν8_~Pl]2)))AAA)))‡?EGAgHEEEXXhdD:TGRggzҤI/NKI%:أD,9D5͢EuttH'-8MbϿ{vDz{{gϞS,_J;2p@0`32_evڕ_\\\WWWYY;(-B}c/g]_2jSLpW I{ZJ֬Y/ڵwբD,돌3" H{{{\\Ç}oA(d̙V*++S;lEU*UIIIdddTTTuu5{gggrrrhh֌VGC1L ,)--;߿vZFdX 6\tҗnR#̿Æk%(~f_{]AYx"!;<11A$ϒ%&:0m5"y_R3"\=t_SS&+"=C Ρ Iq ̿^Ab~$gg]:to63&,Rtriv&."%0z 8-w`z}}}cg}c@._,:._ƪ¹T;/m۶nݚH9 /W!b@EEEVV]AwCJwf_{r^d{@"""[ Mƚ'+<ZV^7XAD|TQW`/  JADFCey̙3aaag~~~nn?tIXC:W}\ ܴiL&ӼynOOܹso߾=eʔaT;o)asjK9wܺu0"g6 !^Џ ILLg4++㸒,C,j^:Yf={bR\\ju:]UU!=-F9g"r@@C;w /,,tl0\"5$.a@@Itb`^͌~ ̟kt ]#ѡc_rb .0n8B J4ŋFPb~-18v朜B?C2=XO:UXXˢ'O:*XV䫴*X-%СCݻWhllr= ${ݻw'''?{,))iϞ=N۷/99{``az8C%!tn]ΐ':W`Z4CNKKܻwҥKY\yT-WvBN8,h@EWrG-0ϤM tj/{@@IbZVNsꧨ{TTbZ ^ЁLW9CrJXtz4cF*SI-[Bfs^^L0Dž+Wr}jⰠ!0`\ WڨV@:na(^l1t,RyxRL)#1RB.!Wu (0-缴>(Y,._Jyyy7ofX4KA$VyC?ӧ777:E!W'P()JN 2R_u0A#x7=..Çᾷ Vd 2sUV)`6"*$222**ҽ399944BckkkFFFHHHFFFkk!IL Ĕҝwo_vFIJJX,` φ .]DKr7)aGxxr»2%%%NCD=C`wPybbbCCH%KMuaݗ1Dj$cq^&--M8h$W D{@@CCCAAA,,:)wtHώ糗;8l6 gL8{ 8ɓ'j/M\DK` n_pZfzF7j \|Yt8%\ʿ5OO/xxr۶mۺukRRc#нh_{@YYYFo|JRA`e0CJw<_{r^d{@5"""[ M "+<ZV^7XAD|TQW`/  JAD0"(_Ae  A/ 2`EQ̿   xy /IENDB`./gnutls-2.8.1-i686/usr/share/info/gnutls-internals.png0000644000000000000000000006301511271476021021256 0ustar rootrootPNG  IHDRysBITO pHYs IDATxw@S_I{-.pSQNRuTZmZ]ZjV]**(*"HBqj$Iǽ/!y9C`x1 m#"!eT*\.VVVbs])@{5o dee痔WVVVTTTUU׷ǧCkPC6iiiYYYwm X,E"f8rB!ju өS__nݺ>ha D1 z…[n4|}}}||UKW&TTTTTTTVV޽{7??8+++??_wرo߾AAAaaa=znӻ`搵&2..رcIIIgϞU*ڏ`6ü:wI 奥޽{ƍׯ_oACѣѣ $H8+ZT*wťj BCCtֵkװ0l aSSS/^yT  0`?xDD.KRii;89Ejmm>hР={FGGpה$$$;w.!!!))I3RD111|xTT5\.?rȱc86ZYYEGG?sǏH(ꪪ*\.d2JR**wP(doֶ=Ξ!k;vظq#{D"=z ƍuuƖwޟlopBgggnk0Y%%%׮]ͽ}vffݻw޽[RRbqww  ß5Zs5k$%%Ǜ۷ohhwnLրΟ??{/_xP6lXvmYY;vƍ6#c?LNN>vXBBU*#44G]v С60̥KrrrRSSSRR.]f D3 8pȑ!dA,Ydƍ /"&UZ*Tr7x=山۶mL&cy<^.]ػwA>j:99ɓԼ4"|wqqqa++_~9-- v9XLDo&׵OJr̘1D흟u9-rcE"ouQBRƎ5}|>ˮ kcǎD4g=CF!]&ٓ,4h_\\uQ&*??W^a/ \.(}BҥKy!L''';^" }:;9w3'Fw[j瓒 b%K=i@"DDDнwDdgg2$===,,,??\Wd^yӧO :ݯ*ݫJD6lRdn|ѡCt봴:h:ܸqލ_SS֮]ǣ_r:??ã֌3x<Nق騮 !A8h DYYYD6qpp "}mh\\\~CVPP.MED;w# SNgϞdO*hӮ]=ڧO??={憆xzz6OHki΁mhѢk׮u-..ʪG;tP^bq.]~TZ PdIExGG?o5~]䛷_M8on!]ZWzp\~m۶2Z.:zzzj}}={)rFF\BDBP/19sСCr<##cƌm9#no7.D߱NNNzPVV&H|͛7~B.?~q-\0:: **jѢEƍ+((`ۗ,Y¶2֭[SLi>k}T\~䰣/ؠʕ+nܸQ__ʕSa槟~"=zhm7w\"?^SOmݺq;}gM]{(f̘ammfzصD_D^z0.u|k-__vaaaDhƇՏyѐ!Cٳgncccmm=x{횟uȳfҾ>bC1c}߾};w 7nl>k.]ݻ>|m\bnlMRZ7sζ9De˖ @/s/^\]]5NY>1bĝ;w*++g̘Iŋ70??D4q;wԼӴ7xv vb=\;wdٳf{N kn4;Z(**b=STrn{\Aj"H$ZLImDϦ=>TҺF(j<{t^6|2uE4&d|sNVϘ1nݺu9(**""}E ~KW v%ǶkG5{LԦϜ93x`68'111::W]effO<^:d=x'~G"1cի@(ʘ[J?Ss5眜$Iiif6}h7//,RɮV5l2ѭ[ڿ&M4ƿo߾%RWWqYӦM۶mP(\tȑ#ٙ%h$oo}?~\Wp@ 0`0,Yt?SPܼys̙:͝;wJ255uڴili|͢7xNA7PWWgee%J̙ӸԩS^P(jJjnjvL2oۏ'O:;;X,^z5i \dv˕zi&"ҥ.#8p@hhc=9-tS͘1C*k_TjbK#5_輾- ؍u!k "???22}Wi4*j>>>D,XP[[uQd2///"z7n?BրӡC0`@ll,Ƹ-P(6oܹsgٳ . !|>?p׵+'"GG\kytZê]f uq֭Y){/cG-섭H$ھ};׵jJ(_\&Zc7VVO>}ܹ'O ̌>>;v0U*͛7\݇ㅄsڏ"k;y{GD`ѯqOgé[vݻϝ;GD<=A֚4Bw…[n{w4#}|||||<===<<]]]]\\ʊ⒒v csСڧf@ւt'|}v\NDRtÇ9rd)moݺR[oxbGGG3d9QՉoNOOOOOdzZ[[KRDbee%>|JRjZPrBQSSS[[[[[;v-00C}mZ(UUU}>̶gyf̘1xzڵk:x`\\H2>|̙3'O@֚=Ju휜܂+++}]x<';h`Əo߾;js 7n\>}"""N?SRR;6x!CJ,[YYY[[ذ}!XYYܿ޽رciiiiiilWW׈kW&''_z566=ekkK/IReQٱcǾ}rQ߼y͛Ǟ$JHH8qD\\\qq޽{vsppѣGHHH@@@׮]CCC.,33Ν;/_xbvvvrrr|}}3bĈÇsU@p燇/Zas%%%%''9s"!!!!!A[܂\]];t,򒒒۩SȾ}5 70!</00000P{YYYrr rrr222]Ŧ`rttD* @  jRT( B&VWWWUU=BPصkN:DFF6s999 6lذaڍw+\&>/;ߋZQa˫e2\.ST*꣏>?/^<~xPheeeee%Hmmm|hΝէO> c״i&c=a@u `lmZ Y `XZB .6mZPPׅXd-a{ 9d/g͚u AU\\͛333.Y `XZBO>:tu!Y `AO8q] ,X-d-QaZ 9dBk,`ZN`B@ZB ؿZ k9, Z d-QaZ 9dBk,`ZN`B@ZB ؿZ k9,c\y]vq]_kFk-搁3ypZY `XZB ؿZ k99dY `Tؿ!k Y `XZB`ZN k,ֲ0*_kFk-VRRR***u0`4Z=xN>^X[[똠/ĉy]vq] I&ڵkΝ'N08G, Z d-QaZ 5Q|>W^B&J"$%%q]0,d-a!k Y `XZsR^^s '''7#FY `lG(ZCCCLcvBDd޽{cO=vs0,d-a!k Y `jkkbqSq)ufCP7 `~DaZvYk-@0,d-a!k Fkkk\.Z Y `6.MZNNNNIIh+kMh700,d-a!k Y `XZkC0ؿL߭M'N(Of*++4iҙ3g8-M#>fYkB,Yo:tC]V\iCHZCD{mО={4r#>g0a"##O<?xڵk]vuuuj777Bz_UUո=11qڵ7u~ѣ^GB.ذv#`.ؽpm JOOOHH2di IDAT2,""UٳL&&&N6q{``IRG_~v|$ ִĬYf޽YB,X` ԩSjۉhz3G#ٿ @Sm?{q@@EPZ˖-#(00^#`ؐŵQe/^d/++֭[`` Y :tٳtST+V }jI# m7o:99Ž:o޼? ꩧ~ݻ1[-gg^{f/遁:අ# s <<쳭}c[,DJD־DhURRbooODgΜATo؏D^QHdm|Htڵʇy^hd2;;;vFZmW-Y[|$Ο?oDFF~̽uȭеkɓ'o۶mÆ 6lhgVV[,bx̘1;v "JEDǏg2꼼kk3 ؿ?;%"}4^13oPff#\~ƍΝ;rGsO?ϫaA4 З7&h###Vz0Z;w~ y'O~hΜ96mfoyd2,..9R{#LLL[`j̧fimmm8&X|ʕ+=00ի]B\___X\TTdkkƣ8p`֬YFlllR*hr}}ԩS{th0e\VD(ˍS6fh`A-ƍkq4#Zb(6b10T*O믿Z[[#n}ywyG3]jB6l… ;vppp=ztB 6m*..&gy7.#rʧ~ E5#&&׈ih#JkjjR<CSk_:Sqڵ"%vhmllhٲeF{jh54C[2Gmĸp&kM3hF$ch6::?\^lˏHg2ZCbC5Sjd4H^zѢE-Ź;wΛ78::z׮] ())7oގ;B-[:uꔓcZ]Fʠ Eݙ3g^uc+<\n&;`VVV+8ѲC+m\RmhԀΕ00kMyDٳ F\Dxb&.>o>ZMMD"m-dr|_|·ϟ߸],?6̘W!jC[2Am-Zީohhi kjP8o޼-~,n,FvΝ55- R7ʈoqV@ @X&555AAAj~!=\uu[ou!-U]]}岲2-P(|dL+kJ̙35޼y͛ܖr&~lc?n,i-)):uΝ;E"yMɚ~͛Æ Cyyy 4s\bBLW$H$bWTCHHH0 0/O?O?uuLkL {#N@sZ{49dB@n۶o}6mT^^nL OAI&999I$A֒>\`FҦN޽{W?|Μ9F!k h`ELQQQlܸ}VZuXd}^UUU||Z]]ȏhoD4p 6_z%"Zr%ץq Y׶Y'|ĉ2xaaa-3wٳggdd(iӦSNzBP*FS.X7ޘ:u^q+ 459chѣGKҳgVVV0)9L uߧqmNNK/8mڴi+Wد=<<د֮]}5IOOgNKKСCqq –kOٻw+W_hԩc=]F ͛1wf~ C>}zdd$U聛[DDD||5kn޼s]IhoY}K+0ﾛ(###osh;F׭[e˖Ǐo޼O?5ӨbŊ^{#ɓ'z[N빮P<<<.@oƏf-=S98׃Z5 sȖs`4-h\=_7:uٳ' >rL!s]}r]?~K$ ׵ ZBkq]H$'Np]6ZDs]֣GΝ;;BLe-_}}իWoܸQTTSQQQZZZ\\\[[[SSSUUT*r9ٙ$D"wuuussqvvԩ+/.##TTT$%%_t)99.VQ( ]!O>]t֭[PPرcbq_ AXk׮EEEӀ={\p᯿JKKc\_P$8;;{yy;;; P(d2YmmmmmmeeeiiiEEEQQݻw srrܹs%J=zt=22W^ 0[`0ZuڵaÆ5 ,ɓ';vho.JCCCCCCºto[qqqfffJJJbb7N:u˗/ ۿ⋓'O^Ȍ k,vٳG*r]\.O׮]J"9rĈ?x>}䓫k~4[^vĉGݷo_eeׯ_3gΜ9sjkZhHVs]֒.]tƍJb'MO !!!!!!seСCǏߺukNN?p֬Y 9u)))֭#"kCAZ؀u)!Cl۶o9r67f̘>(??ȑ#'OV*_~e@@Y@})))#F(..^p!A h-Z^`q r)S<o۷o/))yr%Kƍg[ Fv"?%[pg}&V\yYvbsnݺ?!666**%&Y DZˠP(뇠L'NXvH$:vؿo3Wȑ#/_W_q]C<mYYYNN'OQ}}}}}=2_}s]~'Oްaëu9AZ: Z"Zdɒ%KzV&r!%*ẒBZ,vF x<^zzR4kX['OPauu=Nc.)J_qq᪰Va&77Ak؛h/^اOkѧ[n1 T* )g?8ܳ"源lȑD4a'''"\eczaΝ 3q"=QFr]pё:w\WWu-zVnjæXMM Ɩk,ݻ8:6uwӑ#`uߏ\]"Hbcc1dvvvDt"B1a„u^&:ƍ㺊v+99A C{Pm-9BO=@;S KdggҹsO?_6ܹsӦMȰg7ຢz};l^~!21u1D Ko1SpT@QZZڈ#aaa۶mS*\:6lu떞nmmM&?lrZX|hʁS"C۷}w>|?դY^Ƶ,T_mݺuѢE/^|g=<*+ڄ"J0L >kd-6mڿ}A```pp_PPPHH{[2(''YYYo>w<gϞǏ6lH$j5nݢUh-ՔΚjQz:!kx+VP(O>uTJJJJJJFFFZZZZZZonnnR^(D"+++ajZdL3CBBifcN^QegIagW]U]Y`wЅ ŋx:tP?JիW޽uƍ{_.שS'ooΝ;իޟm~X"z k蒽=!kۙݻׂ ={lR,------..R* |>/$D"wuu2smmjzړ'(c{֭a48Y:s Y  ݹ.< k[H[E?_4sfWE5Rс4cZ!KS3MJ &m;oTڻs:> ЫRyEЧm 8xbbbR׿:d- Ƶwt- v cs'd$BA;ZMii0RQEI$ZhdmiɒJ%ЩSD׶wڱ@@<ZsZJJtWTPf&/uhUlUi e*+;k1Ud- 4o XFcǎMMM5b}`,Zh3!7'ᣚ4Ξ={ɲ2'''M?Xo+W/-BD/DR۷?&+k_c6 &LBС̠A?[~5C8;3*0u]v:;u'b5K=5ؿ=HDO{7=$7?NwED̬Y5do ~kll G b5!kF&gϧH )"""h\Fxg| ߚE|1߷o_k(47!ZK`F\2;; x(kq"{[9իdmM}pS _m >L=u'++nJc2q- dmI r k͐:}r #GZ6C6rM %%PH|̕ smֱcDDOM Mqg1]lO?mPڦ5@V*Y0 &|ܖmZ ݝL#V!kP]MϓPȄ\ k@ԷZ 6C623Zbk\ k8kҨS'nJN`\ mե.\ !,&- YKB)ԯ_ YH3'kqaB@!kit*IԷ/7%Wx}7ҭ[@=zpWp Zh/ܹs{ POҽ_USSӯ_? ʕ+uuu&~3ٓ@U]=d-&M"ڠϢ=}M2E`ڿN dCB{1yd>ȑٳgT*=˨QR}? |v͚5k׮%ӧYY i8_ 텷ۧzbcc3rHZ\\\ԵkWC>>ׯ ?9s,zgYj&~ӤVS~d'о 4(%%W(|I@@9sN8fp'Ԝ:rrrE:udɒQF?~ڴiz| A'24Y 펿?4bĈM6 :cɒ%h{躹3m<0/^\no޽?^z=zám<ޥ}Ý v*44v?/dffYf͚5ᑑ ~GGGir}=܀xr^`sёSWGNNTRI 98pZp-+cG|}c=nܹZ riiifffZZڵ{2225F3j(G'jNjI.^+XNǏ_x͛7oܿP(С=...RT"bC(;ChdBւ6mCJJJee+K+j0ٯ/^j,5koݢlrqi=-mXD\\܇~%SYYOK=>ܳgO++;5ȻGrss>ݻw5=+WWWww}=Z>/eff1B"1"޽욧֮AgO"zwU8e|R68YNI&Z0}YhQFFvҥK=<9iҤ˗/+rDLNÇd2٧~:|Gro֒%KH&AOggkk׮dk׮jΗ]2E)6!b"&*$%%1DL^ ?EM:ٳ'<<'`f666}sBGGiQgLܹsg"hwT|6lѣG-[8;;;99[G666F=hRtyyy2uKzľdSۛ(5|5ڰVe˸ LLRC{Ӆ #=X^\)Ro_j8Z Zѝ@iiO^^@;Vp²VV&sϧ9( LƵǭt=KdzU*(sH.=ёhgjYSAHD..$SI RYs[)Ai;vlMࡄ\`DOd4ZD8x<ޖ-[*++B? 5b䎎O{7BI&9@ @d=X,6Ԏ Sk^Y;ݾ)V ѣGJ%zׯwzzzv:uꭷ޲l8 .]P{Wt_bB`,:gŠadV,={3B+WLMMUu)vRT999r<'-HOO~m|>KNN.***g>ž={nܸ! Y,بH"A&joo犗 9Q~ @<~0ht:7`0t:dĸDt)Z]0p n܈*;@]?!! )3D._rY,͆o8mXNZ6\.n|rv~?\t6`0l6.bx<dr8xr|~lll\\r<GF6g7t>8p!p]@>lrL&\. ppYe0111,>t՚& n ].n=@Ɲq͆_>]1L F) X,HD"QJJT*OKKd6?EeeNG *-Eӂ%OBv|otZVәL&Ft:cK)RT$%%%IR C-@ E-t:i$i2l6lZvl6;N`0v{hwvvvvv>h4LP(T*X,d\.OJJz'6) *@< PkٌQ5}_kCBa P(LJJJNNNJJ B& D"HryOjh4H$"^?57 8jtzZZRT*R4==]P[P$%%dLJ%T*Ո/ j4fFjp qJJJNNNFFF~~Jc˖~w_H$BV+j5MeeessseeebX\\\ffԩSrynnJ={6$q@777:5c JUTTRrssJu\Wf|>hLL̬YM!˩JDFSWWwߩ꺺A( Ν;r6MU1>km[[իWjӧB42jBdN:uΜ9* gF*++}>_֭[`A v eW~WݡbXEEExp$PQQQSS+ƮZjɒ%-d& ec/^vۡxJJK/TTTTXX+D0qƭ[;w~Rx0ZΜ9… bbb-[~)SP!Cݺuʕ+.]  /riiڵkvƫTkIOuRPCVoذ!4o޼sI$<誵h4&&&/Y` >-[f\^YY ӈ0DQ3gYlٹs$LB  \n]]J:#S+NgiiYv .))IV/YtY!(3:t`0̜9ԩSLcZ$T'5'I/wa`0L&=z(O?Eٳg|OSG~om۳g0P\|>_SSA .6 h}) ./Zf/Z=Çbqbbq˹L&ST;v,~+3w|[z} F|Plw===b"l6+PI /^ MC(t:NACm&ԺuVEENr Bh;v0LoFhήݻwo߾G^{>p\~͛-~qqqh˭[Ν;bl۶mW?DL䫯B-++Gw!JM&Syy֭[I \.B`0PYyB'N04t7v\L&I`L&۽{w}} ===$I$&&H$nDWwۄ''^$/`RR^'Il6DǦ4۷!TVVFu"-ɓdJa&bpBVVAVUUZJ&qÇ $IPUC_}cNz^$y^d0 hOMKK F>Ƅh@!kX(dtb>̙3Ν:1$cǎm޼y``Nܹs׮]tƫh1 {666䴵gggQX6x<իN$ڹ\#GL2'?@AAAKKo[(iQ y޽k׮)ʆ p8zcA[DWGG~3@i&|t͛oNKK:5Ecȃ$yխ[jF[bŦMJKKCד0/>|/đ{P`DDњz}СgAN_xo/P;wѣׯ_ol ^}-[ Tg1cbfӗ.]:<ΖFoܸ^Φ:Aĉ~-h򲲲իWxs D"ц f̘|rDBm޽_Z,d0_yXLmg~oɓ#WD.IDAT*EEE͛={v~~> FIwܩ600z_d |0ZNV_~ƍ7o !QPPP\\k <}7|S___QQahSN>}znnnFFƬYT*T_0I---խ xp EEEYYY%%%/H$$U@v^_QQh*++ۛ8FS* "77wSLΖP'$jukkksss}}}GGGWWנh4ڼyr3T*UYYY2k $Ij4;wh4{566!P(d2YFFɓe2YjjjbbԩSQ$I666vvvvww777k4VjnL233O?yd< $YSS뛛u:]}}}KKKGGǣOMMMJJdRTTDT0,KOOOwwdjkk4 :6222MP(222 'Ed]]hloojooojj2xG=N+J@P(&M$bX,NHH$IVk6FcoohX,75L]]]'*biRSSJevv6)v:d2i4Ng0p/t:trRi\\@ D |>x &9 ;E t:ml6[Vg6N`0 vI~BP"$'''&&bL6i$\> ;Pk/nZ{{{ C__߃pgۻd2y<\.bsܘ\ `qqqAX,CİX,:t:`Am_$`05$z~0t>/\.=s\.zl6rQƔbA_w+`&INg8fqX, <s8xr|~ll@ q j-|Z  j-|A/Ʋ#!rIENDB`./gnutls-2.8.1-i686/usr/share/info/gnutls-mod_auth_st.png0000644000000000000000000005207211271476021021566 0ustar rootrootPNG  IHDR=Zz{)sBITO pHYs IDATx}TUי /Y(rI)hh|YdjAB\R%QF#6dV8?k5t&v&cX d$aM1ՅIUD+Q@Ԁgnyf~GϾھ}?s}}}X Q /c111?ϯ_o{zKJJ?䓌'|wc|->{Q{;q، 6߿Ý;v`͜9SQՆ0ƾկj% iӦ0;;>;p7#֮]qFwwC7xC0q X~W=x<(gϞeeee꫌њ2ƾ/),{ꩧO[[[cCCC`7NQd}>wؒ%K'˗k%qqq{O-裏|" 111vѫW?Տ`;!4_+++SH=33S;;Ow{ꩧ+W0~_0V^}z%XNNB98ͦFS2>C__icZӧ_p:ug}6iҤBD[\̙31o|cSNaXX-`Uϟ?-hMQ|k_S1vw'|S'hkLֆ ~=00(ʏcX~~foQ#>n>:]+9u\̙̙{@VEUTT=_тw0acƍZ?Oc]ƘӤsϞ=Laa?:ujll'k&io>7x{Kbք *++ߟ;w'`wԌr n- ? jeZ3ƞ}ׯwuumذWպuo1>OӁ-~:;vg}?aٟ/^|񰿌[| %U[G\H C___zz<kXXHi4vcE+?~Qc.]R]v&Lp=8p@kյxq%$$q7nTok]xQlÇcbbRSS͛73Okkk/tMǏ={3<zRrL>]QtX{{V yӧ|111O<1'l6X[ET@-VX`1x.es,+J n[2-q @U2/Rrr2`n(\jUF$ MH&:/,]~ =ݓe٢p"ӧGd'Ndddр1r"bfo`f:{lJJJDLя n2/|r-2x<<򈠐16iҤŋ۷/"Pxy%&&~{*-[,!!!77vp85UUU'NLJJڹs(mmmNsܸqNM7ըO=ǎ1cF\\mݶg&~NNr]1v*qqq=2$kʟGFIŭn?WexxXsM7?LS G$MHK`hhʕ+ f3\. /2\իׯ_z]޷O!B(--mhhI$ INguu7y9aSdڴiJUUMMMڡu$9''GIIݻoܸQ]]ʟ23w]RR"r$JT<`&oQ۷o~i~?7cR*QƓvʛ-VD [߂@OR*ivʛ-|UVD;;[d'pJo0V)q+ڀVhB@؀ '@`%"=@*(@*̌y% %,eogfV~ +h4e a@1J$,gKo&~N"$ a%6V}Zٸei-y!Ҥ&''mNKMMݴiW~̕CJ|Y 0nAJ~ }j!aUVF6nYZKCFvtEAAAyyyaaሣǭweeeVzᇹ +=9 aI +KƂ.^nnmN|eO>իWՒ'O?~|߾}'|+CJV$(G,%/;D(Jss3cY+1šU{֬Yr]ݻ^ +HX]G +HXJ$Vm%OIXYo%:" -Qh @pL~B X -Vb-Stn)fFb[ &>6> [[Dߊ<-544aÆjkP iʻT[;-o)fw54l,om۶>jiiiooWhۿ$-o-oiȟf/AG,yi#r2[-R%[111hi@ [vBKxфlܲVVV֙3gȏH&n\iv0oI -[iB#o1fqիW_^v0ha„]v~0>&i')H@ [-o@ )R@ .pV@+@ D5u,@VhBXNeOb nc4nEV+jy饗%=II03ZeKKYV4 Eϰ 8}kBo >! b]I0 Z `DcNL~2E$%nVEQZ[['OlSN)r`'s$ &6`#ѡ+ ir\jFe e7c I0H ۻߒOzIfEQ\.1PQ7x#H$xHI)9T܂VpH$?P__{{{x:;;v; & &?>$l܂Ny$?(充}r%SN#pI0=2` $F["M Зz[,\pϞ=˖-! &nI0HA,E$%Einnf577җ߿?))+$$Į#$$A yW_k !p VXW [@`qqw5kDږh'0Kt-6B4PBB=%!@LU2 '`1X ĭQ"=P P2t CUB1zBE1X[֘@^Uk,E1Tܺxb~~~RRҶm۴W^}<Zhjkk:$VO~2iҤoc;w8!!ܹsZ5uP?>q̙{5kɓ?C؇~8eI>쳍7:ݻwtDQk&b9Uͤ[ۏ`trIU^%KpSIwYS`dU`>JJjE ɶ69n8&蓬i-[$&&Λ7O+$x<'9ɹ-[,!!!77W{$vX1rJ-1 Yo\.t }(A uzsI6m***2.'$kp`.**2}Ro1"Y# ʯቓXuZ?biii#&idZz}rڵ1]VV&(T쑿(B27#( e@g)ƍ䗹gllZ7(//石<>5%ϹBONrj/f}b/_;Q~ X?D?x.[nҥKO>[nQ cbbTO>DdkbZZ֧V?$>5G41^|Y+$msO촾Ax,|g,F[())g\O) 2ʼ{Af4K]]]iixFA!)=A ۟&d:98.\P> &why"11qܹ}df4E{{{jjzGJ0#"ƨp*2k[{BK,3g&Aش[n3n`<bˀ[,+eU\^zdP cDeeU"5$QhDȚѣЫ,elll>}zDF9qDFFF  gE}ycSl4[ ܠe_~yZD#Qˈ'{򪪪'&%%ܹS1ڰaCZZZJJJuuZH*;vlƌqqqv۞={$dMr oUQɓ'mN"?wOrUI$ed(Nѣz8;H$)mHԪ$zj YAsFra(NȺN*^g&Kܣ655y<7|l۶>jiiiooWrϚ5kvq~w5$ƻ\.?.ls}j w25IUƟ҄ IDATI*deeܹuppPI5ɁHKJJEq\4ۜD~>4IcDm'#EΌ8WL2RqJOOWD{^s7gg, ʼnfבx1)?XV>}[T7T5{111\͘nF(K.ʺkkk$dMr &''mN"?wA[IG;bbbAߜ4^Q%]p_Mۆܴv6_k[8"::dH~ j uS~/ NCyZqŋ\xQPJKKSk~:s WsҤI7n0155UpF.(((///,,Naj_Tڮ7[oTu Enȭܴv:yLLjș_bͦa4M(wVG?wF5;{^P!'٧os+?W^~v횖TYb|044tʕA! YӔDz[f둟&ɫ@ /--mhh1R2hѢU DY즦&0'B]GB=i|6:{= \nn0a®]BRWUNNNll3z-A! YH"uss3cY+1\}rAk&ɫ@ $F3)mHԪ^=Ԟ'ܾ}Yd0'B]G{SSSAAoW>0Gl XTVV:uj6$N:ˑ6,\p֭ ,!! 2ϟ[ƍ+++kjj#m."F6-66o_(4)JsXr\ݞ1eʔt }+DҥKgϞpx@  0sʅC:::f͚uٔ@P@~B&MZx}"mB)ajkk:$h~…[jΝ+..NHH(..>w@1I8s{E-zÇm}ʬ`tC)!O{VSjn 9ynnnKK W_&ȯ`t0"LKsqȧSyl\ DB9<<'SSOjB9+Ga)'OQ=k,_5AH dԧ(.]ҧvG~5qU!q Vrio``㾅~d @weZ%uS0QKrqȧ{}Ѽ}zDF9qDFFF  N#Var2h7h_^|9v3<Xa0[lILL7ooOXUUĉvܩ(),,/,,j mذ!---%%Z-[lYBBBnnV ;6cƌnmϞ=Br TP?q$XMMnw8 \'?wҟ@5IڜNqNg[[O#Eq:G;' n$rzռ.!Kܡ`ɟGN}=O$1rIxΝInr5n+c+Wx<;- 5<<]TTi&MMM7d_r%//oӦMjm۶}G---jTf &D $@$}17 DaH~*?ɁAk&Z ?yٳ&qHo!M"7N͛󻻻^?u~=:-7n39D$|gnNplݽ1JH^W1Euݮi&9033\)P$P- 640$?w/)Vء!rmÙDnZuOOOWD{^s7mw\#9ȚNM!SߧInr5׮]seeeΰ<&▦? }5111\MRL(dd4F$#!%Hu*PK<ep㒛VNR'l`ܒ?::d(ZnF}%i(Ob"nJH/^ԾD(4$fVV֙3gb1!@Q/@*6M'M_kFT25wAw"M׵,wEMuʶ%7o%Mk4M(wVGR6-7#诟dշQ*!޽DPtVWW߸qw:jիׯ_z]&ńH"y"r 즦&o$cR(4I^J`|iiiCCC$=ۆܴ[-PSL6W^ﯪ>"۴3Zבs}iqv9D$t\z;mc2:{***Ν{Fvϟ??..nS.֭&LصkZH Ed! 9J]]]rr2:>i3N'0$?w}F NI$k%P~|.'n$r  o.rCC/^6#ϽN{)tZnܡCON1%Ʀa@,h+Sf5@ZxN9t|ړZU;tsss[ZZ2E~5L{a]"SC>{WTTe+$l䚇n Ḹ82} VW"@_>[N9t|Yf2Ej >Et><򫉫 [ –SNct|Ǐ-#S\xbT޿#G\.S -ɬZBSC>c=裏 2qB7 + M A#({I ]N9t|d S7n"kooOMMUH $12;;,YdΜ9 ''F_7#d- X -Vq+fLeeU$DIdh &e(*SVh1BӓsĉY5*!]=FTI1!RHZA4R-____RR(:x$Cegg?޷g]`m۸CCCNCI +yIcگL3g0>c\1yn\r$ƭPȺNY35 Cd{Ig&O~L-U ŋ7 Zݴ4M3IuXLH/PdT8bsYh|jkk~[^VVj*[Xf/jC5ܸp8[111]]]zl6;4IuZI+RЌ}6o?@4Rv]RR"t:oܸ;Npׯz׮]rQbB@jYӔjz\.VbVHW?W^UKN+**n֞e˖ڡlNv՗.)'{{%98{EEEZ$sxx8..NLĉ -k}rEqݳfd@F}*r%}jWyW'&zq+l94FL700PXXxqB?2Ņg F;rdA F7)!{G| FWWWWZZ rtt421[)!,d @$)$fW̸cLdɒ9s/ h A}YFߌˀ,+1T( mRYYjժ; 5Qh`#KdM QU0+B!e E'Ndddfݘt 4GV//_A PVVvcG"ψ'oٲ%11q޼yYJcUUU'NLJJڹs(0>>P944aÆjoٲe n[-J[[7nlkkD$1rDxΝInr5n+c+Wx<;A0~~-ϟ?ӳpBEQonڴƍ=ZrʦM'x߱cǪUBq3gh$@|Ic7oOsw'9Ğ={rrr.]M6999gϞp8v L ]s&.ﺵknذg蛓 ,KQ:H֔[zxꩧN&O[o}UUUw}` F_>z!!Wv\q+1T'nkOC-<}4'D+ $8ȁ4SG,$Mb#1:}yg}v۶m A.(L"]uh{70n泌uI q+Zn!/A>NrېvڎƘ.++3p$&&仹 }111\MR TWH.dd4R?Djj*OQ3g0>c\ yn\r$u-d!kFr3rS~/ 8]xQP >i5Μ9+!Օ }!RlO$P(kkk~[^VVj*[F}dyn\rt8-}. h$Q:R{)lZnF_>}o `o2Nw.))Ts:7nxNZz{k׮iI%$R]I^rH%;;I<Ǡ3W'|իjɓ'?o߾ĉKKKFSu<-ZTUU500 6m+_UU}D.3Zבs[Vr4rDrv֢[EEEbbܹs}oh͟?_{Dgpppݺuv}„ vR I%$R],$!RKNNf>'Mb_He䑴O_{5k֨w\j{sFv L ]Iujn߾]چa_|E]~/EHsojj*((^ wh%쳳S+**n֞e˖ڡlNv՗.)'{{%98{EEEZ2S(n{֬Y8LqȨOEQ.]O*j@5;n-ƈ ?[G ĨGᲜTܒ:؁&t98=c>h^^o Sw(tyJKKP<=!1J#(!I ]N9t|d S7n"kooOMMUH $12 0k0w ),Y2gΜ@eA6?! X5?!/K`@`%F"jߞ(ᥗ^JNN@eeU|KuQh`+FȚѣЫ t[2 }5{zzrrrN8\F=U0OsY[c+c/eeen1xIJ cO޲eKbby|2ƪ&NsNEQ<Oaaa|||aaVshhhÆ iii)))ja__߲erssnZxر3fvm{ir&1jjjvhhh=oommUuf>uꔢ(.\֝NѣGŮ#DBf4܊vz^5Ո9^;Vq p/uvv9q9ζ6IdM#诊dgܹ!WvX1rJ#so wwwqOnSSy7cW\۴iZg۶m}QKKK{{(!Jd! 96_ęG O\.ڤrsocoxɓ'gϞ-v%r5 IV ټys~~~wwӔ_8{q!"3}Btc&Kqڽ{wII鬮q?t:իW_^vMKM*!JK@*MMM9EIƤP s\/wsK ٳgٲe\yiiiCC}!W3܊[-P5\L6W^ﯪ>"ۊ3Zבs}qv9DU$t\z;mc0{***Ν{Dvϟ??..n0֭&LصkZH*!Jd! 9J]]]rr2⬟>i3'#$?w}R1[hJ_~[N%r5 IVjn߾]Gㆆa_|EmE#ϽN{)trܡCWEN1IwW^{MQeeS~"NooԩS/_iC,… nݺ`H*Z:)֨gpp;Κ5k"mKqʚHǭ1UetDڢbcc$b34R '9nxWt }+SKt~#*NC0F+ A2sʅC:::f͚uٔ@-ƤI/^o߾H@@ (djkk:$h~…[jΝ+..NHH(..>w@1I8s{ի<@bbb^^㉆H<)3[ڣ)!O{VSCjn 9ynnnKK W_&ȯ`t"CԃӽrT{｢"-[QI} DB9<<'SSOjZ"#唓Oǧ(5kF S\2SQK.S#Vr#(,,<~o39rrV`8nIf D0a&t98=c>h^^o Sw(tyJKKP<=!*p ,sOG 2qn }޿TN)*1Vgɒ%s{[i] }3 ˀ,+eUȷs^zd}pe*++9(R[Qh"eE233Oѣ'NdddD*B;D12F^7AkT//_A "l6??$%%{^'&M曟{9Xgg]w5nܸKgmܸp޽[-$eH)#io7~~!c?2e$s'$ENX4I^K^/ټs޼y(F(`qƫK,\'AE"7iyryEUl۶mN&|0?ebi[EEEһx|MXyyy~~+W6mڤٶmG}ޮfSeCYHBqƻ\.?.ls}jyM0a I XzQL੧b=S?vZş mKHG<|OtXG{C2yݦMɚ*odO;3$z{Zrȧ7Ԟ$d繹---\}_MByF+Yץ+jQQ=2w@]1v ah|4lZ{H!H5@$dqqq25ef Bf}A()7ɞ3$2ԌBJkvg͚ITҥK5ȯ&lzz>|GAM${ܡdJ)IScǏ-KQy9rLY+SBőRRRO(QP`dO;3${>tOoc=yyy/q @$dźR0OO74<͐}p5orE|ܡQ=}P@OoH čHySSS;R;I̮&20w 5 }ϒ%K̙HGD>>l64q;I[v:^&gɒ%MMMT MMMK,_]wXmmW_}%=էOcǎ)V[kjj:vX>}LqܯI A"hÆ xΝ;T%cwl6lDTN%S+O㙵ϧ" _=:dǎ_~ݣ"ܻw_~!6cDBuE@^znkjj\]]ZfE?5k_7WWך+rO4omxg?~XWW788͍ꊨ5uԪ*0]]]+2χ7557.&&4::Q]FQTT4|pUUU+޳.X|yLLA|||7B,_r\mxXX؄ M --mРAΝ;Ǐ 3=k.,YڷoĻ9{{}!,Y5=eT]_ ǏSRRB4ulwܑǎۻw˗SMBpԩFJLLtss:uP(l=(;;!o\mSqq ~tR:0r)S :_& ^Jk׮!xzV ;ʩ-^hn TVV.//3mܽ{&$ 7olnnf-,,vޝ]]] pqqח׹M׍rMpSN<}̌rWXX8p/" r,ݣp(=d=ULUUƍ...EEEQQQTWD(gg碢"7n@g%!ZUU5zk |ڵkG]UU0Սd'F Ǡ7e`p'"悄?x`HxKdB$Y;. '^)OxbTT BH[[u %SSS<@9HxG5﹁bŅZYYCϳ?~[344?~|X$YZZ>|ӓOEg@Kn@͘1䉴9s~bOܩ.Ag-ZRH~|ԭwwˑ#Gu)k֬i3ҽQFedd_$P pٶm>pzKnjŋB***[lyKw렇ӂD"oBɓHEEŋq;}ttN=P7ȗ/_g߿߿/T$PPp544L2!LMM; N#G" 3Çqڴi: )))4hBO>2yX,>z#8tX,hBS#//?o, CMNNȁS 55?kٹD믿pMJJJ֭E=$lqqqzB=Z~^r%~ݻ-H8ܹ/;6mZ>ttt|eee$L$<񇊊 B># `Ν/޽{;wIAIr ܝ۪U(c$++k̘18qbnn.5A//ݱceH$SNVuu={+( /Dzj>z(AΟ? JHH" Gp9 _|BHYYҥKTgժUKcc 6ׯ^?2$$ꊀA墦7k?|rަEPTWd .{83Ϟ=w .c/^%V3R&MkpYJOO777G 8PAwwB[n$\fzrssXh>?`JAe#""BKK !ɌC)(H \zUUU!4|@@u92ؼ+WP]4HxwS_}#TIIIC)Hxݻn޼ZH,9r C)HxI$~:trPXX8c BP "hɒ%!%%S]~zf4+2$ӚfΜRWWr73Hx֎?!OCP  eeeCE?}r'v؁BP4 W^ 0!ԯ_ˡ շo_caa!ЎD" w^& |3ưa***.JJJ͛ץA=~$]"##uuuTZ Z ݌ϝ;츺:& :s ^G}||".x|Ws* ޶ 7nHu- L$O!}}'OBP$aƍBP] yxxul? !/_rOFi?Զm۠]ΝRSSv0Pyyybbb swwGܿr޽{"$ wcbhhaƍ7BP$q o1#eiiIIU=SOfPpZ7Y~ӯ_?=@FC/=477 BE׳ڻw/A1BhȐ!ЫWjҥ!]]ݴ4j+T\=+ӧOsbvڅ5n8x. ǭ~R]BA o>gС3gljj4+Vleee++׈#ꂞpHӚSUU>h(55uɨ Ed'N<{ӧ?~@{X,VXXXΝ۾};0?G;Dm:STUUؔQQQrA5***eXs!*Ņ2 ߲eK{fXnnnb@{ۋ7B /"..̒ '''Pb'|vZ{{{J mJMM mѣG$צ6 yf!jjj .\z5\SCCCTTTxxxXX>C_bbb*OQ0!dbbb``gkkƍ,H=zdmmݻwogpSVVvŀ ())Q]NO' ?~ٳw~G͛7?kEWWⷣ6>555---==իWl6*))ijjА 0 {n܋Ixx8(87Du9o{h700RGr8ۋ/7Ny%~8&_.GDFF/tXwP(p8H! _nBbmܸnׯdzeQ )))z̙ `)fΜ=r1~8w~ƦMq+ƬY{Nbx֬Y~UWWS]ӧO\nܸ/xtEk,VSSCu-USSbEpe|u>AwFm޼?tNQhjj!vIu-D'|Eu-ݥ'Du-dq>}jhhwz˧~ڻwdxRB !www <#xO F͚5K{PVVOпsRSSB...T"xFL1>BOB77o611rNNN&&&,bSoXRUUno`!2Nxff&BHq40h \;uɓ'&MT\\,LLLN8?|0;;![vAVwӅ.|466p8|>HQ?@EEk-G^zu fnn]_^"ȔPZZ;GJOOEwgF= .] 9r)S/R;ψAV?;݋+Gӧc`$d߅ vo_(om~ccGwڝ/z…۷w/ao؅>)) ;@j᾵_~ycc㜜޿?===""> hѫ8''!TPP }Q;600b͞=U`EX }}!__.v͛lݻSSSM>AHOǷqi<!555ܻc;Z햄a:`vZFF˗ TUU***nׯ_KûՄ%!! g6D%d'Nt|pbK 󄹠"ݣ 8)y%  zbTrL881pzbd4x"=hT###<ɄER xӅ鉼d@,>}/^5sCo9sAO!!%HM8O ^:w\~9::.[ٳw={vٲeI(++ϝ;ի?cS+M8"AGٶm[II BHIIiԩgϞ1c>e%C7nܸpBppD"Aƍ| n#\rՐܯrܷo_;;}LIIIYYY]]],|@  D"tl3f~ N.$$ҥKϟǓp8cǎ>|q oK"GFFFDDDEE566"lǗ_~&P(|qtttDDijg 9B333GGÇ'$$,Kzh2R;;;;;AZXXhhhhhhhiiI$H$ kjj***JKK ssssrrRRR={7x 6sYf)Axxxaaa^^^VVVeeeYYׯB!ǿjjj***JJJ&&&zzz<lܸqO<5kVnn.>!=w-.t…X|pƃS0f̘ &ɶN@'N|7MMMNNNMMMQQQÇ.ڡW›OMCG IDATMMKKKOOGb^e\.WIIISSW^Ɔ<oɻvںu+0L}}ٳgB>>>عs֭[Cis:@j3f ŹtJzzBHSS7Q[[kjjpNu12 pTdŋi-B᫧aZ###@u!@|ʕ+Z:o޼o>BϏ i /4MHZ+((pss_UTT9ry|qsl6~BRQ"FܹCu!@6BBBz۷;}v횞^pp_,TQQCɴLE T:qsss]\\>>2Yŗ/_j/[߆߹sG,ihhP] 訌 WW׳gH9;6aÆ͞=A[vO ]tsҥ!C?zh޼y2e>rDEI$ccc\ɤy Y!4j(M昐p maaAu! ·{rUUU{F=h+^:+7o~</::GSټy3Bh͚5@ޓ-H8/Xq)SO2%11ŅI/].;;ѣLޡ芪*a[uu5յ3!r͍7B$Or ˗/ݔBsHLLL߿OUƍCZ{鰋N[Aݻw̘1EEEG~ɨQ*f߾}999T@=n!Du!?du -\!4c !b'ٳg!<`ׯ_qD>FHdwtzy鴱c".^Hu! yכ!Ξ=Ku-$Qթp8-==}O#!dnn@u-dVȽ>?dȐŋC IMMm$S] y2pʕ+??zΎFݻwS]ޡZ# 鹚FrQ|&oҥT"wLX,*$$xw>n2338Nrrt`YY% ߾}!4aL @&XaÆ)STTT|b|x ﹑ꟛN4iB̙3T4d׮]{QYYW#(r^N2ፍ,ZzH:F"+6mo={P])d.|@u!=D"ٽ{w7FBm^l7sLK1<_]z*ҋU.σY,ֺump.N>h"Xɯڣ=o#ׯ_;99E=iAե w1Q]̔:̈́S],RN |ر]~zoo/iQQQ}( 裏Z#w)p* 222z9MM .>|XO# --OOPCn|>_KK !F%W{{4ˑ/@0gΜ)Sܓ)XݻrppfjjjZb^ϟC(-Z<T%3xf/v姠`ȑxѣΝ!yp8VIHHyt7otvvO#/T,k6m2P6_"bijjҰ{ %֯_o7P]b\]].Df4\ٳ.9#EDN8.D6p|X҄AVVV-0͍ygqHs~$00M``Ou!2niëW+]]]=;;ZeK wPYYY{i߾}TW***N·D" w~M߽:|K CQ;(8{\}}3gδx+ ȟwy$Ļ=555 ,hѻ'OΞ=;k,4A߶to}||ܨk܃]s   :}txbtC넫?~+BիWo?̾r 4B/[ ~Dg!bF_^^>x`kAtOl{p oK+O|9s& '{M***^^^Waa᯿JxwIJeˤYYY,իϷz;hӧ#G433311x k9HYvޱc^~}iӦ)++S]lL0!22qㆱ<?~|F;gΜիWSLM eAw⚚wll6իWA3ӆ"H"EFF<r_;::fQQ~-N89ҧOYf;v,77|˨6mT[[{ҥq! rrrnλlA:mڴiҥ/_֭% [n}GfffG^xg:^{7o=75ggg( 쥓N9;;|ov̙999999GMNN622 2de{ZeˑI$%KO?wܸq͛={۷nj谍谥alׯ,55UGGſӿkڴiTH! BCCٓecccmmpWt 4]F:{l{oؾ};BhҥdVE!!!?;;;%֊&+%ȟwlñI&߼ysxȢE8 mrM[k='L"6?[ep vw Gp7Hb;jA@'G-ZHA<dc)1g~@A?m0\·d#+0ic6MdTsC6&m8ImP0$&dp A`2H8L  0$&dp A`2H8L  0M^WW Ǐ.,,,,,,⼼upD駟޾}(<<<<<۟~D":rK.脆؄\tiʕTWG1h]GƍBjjj͇GFF!6nHUmsuu_k]]W8r588"8@~m'ND ĉ|>uZQϜ9bX,֙3gFsAeeeeee!̙#]۷LIJJCtttB>>> 1v{Lm˨Ox׶EiLm;(Nx'[ʯBjA&*^XX&,m[xZ6;88tCyyl+M&2LL~)&Pp]wsonm ZȘ+@m ߞ$ s&\ޭA }My /Q+@m I ' &p򷫊uM{©:6V+@mȕ|N6W@79&@_mJ8Mri{Mr+x}XyfB ҷo^[[+qvMmm۩6Ȅ͒&yvss+))3g΅ l{H$ͻt钑QTT X, 'GQQш#&NLI`ԩoxѦȁNg0UPPP^^+W7BHYYʕ+yyyAAATpرoԤTWW?oذB|^:L{0$&dp A`2H8L  0$&dp peee/^fdd4z Ȼ{ã122)--IOOo.++0`Yd=ZWW~-޹dɒ޽{<@:0##cܸqZZZvvv;w$SRRrttz*i /#G2eСCΟ~);;XTUU__={$''7KJJLH۵w76665==u_ҁϟ?G?_|YZZnn޽$̈IgԩSmREE/(( ~zzzDDD}}}@@A999ϟbP끦zںukrrrzz۷<8|p+Wddd9rdɤ͎\fee߿ɒ%ߠJ~a@QJ ˗9N2[$"&&Ņr\tI"O,K__̘1$̈!bqHH---%"!!EII%11 ܖ驢1k֬bk4=1nņ vummmKKy}gN}3?n+W6m wޥr@+*MX=NKK|UCCZ}}fnn.Ϸ@=~xذaB]@_ptttZPP`nnnjjiӦ̬O>oӧ nnnT#L꯿"\.>HLLTUUEMH8L  0$&dp A`2H8L  0$&dp A`2H8L  0$&dp A`2H8L  0$&dp A`2H8L  0$&dp (( . A 0dp A`2H8@A455Q] HQ];s(O>>}={놆J kHIIoy<(Am۶ hL1(++wiiiQQQɓ'מ˗/o{ݻw/22R"ZjD"ꫯ9dddq׷7B@v?|۶m[nl/֋kwܹtқ7oNyLI/ӧO'B?X&Ǯ#444||>dŊvplYYYAddd ~7~ݺuD"?;`US,wa2:ps?W^7o͖-[~ٳ6l'߼ysqB$Ɍ3x<ށB}]uuêU9RQQQ]]]XXk.ss[n.*--]nX,D“'OVWW?|~֭w55~UUU;wdXoyEΟ?N>=dospp_-[v/^76lbױ!TVVv1__Ǐ_|YYYwsskB]FF˗B;wDyyyΎ/6z1cÇkkk>|8bĈիWw;?/мGM6)88A\vݽ#*++׬Y_ڵ-669rd{c?~t"~k l6gٲe?߃wnkkk׬Y3`$f_"H'Csss337n7Bg>t~K?H{zx٩q p8mp>gϞ__ .رC Ԅí6'O&&&)j8[AIII:u~‚7;=ztyyyy}}~SQQADYY^w?~|ԩа̎ީqtdyQLL… Y;3b@wnY=Ҩ;/_. (++$kVq8eHWWW#Ξ=?dɒ@++Ƥ$_PPЎ1+6-/^@G6&dp A`2H8L zv IENDB`./gnutls-2.8.1-i686/usr/share/info/gnutls.info-20000644000000000000000000103763011271476021017574 0ustar rootrootThis is gnutls.info, produced by makeinfo version 4.13 from gnutls.texi. This manual is last updated 2 June 2009 for version 2.8.1 of GNU TLS. Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License". INFO-DIR-SECTION Software libraries START-INFO-DIR-ENTRY * GnuTLS: (gnutls). GNU Transport Layer Security Library. END-INFO-DIR-ENTRY INFO-DIR-SECTION System Administration START-INFO-DIR-ENTRY * certtool: (gnutls)Invoking certtool. Manipulate certificates and keys. * gnutls-serv: (gnutls)Invoking gnutls-serv. GNU TLS test server. * gnutls-cli: (gnutls)Invoking gnutls-cli. GNU TLS test client. * gnutls-cli-debug: (gnutls)Invoking gnutls-cli-debug. GNU TLS debug client. * psktool: (gnutls)Invoking psktool. Simple TLS-Pre-Shared-Keys manager. * srptool: (gnutls)Invoking srptool. Simple SRP password tool. END-INFO-DIR-ENTRY  File: gnutls.info, Node: X.509 certificate functions, Next: GnuTLS-extra functions, Prev: Core functions, Up: Function reference 9.2 X.509 Certificate Functions =============================== The following functions are to be used for X.509 certificate handling. Their prototypes lie in `gnutls/x509.h'. gnutls_pkcs12_bag_decrypt ------------------------- -- Function: int gnutls_pkcs12_bag_decrypt (gnutls_pkcs12_bag_t BAG, const char * PASS) BAG: The bag PASS: The password used for encryption, must be ASCII. This function will decrypt the given encrypted bag and return 0 on success. *Returns:* On success, `GNUTLS_E_SUCCESS' (zero) is returned, otherwise an error code is returned. gnutls_pkcs12_bag_deinit ------------------------ -- Function: void gnutls_pkcs12_bag_deinit (gnutls_pkcs12_bag_t BAG) BAG: The structure to be initialized This function will deinitialize a PKCS12 Bag structure. gnutls_pkcs12_bag_encrypt ------------------------- -- Function: int gnutls_pkcs12_bag_encrypt (gnutls_pkcs12_bag_t BAG, const char * PASS, unsigned int FLAGS) BAG: The bag PASS: The password used for encryption, must be ASCII FLAGS: should be one of `gnutls_pkcs_encrypt_flags_t' elements bitwise or'd This function will encrypt the given bag. *Returns:* On success, `GNUTLS_E_SUCCESS' (zero) is returned, otherwise an error code is returned. gnutls_pkcs12_bag_get_count --------------------------- -- Function: int gnutls_pkcs12_bag_get_count (gnutls_pkcs12_bag_t BAG) BAG: The bag This function will return the number of the elements withing the bag. *Returns:* Number of elements in bag, or an negative error code on error. gnutls_pkcs12_bag_get_data -------------------------- -- Function: int gnutls_pkcs12_bag_get_data (gnutls_pkcs12_bag_t BAG, int INDX, gnutls_datum_t * DATA) BAG: The bag INDX: The element of the bag to get the data from DATA: where the bag's data will be. Should be treated as constant. This function will return the bag's data. The data is a constant that is stored into the bag. Should not be accessed after the bag is deleted. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value.and a negative error code on error. gnutls_pkcs12_bag_get_friendly_name ----------------------------------- -- Function: int gnutls_pkcs12_bag_get_friendly_name (gnutls_pkcs12_bag_t BAG, int INDX, char ** NAME) BAG: The bag INDX: The bag's element to add the id NAME: will hold a pointer to the name (to be treated as const) This function will return the friendly name, of the specified bag element. The key ID is usually used to distinguish the local private key and the certificate pair. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. or a negative value on error. gnutls_pkcs12_bag_get_key_id ---------------------------- -- Function: int gnutls_pkcs12_bag_get_key_id (gnutls_pkcs12_bag_t BAG, int INDX, gnutls_datum_t * ID) BAG: The bag INDX: The bag's element to add the id ID: where the ID will be copied (to be treated as const) This function will return the key ID, of the specified bag element. The key ID is usually used to distinguish the local private key and the certificate pair. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. or a negative value on error. gnutls_pkcs12_bag_get_type -------------------------- -- Function: gnutls_pkcs12_bag_type_t gnutls_pkcs12_bag_get_type (gnutls_pkcs12_bag_t BAG, int INDX) BAG: The bag INDX: The element of the bag to get the type This function will return the bag's type. *Returns:* One of the `gnutls_pkcs12_bag_type_t' enumerations. gnutls_pkcs12_bag_init ---------------------- -- Function: int gnutls_pkcs12_bag_init (gnutls_pkcs12_bag_t * BAG) BAG: The structure to be initialized This function will initialize a PKCS12 bag structure. PKCS12 Bags usually contain private keys, lists of X.509 Certificates and X.509 Certificate revocation lists. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_pkcs12_bag_set_crl ------------------------- -- Function: int gnutls_pkcs12_bag_set_crl (gnutls_pkcs12_bag_t BAG, gnutls_x509_crl_t CRL) BAG: The bag CRL: the CRL to be copied. This function will insert the given CRL into the bag. This is just a wrapper over `gnutls_pkcs12_bag_set_data()'. *Returns:* the index of the added bag on success, or a negative value on failure. gnutls_pkcs12_bag_set_crt ------------------------- -- Function: int gnutls_pkcs12_bag_set_crt (gnutls_pkcs12_bag_t BAG, gnutls_x509_crt_t CRT) BAG: The bag CRT: the certificate to be copied. This function will insert the given certificate into the bag. This is just a wrapper over `gnutls_pkcs12_bag_set_data()'. *Returns:* the index of the added bag on success, or a negative value on failure. gnutls_pkcs12_bag_set_data -------------------------- -- Function: int gnutls_pkcs12_bag_set_data (gnutls_pkcs12_bag_t BAG, gnutls_pkcs12_bag_type_t TYPE, const gnutls_datum_t * DATA) BAG: The bag TYPE: The data's type DATA: the data to be copied. This function will insert the given data of the given type into the bag. *Returns:* the index of the added bag on success, or a negative value on error. gnutls_pkcs12_bag_set_friendly_name ----------------------------------- -- Function: int gnutls_pkcs12_bag_set_friendly_name (gnutls_pkcs12_bag_t BAG, int INDX, const char * NAME) BAG: The bag INDX: The bag's element to add the id NAME: the name This function will add the given key friendly name, to the specified, by the index, bag element. The name will be encoded as a 'Friendly name' bag attribute, which is usually used to set a user name to the local private key and the certificate pair. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. or a negative value on error. gnutls_pkcs12_bag_set_key_id ---------------------------- -- Function: int gnutls_pkcs12_bag_set_key_id (gnutls_pkcs12_bag_t BAG, int INDX, const gnutls_datum_t * ID) BAG: The bag INDX: The bag's element to add the id ID: the ID This function will add the given key ID, to the specified, by the index, bag element. The key ID will be encoded as a 'Local key identifier' bag attribute, which is usually used to distinguish the local private key and the certificate pair. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. or a negative value on error. gnutls_pkcs12_deinit -------------------- -- Function: void gnutls_pkcs12_deinit (gnutls_pkcs12_t PKCS12) PKCS12: The structure to be initialized This function will deinitialize a PKCS12 structure. gnutls_pkcs12_export -------------------- -- Function: int gnutls_pkcs12_export (gnutls_pkcs12_t PKCS12, gnutls_x509_crt_fmt_t FORMAT, void * OUTPUT_DATA, size_t * OUTPUT_DATA_SIZE) PKCS12: Holds the pkcs12 structure FORMAT: the format of output params. One of PEM or DER. OUTPUT_DATA: will contain a structure PEM or DER encoded OUTPUT_DATA_SIZE: holds the size of output_data (and will be replaced by the actual size of parameters) This function will export the pkcs12 structure to DER or PEM format. If the buffer provided is not long enough to hold the output, then *output_data_size will be updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. If the structure is PEM encoded, it will have a header of "BEGIN PKCS12". *Return value:* In case of failure a negative value will be returned, and 0 on success. gnutls_pkcs12_generate_mac -------------------------- -- Function: int gnutls_pkcs12_generate_mac (gnutls_pkcs12_t PKCS12, const char * PASS) PKCS12: should contain a gnutls_pkcs12_t structure PASS: The password for the MAC This function will generate a MAC for the PKCS12 structure. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_pkcs12_get_bag --------------------- -- Function: int gnutls_pkcs12_get_bag (gnutls_pkcs12_t PKCS12, int INDX, gnutls_pkcs12_bag_t BAG) PKCS12: should contain a gnutls_pkcs12_t structure INDX: contains the index of the bag to extract BAG: An initialized bag, where the contents of the bag will be copied This function will return a Bag from the PKCS12 structure. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. After the last Bag has been read GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned. gnutls_pkcs12_import -------------------- -- Function: int gnutls_pkcs12_import (gnutls_pkcs12_t PKCS12, const gnutls_datum_t * DATA, gnutls_x509_crt_fmt_t FORMAT, unsigned int FLAGS) PKCS12: The structure to store the parsed PKCS12. DATA: The DER or PEM encoded PKCS12. FORMAT: One of DER or PEM FLAGS: an ORed sequence of gnutls_privkey_pkcs8_flags This function will convert the given DER or PEM encoded PKCS12 to the native gnutls_pkcs12_t format. The output will be stored in 'pkcs12'. If the PKCS12 is PEM encoded it should have a header of "PKCS12". *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_pkcs12_init ------------------ -- Function: int gnutls_pkcs12_init (gnutls_pkcs12_t * PKCS12) PKCS12: The structure to be initialized This function will initialize a PKCS12 structure. PKCS12 structures usually contain lists of X.509 Certificates and X.509 Certificate revocation lists. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_pkcs12_set_bag --------------------- -- Function: int gnutls_pkcs12_set_bag (gnutls_pkcs12_t PKCS12, gnutls_pkcs12_bag_t BAG) PKCS12: should contain a gnutls_pkcs12_t structure BAG: An initialized bag This function will insert a Bag into the PKCS12 structure. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_pkcs12_verify_mac ------------------------ -- Function: int gnutls_pkcs12_verify_mac (gnutls_pkcs12_t PKCS12, const char * PASS) PKCS12: should contain a gnutls_pkcs12_t structure PASS: The password for the MAC This function will verify the MAC for the PKCS12 structure. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_pkcs7_deinit ------------------- -- Function: void gnutls_pkcs7_deinit (gnutls_pkcs7_t PKCS7) PKCS7: The structure to be initialized This function will deinitialize a PKCS7 structure. gnutls_pkcs7_delete_crl ----------------------- -- Function: int gnutls_pkcs7_delete_crl (gnutls_pkcs7_t PKCS7, int INDX) PKCS7: should contain a `gnutls_pkcs7_t' structure INDX: the index of the crl to delete This function will delete a crl from a PKCS7 or RFC2630 crl set. Index starts from 0. Returns 0 on success. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_pkcs7_delete_crt ----------------------- -- Function: int gnutls_pkcs7_delete_crt (gnutls_pkcs7_t PKCS7, int INDX) PKCS7: should contain a gnutls_pkcs7_t structure INDX: the index of the certificate to delete This function will delete a certificate from a PKCS7 or RFC2630 certificate set. Index starts from 0. Returns 0 on success. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_pkcs7_export ------------------- -- Function: int gnutls_pkcs7_export (gnutls_pkcs7_t PKCS7, gnutls_x509_crt_fmt_t FORMAT, void * OUTPUT_DATA, size_t * OUTPUT_DATA_SIZE) PKCS7: Holds the pkcs7 structure FORMAT: the format of output params. One of PEM or DER. OUTPUT_DATA: will contain a structure PEM or DER encoded OUTPUT_DATA_SIZE: holds the size of output_data (and will be replaced by the actual size of parameters) This function will export the pkcs7 structure to DER or PEM format. If the buffer provided is not long enough to hold the output, then *`output_data_size' is updated and `GNUTLS_E_SHORT_MEMORY_BUFFER' will be returned. If the structure is PEM encoded, it will have a header of "BEGIN PKCS7". *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_pkcs7_get_crl_count -------------------------- -- Function: int gnutls_pkcs7_get_crl_count (gnutls_pkcs7_t PKCS7) PKCS7: should contain a gnutls_pkcs7_t structure This function will return the number of certifcates in the PKCS7 or RFC2630 crl set. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_pkcs7_get_crl_raw ------------------------ -- Function: int gnutls_pkcs7_get_crl_raw (gnutls_pkcs7_t PKCS7, int INDX, void * CRL, size_t * CRL_SIZE) PKCS7: should contain a `gnutls_pkcs7_t' structure INDX: contains the index of the crl to extract CRL: the contents of the crl will be copied there (may be null) CRL_SIZE: should hold the size of the crl This function will return a crl of the PKCS7 or RFC2630 crl set. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. If the provided buffer is not long enough, then `crl_size' is updated and `GNUTLS_E_SHORT_MEMORY_BUFFER' is returned. After the last crl has been read `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. gnutls_pkcs7_get_crt_count -------------------------- -- Function: int gnutls_pkcs7_get_crt_count (gnutls_pkcs7_t PKCS7) PKCS7: should contain a `gnutls_pkcs7_t' structure This function will return the number of certifcates in the PKCS7 or RFC2630 certificate set. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_pkcs7_get_crt_raw ------------------------ -- Function: int gnutls_pkcs7_get_crt_raw (gnutls_pkcs7_t PKCS7, int INDX, void * CERTIFICATE, size_t * CERTIFICATE_SIZE) PKCS7: should contain a gnutls_pkcs7_t structure INDX: contains the index of the certificate to extract CERTIFICATE: the contents of the certificate will be copied there (may be null) CERTIFICATE_SIZE: should hold the size of the certificate This function will return a certificate of the PKCS7 or RFC2630 certificate set. After the last certificate has been read `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. If the provided buffer is not long enough, then `certificate_size' is updated and `GNUTLS_E_SHORT_MEMORY_BUFFER' is returned. gnutls_pkcs7_import ------------------- -- Function: int gnutls_pkcs7_import (gnutls_pkcs7_t PKCS7, const gnutls_datum_t * DATA, gnutls_x509_crt_fmt_t FORMAT) PKCS7: The structure to store the parsed PKCS7. DATA: The DER or PEM encoded PKCS7. FORMAT: One of DER or PEM This function will convert the given DER or PEM encoded PKCS7 to the native `gnutls_pkcs7_t' format. The output will be stored in 'pkcs7'. If the PKCS7 is PEM encoded it should have a header of "PKCS7". *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_pkcs7_init ----------------- -- Function: int gnutls_pkcs7_init (gnutls_pkcs7_t * PKCS7) PKCS7: The structure to be initialized This function will initialize a PKCS7 structure. PKCS7 structures usually contain lists of X.509 Certificates and X.509 Certificate revocation lists. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_pkcs7_set_crl_raw ------------------------ -- Function: int gnutls_pkcs7_set_crl_raw (gnutls_pkcs7_t PKCS7, const gnutls_datum_t * CRL) PKCS7: should contain a `gnutls_pkcs7_t' structure CRL: the DER encoded crl to be added This function will add a crl to the PKCS7 or RFC2630 crl set. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_pkcs7_set_crl -------------------- -- Function: int gnutls_pkcs7_set_crl (gnutls_pkcs7_t PKCS7, gnutls_x509_crl_t CRL) PKCS7: should contain a `gnutls_pkcs7_t' structure CRL: the DER encoded crl to be added This function will add a parsed CRL to the PKCS7 or RFC2630 crl set. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_pkcs7_set_crt_raw ------------------------ -- Function: int gnutls_pkcs7_set_crt_raw (gnutls_pkcs7_t PKCS7, const gnutls_datum_t * CRT) PKCS7: should contain a `gnutls_pkcs7_t' structure CRT: the DER encoded certificate to be added This function will add a certificate to the PKCS7 or RFC2630 certificate set. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_pkcs7_set_crt -------------------- -- Function: int gnutls_pkcs7_set_crt (gnutls_pkcs7_t PKCS7, gnutls_x509_crt_t CRT) PKCS7: should contain a `gnutls_pkcs7_t' structure CRT: the certificate to be copied. This function will add a parsed certificate to the PKCS7 or RFC2630 certificate set. This is a wrapper function over `gnutls_pkcs7_set_crt_raw()' . *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crl_check_issuer ---------------------------- -- Function: int gnutls_x509_crl_check_issuer (gnutls_x509_crl_t CERT, gnutls_x509_crt_t ISSUER) ISSUER: is the certificate of a possible issuer This function will check if the given CRL was issued by the given issuer certificate. It will return true (1) if the given CRL was issued by the given issuer, and false (0) if not. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crl_deinit ---------------------- -- Function: void gnutls_x509_crl_deinit (gnutls_x509_crl_t CRL) CRL: The structure to be initialized This function will deinitialize a CRL structure. gnutls_x509_crl_export ---------------------- -- Function: int gnutls_x509_crl_export (gnutls_x509_crl_t CRL, gnutls_x509_crt_fmt_t FORMAT, void * OUTPUT_DATA, size_t * OUTPUT_DATA_SIZE) CRL: Holds the revocation list FORMAT: the format of output params. One of PEM or DER. OUTPUT_DATA: will contain a private key PEM or DER encoded OUTPUT_DATA_SIZE: holds the size of output_data (and will be replaced by the actual size of parameters) This function will export the revocation list to DER or PEM format. If the buffer provided is not long enough to hold the output, then ¤GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. If the structure is PEM encoded, it will have a header of "BEGIN X509 CRL". *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. and a negative value on failure. gnutls_x509_crl_get_authority_key_id ------------------------------------ -- Function: int gnutls_x509_crl_get_authority_key_id (gnutls_x509_crl_t CRL, void * RET, size_t * RET_SIZE, unsigned int * CRITICAL) CRL: should contain a `gnutls_x509_crl_t' structure RET: The place where the identifier will be copied RET_SIZE: Holds the size of the result field. CRITICAL: will be non zero if the extension is marked as critical (may be null) This function will return the CRL authority's key identifier. This is obtained by the X.509 Authority Key identifier extension field (2.5.29.35). Note that this function only returns the keyIdentifier field of the extension. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative value in case of an error. *Since:* 2.8.0 gnutls_x509_crl_get_crt_count ----------------------------- -- Function: int gnutls_x509_crl_get_crt_count (gnutls_x509_crl_t CRL) CRL: should contain a `gnutls_x509_crl_t' structure This function will return the number of revoked certificates in the given CRL. *Returns:* number of certificates, a negative value on failure. gnutls_x509_crl_get_crt_serial ------------------------------ -- Function: int gnutls_x509_crl_get_crt_serial (gnutls_x509_crl_t CRL, int INDX, unsigned char * SERIAL, size_t * SERIAL_SIZE, time_t * T) CRL: should contain a `gnutls_x509_crl_t' structure INDX: the index of the certificate to extract (starting from 0) SERIAL: where the serial number will be copied SERIAL_SIZE: initially holds the size of serial T: if non null, will hold the time this certificate was revoked This function will retrieve the serial number of the specified, by the index, revoked certificate. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. and a negative value on error. gnutls_x509_crl_get_dn_oid -------------------------- -- Function: int gnutls_x509_crl_get_dn_oid (gnutls_x509_crl_t CRL, int INDX, void * OID, size_t * SIZEOF_OID) CRL: should contain a gnutls_x509_crl_t structure INDX: Specifies which DN OID to send. Use zero to get the first one. OID: a pointer to a structure to hold the name (may be null) SIZEOF_OID: initially holds the size of 'oid' This function will extract the requested OID of the name of the CRL issuer, specified by the given index. If oid is null then only the size will be filled. *Returns:* `GNUTLS_E_SHORT_MEMORY_BUFFER' if the provided buffer is not long enough, and in that case the sizeof_oid will be updated with the required size. On success 0 is returned. gnutls_x509_crl_get_extension_data ---------------------------------- -- Function: int gnutls_x509_crl_get_extension_data (gnutls_x509_crl_t CRL, int INDX, void * DATA, size_t * SIZEOF_DATA) CRL: should contain a `gnutls_x509_crl_t' structure INDX: Specifies which extension OID to send. Use zero to get the first one. DATA: a pointer to a structure to hold the data (may be null) SIZEOF_DATA: initially holds the size of `oid' This function will return the requested extension data in the CRL. The extension data will be stored as a string in the provided buffer. Use `gnutls_x509_crl_get_extension_info()' to extract the OID and critical flag. Use `gnutls_x509_crl_get_extension_by_oid()' instead, if you want to get data indexed by the extension OID rather than sequence. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative value in case of an error. If your have reached the last extension available `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. *Since:* 2.8.0 gnutls_x509_crl_get_extension_info ---------------------------------- -- Function: int gnutls_x509_crl_get_extension_info (gnutls_x509_crl_t CRL, int INDX, void * OID, size_t * SIZEOF_OID, int * CRITICAL) CRL: should contain a `gnutls_x509_crl_t' structure INDX: Specifies which extension OID to send, use zero to get the first one. OID: a pointer to a structure to hold the OID SIZEOF_OID: initially holds the maximum size of `oid', on return holds actual size of `oid'. CRITICAL: output variable with critical flag, may be NULL. This function will return the requested extension OID in the CRL, and the critical flag for it. The extension OID will be stored as a string in the provided buffer. Use `gnutls_x509_crl_get_extension_data()' to extract the data. If the buffer provided is not long enough to hold the output, then *`sizeof_oid' is updated and `GNUTLS_E_SHORT_MEMORY_BUFFER' will be returned. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative value in case of an error. If your have reached the last extension available `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. *Since:* 2.8.0 gnutls_x509_crl_get_extension_oid --------------------------------- -- Function: int gnutls_x509_crl_get_extension_oid (gnutls_x509_crl_t CRL, int INDX, void * OID, size_t * SIZEOF_OID) CRL: should contain a `gnutls_x509_crl_t' structure INDX: Specifies which extension OID to send, use zero to get the first one. OID: a pointer to a structure to hold the OID (may be null) SIZEOF_OID: initially holds the size of `oid' This function will return the requested extension OID in the CRL. The extension OID will be stored as a string in the provided buffer. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative value in case of an error. If your have reached the last extension available `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. *Since:* 2.8.0 gnutls_x509_crl_get_issuer_dn_by_oid ------------------------------------ -- Function: int gnutls_x509_crl_get_issuer_dn_by_oid (gnutls_x509_crl_t CRL, const char * OID, int INDX, unsigned int RAW_FLAG, void * BUF, size_t * SIZEOF_BUF) CRL: should contain a gnutls_x509_crl_t structure OID: holds an Object Identified in null terminated string INDX: In case multiple same OIDs exist in the RDN, this specifies which to send. Use zero to get the first one. RAW_FLAG: If non zero returns the raw DER data of the DN part. BUF: a pointer to a structure to hold the peer's name (may be null) SIZEOF_BUF: initially holds the size of `buf' This function will extract the part of the name of the CRL issuer specified by the given OID. The output will be encoded as described in RFC2253. The output string will be ASCII or UTF-8 encoded, depending on the certificate data. Some helper macros with popular OIDs can be found in gnutls/x509.h If raw flag is zero, this function will only return known OIDs as text. Other OIDs will be DER encoded, as described in RFC2253 - in hex format with a '\#' prefix. You can check about known OIDs using `gnutls_x509_dn_oid_known()'. If buf is null then only the size will be filled. *Returns:* `GNUTLS_E_SHORT_MEMORY_BUFFER' if the provided buffer is not long enough, and in that case the sizeof_buf will be updated with the required size, and 0 on success. gnutls_x509_crl_get_issuer_dn ----------------------------- -- Function: int gnutls_x509_crl_get_issuer_dn (const gnutls_x509_crl_t CRL, char * BUF, size_t * SIZEOF_BUF) CRL: should contain a gnutls_x509_crl_t structure BUF: a pointer to a structure to hold the peer's name (may be null) SIZEOF_BUF: initially holds the size of `buf' This function will copy the name of the CRL issuer in the provided buffer. The name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described in RFC2253. The output string will be ASCII or UTF-8 encoded, depending on the certificate data. If buf is `NULL' then only the size will be filled. *Returns:* `GNUTLS_E_SHORT_MEMORY_BUFFER' if the provided buffer is not long enough, and in that case the sizeof_buf will be updated with the required size, and 0 on success. gnutls_x509_crl_get_next_update ------------------------------- -- Function: time_t gnutls_x509_crl_get_next_update (gnutls_x509_crl_t CRL) CRL: should contain a `gnutls_x509_crl_t' structure This function will return the time the next CRL will be issued. This field is optional in a CRL so it might be normal to get an error instead. *Returns:* when the next CRL will be issued, or (time_t)-1 on error. gnutls_x509_crl_get_number -------------------------- -- Function: int gnutls_x509_crl_get_number (gnutls_x509_crl_t CRL, void * RET, size_t * RET_SIZE, unsigned int * CRITICAL) CRL: should contain a `gnutls_x509_crl_t' structure RET: The place where the number will be copied RET_SIZE: Holds the size of the result field. CRITICAL: will be non zero if the extension is marked as critical (may be null) This function will return the CRL number extension. This is obtained by the CRL Number extension field (2.5.29.20). *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative value in case of an error. *Since:* 2.8.0 gnutls_x509_crl_get_signature_algorithm --------------------------------------- -- Function: int gnutls_x509_crl_get_signature_algorithm (gnutls_x509_crl_t CRL) CRL: should contain a `gnutls_x509_crl_t' structure This function will return a value of the `gnutls_sign_algorithm_t' enumeration that is the signature algorithm. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crl_get_signature ----------------------------- -- Function: int gnutls_x509_crl_get_signature (gnutls_x509_crl_t CRL, char * SIG, size_t * SIZEOF_SIG) CRL: should contain a gnutls_x509_crl_t structure SIG: a pointer where the signature part will be copied (may be null). SIZEOF_SIG: initially holds the size of `sig' This function will extract the signature field of a CRL. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. and a negative value on error. gnutls_x509_crl_get_this_update ------------------------------- -- Function: time_t gnutls_x509_crl_get_this_update (gnutls_x509_crl_t CRL) CRL: should contain a `gnutls_x509_crl_t' structure This function will return the time this CRL was issued. *Returns:* when the CRL was issued, or (time_t)-1 on error. gnutls_x509_crl_get_version --------------------------- -- Function: int gnutls_x509_crl_get_version (gnutls_x509_crl_t CRL) CRL: should contain a `gnutls_x509_crl_t' structure This function will return the version of the specified CRL. *Returns:* The version number, or a negative value on error. gnutls_x509_crl_import ---------------------- -- Function: int gnutls_x509_crl_import (gnutls_x509_crl_t CRL, const gnutls_datum_t * DATA, gnutls_x509_crt_fmt_t FORMAT) CRL: The structure to store the parsed CRL. DATA: The DER or PEM encoded CRL. FORMAT: One of DER or PEM This function will convert the given DER or PEM encoded CRL to the native `gnutls_x509_crl_t' format. The output will be stored in 'crl'. If the CRL is PEM encoded it should have a header of "X509 CRL". *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crl_init -------------------- -- Function: int gnutls_x509_crl_init (gnutls_x509_crl_t * CRL) CRL: The structure to be initialized This function will initialize a CRL structure. CRL stands for Certificate Revocation List. A revocation list usually contains lists of certificate serial numbers that have been revoked by an Authority. The revocation lists are always signed with the authority's private key. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crl_print --------------------- -- Function: int gnutls_x509_crl_print (gnutls_x509_crl_t CRL, gnutls_certificate_print_formats_t FORMAT, gnutls_datum_t * OUT) CRL: The structure to be printed FORMAT: Indicate the format to use OUT: Newly allocated datum with zero terminated string. This function will pretty print a X.509 certificate revocation list, suitable for display to a human. The output `out' needs to be deallocate using `gnutls_free()'. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crl_set_authority_key_id ------------------------------------ -- Function: int gnutls_x509_crl_set_authority_key_id (gnutls_x509_crl_t CRL, const void * ID, size_t ID_SIZE) CRL: a CRL of type `gnutls_x509_crl_t' ID: The key ID ID_SIZE: Holds the size of the serial field. This function will set the CRL's authority key ID extension. Only the keyIdentifier field can be set with this function. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. *Since:* 2.8.0 gnutls_x509_crl_set_crt_serial ------------------------------ -- Function: int gnutls_x509_crl_set_crt_serial (gnutls_x509_crl_t CRL, const void * SERIAL, size_t SERIAL_SIZE, time_t REVOCATION_TIME) CRL: should contain a gnutls_x509_crl_t structure SERIAL: The revoked certificate's serial number SERIAL_SIZE: Holds the size of the serial field. REVOCATION_TIME: The time this certificate was revoked This function will set a revoked certificate's serial number to the CRL. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crl_set_crt ----------------------- -- Function: int gnutls_x509_crl_set_crt (gnutls_x509_crl_t CRL, gnutls_x509_crt_t CRT, time_t REVOCATION_TIME) CRL: should contain a gnutls_x509_crl_t structure CRT: a certificate of type `gnutls_x509_crt_t' with the revoked certificate REVOCATION_TIME: The time this certificate was revoked This function will set a revoked certificate's serial number to the CRL. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crl_set_next_update ------------------------------- -- Function: int gnutls_x509_crl_set_next_update (gnutls_x509_crl_t CRL, time_t EXP_TIME) CRL: should contain a gnutls_x509_crl_t structure EXP_TIME: The actual time This function will set the time this CRL will be updated. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crl_set_number -------------------------- -- Function: int gnutls_x509_crl_set_number (gnutls_x509_crl_t CRL, const void * NR, size_t NR_SIZE) CRL: a CRL of type `gnutls_x509_crl_t' NR: The CRL number NR_SIZE: Holds the size of the nr field. This function will set the CRL's number extension. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. *Since:* 2.8.0 gnutls_x509_crl_set_this_update ------------------------------- -- Function: int gnutls_x509_crl_set_this_update (gnutls_x509_crl_t CRL, time_t ACT_TIME) CRL: should contain a gnutls_x509_crl_t structure ACT_TIME: The actual time This function will set the time this CRL was issued. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crl_set_version --------------------------- -- Function: int gnutls_x509_crl_set_version (gnutls_x509_crl_t CRL, unsigned int VERSION) CRL: should contain a gnutls_x509_crl_t structure VERSION: holds the version number. For CRLv1 crls must be 1. This function will set the version of the CRL. This must be one for CRL version 1, and so on. The CRLs generated by gnutls should have a version number of 2. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crl_sign2 --------------------- -- Function: int gnutls_x509_crl_sign2 (gnutls_x509_crl_t CRL, gnutls_x509_crt_t ISSUER, gnutls_x509_privkey_t ISSUER_KEY, gnutls_digest_algorithm_t DIG, unsigned int FLAGS) CRL: should contain a gnutls_x509_crl_t structure ISSUER: is the certificate of the certificate issuer ISSUER_KEY: holds the issuer's private key DIG: The message digest to use. GNUTLS_DIG_SHA1 is the safe choice unless you know what you're doing. FLAGS: must be 0 This function will sign the CRL with the issuer's private key, and will copy the issuer's information into the CRL. This must be the last step in a certificate CRL since all the previously set parameters are now signed. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crl_sign -------------------- -- Function: int gnutls_x509_crl_sign (gnutls_x509_crl_t CRL, gnutls_x509_crt_t ISSUER, gnutls_x509_privkey_t ISSUER_KEY) CRL: should contain a gnutls_x509_crl_t structure ISSUER: is the certificate of the certificate issuer ISSUER_KEY: holds the issuer's private key This function is the same a `gnutls_x509_crl_sign2()' with no flags, and SHA1 as the hash algorithm. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crl_verify ---------------------- -- Function: int gnutls_x509_crl_verify (gnutls_x509_crl_t CRL, const gnutls_x509_crt_t * CA_LIST, int CA_LIST_LENGTH, unsigned int FLAGS, unsigned int * VERIFY) CRL: is the crl to be verified CA_LIST: is a certificate list that is considered to be trusted one CA_LIST_LENGTH: holds the number of CA certificates in CA_list FLAGS: Flags that may be used to change the verification algorithm. Use OR of the gnutls_certificate_verify_flags enumerations. VERIFY: will hold the crl verification output. This function will try to verify the given crl and return its status. See `gnutls_x509_crt_list_verify()' for a detailed description of return values. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crq_deinit ---------------------- -- Function: void gnutls_x509_crq_deinit (gnutls_x509_crq_t CRQ) CRQ: The structure to be initialized This function will deinitialize a CRL structure. gnutls_x509_crq_export ---------------------- -- Function: int gnutls_x509_crq_export (gnutls_x509_crq_t CRQ, gnutls_x509_crt_fmt_t FORMAT, void * OUTPUT_DATA, size_t * OUTPUT_DATA_SIZE) CRQ: Holds the request FORMAT: the format of output params. One of PEM or DER. OUTPUT_DATA: will contain a certificate request PEM or DER encoded OUTPUT_DATA_SIZE: holds the size of output_data (and will be replaced by the actual size of parameters) This function will export the certificate request to a PKCS10 If the buffer provided is not long enough to hold the output, then GNUTLS_E_SHORT_MEMORY_BUFFER will be returned and *output_data_size will be updated. If the structure is PEM encoded, it will have a header of "BEGIN NEW CERTIFICATE REQUEST". *Return value:* In case of failure a negative value will be returned, and 0 on success. gnutls_x509_crq_get_attribute_by_oid ------------------------------------ -- Function: int gnutls_x509_crq_get_attribute_by_oid (gnutls_x509_crq_t CRQ, const char * OID, int INDX, void * BUF, size_t * SIZEOF_BUF) CRQ: should contain a gnutls_x509_crq_t structure OID: holds an Object Identified in null terminated string INDX: In case multiple same OIDs exist in the attribute list, this specifies which to send. Use zero to get the first one. BUF: a pointer to a structure to hold the attribute data (may be null) SIZEOF_BUF: initially holds the size of `buf' This function will return the attribute in the certificate request specified by the given Object ID. The attribute will be DER encoded. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crq_get_attribute_data ---------------------------------- -- Function: int gnutls_x509_crq_get_attribute_data (gnutls_x509_crq_t CERT, int INDX, void * DATA, size_t * SIZEOF_DATA) CERT: should contain a `gnutls_x509_crq_t' structure INDX: Specifies which attribute OID to send. Use zero to get the first one. DATA: a pointer to a structure to hold the data (may be null) SIZEOF_DATA: initially holds the size of `oid' This function will return the requested attribute data in the certificate request. The attribute data will be stored as a string in the provided buffer. Use `gnutls_x509_crq_get_attribute_info()' to extract the OID. Use `gnutls_x509_crq_get_attribute_by_oid()' instead, if you want to get data indexed by the attribute OID rather than sequence. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative value in case of an error. If your have reached the last extension available `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. *Since:* 2.8.0 gnutls_x509_crq_get_attribute_info ---------------------------------- -- Function: int gnutls_x509_crq_get_attribute_info (gnutls_x509_crq_t CERT, int INDX, void * OID, size_t * SIZEOF_OID) CERT: should contain a `gnutls_x509_crq_t' structure INDX: Specifies which attribute OID to send. Use zero to get the first one. OID: a pointer to a structure to hold the OID SIZEOF_OID: initially holds the maximum size of `oid', on return holds actual size of `oid'. This function will return the requested attribute OID in the certificate, and the critical flag for it. The attribute OID will be stored as a string in the provided buffer. Use `gnutls_x509_crq_get_attribute_data()' to extract the data. If the buffer provided is not long enough to hold the output, then *`sizeof_oid' is updated and `GNUTLS_E_SHORT_MEMORY_BUFFER' will be returned. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative value in case of an error. If your have reached the last extension available `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. *Since:* 2.8.0 gnutls_x509_crq_get_basic_constraints ------------------------------------- -- Function: int gnutls_x509_crq_get_basic_constraints (gnutls_x509_crq_t CERT, unsigned int * CRITICAL, int * CA, int * PATHLEN) CERT: should contain a `gnutls_x509_crq_t' structure CRITICAL: will be non zero if the extension is marked as critical CA: pointer to output integer indicating CA status, may be NULL, value is 1 if the certificate CA flag is set, 0 otherwise. PATHLEN: pointer to output integer indicating path length (may be NULL), non-negative values indicate a present pathLenConstraint field and the actual value, -1 indicate that the field is absent. This function will read the certificate's basic constraints, and return the certificates CA status. It reads the basicConstraints X.509 extension (2.5.29.19). *Return value:* If the certificate is a CA a positive value will be returned, or zero if the certificate does not have CA flag set. A negative value may be returned in case of errors. If the certificate does not contain the basicConstraints extension `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. *Since:* 2.8.0 gnutls_x509_crq_get_challenge_password -------------------------------------- -- Function: int gnutls_x509_crq_get_challenge_password (gnutls_x509_crq_t CRQ, char * PASS, size_t * SIZEOF_PASS) CRQ: should contain a gnutls_x509_crq_t structure PASS: will hold a null terminated password SIZEOF_PASS: Initially holds the size of `pass'. This function will return the challenge password in the request. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crq_get_dn_by_oid ----------------------------- -- Function: int gnutls_x509_crq_get_dn_by_oid (gnutls_x509_crq_t CRQ, const char * OID, int INDX, unsigned int RAW_FLAG, void * BUF, size_t * SIZEOF_BUF) CRQ: should contain a gnutls_x509_crq_t structure OID: holds an Object Identified in null terminated string INDX: In case multiple same OIDs exist in the RDN, this specifies which to send. Use zero to get the first one. RAW_FLAG: If non zero returns the raw DER data of the DN part. BUF: a pointer to a structure to hold the name (may be null) SIZEOF_BUF: initially holds the size of `buf' This function will extract the part of the name of the Certificate request subject, specified by the given OID. The output will be encoded as described in RFC2253. The output string will be ASCII or UTF-8 encoded, depending on the certificate data. Some helper macros with popular OIDs can be found in gnutls/x509.h If raw flag is zero, this function will only return known OIDs as text. Other OIDs will be DER encoded, as described in RFC2253 - in hex format with a '\#' prefix. You can check about known OIDs using `gnutls_x509_dn_oid_known()'. If `buf' is null then only the size will be filled. *Returns:* GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_buf will be updated with the required size. On success 0 is returned. gnutls_x509_crq_get_dn_oid -------------------------- -- Function: int gnutls_x509_crq_get_dn_oid (gnutls_x509_crq_t CRQ, int INDX, void * OID, size_t * SIZEOF_OID) CRQ: should contain a gnutls_x509_crq_t structure INDX: Specifies which DN OID to send. Use zero to get the first one. OID: a pointer to a structure to hold the name (may be null) SIZEOF_OID: initially holds the size of `oid' This function will extract the requested OID of the name of the Certificate request subject, specified by the given index. If oid is null then only the size will be filled. *Returns:* GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_oid will be updated with the required size. On success 0 is returned. gnutls_x509_crq_get_dn ---------------------- -- Function: int gnutls_x509_crq_get_dn (gnutls_x509_crq_t CRQ, char * BUF, size_t * SIZEOF_BUF) CRQ: should contain a gnutls_x509_crq_t structure BUF: a pointer to a structure to hold the name (may be null) SIZEOF_BUF: initially holds the size of `buf' This function will copy the name of the Certificate request subject in the provided buffer. The name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described in RFC2253. The output string will be ASCII or UTF-8 encoded, depending on the certificate data. If `buf' is null then only the size will be filled. *Returns:* GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_buf will be updated with the required size. On success 0 is returned. gnutls_x509_crq_get_extension_by_oid ------------------------------------ -- Function: int gnutls_x509_crq_get_extension_by_oid (gnutls_x509_crq_t CERT, const char * OID, int INDX, void * BUF, size_t * SIZEOF_BUF, unsigned int * CRITICAL) CERT: should contain a `gnutls_x509_crq_t' structure OID: holds an Object Identified in null terminated string INDX: In case multiple same OIDs exist in the extensions, this specifies which to send. Use zero to get the first one. BUF: a pointer to a structure to hold the name (may be null) SIZEOF_BUF: initially holds the size of `buf' CRITICAL: will be non zero if the extension is marked as critical This function will return the extension specified by the OID in the certificate. The extensions will be returned as binary data DER encoded, in the provided buffer. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative value in case of an error. If the certificate does not contain the specified extension `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. *Since:* 2.8.0 gnutls_x509_crq_get_extension_data ---------------------------------- -- Function: int gnutls_x509_crq_get_extension_data (gnutls_x509_crq_t CERT, int INDX, void * DATA, size_t * SIZEOF_DATA) CERT: should contain a `gnutls_x509_crq_t' structure INDX: Specifies which extension OID to send. Use zero to get the first one. DATA: a pointer to a structure to hold the data (may be null) SIZEOF_DATA: initially holds the size of `oid' This function will return the requested extension data in the certificate. The extension data will be stored as a string in the provided buffer. Use `gnutls_x509_crq_get_extension_info()' to extract the OID and critical flag. Use `gnutls_x509_crq_get_extension_by_oid()' instead, if you want to get data indexed by the extension OID rather than sequence. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative value in case of an error. If your have reached the last extension available `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. *Since:* 2.8.0 gnutls_x509_crq_get_extension_info ---------------------------------- -- Function: int gnutls_x509_crq_get_extension_info (gnutls_x509_crq_t CERT, int INDX, void * OID, size_t * SIZEOF_OID, int * CRITICAL) CERT: should contain a `gnutls_x509_crq_t' structure INDX: Specifies which extension OID to send. Use zero to get the first one. OID: a pointer to a structure to hold the OID SIZEOF_OID: initially holds the maximum size of `oid', on return holds actual size of `oid'. CRITICAL: output variable with critical flag, may be NULL. This function will return the requested extension OID in the certificate, and the critical flag for it. The extension OID will be stored as a string in the provided buffer. Use `gnutls_x509_crq_get_extension_data()' to extract the data. If the buffer provided is not long enough to hold the output, then *`sizeof_oid' is updated and `GNUTLS_E_SHORT_MEMORY_BUFFER' will be returned. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative value in case of an error. If your have reached the last extension available `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. *Since:* 2.8.0 gnutls_x509_crq_get_key_id -------------------------- -- Function: int gnutls_x509_crq_get_key_id (gnutls_x509_crq_t CRQ, unsigned int FLAGS, unsigned char * OUTPUT_DATA, size_t * OUTPUT_DATA_SIZE) CRQ: Holds the certificate signing request FLAGS: should be 0 for now OUTPUT_DATA: will contain the key ID OUTPUT_DATA_SIZE: holds the size of output_data (and will be replaced by the actual size of parameters) 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 private key. If the buffer provided is not long enough to hold the output, then *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. The output will normally be a SHA-1 hash output, which is 20 bytes. *Return value:* In case of failure a negative value will be returned, and 0 on success. *Since:* 2.8.0 gnutls_x509_crq_get_key_purpose_oid ----------------------------------- -- Function: int gnutls_x509_crq_get_key_purpose_oid (gnutls_x509_crq_t CERT, int INDX, void * OID, size_t * SIZEOF_OID, unsigned int * CRITICAL) CERT: should contain a `gnutls_x509_crq_t' structure INDX: This specifies which OID to return. Use zero to get the first one. OID: a pointer to a buffer to hold the OID (may be null) SIZEOF_OID: initially holds the size of `oid' CRITICAL: output variable with critical flag, may be NULL. This function will extract the key purpose OIDs of the Certificate specified by the given index. These are stored in the Extended Key Usage extension (2.5.29.37). See the GNUTLS_KP_* definitions for human readable names. If `oid' is null then only the size will be filled. *Returns:* `GNUTLS_E_SHORT_MEMORY_BUFFER' if the provided buffer is not long enough, and in that case the *sizeof_oid will be updated with the required size. On success 0 is returned. *Since:* 2.8.0 gnutls_x509_crq_get_key_rsa_raw ------------------------------- -- Function: int gnutls_x509_crq_get_key_rsa_raw (gnutls_x509_crq_t CRQ, gnutls_datum_t * M, gnutls_datum_t * E) CRQ: Holds the certificate M: will hold the modulus E: will hold the public exponent This function will export the RSA public key's parameters found in the given structure. The new parameters will be allocated using `gnutls_malloc()' and will be stored in the appropriate datum. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. *Since:* 2.8.0 gnutls_x509_crq_get_key_usage ----------------------------- -- Function: int gnutls_x509_crq_get_key_usage (gnutls_x509_crq_t CERT, unsigned int * KEY_USAGE, unsigned int * CRITICAL) CERT: should contain a `gnutls_x509_crq_t' structure KEY_USAGE: where the key usage bits will be stored CRITICAL: will be non zero if the extension is marked as critical This function will return certificate's key usage, by reading the keyUsage X.509 extension (2.5.29.15). The key usage value will *ORed values of the:* `GNUTLS_KEY_DIGITAL_SIGNATURE', `GNUTLS_KEY_NON_REPUDIATION', `GNUTLS_KEY_KEY_ENCIPHERMENT', `GNUTLS_KEY_DATA_ENCIPHERMENT', `GNUTLS_KEY_KEY_AGREEMENT', `GNUTLS_KEY_KEY_CERT_SIGN', `GNUTLS_KEY_CRL_SIGN', `GNUTLS_KEY_ENCIPHER_ONLY', `GNUTLS_KEY_DECIPHER_ONLY'. *Returns:* the certificate key usage, or a negative value in case of parsing error. If the certificate does not contain the keyUsage extension `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. *Since:* 2.8.0 gnutls_x509_crq_get_pk_algorithm -------------------------------- -- Function: int gnutls_x509_crq_get_pk_algorithm (gnutls_x509_crq_t CRQ, unsigned int * BITS) CRQ: should contain a gnutls_x509_crq_t structure BITS: if bits is non null it will hold the size of the parameters' in bits This function will return the public key algorithm of a PKCS \`10' certificate request. If bits is non null, it should have enough size to hold the parameters size in bits. For RSA the bits returned is the modulus. For DSA the bits returned are of the public exponent. *Returns:* a member of the `gnutls_pk_algorithm_t' enumeration on success, or a negative value on error. gnutls_x509_crq_get_subject_alt_name ------------------------------------ -- Function: int gnutls_x509_crq_get_subject_alt_name (gnutls_x509_crq_t CERT, unsigned int SEQ, void * RET, size_t * RET_SIZE, unsigned int * RET_TYPE, unsigned int * CRITICAL) CERT: should contain a `gnutls_x509_crq_t' structure SEQ: specifies the sequence number of the alt name, 0 for the first one, 1 for the second etc. RET: is the place where the alternative name will be copied to RET_SIZE: holds the size of ret. RET_TYPE: holds the `gnutls_x509_subject_alt_name_t' name type CRITICAL: will be non zero if the extension is marked as critical (may be null) This function will return the alternative names, contained in the given certificate. It is the same as `gnutls_x509_crq_get_subject_alt_name()' except for the fact that it will return the type of the alternative name in `ret_type' even if the function fails for some reason (i.e. the buffer provided is not enough). *Returns:* the alternative subject name type on success, one of the enumerated `gnutls_x509_subject_alt_name_t'. It will return `GNUTLS_E_SHORT_MEMORY_BUFFER' if `ret_size' is not large enough to hold the value. In that case `ret_size' will be updated with the required size. If the certificate request does not have an Alternative name with the specified sequence number then `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' is returned. *Since:* 2.8.0 gnutls_x509_crq_get_subject_alt_othername_oid --------------------------------------------- -- Function: int gnutls_x509_crq_get_subject_alt_othername_oid (gnutls_x509_crq_t CERT, unsigned int SEQ, void * RET, size_t * RET_SIZE) CERT: should contain a `gnutls_x509_crq_t' structure SEQ: specifies the sequence number of the alt name (0 for the first one, 1 for the second etc.) RET: is the place where the otherName OID will be copied to RET_SIZE: holds the size of ret. 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 `gnutls_x509_crq_get_subject_alt_name()' returned `GNUTLS_SAN_OTHERNAME'. *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. `GNUTLS_SAN_OTHERNAME_XMPP', and `GNUTLS_SAN_OTHERNAME' for unknown OIDs. It will return `GNUTLS_E_SHORT_MEMORY_BUFFER' if `ret_size' is not large enough to hold the value. In that case `ret_size' 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 `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' is returned. *Since:* 2.8.0 gnutls_x509_crq_get_version --------------------------- -- Function: int gnutls_x509_crq_get_version (gnutls_x509_crq_t CRQ) CRQ: should contain a gnutls_x509_crq_t structure This function will return the version of the specified Certificate request. *Returns:* version of certificate request, or a negative value on error. gnutls_x509_crq_import ---------------------- -- Function: int gnutls_x509_crq_import (gnutls_x509_crq_t CRQ, const gnutls_datum_t * DATA, gnutls_x509_crt_fmt_t FORMAT) CRQ: The structure to store the parsed certificate request. DATA: The DER or PEM encoded certificate. FORMAT: One of DER or PEM This function will convert the given DER or PEM encoded Certificate to the native gnutls_x509_crq_t format. The output will be stored in `cert'. If the Certificate is PEM encoded it should have a header of "NEW CERTIFICATE REQUEST". *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crq_init -------------------- -- Function: int gnutls_x509_crq_init (gnutls_x509_crq_t * CRQ) CRQ: The structure to be initialized This function will initialize a PKCS10 certificate request structure. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crq_print --------------------- -- Function: int gnutls_x509_crq_print (gnutls_x509_crq_t CRQ, gnutls_certificate_print_formats_t FORMAT, gnutls_datum_t * OUT) CRQ: The structure to be printed FORMAT: Indicate the format to use OUT: Newly allocated datum with zero terminated string. This function will pretty print a certificate request, suitable for display to a human. The output `out' needs to be deallocate using `gnutls_free()'. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. *Since:* 2.8.0 gnutls_x509_crq_set_attribute_by_oid ------------------------------------ -- Function: int gnutls_x509_crq_set_attribute_by_oid (gnutls_x509_crq_t CRQ, const char * OID, void * BUF, size_t SIZEOF_BUF) CRQ: should contain a gnutls_x509_crq_t structure OID: holds an Object Identified in null terminated string BUF: a pointer to a structure that holds the attribute data SIZEOF_BUF: holds the size of `buf' This function will set the attribute in the certificate request specified by the given Object ID. The attribute must be be DER encoded. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crq_set_basic_constraints ------------------------------------- -- Function: int gnutls_x509_crq_set_basic_constraints (gnutls_x509_crq_t CRQ, unsigned int CA, int PATHLENCONSTRAINT) CRQ: a certificate of type `gnutls_x509_crq_t' CA: true(1) or false(0). Depending on the Certificate authority status. PATHLENCONSTRAINT: non-negative values indicate maximum length of path, and negative values indicate that the pathLenConstraints field should not be present. This function will set the basicConstraints certificate extension. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. *Since:* 2.8.0 gnutls_x509_crq_set_challenge_password -------------------------------------- -- Function: int gnutls_x509_crq_set_challenge_password (gnutls_x509_crq_t CRQ, const char * PASS) CRQ: should contain a gnutls_x509_crq_t structure PASS: holds a null terminated password This function will set a challenge password to be used when revoking the request. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crq_set_dn_by_oid ----------------------------- -- Function: int gnutls_x509_crq_set_dn_by_oid (gnutls_x509_crq_t CRQ, const char * OID, unsigned int RAW_FLAG, const void * DATA, unsigned int SIZEOF_DATA) CRQ: should contain a gnutls_x509_crq_t structure OID: holds an Object Identifier in a null terminated string RAW_FLAG: must be 0, or 1 if the data are DER encoded DATA: a pointer to the input data SIZEOF_DATA: holds the size of `data' This function will set the part of the name of the Certificate request subject, specified by the given OID. The input string should be ASCII or UTF-8 encoded. Some helper macros with popular OIDs can be found in gnutls/x509.h With this function you can only set the known OIDs. You can test for known OIDs using `gnutls_x509_dn_oid_known()'. For OIDs that are not known (by gnutls) you should properly DER encode your data, and call this function with raw_flag set. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crq_set_key_purpose_oid ----------------------------------- -- Function: int gnutls_x509_crq_set_key_purpose_oid (gnutls_x509_crq_t CERT, const void * OID, unsigned int CRITICAL) CERT: a certificate of type `gnutls_x509_crq_t' OID: a pointer to a null terminated string that holds the OID CRITICAL: Whether this extension will be critical or not This function will set the key purpose OIDs of the Certificate. These are stored in the Extended Key Usage extension (2.5.29.37) See the GNUTLS_KP_* definitions for human readable names. Subsequent calls to this function will append OIDs to the OID list. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. *Since:* 2.8.0 gnutls_x509_crq_set_key_rsa_raw ------------------------------- -- Function: int gnutls_x509_crq_set_key_rsa_raw (gnutls_x509_crq_t CRQ, const gnutls_datum_t * M, const gnutls_datum_t * E) CRQ: should contain a `gnutls_x509_crq_t' structure M: holds the modulus E: holds the public exponent This function will set the public parameters from the given private key to the request. Only RSA keys are currently supported. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. *Since:* 2.6.0 gnutls_x509_crq_set_key_usage ----------------------------- -- Function: int gnutls_x509_crq_set_key_usage (gnutls_x509_crq_t CRQ, unsigned int USAGE) CRQ: a certificate of type `gnutls_x509_crq_t' USAGE: an ORed sequence of the GNUTLS_KEY_* elements. This function will set the keyUsage certificate extension. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. *Since:* 2.8.0 gnutls_x509_crq_set_key ----------------------- -- Function: int gnutls_x509_crq_set_key (gnutls_x509_crq_t CRQ, gnutls_x509_privkey_t KEY) CRQ: should contain a gnutls_x509_crq_t structure KEY: holds a private key This function will set the public parameters from the given private key to the request. Only RSA keys are currently supported. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crq_set_subject_alt_name ------------------------------------ -- Function: int gnutls_x509_crq_set_subject_alt_name (gnutls_x509_crq_t CRQ, gnutls_x509_subject_alt_name_t NT, const void * DATA, unsigned int DATA_SIZE, unsigned int FLAGS) CRQ: a certificate of type `gnutls_x509_crq_t' NT: is one of the `gnutls_x509_subject_alt_name_t' enumerations DATA: The data to be set DATA_SIZE: The size of data to be set FLAGS: `GNUTLS_FSAN_SET' to clear previous data or `GNUTLS_FSAN_APPEND' to append. This function will set the subject alternative name certificate extension. It can set the following types: &GNUTLS_SAN_DNSNAME: as a text string &GNUTLS_SAN_RFC822NAME: as a text string &GNUTLS_SAN_URI: as a text string &GNUTLS_SAN_IPADDRESS: as a binary IP address (4 or 16 bytes) Other values can be set as binary values with the proper DER encoding. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. *Since:* 2.8.0 gnutls_x509_crq_set_version --------------------------- -- Function: int gnutls_x509_crq_set_version (gnutls_x509_crq_t CRQ, unsigned int VERSION) CRQ: should contain a gnutls_x509_crq_t structure VERSION: holds the version number. For v1 Requests must be 1. This function will set the version of the certificate request. For version 1 requests this must be one. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crq_sign2 --------------------- -- Function: int gnutls_x509_crq_sign2 (gnutls_x509_crq_t CRQ, gnutls_x509_privkey_t KEY, gnutls_digest_algorithm_t DIG, unsigned int FLAGS) CRQ: should contain a `gnutls_x509_crq_t' structure KEY: holds a private key DIG: The message digest to use, `GNUTLS_DIG_SHA1' is the safe choice unless you know what you're doing. FLAGS: must be 0 This function will sign the certificate request with a private key. This must be the same key as the one used in `gnutls_x509_crt_set_key()' since a certificate request is self signed. This must be the last step in a certificate request generation since all the previously set parameters are now signed. *Returns:* `GNUTLS_E_SUCCESS' on success, otherwise an error. `GNUTLS_E_ASN1_VALUE_NOT_FOUND' is returned if you didn't set all information in the certificate request (e.g., the version using `gnutls_x509_crq_set_version()'). gnutls_x509_crq_sign -------------------- -- Function: int gnutls_x509_crq_sign (gnutls_x509_crq_t CRQ, gnutls_x509_privkey_t KEY) CRQ: should contain a gnutls_x509_crq_t structure KEY: holds a private key This function is the same a `gnutls_x509_crq_sign2()' with no flags, and SHA1 as the hash algorithm. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_check_hostname ------------------------------ -- Function: int gnutls_x509_crt_check_hostname (gnutls_x509_crt_t CERT, const char * HOSTNAME) CERT: should contain an gnutls_x509_crt_t structure HOSTNAME: A null terminated string that contains a DNS name This function will check if the given certificate's subject matches the given hostname. This is a basic implementation of the matching described in RFC2818 (HTTPS), which takes into account wildcards, and the DNSName/IPAddress subject alternative name PKIX extension. *Returns:* non zero for a successful match, and zero on failure. gnutls_x509_crt_check_issuer ---------------------------- -- Function: int gnutls_x509_crt_check_issuer (gnutls_x509_crt_t CERT, gnutls_x509_crt_t ISSUER) CERT: is the certificate to be checked ISSUER: is the certificate of a possible issuer This function will check if the given certificate was issued by the given issuer. *Returns:* It will return true (1) if the given certificate is issued by the given issuer, and false (0) if not. A negative value is returned in case of an error. gnutls_x509_crt_check_revocation -------------------------------- -- Function: int gnutls_x509_crt_check_revocation (gnutls_x509_crt_t CERT, const gnutls_x509_crl_t * CRL_LIST, int CRL_LIST_LENGTH) CERT: should contain a `gnutls_x509_crt_t' structure CRL_LIST: should contain a list of gnutls_x509_crl_t structures CRL_LIST_LENGTH: the length of the crl_list This function will return check if the given certificate is revoked. It is assumed that the CRLs have been verified before. *Returns:* 0 if the certificate is NOT revoked, and 1 if it is. A negative value is returned on error. gnutls_x509_crt_cpy_crl_dist_points ----------------------------------- -- Function: int gnutls_x509_crt_cpy_crl_dist_points (gnutls_x509_crt_t DST, gnutls_x509_crt_t SRC) DST: a certificate of type `gnutls_x509_crt_t' SRC: the certificate where the dist points will be copied from This function will copy the CRL distribution points certificate extension, from the source to the destination certificate. This may be useful to copy from a CA certificate to issued ones. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_deinit ---------------------- -- Function: void gnutls_x509_crt_deinit (gnutls_x509_crt_t CERT) CERT: The structure to be initialized This function will deinitialize a CRL structure. gnutls_x509_crt_export ---------------------- -- Function: int gnutls_x509_crt_export (gnutls_x509_crt_t CERT, gnutls_x509_crt_fmt_t FORMAT, void * OUTPUT_DATA, size_t * OUTPUT_DATA_SIZE) CERT: Holds the certificate FORMAT: the format of output params. One of PEM or DER. OUTPUT_DATA: will contain a certificate PEM or DER encoded OUTPUT_DATA_SIZE: holds the size of output_data (and will be replaced by the actual size of parameters) This function will export the certificate to DER or PEM format. If the buffer provided is not long enough to hold the output, then *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. If the structure is PEM encoded, it will have a header of "BEGIN CERTIFICATE". *Return value:* In case of failure a negative value will be returned, and 0 on success. gnutls_x509_crt_get_activation_time ----------------------------------- -- Function: time_t gnutls_x509_crt_get_activation_time (gnutls_x509_crt_t CERT) CERT: should contain a `gnutls_x509_crt_t' structure This function will return the time this Certificate was or will be activated. *Returns:* activation time, or (time_t)-1 on error. gnutls_x509_crt_get_authority_key_id ------------------------------------ -- Function: int gnutls_x509_crt_get_authority_key_id (gnutls_x509_crt_t CERT, void * RET, size_t * RET_SIZE, unsigned int * CRITICAL) CERT: should contain a `gnutls_x509_crt_t' structure RET: The place where the identifier will be copied RET_SIZE: Holds the size of the result field. CRITICAL: will be non zero if the extension is marked as critical (may be null) This function will return the X.509v3 certificate authority's key identifier. This is obtained by the X.509 Authority Key identifier extension field (2.5.29.35). Note that this function only returns the keyIdentifier field of the extension. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value.and a negative value in case of an error. gnutls_x509_crt_get_basic_constraints ------------------------------------- -- Function: int gnutls_x509_crt_get_basic_constraints (gnutls_x509_crt_t CERT, unsigned int * CRITICAL, int * CA, int * PATHLEN) CERT: should contain a `gnutls_x509_crt_t' structure CRITICAL: will be non zero if the extension is marked as critical CA: pointer to output integer indicating CA status, may be NULL, value is 1 if the certificate CA flag is set, 0 otherwise. PATHLEN: pointer to output integer indicating path length (may be NULL), non-negative values indicate a present pathLenConstraint field and the actual value, -1 indicate that the field is absent. This function will read the certificate's basic constraints, and return the certificates CA status. It reads the basicConstraints X.509 extension (2.5.29.19). *Return value:* If the certificate is a CA a positive value will be returned, or zero if the certificate does not have CA flag set. A negative value may be returned in case of errors. If the certificate does not contain the basicConstraints extension GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned. gnutls_x509_crt_get_ca_status ----------------------------- -- Function: int gnutls_x509_crt_get_ca_status (gnutls_x509_crt_t CERT, unsigned int * CRITICAL) CERT: should contain a `gnutls_x509_crt_t' structure CRITICAL: will be non zero if the extension is marked as critical This function will return certificates CA status, by reading the basicConstraints X.509 extension (2.5.29.19). If the certificate is a CA a positive value will be returned, or zero if the certificate does not have CA flag set. Use `gnutls_x509_crt_get_basic_constraints()' if you want to read the pathLenConstraint field too. *Returns:* A negative value may be returned in case of parsing error. If the certificate does not contain the basicConstraints extension `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. gnutls_x509_crt_get_crl_dist_points ----------------------------------- -- Function: int gnutls_x509_crt_get_crl_dist_points (gnutls_x509_crt_t CERT, unsigned int SEQ, void * RET, size_t * RET_SIZE, unsigned int * REASON_FLAGS, unsigned int * CRITICAL) CERT: should contain a `gnutls_x509_crt_t' structure SEQ: specifies the sequence number of the distribution point (0 for the first one, 1 for the second etc.) RET: is the place where the distribution point will be copied to RET_SIZE: holds the size of ret. REASON_FLAGS: Revocation reasons flags. CRITICAL: will be non zero if the extension is marked as critical (may be null) This function will return the CRL distribution points (2.5.29.31), contained in the given certificate. `reason_flags' should be an ORed sequence of GNUTLS_CRL_REASON_UNUSED, GNUTLS_CRL_REASON_KEY_COMPROMISE, GNUTLS_CRL_REASON_CA_COMPROMISE, GNUTLS_CRL_REASON_AFFILIATION_CHANGED, GNUTLS_CRL_REASON_SUPERSEEDED, GNUTLS_CRL_REASON_CESSATION_OF_OPERATION, GNUTLS_CRL_REASON_CERTIFICATE_HOLD, GNUTLS_CRL_REASON_PRIVILEGE_WITHDRAWN, GNUTLS_CRL_REASON_AA_COMPROMISE, or zero for all possible reasons. This is specified in X509v3 Certificate Extensions. GNUTLS will return the distribution point type, or a negative error code on error. *Returns:* `GNUTLS_E_SHORT_MEMORY_BUFFER' and updates &`ret_size' if &`ret_size' is not enough to hold the distribution point, or the type of the distribution point if everything was ok. The type is one of the enumerated `gnutls_x509_subject_alt_name_t'. If the certificate does not have an Alternative name with the specified sequence number then `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' is returned. gnutls_x509_crt_get_dn_by_oid ----------------------------- -- Function: int gnutls_x509_crt_get_dn_by_oid (gnutls_x509_crt_t CERT, const char * OID, int INDX, unsigned int RAW_FLAG, void * BUF, size_t * SIZEOF_BUF) CERT: should contain a `gnutls_x509_crt_t' structure OID: holds an Object Identified in null terminated string INDX: In case multiple same OIDs exist in the RDN, this specifies which to send. Use zero to get the first one. RAW_FLAG: If non zero returns the raw DER data of the DN part. BUF: a pointer where the DN part will be copied (may be null). SIZEOF_BUF: initially holds the size of `buf' This function will extract the part of the name of the Certificate subject specified by the given OID. The output, if the raw flag is not used, will be encoded as described in RFC2253. Thus a string that is ASCII or UTF-8 encoded, depending on the certificate data. Some helper macros with popular OIDs can be found in gnutls/x509.h If raw flag is zero, this function will only return known OIDs as text. Other OIDs will be DER encoded, as described in RFC2253 - in hex format with a '\#' prefix. You can check about known OIDs using `gnutls_x509_dn_oid_known()'. If `buf' is null then only the size will be filled. *Returns:* GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_buf will be updated with the required size. On success 0 is returned. gnutls_x509_crt_get_dn_oid -------------------------- -- Function: int gnutls_x509_crt_get_dn_oid (gnutls_x509_crt_t CERT, int INDX, void * OID, size_t * SIZEOF_OID) CERT: should contain a `gnutls_x509_crt_t' structure INDX: This specifies which OID to return. Use zero to get the first one. OID: a pointer to a buffer to hold the OID (may be null) SIZEOF_OID: initially holds the size of `oid' This function will extract the OIDs of the name of the Certificate subject specified by the given index. If oid is null then only the size will be filled. *Returns:* GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_oid will be updated with the required size. On success 0 is returned. gnutls_x509_crt_get_dn ---------------------- -- Function: int gnutls_x509_crt_get_dn (gnutls_x509_crt_t CERT, char * BUF, size_t * SIZEOF_BUF) CERT: should contain a `gnutls_x509_crt_t' structure BUF: a pointer to a structure to hold the name (may be null) SIZEOF_BUF: initially holds the size of `buf' This function will copy the name of the Certificate in the provided buffer. The name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described in RFC2253. The output string will be ASCII or UTF-8 encoded, depending on the certificate data. If `buf' is null then only the size will be filled. *Returns:* GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_buf will be updated with the required size. On success 0 is returned. gnutls_x509_crt_get_expiration_time ----------------------------------- -- Function: time_t gnutls_x509_crt_get_expiration_time (gnutls_x509_crt_t CERT) CERT: should contain a `gnutls_x509_crt_t' structure This function will return the time this Certificate was or will be expired. *Returns:* expiration time, or (time_t)-1 on error. gnutls_x509_crt_get_extension_by_oid ------------------------------------ -- Function: int gnutls_x509_crt_get_extension_by_oid (gnutls_x509_crt_t CERT, const char * OID, int INDX, void * BUF, size_t * SIZEOF_BUF, unsigned int * CRITICAL) CERT: should contain a `gnutls_x509_crt_t' structure OID: holds an Object Identified in null terminated string INDX: In case multiple same OIDs exist in the extensions, this specifies which to send. Use zero to get the first one. BUF: a pointer to a structure to hold the name (may be null) SIZEOF_BUF: initially holds the size of `buf' CRITICAL: will be non zero if the extension is marked as critical This function will return the extension specified by the OID in the certificate. The extensions will be returned as binary data DER encoded, in the provided buffer. *Returns:* On success, `GNUTLS_E_SUCCESS' (zero) is returned, otherwise an error code is returned. If the certificate does not contain the specified extension GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned. gnutls_x509_crt_get_extension_data ---------------------------------- -- Function: int gnutls_x509_crt_get_extension_data (gnutls_x509_crt_t CERT, int INDX, void * DATA, size_t * SIZEOF_DATA) CERT: should contain a `gnutls_x509_crt_t' structure INDX: Specifies which extension OID to send. Use zero to get the first one. DATA: a pointer to a structure to hold the data (may be null) SIZEOF_DATA: initially holds the size of `oid' This function will return the requested extension data in the certificate. The extension data will be stored as a string in the provided buffer. Use `gnutls_x509_crt_get_extension_info()' to extract the OID and critical flag. Use `gnutls_x509_crt_get_extension_by_oid()' instead, if you want to get data indexed by the extension OID rather than sequence. *Returns:* On success, `GNUTLS_E_SUCCESS' (zero) is returned, otherwise an error code is returned. If you have reached the last extension available `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. gnutls_x509_crt_get_extension_info ---------------------------------- -- Function: int gnutls_x509_crt_get_extension_info (gnutls_x509_crt_t CERT, int INDX, void * OID, size_t * SIZEOF_OID, int * CRITICAL) CERT: should contain a `gnutls_x509_crt_t' structure INDX: Specifies which extension OID to send. Use zero to get the first one. OID: a pointer to a structure to hold the OID SIZEOF_OID: initially holds the maximum size of `oid', on return holds actual size of `oid'. CRITICAL: output variable with critical flag, may be NULL. This function will return the requested extension OID in the certificate, and the critical flag for it. The extension OID will be stored as a string in the provided buffer. Use `gnutls_x509_crt_get_extension_data()' to extract the data. If the buffer provided is not long enough to hold the output, then *`sizeof_oid' is updated and `GNUTLS_E_SHORT_MEMORY_BUFFER' will be returned. *Returns:* On success, `GNUTLS_E_SUCCESS' (zero) is returned, otherwise an error code is returned. If you have reached the last extension available `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. gnutls_x509_crt_get_extension_oid --------------------------------- -- Function: int gnutls_x509_crt_get_extension_oid (gnutls_x509_crt_t CERT, int INDX, void * OID, size_t * SIZEOF_OID) CERT: should contain a `gnutls_x509_crt_t' structure INDX: Specifies which extension OID to send. Use zero to get the first one. OID: a pointer to a structure to hold the OID (may be null) SIZEOF_OID: initially holds the size of `oid' This function will return the requested extension OID in the certificate. The extension OID will be stored as a string in the provided buffer. *Returns:* On success, `GNUTLS_E_SUCCESS' (zero) is returned, otherwise an error code is returned. If you have reached the last extension available `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. gnutls_x509_crt_get_fingerprint ------------------------------- -- Function: int gnutls_x509_crt_get_fingerprint (gnutls_x509_crt_t CERT, gnutls_digest_algorithm_t ALGO, void * BUF, size_t * SIZEOF_BUF) CERT: should contain a `gnutls_x509_crt_t' structure ALGO: is a digest algorithm BUF: a pointer to a structure to hold the fingerprint (may be null) SIZEOF_BUF: initially holds the size of `buf' This function will calculate and copy the certificate's fingerprint in the provided buffer. If the buffer is null then only the size will be filled. *Returns:* `GNUTLS_E_SHORT_MEMORY_BUFFER' if the provided buffer is not long enough, and in that case the *sizeof_buf will be updated with the required size. On success 0 is returned. gnutls_x509_crt_get_issuer_dn_by_oid ------------------------------------ -- Function: int gnutls_x509_crt_get_issuer_dn_by_oid (gnutls_x509_crt_t CERT, const char * OID, int INDX, unsigned int RAW_FLAG, void * BUF, size_t * SIZEOF_BUF) CERT: should contain a `gnutls_x509_crt_t' structure OID: holds an Object Identified in null terminated string INDX: In case multiple same OIDs exist in the RDN, this specifies which to send. Use zero to get the first one. RAW_FLAG: If non zero returns the raw DER data of the DN part. BUF: a pointer to a structure to hold the name (may be null) SIZEOF_BUF: initially holds the size of `buf' This function will extract the part of the name of the Certificate issuer specified by the given OID. The output, if the raw flag is not used, will be encoded as described in RFC2253. Thus a string that is ASCII or UTF-8 encoded, depending on the certificate data. Some helper macros with popular OIDs can be found in gnutls/x509.h If raw flag is zero, this function will only return known OIDs as text. Other OIDs will be DER encoded, as described in RFC2253 - in hex format with a '\#' prefix. You can check about known OIDs using `gnutls_x509_dn_oid_known()'. If `buf' is null then only the size will be filled. *Returns:* GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_buf will be updated with the required size. On success 0 is returned. gnutls_x509_crt_get_issuer_dn_oid --------------------------------- -- Function: int gnutls_x509_crt_get_issuer_dn_oid (gnutls_x509_crt_t CERT, int INDX, void * OID, size_t * SIZEOF_OID) CERT: should contain a `gnutls_x509_crt_t' structure INDX: This specifies which OID to return. Use zero to get the first one. OID: a pointer to a buffer to hold the OID (may be null) SIZEOF_OID: initially holds the size of `oid' This function will extract the OIDs of the name of the Certificate issuer specified by the given index. If `oid' is null then only the size will be filled. *Returns:* GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_oid will be updated with the required size. On success 0 is returned. gnutls_x509_crt_get_issuer_dn ----------------------------- -- Function: int gnutls_x509_crt_get_issuer_dn (gnutls_x509_crt_t CERT, char * BUF, size_t * SIZEOF_BUF) CERT: should contain a `gnutls_x509_crt_t' structure BUF: a pointer to a structure to hold the name (may be null) SIZEOF_BUF: initially holds the size of `buf' This function will copy the name of the Certificate issuer in the provided buffer. The name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described in RFC2253. The output string will be ASCII or UTF-8 encoded, depending on the certificate data. If `buf' is null then only the size will be filled. *Returns:* GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and in that case the *sizeof_buf will be updated with the required size. On success 0 is returned. gnutls_x509_crt_get_issuer -------------------------- -- Function: int gnutls_x509_crt_get_issuer (gnutls_x509_crt_t CERT, gnutls_x509_dn_t * DN) CERT: should contain a `gnutls_x509_crt_t' structure DN: output variable with pointer to opaque DN Return the Certificate's Issuer DN as an opaque data type. You may use `gnutls_x509_dn_get_rdn_ava()' to decode the DN. Note that `dn' should be treated as constant. Because points into the `cert' object, you may not deallocate `cert' and continue to access `dn'. *Returns:* Returns 0 on success, or an error code. gnutls_x509_crt_get_key_id -------------------------- -- Function: int gnutls_x509_crt_get_key_id (gnutls_x509_crt_t CRT, unsigned int FLAGS, unsigned char * OUTPUT_DATA, size_t * OUTPUT_DATA_SIZE) CRT: Holds the certificate FLAGS: should be 0 for now OUTPUT_DATA: will contain the key ID OUTPUT_DATA_SIZE: holds the size of output_data (and will be replaced by the actual size of parameters) 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 private key. If the buffer provided is not long enough to hold the output, then *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. The output will normally be a SHA-1 hash output, which is 20 bytes. *Return value:* In case of failure a negative value will be returned, and 0 on success. gnutls_x509_crt_get_key_purpose_oid ----------------------------------- -- Function: int gnutls_x509_crt_get_key_purpose_oid (gnutls_x509_crt_t CERT, int INDX, void * OID, size_t * SIZEOF_OID, unsigned int * CRITICAL) CERT: should contain a `gnutls_x509_crt_t' structure INDX: This specifies which OID to return. Use zero to get the first one. OID: a pointer to a buffer to hold the OID (may be null) SIZEOF_OID: initially holds the size of `oid' CRITICAL: output flag to indicate criticality of extension This function will extract the key purpose OIDs of the Certificate specified by the given index. These are stored in the Extended Key Usage extension (2.5.29.37) See the GNUTLS_KP_* definitions for human readable names. If `oid' is null then only the size will be filled. *Returns:* `GNUTLS_E_SHORT_MEMORY_BUFFER' if the provided buffer is not long enough, and in that case the *sizeof_oid will be updated with the required size. On success 0 is returned. gnutls_x509_crt_get_key_usage ----------------------------- -- Function: int gnutls_x509_crt_get_key_usage (gnutls_x509_crt_t CERT, unsigned int * KEY_USAGE, unsigned int * CRITICAL) CERT: should contain a `gnutls_x509_crt_t' structure KEY_USAGE: where the key usage bits will be stored CRITICAL: will be non zero if the extension is marked as critical This function will return certificate's key usage, by reading the keyUsage X.509 extension (2.5.29.15). The key usage value will *ORed values of the:* `GNUTLS_KEY_DIGITAL_SIGNATURE', `GNUTLS_KEY_NON_REPUDIATION', `GNUTLS_KEY_KEY_ENCIPHERMENT', `GNUTLS_KEY_DATA_ENCIPHERMENT', `GNUTLS_KEY_KEY_AGREEMENT', `GNUTLS_KEY_KEY_CERT_SIGN', `GNUTLS_KEY_CRL_SIGN', `GNUTLS_KEY_ENCIPHER_ONLY', `GNUTLS_KEY_DECIPHER_ONLY'. *Returns:* the certificate key usage, or a negative value in case of parsing error. If the certificate does not contain the keyUsage extension `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. gnutls_x509_crt_get_pk_algorithm -------------------------------- -- Function: int gnutls_x509_crt_get_pk_algorithm (gnutls_x509_crt_t CERT, unsigned int * BITS) CERT: should contain a `gnutls_x509_crt_t' structure BITS: if bits is non null it will hold the size of the parameters' in bits This function will return the public key algorithm of an X.509 certificate. If bits is non null, it should have enough size to hold the parameters size in bits. For RSA the bits returned is the modulus. For DSA the bits returned are of the public exponent. *Returns:* a member of the `gnutls_pk_algorithm_t' enumeration on success, or a negative value on error. gnutls_x509_crt_get_pk_dsa_raw ------------------------------ -- Function: int gnutls_x509_crt_get_pk_dsa_raw (gnutls_x509_crt_t CRT, gnutls_datum_t * P, gnutls_datum_t * Q, gnutls_datum_t * G, gnutls_datum_t * Y) CRT: Holds the certificate P: will hold the p Q: will hold the q G: will hold the g Y: will hold the y This function will export the DSA public key's parameters found in the given certificate. The new parameters will be allocated using `gnutls_malloc()' and will be stored in the appropriate datum. *Returns:* `GNUTLS_E_SUCCESS' on success, otherwise an error. gnutls_x509_crt_get_pk_rsa_raw ------------------------------ -- Function: int gnutls_x509_crt_get_pk_rsa_raw (gnutls_x509_crt_t CRT, gnutls_datum_t * M, gnutls_datum_t * E) CRT: Holds the certificate M: will hold the modulus E: will hold the public exponent This function will export the RSA public key's parameters found in the given structure. The new parameters will be allocated using `gnutls_malloc()' and will be stored in the appropriate datum. *Returns:* `GNUTLS_E_SUCCESS' on success, otherwise an error. gnutls_x509_crt_get_proxy ------------------------- -- Function: int gnutls_x509_crt_get_proxy (gnutls_x509_crt_t CERT, unsigned int * CRITICAL, int * PATHLEN, char ** POLICYLANGUAGE, char ** POLICY, size_t * SIZEOF_POLICY) CERT: should contain a `gnutls_x509_crt_t' structure CRITICAL: will be non zero if the extension is marked as critical PATHLEN: pointer to output integer indicating path length (may be NULL), non-negative values indicate a present pCPathLenConstraint field and the actual value, -1 indicate that the field is absent. POLICYLANGUAGE: output variable with OID of policy language POLICY: output variable with policy data SIZEOF_POLICY: output variable size of policy data This function will get information from a proxy certificate. It reads the ProxyCertInfo X.509 extension (1.3.6.1.5.5.7.1.14). *Returns:* On success, `GNUTLS_E_SUCCESS' (zero) is returned, otherwise an error code is returned. gnutls_x509_crt_get_raw_dn -------------------------- -- Function: int gnutls_x509_crt_get_raw_dn (gnutls_x509_crt_t CERT, gnutls_datum_t * START) CERT: should contain a `gnutls_x509_crt_t' structure START: will hold the starting point of the DN This function will return a pointer to the DER encoded DN structure and the length. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. or a negative value on error. gnutls_x509_crt_get_raw_issuer_dn --------------------------------- -- Function: int gnutls_x509_crt_get_raw_issuer_dn (gnutls_x509_crt_t CERT, gnutls_datum_t * START) CERT: should contain a `gnutls_x509_crt_t' structure START: will hold the starting point of the DN This function will return a pointer to the DER encoded DN structure and the length. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value.or a negative value on error. gnutls_x509_crt_get_serial -------------------------- -- Function: int gnutls_x509_crt_get_serial (gnutls_x509_crt_t CERT, void * RESULT, size_t * RESULT_SIZE) CERT: should contain a `gnutls_x509_crt_t' structure RESULT: The place where the serial number will be copied RESULT_SIZE: Holds the size of the result field. 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. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value.and a negative value in case of an error. gnutls_x509_crt_get_signature_algorithm --------------------------------------- -- Function: int gnutls_x509_crt_get_signature_algorithm (gnutls_x509_crt_t CERT) CERT: should contain a `gnutls_x509_crt_t' structure This function will return a value of the `gnutls_sign_algorithm_t' enumeration that is the signature algorithm. *Returns:* a `gnutls_sign_algorithm_t' value, or a negative value on error. gnutls_x509_crt_get_signature ----------------------------- -- Function: int gnutls_x509_crt_get_signature (gnutls_x509_crt_t CERT, char * SIG, size_t * SIZEOF_SIG) CERT: should contain a `gnutls_x509_crt_t' structure SIG: a pointer where the signature part will be copied (may be null). SIZEOF_SIG: initially holds the size of `sig' This function will extract the signature field of a certificate. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. and a negative value on error. gnutls_x509_crt_get_subject_alt_name2 ------------------------------------- -- Function: 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) CERT: should contain a `gnutls_x509_crt_t' structure SEQ: specifies the sequence number of the alt name (0 for the first one, 1 for the second etc.) RET: is the place where the alternative name will be copied to RET_SIZE: holds the size of ret. RET_TYPE: holds the type of the alternative name (one of gnutls_x509_subject_alt_name_t). CRITICAL: will be non zero if the extension is marked as critical (may be null) This function will return the alternative names, contained in the given certificate. It is the same as `gnutls_x509_crt_get_subject_alt_name()' except for the fact that it will return the type of the alternative name in `ret_type' even if the function fails for some reason (i.e. the buffer provided is not enough). *Returns:* the alternative subject name type on success, one of the enumerated `gnutls_x509_subject_alt_name_t'. It will return `GNUTLS_E_SHORT_MEMORY_BUFFER' if `ret_size' is not large enough to hold the value. In that case `ret_size' will be updated with the required size. If the certificate does not have an Alternative name with the specified sequence number then `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' is returned. gnutls_x509_crt_get_subject_alt_name ------------------------------------ -- Function: 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) CERT: should contain a `gnutls_x509_crt_t' structure SEQ: specifies the sequence number of the alt name (0 for the first one, 1 for the second etc.) RET: is the place where the alternative name will be copied to RET_SIZE: holds the size of ret. CRITICAL: will be non zero if the extension is marked as critical (may be null) 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 `GNUTLS_SAN_OTHERNAME' is returned. You may use `gnutls_x509_crt_get_subject_alt_othername_oid()' to get the corresponding OID and the "virtual" SAN types (e.g., `GNUTLS_SAN_OTHERNAME_XMPP'). 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. *Returns:* the alternative subject name type on success, one of the enumerated `gnutls_x509_subject_alt_name_t'. It will return `GNUTLS_E_SHORT_MEMORY_BUFFER' if `ret_size' is not large enough to hold the value. In that case `ret_size' will be updated with the required size. If the certificate does not have an Alternative name with the specified sequence number then `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' is returned. gnutls_x509_crt_get_subject_alt_othername_oid --------------------------------------------- -- Function: int gnutls_x509_crt_get_subject_alt_othername_oid (gnutls_x509_crt_t CERT, unsigned int SEQ, void * RET, size_t * RET_SIZE) CERT: should contain a `gnutls_x509_crt_t' structure SEQ: specifies the sequence number of the alt name (0 for the first one, 1 for the second etc.) RET: is the place where the otherName OID will be copied to RET_SIZE: holds the size of ret. 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 `gnutls_x509_crt_get_subject_alt_name()' returned `GNUTLS_SAN_OTHERNAME'. *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. `GNUTLS_SAN_OTHERNAME_XMPP', and `GNUTLS_SAN_OTHERNAME' for unknown OIDs. It will return `GNUTLS_E_SHORT_MEMORY_BUFFER' if `ret_size' is not large enough to hold the value. In that case `ret_size' 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 `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' is returned. gnutls_x509_crt_get_subject_key_id ---------------------------------- -- Function: int gnutls_x509_crt_get_subject_key_id (gnutls_x509_crt_t CERT, void * RET, size_t * RET_SIZE, unsigned int * CRITICAL) CERT: should contain a `gnutls_x509_crt_t' structure RET: The place where the identifier will be copied RET_SIZE: Holds the size of the result field. CRITICAL: will be non zero if the extension is marked as critical (may be null) 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). *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value.and a negative value in case of an error. gnutls_x509_crt_get_subject --------------------------- -- Function: int gnutls_x509_crt_get_subject (gnutls_x509_crt_t CERT, gnutls_x509_dn_t * DN) CERT: should contain a `gnutls_x509_crt_t' structure DN: output variable with pointer to opaque DN. Return the Certificate's Subject DN as an opaque data type. You may use `gnutls_x509_dn_get_rdn_ava()' to decode the DN. Note that `dn' should be treated as constant. Because points into the `cert' object, you may not deallocate `cert' and continue to access `dn'. *Returns:* Returns 0 on success, or an error code. gnutls_x509_crt_get_verify_algorithm ------------------------------------ -- Function: int gnutls_x509_crt_get_verify_algorithm (gnutls_x509_crt_t CRT, const gnutls_datum_t * SIGNATURE, gnutls_digest_algorithm_t * HASH) CRT: Holds the certificate SIGNATURE: contains the signature HASH: The result of the call with the hash algorithm used for signature This function will read the certifcate and the signed data to determine the hash algorithm used to generate the signature. *Returns:* the 0 if the hash algorithm is found. A negative value is returned on error. *Since:* 2.8.0 gnutls_x509_crt_get_version --------------------------- -- Function: int gnutls_x509_crt_get_version (gnutls_x509_crt_t CERT) CERT: should contain a `gnutls_x509_crt_t' structure This function will return the version of the specified Certificate. *Returns:* version of certificate, or a negative value on error. gnutls_x509_crt_import ---------------------- -- Function: int gnutls_x509_crt_import (gnutls_x509_crt_t CERT, const gnutls_datum_t * DATA, gnutls_x509_crt_fmt_t FORMAT) CERT: The structure to store the parsed certificate. DATA: The DER or PEM encoded certificate. FORMAT: One of DER or PEM 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 `cert'. If the Certificate is PEM encoded it should have a header of "X509 CERTIFICATE", or "CERTIFICATE". *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_init -------------------- -- Function: int gnutls_x509_crt_init (gnutls_x509_crt_t * CERT) CERT: The structure to be initialized This function will initialize an X.509 certificate structure. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_list_import --------------------------- -- Function: int gnutls_x509_crt_list_import (gnutls_x509_crt_t * CERTS, unsigned int * CERT_MAX, const gnutls_datum_t * DATA, gnutls_x509_crt_fmt_t FORMAT, unsigned int FLAGS) CERTS: The structures to store the parsed certificate. Must not be initialized. CERT_MAX: Initially must hold the maximum number of certs. It will be updated with the number of certs available. DATA: The PEM encoded certificate. FORMAT: One of DER or PEM. FLAGS: must be zero or an OR'd sequence of gnutls_certificate_import_flags. This function will convert the given PEM encoded certificate list to the native gnutls_x509_crt_t format. The output will be stored in `certs'. They will be automatically initialized. If the Certificate is PEM encoded it should have a header of "X509 CERTIFICATE", or "CERTIFICATE". *Returns:* the number of certificates read or a negative error value. gnutls_x509_crt_list_verify --------------------------- -- Function: int gnutls_x509_crt_list_verify (const gnutls_x509_crt_t * CERT_LIST, int CERT_LIST_LENGTH, const gnutls_x509_crt_t * CA_LIST, int CA_LIST_LENGTH, const gnutls_x509_crl_t * CRL_LIST, int CRL_LIST_LENGTH, unsigned int FLAGS, unsigned int * VERIFY) CERT_LIST: is the certificate list to be verified CERT_LIST_LENGTH: holds the number of certificate in cert_list CA_LIST: is the CA list which will be used in verification CA_LIST_LENGTH: holds the number of CA certificate in CA_list CRL_LIST: holds a list of CRLs. CRL_LIST_LENGTH: the length of CRL list. FLAGS: Flags that may be used to change the verification algorithm. Use OR of the gnutls_certificate_verify_flags enumerations. VERIFY: will hold the certificate verification output. This function will try to verify the given certificate list and return its status. If no flags are specified (0), this function will use the basicConstraints (2.5.29.19) PKIX extension. This means that only a certificate authority is allowed to sign a certificate. You must also check the peer's name in order to check if the verified certificate belongs to the actual peer. The certificate verification output will be put in `verify' and will be one or more of the gnutls_certificate_status_t enumerated elements bitwise or'd. For a more detailed verification status use `gnutls_x509_crt_verify()' per list element. *GNUTLS_CERT_INVALID:* the certificate chain is not valid. *GNUTLS_CERT_REVOKED:* a certificate in the chain has been revoked. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value.and a negative value in case of an error. gnutls_x509_crt_print --------------------- -- Function: int gnutls_x509_crt_print (gnutls_x509_crt_t CERT, gnutls_certificate_print_formats_t FORMAT, gnutls_datum_t * OUT) CERT: The structure to be printed FORMAT: Indicate the format to use OUT: Newly allocated datum with zero terminated string. This function will pretty print a X.509 certificate, suitable for display to a human. If the format is `GNUTLS_CRT_PRINT_FULL' then all fields of the certificate will be output, on multiple lines. The `GNUTLS_CRT_PRINT_ONELINE' format will generate one line with some selected fields, which is useful for logging purposes. The output `out' needs to be deallocate using `gnutls_free()'. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_activation_time ----------------------------------- -- Function: int gnutls_x509_crt_set_activation_time (gnutls_x509_crt_t CERT, time_t ACT_TIME) CERT: a certificate of type `gnutls_x509_crt_t' ACT_TIME: The actual time This function will set the time this Certificate was or will be activated. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_authority_key_id ------------------------------------ -- Function: int gnutls_x509_crt_set_authority_key_id (gnutls_x509_crt_t CERT, const void * ID, size_t ID_SIZE) CERT: a certificate of type `gnutls_x509_crt_t' ID: The key ID ID_SIZE: Holds the size of the serial field. This function will set the X.509 certificate's authority key ID extension. Only the keyIdentifier field can be set with this function. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_basic_constraints ------------------------------------- -- Function: int gnutls_x509_crt_set_basic_constraints (gnutls_x509_crt_t CRT, unsigned int CA, int PATHLENCONSTRAINT) CRT: a certificate of type `gnutls_x509_crt_t' CA: true(1) or false(0). Depending on the Certificate authority status. PATHLENCONSTRAINT: non-negative values indicate maximum length of path, and negative values indicate that the pathLenConstraints field should not be present. This function will set the basicConstraints certificate extension. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_ca_status ----------------------------- -- Function: int gnutls_x509_crt_set_ca_status (gnutls_x509_crt_t CRT, unsigned int CA) CRT: a certificate of type `gnutls_x509_crt_t' CA: true(1) or false(0). Depending on the Certificate authority status. This function will set the basicConstraints certificate extension. Use `gnutls_x509_crt_set_basic_constraints()' if you want to control the pathLenConstraint field too. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_crl_dist_points2 ------------------------------------ -- Function: int gnutls_x509_crt_set_crl_dist_points2 (gnutls_x509_crt_t CRT, gnutls_x509_subject_alt_name_t TYPE, const void * DATA, unsigned int DATA_SIZE, unsigned int REASON_FLAGS) CRT: a certificate of type `gnutls_x509_crt_t' TYPE: is one of the gnutls_x509_subject_alt_name_t enumerations DATA: The data to be set DATA_SIZE: The data size REASON_FLAGS: revocation reasons This function will set the CRL distribution points certificate extension. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. *Since:* 2.6.0 gnutls_x509_crt_set_crl_dist_points ----------------------------------- -- Function: int gnutls_x509_crt_set_crl_dist_points (gnutls_x509_crt_t CRT, gnutls_x509_subject_alt_name_t TYPE, const void * DATA_STRING, unsigned int REASON_FLAGS) CRT: a certificate of type `gnutls_x509_crt_t' TYPE: is one of the gnutls_x509_subject_alt_name_t enumerations DATA_STRING: The data to be set REASON_FLAGS: revocation reasons This function will set the CRL distribution points certificate extension. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_crq_extensions ---------------------------------- -- Function: int gnutls_x509_crt_set_crq_extensions (gnutls_x509_crt_t CRT, gnutls_x509_crq_t CRQ) CRT: a certificate of type `gnutls_x509_crt_t' CRQ: holds a certificate request This function will set extensions from the given request to the certificate. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. *Since:* 2.8.0 gnutls_x509_crt_set_crq ----------------------- -- Function: int gnutls_x509_crt_set_crq (gnutls_x509_crt_t CRT, gnutls_x509_crq_t CRQ) CRT: a certificate of type `gnutls_x509_crt_t' CRQ: holds a certificate request This function will set the name and public parameters as well as the extensions from the given certificate request to the certificate. Only RSA keys are currently supported. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_dn_by_oid ----------------------------- -- Function: int gnutls_x509_crt_set_dn_by_oid (gnutls_x509_crt_t CRT, const char * OID, unsigned int RAW_FLAG, const void * NAME, unsigned int SIZEOF_NAME) CRT: a certificate of type `gnutls_x509_crt_t' OID: holds an Object Identifier in a null terminated string RAW_FLAG: must be 0, or 1 if the data are DER encoded NAME: a pointer to the name SIZEOF_NAME: holds the size of `name' This function will set the part of the name of the Certificate subject, specified by the given OID. The input string should be ASCII or UTF-8 encoded. Some helper macros with popular OIDs can be found in gnutls/x509.h With this function you can only set the known OIDs. You can test for known OIDs using `gnutls_x509_dn_oid_known()'. For OIDs that are not known (by gnutls) you should properly DER encode your data, and call this function with `raw_flag' set. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_expiration_time ----------------------------------- -- Function: int gnutls_x509_crt_set_expiration_time (gnutls_x509_crt_t CERT, time_t EXP_TIME) CERT: a certificate of type `gnutls_x509_crt_t' EXP_TIME: The actual time This function will set the time this Certificate will expire. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_extension_by_oid ------------------------------------ -- Function: int gnutls_x509_crt_set_extension_by_oid (gnutls_x509_crt_t CRT, const char * OID, const void * BUF, size_t SIZEOF_BUF, unsigned int CRITICAL) CRT: a certificate of type `gnutls_x509_crt_t' OID: holds an Object Identified in null terminated string BUF: a pointer to a DER encoded data SIZEOF_BUF: holds the size of `buf' CRITICAL: should be non zero if the extension is to be marked as critical This function will set an the extension, by the specified OID, in the certificate. The extension data should be binary data DER encoded. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value.and a negative value in case of an error. gnutls_x509_crt_set_issuer_dn_by_oid ------------------------------------ -- Function: int gnutls_x509_crt_set_issuer_dn_by_oid (gnutls_x509_crt_t CRT, const char * OID, unsigned int RAW_FLAG, const void * NAME, unsigned int SIZEOF_NAME) CRT: a certificate of type `gnutls_x509_crt_t' OID: holds an Object Identifier in a null terminated string RAW_FLAG: must be 0, or 1 if the data are DER encoded NAME: a pointer to the name SIZEOF_NAME: holds the size of `name' This function will set the part of the name of the Certificate issuer, specified by the given OID. The input string should be ASCII or UTF-8 encoded. Some helper macros with popular OIDs can be found in gnutls/x509.h With this function you can only set the known OIDs. You can test for known OIDs using `gnutls_x509_dn_oid_known()'. For OIDs that are not known (by gnutls) you should properly DER encode your data, and call this function with `raw_flag' set. Normally you do not need to call this function, since the signing operation will copy the signer's name as the issuer of the certificate. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_key_purpose_oid ----------------------------------- -- Function: int gnutls_x509_crt_set_key_purpose_oid (gnutls_x509_crt_t CERT, const void * OID, unsigned int CRITICAL) CERT: a certificate of type `gnutls_x509_crt_t' OID: a pointer to a null terminated string that holds the OID CRITICAL: Whether this extension will be critical or not This function will set the key purpose OIDs of the Certificate. These are stored in the Extended Key Usage extension (2.5.29.37) See the GNUTLS_KP_* definitions for human readable names. Subsequent calls to this function will append OIDs to the OID list. *Returns:* On success, `GNUTLS_E_SUCCESS' (zero) is returned, otherwise an error code is returned. gnutls_x509_crt_set_key_usage ----------------------------- -- Function: int gnutls_x509_crt_set_key_usage (gnutls_x509_crt_t CRT, unsigned int USAGE) CRT: a certificate of type `gnutls_x509_crt_t' USAGE: an ORed sequence of the GNUTLS_KEY_* elements. This function will set the keyUsage certificate extension. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_key ----------------------- -- Function: int gnutls_x509_crt_set_key (gnutls_x509_crt_t CRT, gnutls_x509_privkey_t KEY) CRT: a certificate of type `gnutls_x509_crt_t' KEY: holds a private key This function will set the public parameters from the given private key to the certificate. Only RSA keys are currently supported. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_proxy_dn ---------------------------- -- Function: int gnutls_x509_crt_set_proxy_dn (gnutls_x509_crt_t CRT, gnutls_x509_crt_t EECRT, unsigned int RAW_FLAG, const void * NAME, unsigned int SIZEOF_NAME) CRT: a gnutls_x509_crt_t structure with the new proxy cert EECRT: the end entity certificate that will be issuing the proxy RAW_FLAG: must be 0, or 1 if the CN is DER encoded NAME: a pointer to the CN name, may be NULL (but MUST then be added later) SIZEOF_NAME: holds the size of `name' This function will set the subject in `crt' to the end entity's `eecrt' subject name, and add a single Common Name component `name' of size `sizeof_name'. This corresponds to the required proxy certificate naming style. Note that if `name' is `NULL', you MUST set it later by using `gnutls_x509_crt_set_dn_by_oid()' or similar. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_proxy ------------------------- -- Function: int gnutls_x509_crt_set_proxy (gnutls_x509_crt_t CRT, int PATHLENCONSTRAINT, const char * POLICYLANGUAGE, const char * POLICY, size_t SIZEOF_POLICY) CRT: a certificate of type `gnutls_x509_crt_t' PATHLENCONSTRAINT: non-negative values indicate maximum length of path, and negative values indicate that the pathLenConstraints field should not be present. POLICYLANGUAGE: OID describing the language of `policy'. POLICY: opaque byte array with policy language, can be `NULL' SIZEOF_POLICY: size of `policy'. This function will set the proxyCertInfo extension. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_serial -------------------------- -- Function: int gnutls_x509_crt_set_serial (gnutls_x509_crt_t CERT, const void * SERIAL, size_t SERIAL_SIZE) CERT: a certificate of type `gnutls_x509_crt_t' SERIAL: The serial number SERIAL_SIZE: Holds the size of the serial field. This function will set the X.509 certificate's serial number. 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. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_subject_alt_name ------------------------------------ -- Function: int gnutls_x509_crt_set_subject_alt_name (gnutls_x509_crt_t CRT, gnutls_x509_subject_alt_name_t TYPE, const void * DATA, unsigned int DATA_SIZE, unsigned int FLAGS) CRT: a certificate of type `gnutls_x509_crt_t' TYPE: is one of the gnutls_x509_subject_alt_name_t enumerations DATA: The data to be set DATA_SIZE: The size of data to be set FLAGS: GNUTLS_FSAN_SET to clear previous data or GNUTLS_FSAN_APPEND to append. This function will set the subject alternative name certificate extension. It can set the following types: &GNUTLS_SAN_DNSNAME: as a text string &GNUTLS_SAN_RFC822NAME: as a text string &GNUTLS_SAN_URI: as a text string &GNUTLS_SAN_IPADDRESS: as a binary IP address (4 or 16 bytes) Other values can be set as binary values with the proper DER encoding. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. *Since:* 2.6.0 gnutls_x509_crt_set_subject_alternative_name -------------------------------------------- -- Function: int gnutls_x509_crt_set_subject_alternative_name (gnutls_x509_crt_t CRT, gnutls_x509_subject_alt_name_t TYPE, const char * DATA_STRING) CRT: a certificate of type `gnutls_x509_crt_t' TYPE: is one of the gnutls_x509_subject_alt_name_t enumerations DATA_STRING: The data to be set, a zero terminated string This function will set the subject alternative name certificate extension. This function assumes that data can be expressed as a null terminated string. The name of the function is unfortunate since it is incosistent with `gnutls_x509_crt_get_subject_alt_name()'. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_subject_key_id ---------------------------------- -- Function: int gnutls_x509_crt_set_subject_key_id (gnutls_x509_crt_t CERT, const void * ID, size_t ID_SIZE) CERT: a certificate of type `gnutls_x509_crt_t' ID: The key ID ID_SIZE: Holds the size of the serial field. This function will set the X.509 certificate's subject key ID extension. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_set_version --------------------------- -- Function: int gnutls_x509_crt_set_version (gnutls_x509_crt_t CRT, unsigned int VERSION) CRT: a certificate of type `gnutls_x509_crt_t' VERSION: holds the version number. For X.509v1 certificates must be 1. This function will set the version of the certificate. This must be one for X.509 version 1, and so on. Plain certificates without extensions must have version set to one. To create well-formed certificates, you must specify version 3 if you use any certificate extensions. Extensions are created by functions such as `gnutls_x509_crt_set_subject_alt_name()' or `gnutls_x509_crt_set_key_usage()'. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_sign2 --------------------- -- Function: int gnutls_x509_crt_sign2 (gnutls_x509_crt_t CRT, gnutls_x509_crt_t ISSUER, gnutls_x509_privkey_t ISSUER_KEY, gnutls_digest_algorithm_t DIG, unsigned int FLAGS) CRT: a certificate of type `gnutls_x509_crt_t' ISSUER: is the certificate of the certificate issuer ISSUER_KEY: holds the issuer's private key DIG: The message digest to use, `GNUTLS_DIG_SHA1' is a safe choice FLAGS: must be 0 This function will sign the certificate with the issuer's private key, and will copy the issuer's information into the certificate. This must be the last step in a certificate generation since all the previously set parameters are now signed. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_sign -------------------- -- Function: int gnutls_x509_crt_sign (gnutls_x509_crt_t CRT, gnutls_x509_crt_t ISSUER, gnutls_x509_privkey_t ISSUER_KEY) CRT: a certificate of type `gnutls_x509_crt_t' ISSUER: is the certificate of the certificate issuer ISSUER_KEY: holds the issuer's private key This function is the same a `gnutls_x509_crt_sign2()' with no flags, and SHA1 as the hash algorithm. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_crt_verify_data --------------------------- -- Function: int gnutls_x509_crt_verify_data (gnutls_x509_crt_t CRT, unsigned int FLAGS, const gnutls_datum_t * DATA, const gnutls_datum_t * SIGNATURE) CRT: Holds the certificate FLAGS: should be 0 for now DATA: holds the data to be signed SIGNATURE: contains the signature This function will verify the given signed data, using the parameters from the certificate. *Returns:* In case of a verification failure 0 is returned, and 1 on success. gnutls_x509_crt_verify_hash --------------------------- -- Function: int gnutls_x509_crt_verify_hash (gnutls_x509_crt_t CRT, unsigned int FLAGS, const gnutls_datum_t * HASH, const gnutls_datum_t * SIGNATURE) CRT: Holds the certificate FLAGS: should be 0 for now HASH: holds the hash digest to be verified SIGNATURE: contains the signature This function will verify the given signed digest, using the parameters from the certificate. *Returns:* In case of a verification failure 0 is returned, and 1 on success. gnutls_x509_crt_verify ---------------------- -- Function: int gnutls_x509_crt_verify (gnutls_x509_crt_t CERT, const gnutls_x509_crt_t * CA_LIST, int CA_LIST_LENGTH, unsigned int FLAGS, unsigned int * VERIFY) CERT: is the certificate to be verified CA_LIST: is one certificate that is considered to be trusted one CA_LIST_LENGTH: holds the number of CA certificate in CA_list FLAGS: Flags that may be used to change the verification algorithm. Use OR of the gnutls_certificate_verify_flags enumerations. VERIFY: will hold the certificate verification output. This function will try to verify the given certificate and return its status. The verification output in this functions cannot be GNUTLS_CERT_NOT_VALID. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value.and a negative value in case of an error. gnutls_x509_dn_deinit --------------------- -- Function: void gnutls_x509_dn_deinit (gnutls_x509_dn_t DN) DN: a DN opaque object pointer. This function deallocates the DN object as returned by `gnutls_x509_dn_import()'. *Since:* 2.4.0 gnutls_x509_dn_export --------------------- -- Function: int gnutls_x509_dn_export (gnutls_x509_dn_t DN, gnutls_x509_crt_fmt_t FORMAT, void * OUTPUT_DATA, size_t * OUTPUT_DATA_SIZE) DN: Holds the opaque DN object FORMAT: the format of output params. One of PEM or DER. OUTPUT_DATA: will contain a DN PEM or DER encoded OUTPUT_DATA_SIZE: holds the size of output_data (and will be replaced by the actual size of parameters) This function will export the DN to DER or PEM format. If the buffer provided is not long enough to hold the output, then *`output_data_size' is updated and `GNUTLS_E_SHORT_MEMORY_BUFFER' will be returned. If the structure is PEM encoded, it will have a header of "BEGIN NAME". *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_dn_get_rdn_ava -------------------------- -- Function: int gnutls_x509_dn_get_rdn_ava (gnutls_x509_dn_t DN, int IRDN, int IAVA, gnutls_x509_ava_st * AVA) DN: input variable with opaque DN pointer IRDN: index of RDN IAVA: index of AVA. AVA: Pointer to structure which will hold output information. Get pointers to data within the DN. Note that `ava' will contain pointers into the `dn' structure, so you should not modify any data or deallocate it. Note also that the DN in turn points into the original certificate structure, and thus you may not deallocate the certificate and continue to access `dn'. *Returns:* Returns 0 on success, or an error code. gnutls_x509_dn_import --------------------- -- Function: int gnutls_x509_dn_import (gnutls_x509_dn_t DN, const gnutls_datum_t * DATA) DN: the structure that will hold the imported DN DATA: should contain a DER encoded RDN sequence This function parses an RDN sequence and stores the result to a `gnutls_x509_dn_t' structure. The structure must have been initialized with `gnutls_x509_dn_init()'. You may use `gnutls_x509_dn_get_rdn_ava()' to decode the DN. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. *Since:* 2.4.0 gnutls_x509_dn_init ------------------- -- Function: int gnutls_x509_dn_init (gnutls_x509_dn_t * DN) DN: the object to be initialized This function initializes a `gnutls_x509_dn_t' structure. The object returned must be deallocated using `gnutls_x509_dn_deinit()'. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. *Since:* 2.4.0 gnutls_x509_dn_oid_known ------------------------ -- Function: int gnutls_x509_dn_oid_known (const char * OID) OID: holds an Object Identifier in a null terminated string This function will inform about known DN OIDs. This is useful since functions like `gnutls_x509_crt_set_dn_by_oid()' use the information on known OIDs to properly encode their input. Object Identifiers that are not known are not encoded by these functions, and their input is stored directly into the ASN.1 structure. In that case of unknown OIDs, you have the responsibility of DER encoding your data. *Returns:* 1 on known OIDs and 0 otherwise. gnutls_x509_privkey_cpy ----------------------- -- Function: int gnutls_x509_privkey_cpy (gnutls_x509_privkey_t DST, gnutls_x509_privkey_t SRC) DST: The destination key, which should be initialized. SRC: The source key This function will copy a private key from source to destination key. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_privkey_deinit -------------------------- -- Function: void gnutls_x509_privkey_deinit (gnutls_x509_privkey_t KEY) KEY: The structure to be initialized This function will deinitialize a private key structure. gnutls_x509_privkey_export_dsa_raw ---------------------------------- -- Function: int gnutls_x509_privkey_export_dsa_raw (gnutls_x509_privkey_t KEY, gnutls_datum_t * P, gnutls_datum_t * Q, gnutls_datum_t * G, gnutls_datum_t * Y, gnutls_datum_t * X) KEY: a structure that holds the DSA parameters P: will hold the p Q: will hold the q G: will hold the g Y: will hold the y X: will hold the x This function will export the DSA private key's parameters found in the given structure. The new parameters will be allocated using `gnutls_malloc()' and will be stored in the appropriate datum. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_privkey_export_pkcs8 -------------------------------- -- Function: int gnutls_x509_privkey_export_pkcs8 (gnutls_x509_privkey_t KEY, gnutls_x509_crt_fmt_t FORMAT, const char * PASSWORD, unsigned int FLAGS, void * OUTPUT_DATA, size_t * OUTPUT_DATA_SIZE) KEY: Holds the key FORMAT: the format of output params. One of PEM or DER. PASSWORD: the password that will be used to encrypt the key. FLAGS: an ORed sequence of gnutls_pkcs_encrypt_flags_t OUTPUT_DATA: will contain a private key PEM or DER encoded OUTPUT_DATA_SIZE: holds the size of output_data (and will be replaced by the actual size of parameters) This function will export the private key to a PKCS8 structure. Both RSA and DSA keys can be exported. For DSA keys we use PKCS `11' definitions. If the flags do not specify the encryption cipher, then the default 3DES (PBES2) will be used. The `password' can be either ASCII or UTF-8 in the default PBES2 encryption schemas, or ASCII for the PKCS12 schemas. If the buffer provided is not long enough to hold the output, then *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. If the structure is PEM encoded, it will have a header of "BEGIN ENCRYPTED PRIVATE KEY" or "BEGIN PRIVATE KEY" if encryption is not used. *Return value:* In case of failure a negative value will be returned, and 0 on success. gnutls_x509_privkey_export_rsa_raw ---------------------------------- -- Function: int gnutls_x509_privkey_export_rsa_raw (gnutls_x509_privkey_t KEY, gnutls_datum_t * M, gnutls_datum_t * E, gnutls_datum_t * D, gnutls_datum_t * P, gnutls_datum_t * Q, gnutls_datum_t * U) KEY: a structure that holds the rsa parameters M: will hold the modulus E: will hold the public exponent D: will hold the private exponent P: will hold the first prime (p) Q: will hold the second prime (q) U: will hold the coefficient This function will export the RSA private key's parameters found in the given structure. The new parameters will be allocated using `gnutls_malloc()' and will be stored in the appropriate datum. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_privkey_export -------------------------- -- Function: int gnutls_x509_privkey_export (gnutls_x509_privkey_t KEY, gnutls_x509_crt_fmt_t FORMAT, void * OUTPUT_DATA, size_t * OUTPUT_DATA_SIZE) KEY: Holds the key FORMAT: the format of output params. One of PEM or DER. OUTPUT_DATA: will contain a private key PEM or DER encoded OUTPUT_DATA_SIZE: holds the size of output_data (and will be replaced by the actual size of parameters) This function will export the private key to a PKCS1 structure for RSA keys, or an integer sequence for DSA keys. The DSA keys are in the same format with the parameters used by openssl. If the buffer provided is not long enough to hold the output, then *`output_data_size' is updated and `GNUTLS_E_SHORT_MEMORY_BUFFER' will be returned. If the structure is PEM encoded, it will have a header of "BEGIN RSA PRIVATE KEY". *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_privkey_fix ----------------------- -- Function: int gnutls_x509_privkey_fix (gnutls_x509_privkey_t KEY) KEY: Holds the key This function will recalculate the secondary parameters in a key. In RSA keys, this can be the coefficient and exponent1,2. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_privkey_generate ---------------------------- -- Function: int gnutls_x509_privkey_generate (gnutls_x509_privkey_t KEY, gnutls_pk_algorithm_t ALGO, unsigned int BITS, unsigned int FLAGS) KEY: should contain a `gnutls_x509_privkey_t' structure ALGO: is one of RSA or DSA. BITS: the size of the modulus FLAGS: unused for now. Must be 0. This function will generate a random private key. Note that this function must be called on an empty private key. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_privkey_get_key_id ------------------------------ -- Function: int gnutls_x509_privkey_get_key_id (gnutls_x509_privkey_t KEY, unsigned int FLAGS, unsigned char * OUTPUT_DATA, size_t * OUTPUT_DATA_SIZE) KEY: Holds the key FLAGS: should be 0 for now OUTPUT_DATA: will contain the key ID OUTPUT_DATA_SIZE: holds the size of output_data (and will be replaced by the actual size of parameters) 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 *`output_data_size' is updated and `GNUTLS_E_SHORT_MEMORY_BUFFER' will be returned. The output will normally be a SHA-1 hash output, which is 20 bytes. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_privkey_get_pk_algorithm ------------------------------------ -- Function: int gnutls_x509_privkey_get_pk_algorithm (gnutls_x509_privkey_t KEY) KEY: should contain a `gnutls_x509_privkey_t' structure This function will return the public key algorithm of a private key. *Returns:* a member of the `gnutls_pk_algorithm_t' enumeration on success, or a negative value on error. gnutls_x509_privkey_import_dsa_raw ---------------------------------- -- Function: 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) KEY: The structure to store the parsed key P: holds the p Q: holds the q G: holds the g Y: holds the y X: holds the x This function will convert the given DSA raw parameters to the native `gnutls_x509_privkey_t' format. The output will be stored in `key'. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_privkey_import_pkcs8 -------------------------------- -- Function: 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) KEY: The structure to store the parsed key DATA: The DER or PEM encoded key. FORMAT: One of DER or PEM PASSWORD: the password to decrypt the key (if it is encrypted). FLAGS: 0 if encrypted or GNUTLS_PKCS_PLAIN if not encrypted. 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 `key'. Both RSA and DSA keys can be imported, and flags can only be used to indicate an unencrypted key. The `password' 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. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_privkey_import_rsa_raw ---------------------------------- -- Function: 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) KEY: The structure to store the parsed key M: holds the modulus E: holds the public exponent D: holds the private exponent P: holds the first prime (p) Q: holds the second prime (q) U: holds the coefficient This function will convert the given RSA raw parameters to the native `gnutls_x509_privkey_t' format. The output will be stored in `key'. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_privkey_import -------------------------- -- Function: int gnutls_x509_privkey_import (gnutls_x509_privkey_t KEY, const gnutls_datum_t * DATA, gnutls_x509_crt_fmt_t FORMAT) KEY: The structure to store the parsed key DATA: The DER or PEM encoded certificate. FORMAT: One of DER or PEM This function will convert the given DER or PEM encoded key to the native `gnutls_x509_privkey_t' format. The output will be stored in `key' . If the key is PEM encoded it should have a header of "RSA PRIVATE KEY", or "DSA PRIVATE KEY". *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_privkey_init ------------------------ -- Function: int gnutls_x509_privkey_init (gnutls_x509_privkey_t * KEY) KEY: The structure to be initialized This function will initialize an private key structure. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_privkey_sign_data ----------------------------- -- Function: 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) KEY: Holds the key DIGEST: should be MD5 or SHA1 FLAGS: should be 0 for now DATA: holds the data to be signed SIGNATURE: will contain the signature SIGNATURE_SIZE: holds the size of signature (and will be replaced by the new size) 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 *`signature_size' is updated and `GNUTLS_E_SHORT_MEMORY_BUFFER' will be returned. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_privkey_sign_hash ----------------------------- -- Function: int gnutls_x509_privkey_sign_hash (gnutls_x509_privkey_t KEY, const gnutls_datum_t * HASH, gnutls_datum_t * SIGNATURE) KEY: Holds the key HASH: holds the data to be signed SIGNATURE: will contain newly allocated signature This function will sign the given hash using the private key. Do not use this function directly unless you know what it is. Typical signing requires the data to be hashed and stored in special formats (e.g. BER Digest-Info for RSA). *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_x509_privkey_verify_data ------------------------------- -- Function: int gnutls_x509_privkey_verify_data (gnutls_x509_privkey_t KEY, unsigned int FLAGS, const gnutls_datum_t * DATA, const gnutls_datum_t * SIGNATURE) KEY: Holds the key FLAGS: should be 0 for now DATA: holds the data to be signed SIGNATURE: contains the signature This function will verify the given signed data, using the parameters in the private key. *Returns:* In case of a verification failure 0 is returned, and 1 on success. gnutls_x509_rdn_get_by_oid -------------------------- -- Function: int gnutls_x509_rdn_get_by_oid (const gnutls_datum_t * IDN, const char * OID, int INDX, unsigned int RAW_FLAG, void * BUF, size_t * SIZEOF_BUF) IDN: should contain a DER encoded RDN sequence OID: an Object Identifier INDX: In case multiple same OIDs exist in the RDN indicates which to send. Use 0 for the first one. RAW_FLAG: If non zero then the raw DER data are returned. BUF: a pointer to a structure to hold the peer's name SIZEOF_BUF: holds the size of `buf' This function will return the name of the given Object identifier, of the RDN sequence. The name will be encoded using the rules from RFC2253. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, or `GNUTLS_E_SHORT_MEMORY_BUFFER' is returned and *`sizeof_buf' is updated if the provided buffer is not long enough, otherwise a negative error value. gnutls_x509_rdn_get_oid ----------------------- -- Function: int gnutls_x509_rdn_get_oid (const gnutls_datum_t * IDN, int INDX, void * BUF, size_t * SIZEOF_BUF) IDN: should contain a DER encoded RDN sequence INDX: Indicates which OID to return. Use 0 for the first one. BUF: a pointer to a structure to hold the peer's name OID SIZEOF_BUF: holds the size of `buf' This function will return the specified Object identifier, of the RDN sequence. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, or `GNUTLS_E_SHORT_MEMORY_BUFFER' is returned and *`sizeof_buf' is updated if the provided buffer is not long enough, otherwise a negative error value. *Since:* 2.4.0 gnutls_x509_rdn_get ------------------- -- Function: int gnutls_x509_rdn_get (const gnutls_datum_t * IDN, char * BUF, size_t * SIZEOF_BUF) IDN: should contain a DER encoded RDN sequence BUF: a pointer to a structure to hold the peer's name SIZEOF_BUF: holds the size of `buf' This function will return the name of the given RDN sequence. The name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described in RFC2253. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, or `GNUTLS_E_SHORT_MEMORY_BUFFER' is returned and *`sizeof_buf' is updated if the provided buffer is not long enough, otherwise a negative error value.  File: gnutls.info, Node: GnuTLS-extra functions, Next: OpenPGP functions, Prev: X.509 certificate functions, Up: Function reference 9.3 GnuTLS-extra Functions ========================== These functions are only available in the GPLv3+ version of the library called `gnutls-extra'. The prototypes for this library lie in `gnutls/extra.h'. gnutls_extra_check_version -------------------------- -- Function: const char * gnutls_extra_check_version (const char * REQ_VERSION) REQ_VERSION: version string to compare with, or `NULL'. Check GnuTLS Extra Library version. See `GNUTLS_EXTRA_VERSION' for a suitable `req_version' string. *Return value:* Check that the version of the library is at minimum the one given as a string in `req_version' and return the actual version string of the library; return `NULL' if the condition is not met. If `NULL' is passed to this function no check is done and only the version string is returned. gnutls_global_init_extra ------------------------ -- Function: int gnutls_global_init_extra ( VOID) This function initializes the global state of gnutls-extra library to defaults. Note that `gnutls_global_init()' has to be called before this function. If this function is not called then the gnutls-extra library will not be usable. This function is not thread safe, see the discussion for `gnutls_global_init()' on how to deal with that. *Returns:* On success, `GNUTLS_E_SUCCESS' (zero) is returned, otherwise an error code is returned.  File: gnutls.info, Node: OpenPGP functions, Next: TLS Inner Application (TLS/IA) functions, Prev: GnuTLS-extra functions, Up: Function reference 9.4 OpenPGP Functions ===================== The following functions are to be used for OpenPGP certificate handling. Their prototypes lie in `gnutls/openpgp.h'. gnutls_certificate_set_openpgp_key_file2 ---------------------------------------- -- Function: int gnutls_certificate_set_openpgp_key_file2 (gnutls_certificate_credentials_t RES, const char * CERTFILE, const char * KEYFILE, const char * SUBKEY_ID, gnutls_openpgp_crt_fmt_t FORMAT) RES: the destination context to save the data. CERTFILE: the file that contains the public key. KEYFILE: the file that contains the secret key. SUBKEY_ID: a hex encoded subkey id FORMAT: the format of the keys This funtion is used to load OpenPGP keys into the GnuTLS credential structure. The files should contain non encrypted keys. The special keyword "auto" is also accepted as `subkey_id'. In that case the `gnutls_openpgp_crt_get_auth_subkey()' will be used to retrieve the subkey. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. *Since:* 2.4.0 gnutls_certificate_set_openpgp_key_file --------------------------------------- -- Function: int gnutls_certificate_set_openpgp_key_file (gnutls_certificate_credentials_t RES, const char * CERTFILE, const char * KEYFILE, gnutls_openpgp_crt_fmt_t FORMAT) RES: the destination context to save the data. CERTFILE: the file that contains the public key. KEYFILE: the file that contains the secret key. FORMAT: the format of the keys This funtion is used to load OpenPGP keys into the GnuTLS credentials structure. The files should only contain one key which is not encrypted. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_certificate_set_openpgp_key_mem2 --------------------------------------- -- Function: int gnutls_certificate_set_openpgp_key_mem2 (gnutls_certificate_credentials_t RES, const gnutls_datum_t * CERT, const gnutls_datum_t * KEY, const char * SUBKEY_ID, gnutls_openpgp_crt_fmt_t FORMAT) RES: the destination context to save the data. CERT: the datum that contains the public key. KEY: the datum that contains the secret key. SUBKEY_ID: a hex encoded subkey id FORMAT: the format of the keys This funtion is used to load OpenPGP keys into the GnuTLS credentials structure. The files should only contain one key which is not encrypted. The special keyword "auto" is also accepted as `subkey_id'. In that case the `gnutls_openpgp_crt_get_auth_subkey()' will be used to retrieve the subkey. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. *Since:* 2.4.0 gnutls_certificate_set_openpgp_key_mem -------------------------------------- -- Function: int gnutls_certificate_set_openpgp_key_mem (gnutls_certificate_credentials_t RES, const gnutls_datum_t * CERT, const gnutls_datum_t * KEY, gnutls_openpgp_crt_fmt_t FORMAT) RES: the destination context to save the data. CERT: the datum that contains the public key. KEY: the datum that contains the secret key. FORMAT: the format of the keys This funtion is used to load OpenPGP keys into the GnuTLS credential structure. The files should contain non encrypted keys. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_certificate_set_openpgp_keyring_file ------------------------------------------- -- Function: int gnutls_certificate_set_openpgp_keyring_file (gnutls_certificate_credentials_t C, const char * FILE, gnutls_openpgp_crt_fmt_t FORMAT) C: A certificate credentials structure FILE: filename of the keyring. FORMAT: format of keyring. The function is used to set keyrings that will be used internally by various OpenPGP functions. For example to find a key when it is needed for an operations. The keyring will also be used at the verification functions. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_certificate_set_openpgp_keyring_mem ------------------------------------------ -- Function: int gnutls_certificate_set_openpgp_keyring_mem (gnutls_certificate_credentials_t C, const opaque * DATA, size_t DLEN, gnutls_openpgp_crt_fmt_t FORMAT) C: A certificate credentials structure DATA: buffer with keyring data. DLEN: length of data buffer. FORMAT: the format of the keyring The function is used to set keyrings that will be used internally by various OpenPGP functions. For example to find a key when it is needed for an operations. The keyring will also be used at the verification functions. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_certificate_set_openpgp_key ---------------------------------- -- Function: int gnutls_certificate_set_openpgp_key (gnutls_certificate_credentials_t RES, gnutls_openpgp_crt_t CRT, gnutls_openpgp_privkey_t PKEY) RES: is an `gnutls_certificate_credentials_t' structure. PKEY: is an openpgp private key This function sets a certificate/private key pair in the gnutls_certificate_credentials_t structure. This function may be called more than once (in case multiple keys/certificates exist for the server). With this function the subkeys of the certificate are not used. *Returns:* On success, `GNUTLS_E_SUCCESS' (zero) is returned, otherwise an error code is returned. gnutls_openpgp_crt_check_hostname --------------------------------- -- Function: int gnutls_openpgp_crt_check_hostname (gnutls_openpgp_crt_t KEY, const char * HOSTNAME) KEY: should contain an `gnutls_openpgp_crt_t' structure HOSTNAME: A null terminated string that contains a DNS name This function will check if the given key's owner matches the given hostname. This is a basic implementation of the matching described in RFC2818 (HTTPS), which takes into account wildcards. *Returns:* `GNUTLS_E_SUCCESS' on success, or an error code. gnutls_openpgp_crt_deinit ------------------------- -- Function: void gnutls_openpgp_crt_deinit (gnutls_openpgp_crt_t KEY) KEY: The structure to be initialized This function will deinitialize a key structure. gnutls_openpgp_crt_export ------------------------- -- Function: int gnutls_openpgp_crt_export (gnutls_openpgp_crt_t KEY, gnutls_openpgp_crt_fmt_t FORMAT, void * OUTPUT_DATA, size_t * OUTPUT_DATA_SIZE) KEY: Holds the key. FORMAT: One of gnutls_openpgp_crt_fmt_t elements. OUTPUT_DATA: will contain the key base64 encoded or raw OUTPUT_DATA_SIZE: holds the size of output_data (and will be replaced by the actual size of parameters) This function will convert the given key to RAW or Base64 format. If the buffer provided is not long enough to hold the output, then `GNUTLS_E_SHORT_MEMORY_BUFFER' will be returned. *Returns:* `GNUTLS_E_SUCCESS' on success, or an error code. gnutls_openpgp_crt_get_auth_subkey ---------------------------------- -- Function: int gnutls_openpgp_crt_get_auth_subkey (gnutls_openpgp_crt_t CRT, gnutls_openpgp_keyid_t KEYID, unsigned int FLAG) CRT: the structure that contains the OpenPGP public key. KEYID: the struct to save the keyid. FLAG: Non zero indicates that a valid subkey is always returned. Returns the 64-bit keyID of the first valid OpenPGP subkey marked for authentication. If flag is non zero and no authentication subkey exists, then a valid subkey will be returned even if it is not marked for authentication. Returns the 64-bit keyID of the first valid OpenPGP subkey marked for authentication. If flag is non zero and no authentication subkey exists, then a valid subkey will be returned even if it is not marked for authentication. *Returns:* `GNUTLS_E_SUCCESS' on success, or an error code. gnutls_openpgp_crt_get_creation_time ------------------------------------ -- Function: time_t gnutls_openpgp_crt_get_creation_time (gnutls_openpgp_crt_t KEY) KEY: the structure that contains the OpenPGP public key. Get key creation time. *Returns:* the timestamp when the OpenPGP key was created. gnutls_openpgp_crt_get_expiration_time -------------------------------------- -- Function: time_t gnutls_openpgp_crt_get_expiration_time (gnutls_openpgp_crt_t KEY) KEY: the structure that contains the OpenPGP public key. Get key expiration time. A value of '0' means that the key doesn't expire at all. *Returns:* the time when the OpenPGP key expires. gnutls_openpgp_crt_get_fingerprint ---------------------------------- -- Function: int gnutls_openpgp_crt_get_fingerprint (gnutls_openpgp_crt_t KEY, void * FPR, size_t * FPRLEN) KEY: the raw data that contains the OpenPGP public key. FPR: the buffer to save the fingerprint, must hold at least 20 bytes. FPRLEN: the integer to save the length of the fingerprint. Get key fingerprint. Depending on the algorithm, the fingerprint can be 16 or 20 bytes. *Returns:* On success, 0 is returned. Otherwise, an error code. gnutls_openpgp_crt_get_key_id ----------------------------- -- Function: int gnutls_openpgp_crt_get_key_id (gnutls_openpgp_crt_t KEY, gnutls_openpgp_keyid_t KEYID) KEY: the structure that contains the OpenPGP public key. KEYID: the buffer to save the keyid. Get key id string. *Returns:* the 64-bit keyID of the OpenPGP key. *Since:* 2.4.0 gnutls_openpgp_crt_get_key_usage -------------------------------- -- Function: int gnutls_openpgp_crt_get_key_usage (gnutls_openpgp_crt_t KEY, unsigned int * KEY_USAGE) KEY: should contain a gnutls_openpgp_crt_t structure KEY_USAGE: where the key usage bits will be stored This function will return certificate's key usage, by checking the key algorithm. The key usage value will ORed values of the: `GNUTLS_KEY_DIGITAL_SIGNATURE', `GNUTLS_KEY_KEY_ENCIPHERMENT'. *Returns:* `GNUTLS_E_SUCCESS' on success, or an error code. gnutls_openpgp_crt_get_name --------------------------- -- Function: int gnutls_openpgp_crt_get_name (gnutls_openpgp_crt_t KEY, int IDX, char * BUF, size_t * SIZEOF_BUF) KEY: the structure that contains the OpenPGP public key. IDX: the index of the ID to extract BUF: a pointer to a structure to hold the name SIZEOF_BUF: holds the maximum size of `buf', on return hold the actual/required size of `buf'. Extracts the userID from the parsed OpenPGP key. *Returns:* `GNUTLS_E_SUCCESS' on success, and if the index of the ID does not exist `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE', or an error code. gnutls_openpgp_crt_get_pk_algorithm ----------------------------------- -- Function: gnutls_pk_algorithm_t gnutls_openpgp_crt_get_pk_algorithm (gnutls_openpgp_crt_t KEY, unsigned int * BITS) KEY: is an OpenPGP key BITS: if bits is non null it will hold the size of the parameters' in bits This function will return the public key algorithm of an OpenPGP certificate. If bits is non null, it should have enough size to hold the parameters size in bits. For RSA the bits returned is the modulus. For DSA the bits returned are of the public exponent. *Returns:* a member of the `gnutls_pk_algorithm_t' enumeration on success, or a negative value on error. gnutls_openpgp_crt_get_pk_dsa_raw --------------------------------- -- Function: int gnutls_openpgp_crt_get_pk_dsa_raw (gnutls_openpgp_crt_t CRT, gnutls_datum_t * P, gnutls_datum_t * Q, gnutls_datum_t * G, gnutls_datum_t * Y) CRT: Holds the certificate P: will hold the p Q: will hold the q G: will hold the g Y: will hold the y This function will export the DSA public key's parameters found in the given certificate. The new parameters will be allocated using `gnutls_malloc()' and will be stored in the appropriate datum. *Returns:* `GNUTLS_E_SUCCESS' on success, otherwise an error. *Since:* 2.4.0 gnutls_openpgp_crt_get_pk_rsa_raw --------------------------------- -- Function: int gnutls_openpgp_crt_get_pk_rsa_raw (gnutls_openpgp_crt_t CRT, gnutls_datum_t * M, gnutls_datum_t * E) CRT: Holds the certificate M: will hold the modulus E: will hold the public exponent This function will export the RSA public key's parameters found in the given structure. The new parameters will be allocated using `gnutls_malloc()' and will be stored in the appropriate datum. *Returns:* `GNUTLS_E_SUCCESS' on success, otherwise an error. *Since:* 2.4.0 gnutls_openpgp_crt_get_preferred_key_id --------------------------------------- -- Function: int gnutls_openpgp_crt_get_preferred_key_id (gnutls_openpgp_crt_t KEY, gnutls_openpgp_keyid_t KEYID) KEY: the structure that contains the OpenPGP public key. KEYID: the struct to save the keyid. Get preferred key id. If it hasn't been set it returns `GNUTLS_E_INVALID_REQUEST'. *Returns:* the 64-bit preferred keyID of the OpenPGP key. gnutls_openpgp_crt_get_revoked_status ------------------------------------- -- Function: int gnutls_openpgp_crt_get_revoked_status (gnutls_openpgp_crt_t KEY) KEY: the structure that contains the OpenPGP public key. Get revocation status of key. *Returns:* true (1) if the key has been revoked, or false (0) if it has not. *Since:* 2.4.0 gnutls_openpgp_crt_get_subkey_count ----------------------------------- -- Function: int gnutls_openpgp_crt_get_subkey_count (gnutls_openpgp_crt_t KEY) KEY: is an OpenPGP key This function will return the number of subkeys present in the given OpenPGP certificate. *Returns:* the number of subkeys, or a negative value on error. *Since:* 2.4.0 gnutls_openpgp_crt_get_subkey_creation_time ------------------------------------------- -- Function: time_t gnutls_openpgp_crt_get_subkey_creation_time (gnutls_openpgp_crt_t KEY, unsigned int IDX) KEY: the structure that contains the OpenPGP public key. IDX: the subkey index Get subkey creation time. *Returns:* the timestamp when the OpenPGP sub-key was created. *Since:* 2.4.0 gnutls_openpgp_crt_get_subkey_expiration_time --------------------------------------------- -- Function: time_t gnutls_openpgp_crt_get_subkey_expiration_time (gnutls_openpgp_crt_t KEY, unsigned int IDX) KEY: the structure that contains the OpenPGP public key. IDX: the subkey index Get subkey expiration time. A value of '0' means that the key doesn't expire at all. *Returns:* the time when the OpenPGP key expires. *Since:* 2.4.0 gnutls_openpgp_crt_get_subkey_fingerprint ----------------------------------------- -- Function: int gnutls_openpgp_crt_get_subkey_fingerprint (gnutls_openpgp_crt_t KEY, unsigned int IDX, void * FPR, size_t * FPRLEN) KEY: the raw data that contains the OpenPGP public key. IDX: the subkey index FPR: the buffer to save the fingerprint, must hold at least 20 bytes. FPRLEN: the integer to save the length of the fingerprint. Get key fingerprint of a subkey. Depending on the algorithm, the fingerprint can be 16 or 20 bytes. *Returns:* On success, 0 is returned. Otherwise, an error code. *Since:* 2.4.0 gnutls_openpgp_crt_get_subkey_idx --------------------------------- -- Function: int gnutls_openpgp_crt_get_subkey_idx (gnutls_openpgp_crt_t KEY, const gnutls_openpgp_keyid_t KEYID) KEY: the structure that contains the OpenPGP public key. KEYID: the keyid. Get subkey's index. *Returns:* the index of the subkey or a negative error value. *Since:* 2.4.0 gnutls_openpgp_crt_get_subkey_id -------------------------------- -- Function: int gnutls_openpgp_crt_get_subkey_id (gnutls_openpgp_crt_t KEY, unsigned int IDX, gnutls_openpgp_keyid_t KEYID) KEY: the structure that contains the OpenPGP public key. IDX: the subkey index KEYID: the buffer to save the keyid. Get the subkey's key-id. *Returns:* the 64-bit keyID of the OpenPGP key. gnutls_openpgp_crt_get_subkey_pk_algorithm ------------------------------------------ -- Function: gnutls_pk_algorithm_t gnutls_openpgp_crt_get_subkey_pk_algorithm (gnutls_openpgp_crt_t KEY, unsigned int IDX, unsigned int * BITS) KEY: is an OpenPGP key IDX: is the subkey index BITS: if bits is non null it will hold the size of the parameters' in bits This function will return the public key algorithm of a subkey of an OpenPGP certificate. If bits is non null, it should have enough size to hold the parameters size in bits. For RSA the bits returned is the modulus. For DSA the bits returned are of the public exponent. *Returns:* a member of the `gnutls_pk_algorithm_t' enumeration on success, or a negative value on error. *Since:* 2.4.0 gnutls_openpgp_crt_get_subkey_pk_dsa_raw ---------------------------------------- -- Function: int gnutls_openpgp_crt_get_subkey_pk_dsa_raw (gnutls_openpgp_crt_t CRT, unsigned int IDX, gnutls_datum_t * P, gnutls_datum_t * Q, gnutls_datum_t * G, gnutls_datum_t * Y) CRT: Holds the certificate IDX: Is the subkey index P: will hold the p Q: will hold the q G: will hold the g Y: will hold the y This function will export the DSA public key's parameters found in the given certificate. The new parameters will be allocated using `gnutls_malloc()' and will be stored in the appropriate datum. *Returns:* `GNUTLS_E_SUCCESS' on success, otherwise an error. *Since:* 2.4.0 gnutls_openpgp_crt_get_subkey_pk_rsa_raw ---------------------------------------- -- Function: int gnutls_openpgp_crt_get_subkey_pk_rsa_raw (gnutls_openpgp_crt_t CRT, unsigned int IDX, gnutls_datum_t * M, gnutls_datum_t * E) CRT: Holds the certificate IDX: Is the subkey index M: will hold the modulus E: will hold the public exponent This function will export the RSA public key's parameters found in the given structure. The new parameters will be allocated using `gnutls_malloc()' and will be stored in the appropriate datum. *Returns:* `GNUTLS_E_SUCCESS' on success, otherwise an error. *Since:* 2.4.0 gnutls_openpgp_crt_get_subkey_revoked_status -------------------------------------------- -- Function: int gnutls_openpgp_crt_get_subkey_revoked_status (gnutls_openpgp_crt_t KEY, unsigned int IDX) KEY: the structure that contains the OpenPGP public key. IDX: is the subkey index Get subkey revocation status. A negative value indicates an error. *Returns:* true (1) if the key has been revoked, or false (0) if it has not. *Since:* 2.4.0 gnutls_openpgp_crt_get_subkey_usage ----------------------------------- -- Function: int gnutls_openpgp_crt_get_subkey_usage (gnutls_openpgp_crt_t KEY, unsigned int IDX, unsigned int * KEY_USAGE) KEY: should contain a gnutls_openpgp_crt_t structure IDX: the subkey index KEY_USAGE: where the key usage bits will be stored This function will return certificate's key usage, by checking the key algorithm. The key usage value will ORed values of `GNUTLS_KEY_DIGITAL_SIGNATURE' or `GNUTLS_KEY_KEY_ENCIPHERMENT'. A negative value may be returned in case of parsing error. *Returns:* key usage value. *Since:* 2.4.0 gnutls_openpgp_crt_get_version ------------------------------ -- Function: int gnutls_openpgp_crt_get_version (gnutls_openpgp_crt_t KEY) KEY: the structure that contains the OpenPGP public key. Extract the version of the OpenPGP key. *Returns:* the version number is returned, or a negative value on errors. gnutls_openpgp_crt_import ------------------------- -- Function: int gnutls_openpgp_crt_import (gnutls_openpgp_crt_t KEY, const gnutls_datum_t * DATA, gnutls_openpgp_crt_fmt_t FORMAT) KEY: The structure to store the parsed key. DATA: The RAW or BASE64 encoded key. FORMAT: One of gnutls_openpgp_crt_fmt_t elements. This function will convert the given RAW or Base64 encoded key to the native `gnutls_openpgp_crt_t' format. The output will be stored in 'key'. *Returns:* `GNUTLS_E_SUCCESS' on success, or an error code. gnutls_openpgp_crt_init ----------------------- -- Function: int gnutls_openpgp_crt_init (gnutls_openpgp_crt_t * KEY) KEY: The structure to be initialized This function will initialize an OpenPGP key structure. *Returns:* `GNUTLS_E_SUCCESS' on success, or an error code. gnutls_openpgp_crt_print ------------------------ -- Function: int gnutls_openpgp_crt_print (gnutls_openpgp_crt_t CERT, gnutls_certificate_print_formats_t FORMAT, gnutls_datum_t * OUT) CERT: The structure to be printed FORMAT: Indicate the format to use OUT: Newly allocated datum with zero terminated string. This function will pretty print an OpenPGP certificate, suitable for display to a human. The format should be zero for future compatibility. The output `out' needs to be deallocate using `gnutls_free()'. *Returns:* `GNUTLS_E_SUCCESS' on success, or an error code. gnutls_openpgp_crt_set_preferred_key_id --------------------------------------- -- Function: int gnutls_openpgp_crt_set_preferred_key_id (gnutls_openpgp_crt_t KEY, const gnutls_openpgp_keyid_t KEYID) KEY: the structure that contains the OpenPGP public key. KEYID: the selected keyid This allows setting a preferred key id for the given certificate. This key will be used by functions that involve key handling. *Returns:* On success, `GNUTLS_E_SUCCESS' (zero) is returned, otherwise an error code is returned. gnutls_openpgp_crt_verify_ring ------------------------------ -- Function: int gnutls_openpgp_crt_verify_ring (gnutls_openpgp_crt_t KEY, gnutls_openpgp_keyring_t KEYRING, unsigned int FLAGS, unsigned int * VERIFY) KEY: the structure that holds the key. KEYRING: holds the keyring to check against FLAGS: unused (should be 0) VERIFY: will hold the certificate verification output. Verify all signatures in the key, using the given set of keys (keyring). The key verification output will be put in `verify' and will be one or more of the `gnutls_certificate_status_t' enumerated elements bitwise or'd. *Returns:* `GNUTLS_E_SUCCESS' on success, or an error code. gnutls_openpgp_crt_verify_self ------------------------------ -- Function: int gnutls_openpgp_crt_verify_self (gnutls_openpgp_crt_t KEY, unsigned int FLAGS, unsigned int * VERIFY) KEY: the structure that holds the key. FLAGS: unused (should be 0) VERIFY: will hold the key verification output. Verifies the self signature in the key. The key verification output will be put in `verify' and will be one or more of the gnutls_certificate_status_t enumerated elements bitwise or'd. *Returns:* `GNUTLS_E_SUCCESS' on success, or an error code. gnutls_openpgp_keyring_check_id ------------------------------- -- Function: int gnutls_openpgp_keyring_check_id (gnutls_openpgp_keyring_t RING, const gnutls_openpgp_keyid_t KEYID, unsigned int FLAGS) RING: holds the keyring to check against KEYID: will hold the keyid to check for. FLAGS: unused (should be 0) Check if a given key ID exists in the keyring. *Returns:* `GNUTLS_E_SUCCESS' on success (if keyid exists) and a negative error code on failure. gnutls_openpgp_keyring_deinit ----------------------------- -- Function: void gnutls_openpgp_keyring_deinit (gnutls_openpgp_keyring_t KEYRING) KEYRING: The structure to be initialized This function will deinitialize a keyring structure. gnutls_openpgp_keyring_get_crt_count ------------------------------------ -- Function: int gnutls_openpgp_keyring_get_crt_count (gnutls_openpgp_keyring_t RING) RING: is an OpenPGP key ring This function will return the number of OpenPGP certificates present in the given keyring. *Returns:* the number of subkeys, or a negative value on error. gnutls_openpgp_keyring_get_crt ------------------------------ -- Function: int gnutls_openpgp_keyring_get_crt (gnutls_openpgp_keyring_t RING, unsigned int IDX, gnutls_openpgp_crt_t * CERT) RING: Holds the keyring. IDX: the index of the certificate to export CERT: An uninitialized `gnutls_openpgp_crt_t' structure This function will extract an OpenPGP certificate from the given keyring. If the index given is out of range `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE' will be returned. The returned structure needs to be deinited. *Returns:* `GNUTLS_E_SUCCESS' on success, or an error code. gnutls_openpgp_keyring_import ----------------------------- -- Function: int gnutls_openpgp_keyring_import (gnutls_openpgp_keyring_t KEYRING, const gnutls_datum_t * DATA, gnutls_openpgp_crt_fmt_t FORMAT) KEYRING: The structure to store the parsed key. DATA: The RAW or BASE64 encoded keyring. FORMAT: One of `gnutls_openpgp_keyring_fmt' elements. This function will convert the given RAW or Base64 encoded keyring to the native `gnutls_openpgp_keyring_t' format. The output will be stored in 'keyring'. *Returns:* `GNUTLS_E_SUCCESS' on success, or an error code. gnutls_openpgp_keyring_init --------------------------- -- Function: int gnutls_openpgp_keyring_init (gnutls_openpgp_keyring_t * KEYRING) KEYRING: The structure to be initialized This function will initialize an keyring structure. *Returns:* `GNUTLS_E_SUCCESS' on success, or an error code. gnutls_openpgp_privkey_deinit ----------------------------- -- Function: void gnutls_openpgp_privkey_deinit (gnutls_openpgp_privkey_t KEY) KEY: The structure to be initialized This function will deinitialize a key structure. gnutls_openpgp_privkey_export_dsa_raw ------------------------------------- -- Function: int gnutls_openpgp_privkey_export_dsa_raw (gnutls_openpgp_privkey_t PKEY, gnutls_datum_t * P, gnutls_datum_t * Q, gnutls_datum_t * G, gnutls_datum_t * Y, gnutls_datum_t * X) PKEY: Holds the certificate P: will hold the p Q: will hold the q G: will hold the g Y: will hold the y X: will hold the x This function will export the DSA private key's parameters found in the given certificate. The new parameters will be allocated using `gnutls_malloc()' and will be stored in the appropriate datum. *Returns:* `GNUTLS_E_SUCCESS' on success, otherwise an error. *Since:* 2.4.0 gnutls_openpgp_privkey_export_rsa_raw ------------------------------------- -- Function: int gnutls_openpgp_privkey_export_rsa_raw (gnutls_openpgp_privkey_t PKEY, gnutls_datum_t * M, gnutls_datum_t * E, gnutls_datum_t * D, gnutls_datum_t * P, gnutls_datum_t * Q, gnutls_datum_t * U) PKEY: Holds the certificate M: will hold the modulus E: will hold the public exponent D: will hold the private exponent P: will hold the first prime (p) Q: will hold the second prime (q) U: will hold the coefficient This function will export the RSA private key's parameters found in the given structure. The new parameters will be allocated using `gnutls_malloc()' and will be stored in the appropriate datum. *Returns:* `GNUTLS_E_SUCCESS' on success, otherwise an error. *Since:* 2.4.0 gnutls_openpgp_privkey_export_subkey_dsa_raw -------------------------------------------- -- Function: int gnutls_openpgp_privkey_export_subkey_dsa_raw (gnutls_openpgp_privkey_t PKEY, unsigned int IDX, gnutls_datum_t * P, gnutls_datum_t * Q, gnutls_datum_t * G, gnutls_datum_t * Y, gnutls_datum_t * X) PKEY: Holds the certificate IDX: Is the subkey index P: will hold the p Q: will hold the q G: will hold the g Y: will hold the y X: will hold the x This function will export the DSA private key's parameters found in the given certificate. The new parameters will be allocated using `gnutls_malloc()' and will be stored in the appropriate datum. *Returns:* `GNUTLS_E_SUCCESS' on success, otherwise an error. *Since:* 2.4.0 gnutls_openpgp_privkey_export_subkey_rsa_raw -------------------------------------------- -- Function: int gnutls_openpgp_privkey_export_subkey_rsa_raw (gnutls_openpgp_privkey_t PKEY, unsigned int IDX, gnutls_datum_t * M, gnutls_datum_t * E, gnutls_datum_t * D, gnutls_datum_t * P, gnutls_datum_t * Q, gnutls_datum_t * U) PKEY: Holds the certificate IDX: Is the subkey index M: will hold the modulus E: will hold the public exponent D: will hold the private exponent P: will hold the first prime (p) Q: will hold the second prime (q) U: will hold the coefficient This function will export the RSA private key's parameters found in the given structure. The new parameters will be allocated using `gnutls_malloc()' and will be stored in the appropriate datum. *Returns:* `GNUTLS_E_SUCCESS' on success, otherwise an error. *Since:* 2.4.0 gnutls_openpgp_privkey_export ----------------------------- -- Function: int gnutls_openpgp_privkey_export (gnutls_openpgp_privkey_t KEY, gnutls_openpgp_crt_fmt_t FORMAT, const char * PASSWORD, unsigned int FLAGS, void * OUTPUT_DATA, size_t * OUTPUT_DATA_SIZE) KEY: Holds the key. FORMAT: One of gnutls_openpgp_crt_fmt_t elements. PASSWORD: the password that will be used to encrypt the key. (unused for now) FLAGS: zero for future compatibility OUTPUT_DATA: will contain the key base64 encoded or raw OUTPUT_DATA_SIZE: holds the size of output_data (and will be replaced by the actual size of parameters) This function will convert the given key to RAW or Base64 format. If the buffer provided is not long enough to hold the output, then GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. *Returns:* `GNUTLS_E_SUCCESS' on success, or an error code. *Since:* 2.4.0 gnutls_openpgp_privkey_get_fingerprint -------------------------------------- -- Function: int gnutls_openpgp_privkey_get_fingerprint (gnutls_openpgp_privkey_t KEY, void * FPR, size_t * FPRLEN) KEY: the raw data that contains the OpenPGP secret key. FPR: the buffer to save the fingerprint, must hold at least 20 bytes. FPRLEN: the integer to save the length of the fingerprint. Get the fingerprint of the OpenPGP key. Depends on the algorithm, the fingerprint can be 16 or 20 bytes. *Returns:* On success, 0 is returned, or an error code. *Since:* 2.4.0 gnutls_openpgp_privkey_get_key_id --------------------------------- -- Function: int gnutls_openpgp_privkey_get_key_id (gnutls_openpgp_privkey_t KEY, gnutls_openpgp_keyid_t KEYID) KEY: the structure that contains the OpenPGP secret key. KEYID: the buffer to save the keyid. Get key-id. *Returns:* the 64-bit keyID of the OpenPGP key. *Since:* 2.4.0 gnutls_openpgp_privkey_get_pk_algorithm --------------------------------------- -- Function: gnutls_pk_algorithm_t gnutls_openpgp_privkey_get_pk_algorithm (gnutls_openpgp_privkey_t KEY, unsigned int * BITS) KEY: is an OpenPGP key BITS: if bits is non null it will hold the size of the parameters' in bits This function will return the public key algorithm of an OpenPGP certificate. If bits is non null, it should have enough size to hold the parameters size in bits. For RSA the bits returned is the modulus. For DSA the bits returned are of the public exponent. *Returns:* a member of the `gnutls_pk_algorithm_t' enumeration on success, or a negative value on error. *Since:* 2.4.0 gnutls_openpgp_privkey_get_preferred_key_id ------------------------------------------- -- Function: int gnutls_openpgp_privkey_get_preferred_key_id (gnutls_openpgp_privkey_t KEY, gnutls_openpgp_keyid_t KEYID) KEY: the structure that contains the OpenPGP public key. KEYID: the struct to save the keyid. Get the preferred key-id for the key. *Returns:* the 64-bit preferred keyID of the OpenPGP key, or if it hasn't been set it returns `GNUTLS_E_INVALID_REQUEST'. gnutls_openpgp_privkey_get_revoked_status ----------------------------------------- -- Function: int gnutls_openpgp_privkey_get_revoked_status (gnutls_openpgp_privkey_t KEY) KEY: the structure that contains the OpenPGP private key. Get revocation status of key. *Returns:* true (1) if the key has been revoked, or false (0) if it has not, or a negative value indicates an error. *Since:* 2.4.0 gnutls_openpgp_privkey_get_subkey_count --------------------------------------- -- Function: int gnutls_openpgp_privkey_get_subkey_count (gnutls_openpgp_privkey_t KEY) KEY: is an OpenPGP key This function will return the number of subkeys present in the given OpenPGP certificate. *Returns:* the number of subkeys, or a negative value on error. *Since:* 2.4.0 gnutls_openpgp_privkey_get_subkey_creation_time ----------------------------------------------- -- Function: time_t gnutls_openpgp_privkey_get_subkey_creation_time (gnutls_openpgp_privkey_t KEY, unsigned int IDX) KEY: the structure that contains the OpenPGP private key. IDX: the subkey index Get subkey creation time. *Returns:* the timestamp when the OpenPGP key was created. *Since:* 2.4.0 gnutls_openpgp_privkey_get_subkey_expiration_time ------------------------------------------------- -- Function: time_t gnutls_openpgp_privkey_get_subkey_expiration_time (gnutls_openpgp_privkey_t KEY, unsigned int IDX) KEY: the structure that contains the OpenPGP private key. IDX: the subkey index Get subkey expiration time. A value of '0' means that the key doesn't expire at all. *Returns:* the time when the OpenPGP key expires. *Since:* 2.4.0 gnutls_openpgp_privkey_get_subkey_fingerprint --------------------------------------------- -- Function: int gnutls_openpgp_privkey_get_subkey_fingerprint (gnutls_openpgp_privkey_t KEY, unsigned int IDX, void * FPR, size_t * FPRLEN) KEY: the raw data that contains the OpenPGP secret key. IDX: the subkey index FPR: the buffer to save the fingerprint, must hold at least 20 bytes. FPRLEN: the integer to save the length of the fingerprint. Get the fingerprint of an OpenPGP subkey. Depends on the algorithm, the fingerprint can be 16 or 20 bytes. *Returns:* On success, 0 is returned, or an error code. *Since:* 2.4.0 gnutls_openpgp_privkey_get_subkey_idx ------------------------------------- -- Function: int gnutls_openpgp_privkey_get_subkey_idx (gnutls_openpgp_privkey_t KEY, const gnutls_openpgp_keyid_t KEYID) KEY: the structure that contains the OpenPGP private key. KEYID: the keyid. Get index of subkey. *Returns:* the index of the subkey or a negative error value. *Since:* 2.4.0 gnutls_openpgp_privkey_get_subkey_id ------------------------------------ -- Function: int gnutls_openpgp_privkey_get_subkey_id (gnutls_openpgp_privkey_t KEY, unsigned int IDX, gnutls_openpgp_keyid_t KEYID) KEY: the structure that contains the OpenPGP secret key. IDX: the subkey index KEYID: the buffer to save the keyid. Get the key-id for the subkey. *Returns:* the 64-bit keyID of the OpenPGP key. *Since:* 2.4.0 gnutls_openpgp_privkey_get_subkey_pk_algorithm ---------------------------------------------- -- Function: gnutls_pk_algorithm_t gnutls_openpgp_privkey_get_subkey_pk_algorithm (gnutls_openpgp_privkey_t KEY, unsigned int IDX, unsigned int * BITS) KEY: is an OpenPGP key IDX: is the subkey index BITS: if bits is non null it will hold the size of the parameters' in bits This function will return the public key algorithm of a subkey of an OpenPGP certificate. If bits is non null, it should have enough size to hold the parameters size in bits. For RSA the bits returned is the modulus. For DSA the bits returned are of the public exponent. *Returns:* a member of the `gnutls_pk_algorithm_t' enumeration on success, or a negative value on error. *Since:* 2.4.0 gnutls_openpgp_privkey_get_subkey_revoked_status ------------------------------------------------ -- Function: int gnutls_openpgp_privkey_get_subkey_revoked_status (gnutls_openpgp_privkey_t KEY, unsigned int IDX) KEY: the structure that contains the OpenPGP private key. IDX: is the subkey index Get revocation status of key. *Returns:* true (1) if the key has been revoked, or false (0) if it has not, or a negative value indicates an error. *Since:* 2.4.0 gnutls_openpgp_privkey_import ----------------------------- -- Function: int gnutls_openpgp_privkey_import (gnutls_openpgp_privkey_t KEY, const gnutls_datum_t * DATA, gnutls_openpgp_crt_fmt_t FORMAT, const char * PASSWORD, unsigned int FLAGS) KEY: The structure to store the parsed key. DATA: The RAW or BASE64 encoded key. FORMAT: One of `gnutls_openpgp_crt_fmt_t' elements. PASSWORD: not used for now FLAGS: should be zero This function will convert the given RAW or Base64 encoded key to the native gnutls_openpgp_privkey_t format. The output will be stored in 'key'. *Returns:* `GNUTLS_E_SUCCESS' on success, or an error code. gnutls_openpgp_privkey_init --------------------------- -- Function: int gnutls_openpgp_privkey_init (gnutls_openpgp_privkey_t * KEY) KEY: The structure to be initialized This function will initialize an OpenPGP key structure. *Returns:* `GNUTLS_E_SUCCESS' on success, or an error code. gnutls_openpgp_privkey_set_preferred_key_id ------------------------------------------- -- Function: int gnutls_openpgp_privkey_set_preferred_key_id (gnutls_openpgp_privkey_t KEY, const gnutls_openpgp_keyid_t KEYID) KEY: the structure that contains the OpenPGP public key. KEYID: the selected keyid This allows setting a preferred key id for the given certificate. This key will be used by functions that involve key handling. *Returns:* On success, 0 is returned, or an error code. gnutls_openpgp_privkey_sign_hash -------------------------------- -- Function: int gnutls_openpgp_privkey_sign_hash (gnutls_openpgp_privkey_t KEY, const gnutls_datum_t * HASH, gnutls_datum_t * SIGNATURE) KEY: Holds the key HASH: holds the data to be signed SIGNATURE: will contain newly allocated signature This function will sign the given hash using the private key. You should use `gnutls_openpgp_privkey_set_subkey()' before calling this function to set the subkey to use. *Returns:* On success, `GNUTLS_E_SUCCESS' is returned, otherwise a negative error value. gnutls_openpgp_set_recv_key_function ------------------------------------ -- Function: void gnutls_openpgp_set_recv_key_function (gnutls_session_t SESSION, gnutls_openpgp_recv_key_func FUNC) SESSION: a TLS session FUNC: the callback This funtion will set a key retrieval function for OpenPGP keys. This callback is only useful in server side, and will be used if the peer sent a key fingerprint instead of a full key.  File: gnutls.info, Node: TLS Inner Application (TLS/IA) functions, Next: Error codes and descriptions, Prev: OpenPGP functions, Up: Function reference 9.5 TLS Inner Application (TLS/IA) Functions ============================================ The following functions are used for TLS Inner Application (TLS/IA). Their prototypes lie in `gnutls/extra.h'. You need to link with `libgnutls-extra' to be able to use these functions (*note GnuTLS-extra functions::). The typical control flow in an TLS/IA client (that would not require an Application Phase for resumed sessions) would be similar to the following: int client_avp (gnuls_session_t *session, void *ptr, const char *last, size_t lastlen, char **new, size_t *newlen) { ... } ... int main () { gnutls_ia_client_credentials_t iacred; ... gnutls_init (&session, GNUTLS_CLIENT); ... /* Enable TLS/IA. */ gnutls_ia_allocate_client_credentials(&iacred); gnutls_ia_set_client_avp_function(iacred, client_avp); gnutls_credentials_set (session, GNUTLS_CRD_IA, iacred); ... ret = gnutls_handshake (session); // Error handling... ... if (gnutls_ia_handshake_p (session)) { ret = gnutls_ia_handshake (session); // Error handling... ... See below for detailed descriptions of all the functions used above. The function `client_avp' would have to be implemented by your application. The function is responsible for handling the AVP data. See `gnutls_ia_set_client_avp_function' below for more information on how that function should be implemented. The control flow in a typical server is similar to the above, use `gnutls_ia_server_credentials_t' instead of `gnutls_ia_client_credentials_t', and replace the call to the client functions with the corresponding server functions. gnutls_ia_allocate_client_credentials ------------------------------------- -- Function: int gnutls_ia_allocate_client_credentials (gnutls_ia_client_credentials_t * SC) SC: is a pointer to an `gnutls_ia_server_credentials_t' structure. This structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. Adding this credential to a session will enable TLS/IA, and will require an Application Phase after the TLS handshake (if the server support TLS/IA). Use `gnutls_ia_require_inner_phase()' to toggle the TLS/IA mode. *Returns:* On success, `GNUTLS_E_SUCCESS' (0) is returned, otherwise an error code is returned. gnutls_ia_allocate_server_credentials ------------------------------------- -- Function: int gnutls_ia_allocate_server_credentials (gnutls_ia_server_credentials_t * SC) SC: is a pointer to an `gnutls_ia_server_credentials_t' structure. This structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. Adding this credential to a session will enable TLS/IA, and will require an Application Phase after the TLS handshake (if the client support TLS/IA). Use `gnutls_ia_require_inner_phase()' to toggle the TLS/IA mode. *Returns:* On success, `GNUTLS_E_SUCCESS' (0) is returned, otherwise an error code is returned. gnutls_ia_enable ---------------- -- Function: void gnutls_ia_enable (gnutls_session_t SESSION, int ALLOW_SKIP_ON_RESUME) SESSION: is a `gnutls_session_t' structure. ALLOW_SKIP_ON_RESUME: non-zero if local party allows to skip the TLS/IA application phases for a resumed session. Specify whether we must advertise support for the TLS/IA extension during the handshake. At the client side, we always advertise TLS/IA if gnutls_ia_enable was called before the handshake; at the server side, we also require that the client has advertised that it wants to run TLS/IA before including the advertisement, as required by the protocol. Similarly, at the client side we always advertise that we allow TLS/IA to be skipped for resumed sessions if `allow_skip_on_resume' is non-zero; at the server side, we also require that the session is indeed resumable and that the client has also advertised that it allows TLS/IA to be skipped for resumed sessions. After the TLS handshake, call `gnutls_ia_handshake_p()' to find out whether both parties agreed to do a TLS/IA handshake, before calling `gnutls_ia_handshake()' or one of the lower level gnutls_ia_* functions. gnutls_ia_endphase_send ----------------------- -- Function: int gnutls_ia_endphase_send (gnutls_session_t SESSION, int FINAL_P) SESSION: is a `gnutls_session_t' structure. FINAL_P: Set iff this should signal the final phase. Send a TLS/IA end phase message. In the client, this should only be used to acknowledge an end phase message sent by the server. In the server, this can be called instead of `gnutls_ia_send()' if the server wishes to end an application phase. *Return value:* Return 0 on success, or an error code. gnutls_ia_extract_inner_secret ------------------------------ -- Function: void gnutls_ia_extract_inner_secret (gnutls_session_t SESSION, char * BUFFER) SESSION: is a `gnutls_session_t' structure. BUFFER: pre-allocated buffer to hold 48 bytes of inner secret. Copy the 48 bytes large inner secret into the specified buffer This function is typically used after the TLS/IA handshake has concluded. The TLS/IA inner secret can be used as input to a PRF to derive session keys. Do not use the inner secret directly as a session key, because for a resumed session that does not include an application phase, the inner secret will be identical to the inner secret in the original session. It is important to include, for example, the client and server randomness when deriving a sesssion key from the inner secret. gnutls_ia_free_client_credentials --------------------------------- -- Function: void gnutls_ia_free_client_credentials (gnutls_ia_client_credentials_t SC) SC: is an `gnutls_ia_client_credentials_t' structure. This structure is complex enough to manipulate directly thus this helper function is provided in order to free (deallocate) it. gnutls_ia_free_server_credentials --------------------------------- -- Function: void gnutls_ia_free_server_credentials (gnutls_ia_server_credentials_t SC) SC: is an `gnutls_ia_server_credentials_t' structure. This structure is complex enough to manipulate directly thus this helper function is provided in order to free (deallocate) it. gnutls_ia_generate_challenge ---------------------------- -- Function: int gnutls_ia_generate_challenge (gnutls_session_t SESSION, size_t BUFFER_SIZE, char * BUFFER) SESSION: is a `gnutls_session_t' structure. BUFFER_SIZE: size of output buffer. BUFFER: pre-allocated buffer to contain `buffer_size' bytes of output. Generate an application challenge that the client cannot control or predict, based on the TLS/IA inner secret. *Return value:* Returns 0 on success, or an negative error code. gnutls_ia_get_client_avp_ptr ---------------------------- -- Function: void * gnutls_ia_get_client_avp_ptr (gnutls_ia_client_credentials_t CRED) CRED: is a `gnutls_ia_client_credentials_t' structure. Returns the pointer that will be provided to the TLS/IA callback function as the first argument. *Returns:* The client callback data pointer. gnutls_ia_get_server_avp_ptr ---------------------------- -- Function: void * gnutls_ia_get_server_avp_ptr (gnutls_ia_server_credentials_t CRED) CRED: is a `gnutls_ia_client_credentials_t' structure. Returns the pointer that will be provided to the TLS/IA callback function as the first argument. *Returns:* The server callback data pointer. gnutls_ia_handshake_p --------------------- -- Function: int gnutls_ia_handshake_p (gnutls_session_t SESSION) SESSION: is a `gnutls_session_t' structure. Predicate to be used after `gnutls_handshake()' to decide whether to invoke `gnutls_ia_handshake()'. Usable by both clients and servers. *Return value:* non-zero if TLS/IA handshake is expected, zero otherwise. gnutls_ia_handshake ------------------- -- Function: int gnutls_ia_handshake (gnutls_session_t SESSION) SESSION: is a `gnutls_session_t' structure. Perform a TLS/IA handshake. This should be called after `gnutls_handshake()' iff `gnutls_ia_handshake_p()'. *Returns:* On success, `GNUTLS_E_SUCCESS' (zero) is returned, otherwise an error code is returned. gnutls_ia_permute_inner_secret ------------------------------ -- Function: int gnutls_ia_permute_inner_secret (gnutls_session_t SESSION, size_t SESSION_KEYS_SIZE, const char * SESSION_KEYS) SESSION: is a `gnutls_session_t' structure. SESSION_KEYS_SIZE: Size of generated session keys (0 if none). SESSION_KEYS: Generated session keys, used to permute inner secret (NULL if none). 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. *Return value:* Return zero on success, or a negative error code. gnutls_ia_recv -------------- -- Function: ssize_t gnutls_ia_recv (gnutls_session_t SESSION, char * DATA, size_t SIZEOFDATA) SESSION: is a `gnutls_session_t' structure. DATA: the buffer that the data will be read into, must hold >= 12 bytes. SIZEOFDATA: the number of requested bytes, must be >= 12. Receive TLS/IA data. This function has the similar semantics with `recv()'. The only difference is that it accepts a GnuTLS session, and uses different error codes. If the server attempt to finish an application phase, this function will return `GNUTLS_E_WARNING_IA_IPHF_RECEIVED' or `GNUTLS_E_WARNING_IA_FPHF_RECEIVED'. The caller should then invoke `gnutls_ia_verify_endphase()', 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 `code'{`recv()'}) 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. *Returns:* The number of bytes received. A negative error code is returned in case of an error. The `GNUTLS_E_WARNING_IA_IPHF_RECEIVED' and `GNUTLS_E_WARNING_IA_FPHF_RECEIVED' errors are returned when an application phase finished message has been sent by the server. gnutls_ia_send -------------- -- Function: ssize_t gnutls_ia_send (gnutls_session_t SESSION, const char * DATA, size_t SIZEOFDATA) SESSION: is a `gnutls_session_t' structure. DATA: contains the data to send SIZEOFDATA: is the length of the data Send TLS/IA application payload data. This function has the similar semantics with `send()'. The only difference is that it 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 `gnutls_ia_endphase_send()'. 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 `send()'} 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. *Returns:* The number of bytes sent, or a negative error code. gnutls_ia_set_client_avp_function --------------------------------- -- Function: void gnutls_ia_set_client_avp_function (gnutls_ia_client_credentials_t CRED, gnutls_ia_avp_func AVP_FUNC) CRED: is a `gnutls_ia_client_credentials_t' structure. AVP_FUNC: is the callback function 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 `session' parameter is the `gnutls_session_t' structure corresponding to the current session. The `ptr' parameter is the application hook pointer, set through `gnutls_ia_set_client_avp_ptr()'. The AVP received from the server is present in `last' of `lastlen' size, which will be `NULL' on the first invocation. The newly allocated output AVP to send to the server should be placed in *`next' of *`nextlen' size. The callback may invoke `gnutls_ia_permute_inner_secret()' to mix any generated session keys with the TLS/IA inner secret. Return 0 (`GNUTLS_IA_APPLICATION_PAYLOAD') on success, or a negative error code to abort the TLS/IA handshake. Note that the callback must use allocate the `next' parameter using `gnutls_malloc()', because it is released via `gnutls_free()' by the TLS/IA handshake function. gnutls_ia_set_client_avp_ptr ---------------------------- -- Function: void gnutls_ia_set_client_avp_ptr (gnutls_ia_client_credentials_t CRED, void * PTR) CRED: is a `gnutls_ia_client_credentials_t' structure. PTR: is the pointer Sets the pointer that will be provided to the TLS/IA callback function as the first argument. gnutls_ia_set_server_avp_function --------------------------------- -- Function: void gnutls_ia_set_server_avp_function (gnutls_ia_server_credentials_t CRED, gnutls_ia_avp_func AVP_FUNC) CRED: is a `gnutls_ia_server_credentials_t' structure. 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 `session' parameter is the `gnutls_session_t' structure corresponding to the current session. The `ptr' parameter is the application hook pointer, set through `gnutls_ia_set_server_avp_ptr()'. The AVP received from the client is present in `last' of `lastlen' size. The newly allocated output AVP to send to the client should be placed in *`next' of *`nextlen' 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 `gnutls_ia_apptype_t' message type. The callback may invoke `gnutls_ia_permute_inner_secret()' to mix any generated session keys with the TLS/IA inner secret. Specifically, return `GNUTLS_IA_APPLICATION_PAYLOAD' (0) to send another AVP to the client, return `GNUTLS_IA_INTERMEDIATE_PHASE_FINISHED' (1) to indicate that an IntermediatePhaseFinished message should be sent, and return `GNUTLS_IA_FINAL_PHASE_FINISHED' (2) to indicate that an FinalPhaseFinished message should be sent. In the last two cases, the contents of the `next' and `nextlen' parameter is not used. Note that the callback must use allocate the `next' parameter using `gnutls_malloc()', because it is released via `gnutls_free()' by the TLS/IA handshake function. gnutls_ia_set_server_avp_ptr ---------------------------- -- Function: void gnutls_ia_set_server_avp_ptr (gnutls_ia_server_credentials_t CRED, void * PTR) CRED: is a `gnutls_ia_client_credentials_t' structure. PTR: is the pointer Sets the pointer that will be provided to the TLS/IA callback function as the first argument. gnutls_ia_verify_endphase ------------------------- -- Function: int gnutls_ia_verify_endphase (gnutls_session_t SESSION, const char * CHECKSUM) SESSION: is a `gnutls_session_t' structure. CHECKSUM: 12-byte checksum data, received from `gnutls_ia_recv()'. Verify TLS/IA end phase checksum data. If verification fails, the `GNUTLS_A_INNER_APPLICATION_VERIFICATION' alert is sent to the other sie. This function is called when `gnutls_ia_recv()' return `GNUTLS_E_WARNING_IA_IPHF_RECEIVED' or `GNUTLS_E_WARNING_IA_FPHF_RECEIVED'. *Return value:* Return 0 on successful verification, or an error code. If the checksum verification of the end phase message fails, `GNUTLS_E_IA_VERIFY_FAILED' is returned.  File: gnutls.info, Node: Error codes and descriptions, Prev: TLS Inner Application (TLS/IA) functions, Up: Function reference 9.6 Error Codes and Descriptions ================================ The error codes used throughout the library are described below. The return code `GNUTLS_E_SUCCESS' indicate successful operation, and is guaranteed to have the value 0, so you can use it in logical expressions. `GNUTLS_E_AGAIN:' Resource temporarily unavailable, try again. `GNUTLS_E_ASN1_DER_ERROR:' ASN1 parser: Error in DER parsing. `GNUTLS_E_ASN1_DER_OVERFLOW:' ASN1 parser: Overflow in DER parsing. `GNUTLS_E_ASN1_ELEMENT_NOT_FOUND:' ASN1 parser: Element was not found. `GNUTLS_E_ASN1_GENERIC_ERROR:' ASN1 parser: Generic parsing error. `GNUTLS_E_ASN1_IDENTIFIER_NOT_FOUND:' ASN1 parser: Identifier was not found `GNUTLS_E_ASN1_SYNTAX_ERROR:' ASN1 parser: Syntax error. `GNUTLS_E_ASN1_TAG_ERROR:' ASN1 parser: Error in TAG. `GNUTLS_E_ASN1_TAG_IMPLICIT:' ASN1 parser: error in implicit tag `GNUTLS_E_ASN1_TYPE_ANY_ERROR:' ASN1 parser: Error in type 'ANY'. `GNUTLS_E_ASN1_VALUE_NOT_FOUND:' ASN1 parser: Value was not found. `GNUTLS_E_ASN1_VALUE_NOT_VALID:' ASN1 parser: Value is not valid. `GNUTLS_E_BASE64_DECODING_ERROR:' Base64 decoding error. `GNUTLS_E_BASE64_ENCODING_ERROR:' Base64 encoding error. `GNUTLS_E_BASE64_UNEXPECTED_HEADER_ERROR:' Base64 unexpected header error. `GNUTLS_E_CERTIFICATE_ERROR:' Error in the certificate. `GNUTLS_E_CERTIFICATE_KEY_MISMATCH:' The certificate and the given key do not match. `GNUTLS_E_COMPRESSION_FAILED:' Compression of the TLS record packet has failed. `GNUTLS_E_CONSTRAINT_ERROR:' Some constraint limits were reached. `GNUTLS_E_CRYPTO_ALREADY_REGISTERED:' There is already a crypto algorithm with lower priority. `GNUTLS_E_DB_ERROR:' Error in Database backend. `GNUTLS_E_DECOMPRESSION_FAILED:' Decompression of the TLS record packet has failed. `GNUTLS_E_DECRYPTION_FAILED:' Decryption has failed. `GNUTLS_E_DH_PRIME_UNACCEPTABLE:' The Diffie-Hellman prime sent by the server is not acceptable (not long enough). `GNUTLS_E_ENCRYPTION_FAILED:' Encryption has failed. `GNUTLS_E_ERROR_IN_FINISHED_PACKET:' An error was encountered at the TLS Finished packet calculation. `GNUTLS_E_EXPIRED:' The requested session has expired. `GNUTLS_E_FATAL_ALERT_RECEIVED:' A TLS fatal alert has been received. `GNUTLS_E_FILE_ERROR:' Error while reading file. `GNUTLS_E_GOT_APPLICATION_DATA:' TLS Application data were received, while expecting handshake data. `GNUTLS_E_HANDSHAKE_TOO_LARGE:' The handshake data size is too large (DoS?), check gnutls_handshake_set_max_packet_length(). `GNUTLS_E_HASH_FAILED:' Hashing has failed. `GNUTLS_E_IA_VERIFY_FAILED:' Verifying TLS/IA phase checksum failed `GNUTLS_E_ILLEGAL_SRP_USERNAME:' The SRP username supplied is illegal. `GNUTLS_E_INCOMPATIBLE_GCRYPT_LIBRARY:' The gcrypt library version is too old. `GNUTLS_E_INCOMPATIBLE_LIBTASN1_LIBRARY:' The tasn1 library version is too old. `GNUTLS_E_INIT_LIBEXTRA:' The initialization of GnuTLS-extra has failed. `GNUTLS_E_INSUFFICIENT_CREDENTIALS:' Insufficient credentials for that request. `GNUTLS_E_INTERNAL_ERROR:' GnuTLS internal error. `GNUTLS_E_INTERRUPTED:' Function was interrupted. `GNUTLS_E_INVALID_PASSWORD:' The given password contains invalid characters. `GNUTLS_E_INVALID_REQUEST:' The request is invalid. `GNUTLS_E_INVALID_SESSION:' The specified session has been invalidated for some reason. `GNUTLS_E_KEY_USAGE_VIOLATION:' Key usage violation in certificate has been detected. `GNUTLS_E_LARGE_PACKET:' A large TLS record packet was received. `GNUTLS_E_LIBRARY_VERSION_MISMATCH:' The GnuTLS library version does not match the GnuTLS-extra library version. `GNUTLS_E_LZO_INIT_FAILED:' The initialization of LZO has failed. `GNUTLS_E_MAC_VERIFY_FAILED:' The Message Authentication Code verification failed. `GNUTLS_E_MEMORY_ERROR:' Internal error in memory allocation. `GNUTLS_E_MPI_PRINT_FAILED:' Could not export a large integer. `GNUTLS_E_MPI_SCAN_FAILED:' The scanning of a large integer has failed. `GNUTLS_E_NO_CERTIFICATE_FOUND:' The peer did not send any certificate. `GNUTLS_E_NO_CIPHER_SUITES:' No supported cipher suites have been found. `GNUTLS_E_NO_COMPRESSION_ALGORITHMS:' No supported compression algorithms have been found. `GNUTLS_E_NO_TEMPORARY_DH_PARAMS:' No temporary DH parameters were found. `GNUTLS_E_NO_TEMPORARY_RSA_PARAMS:' No temporary RSA parameters were found. `GNUTLS_E_OPENPGP_FINGERPRINT_UNSUPPORTED:' The OpenPGP fingerprint is not supported. `GNUTLS_E_OPENPGP_GETKEY_FAILED:' Could not get OpenPGP key. `GNUTLS_E_OPENPGP_KEYRING_ERROR:' Error loading the keyring. `GNUTLS_E_OPENPGP_SUBKEY_ERROR:' Could not find OpenPGP subkey. `GNUTLS_E_OPENPGP_UID_REVOKED:' The OpenPGP User ID is revoked. `GNUTLS_E_PKCS1_WRONG_PAD:' Wrong padding in PKCS1 packet. `GNUTLS_E_PK_DECRYPTION_FAILED:' Public key decryption has failed. `GNUTLS_E_PK_ENCRYPTION_FAILED:' Public key encryption has failed. `GNUTLS_E_PK_SIGN_FAILED:' Public key signing has failed. `GNUTLS_E_PK_SIG_VERIFY_FAILED:' Public key signature verification has failed. `GNUTLS_E_PULL_ERROR:' Error in the pull function. `GNUTLS_E_PUSH_ERROR:' Error in the push function. `GNUTLS_E_RANDOM_FAILED:' Failed to acquire random data. `GNUTLS_E_RECEIVED_ILLEGAL_EXTENSION:' An illegal TLS extension was received. `GNUTLS_E_RECEIVED_ILLEGAL_PARAMETER:' An illegal parameter has been received. `GNUTLS_E_RECORD_LIMIT_REACHED:' The upper limit of record packet sequence numbers has been reached. Wow! `GNUTLS_E_REHANDSHAKE:' Rehandshake was requested by the peer. `GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE:' The requested data were not available. `GNUTLS_E_SHORT_MEMORY_BUFFER:' The given memory buffer is too short to hold parameters. `GNUTLS_E_SRP_PWD_ERROR:' Error in password file. `GNUTLS_E_SRP_PWD_PARSING_ERROR:' Parsing error in password file. `GNUTLS_E_SUCCESS:' Success. `GNUTLS_E_TOO_MANY_EMPTY_PACKETS:' Too many empty record packets have been received. `GNUTLS_E_UNEXPECTED_HANDSHAKE_PACKET:' An unexpected TLS handshake packet was received. `GNUTLS_E_UNEXPECTED_PACKET:' An unexpected TLS packet was received. `GNUTLS_E_UNEXPECTED_PACKET_LENGTH:' A TLS packet with unexpected length was received. `GNUTLS_E_UNKNOWN_ALGORITHM:' The specified algorithm or protocol is unknown. `GNUTLS_E_UNKNOWN_CIPHER_SUITE:' Could not negotiate a supported cipher suite. `GNUTLS_E_UNKNOWN_CIPHER_TYPE:' The cipher type is unsupported. `GNUTLS_E_UNKNOWN_COMPRESSION_ALGORITHM:' Could not negotiate a supported compression method. `GNUTLS_E_UNKNOWN_HASH_ALGORITHM:' The hash algorithm is unknown. `GNUTLS_E_UNKNOWN_PKCS_BAG_TYPE:' The PKCS structure's bag type is unknown. `GNUTLS_E_UNKNOWN_PKCS_CONTENT_TYPE:' The PKCS structure's content type is unknown. `GNUTLS_E_UNKNOWN_PK_ALGORITHM:' An unknown public key algorithm was encountered. `GNUTLS_E_UNSUPPORTED_CERTIFICATE_TYPE:' The certificate type is not supported. `GNUTLS_E_UNSUPPORTED_VERSION_PACKET:' A record packet with illegal version was received. `GNUTLS_E_UNWANTED_ALGORITHM:' An algorithm that is not enabled was negotiated. `GNUTLS_E_WARNING_ALERT_RECEIVED:' A TLS warning alert has been received. `GNUTLS_E_WARNING_IA_FPHF_RECEIVED:' Received a TLS/IA Final Phase Finished message `GNUTLS_E_WARNING_IA_IPHF_RECEIVED:' Received a TLS/IA Intermediate Phase Finished message `GNUTLS_E_X509_UNKNOWN_SAN:' Unknown Subject Alternative name in X.509 certificate. `GNUTLS_E_X509_UNSUPPORTED_ATTRIBUTE:' The certificate has unsupported attributes. `GNUTLS_E_X509_UNSUPPORTED_CRITICAL_EXTENSION:' Unsupported critical extension in X.509 certificate. `GNUTLS_E_X509_UNSUPPORTED_OID:' The OID is not supported.  File: gnutls.info, Node: All the supported ciphersuites in GnuTLS, Next: Guile Bindings, Prev: Function reference, Up: Top 10 All the Supported Ciphersuites in GnuTLS ******************************************* Available cipher suites: TLS_ANON_DH_ARCFOUR_MD5 0x00 0x18 SSL3.0 TLS_ANON_DH_3DES_EDE_CBC_SHA1 0x00 0x1b SSL3.0 TLS_ANON_DH_AES_128_CBC_SHA1 0x00 0x34 SSL3.0 TLS_ANON_DH_AES_256_CBC_SHA1 0x00 0x3a SSL3.0 TLS_PSK_SHA_ARCFOUR_SHA1 0x00 0x8a TLS1.0 TLS_PSK_SHA_3DES_EDE_CBC_SHA1 0x00 0x8b TLS1.0 TLS_PSK_SHA_AES_128_CBC_SHA1 0x00 0x8c TLS1.0 TLS_PSK_SHA_AES_256_CBC_SHA1 0x00 0x8d TLS1.0 TLS_DHE_PSK_SHA_ARCFOUR_SHA1 0x00 0x8e TLS1.0 TLS_DHE_PSK_SHA_3DES_EDE_CBC_SHA1 0x00 0x8f TLS1.0 TLS_DHE_PSK_SHA_AES_128_CBC_SHA1 0x00 0x90 TLS1.0 TLS_DHE_PSK_SHA_AES_256_CBC_SHA1 0x00 0x91 TLS1.0 TLS_SRP_SHA_3DES_EDE_CBC_SHA1 0xc0 0x1a TLS1.0 TLS_SRP_SHA_AES_128_CBC_SHA1 0xc0 0x1d TLS1.0 TLS_SRP_SHA_AES_256_CBC_SHA1 0xc0 0x20 TLS1.0 TLS_SRP_SHA_DSS_3DES_EDE_CBC_SHA1 0xc0 0x1c TLS1.0 TLS_SRP_SHA_RSA_3DES_EDE_CBC_SHA1 0xc0 0x1b TLS1.0 TLS_SRP_SHA_DSS_AES_128_CBC_SHA1 0xc0 0x1f TLS1.0 TLS_SRP_SHA_RSA_AES_128_CBC_SHA1 0xc0 0x1e TLS1.0 TLS_SRP_SHA_DSS_AES_256_CBC_SHA1 0xc0 0x22 TLS1.0 TLS_SRP_SHA_RSA_AES_256_CBC_SHA1 0xc0 0x21 TLS1.0 TLS_DHE_DSS_ARCFOUR_SHA1 0x00 0x66 TLS1.0 TLS_DHE_DSS_3DES_EDE_CBC_SHA1 0x00 0x13 SSL3.0 TLS_DHE_DSS_AES_128_CBC_SHA1 0x00 0x32 SSL3.0 TLS_DHE_DSS_AES_256_CBC_SHA1 0x00 0x38 SSL3.0 TLS_DHE_RSA_3DES_EDE_CBC_SHA1 0x00 0x16 SSL3.0 TLS_DHE_RSA_AES_128_CBC_SHA1 0x00 0x33 SSL3.0 TLS_DHE_RSA_AES_256_CBC_SHA1 0x00 0x39 SSL3.0 TLS_RSA_NULL_MD5 0x00 0x01 SSL3.0 TLS_RSA_EXPORT_ARCFOUR_40_MD5 0x00 0x03 SSL3.0 TLS_RSA_ARCFOUR_SHA1 0x00 0x05 SSL3.0 TLS_RSA_ARCFOUR_MD5 0x00 0x04 SSL3.0 TLS_RSA_3DES_EDE_CBC_SHA1 0x00 0x0a SSL3.0 TLS_RSA_AES_128_CBC_SHA1 0x00 0x2f SSL3.0 TLS_RSA_AES_256_CBC_SHA1 0x00 0x35 SSL3.0 Available certificate types: * X.509 * OPENPGP Available protocols: * SSL3.0 * TLS1.0 * TLS1.1 * TLS1.2 Available ciphers: * AES-256-CBC * AES-128-CBC * 3DES-CBC * DES-CBC * ARCFOUR-128 * ARCFOUR-40 * RC2-40 * NULL Available MAC algorithms: * SHA1 * MD5 * SHA256 * SHA384 * SHA512 * MD2 * RIPEMD160 * NULL Available key exchange methods: * ANON-DH * RSA * RSA-EXPORT * DHE-RSA * DHE-DSS * SRP-DSS * SRP-RSA * SRP * PSK * DHE-PSK Available public key algorithms: * RSA * DSA Available public key signature algorithms: * RSA-SHA * RSA-SHA256 * RSA-SHA384 * RSA-SHA512 * RSA-RMD160 * DSA-SHA * RSA-MD5 * RSA-MD2 Available compression methods: * DEFLATE * NULL Some additional information regarding some of the algorithms: `RSA' RSA is public key cryptosystem designed by Ronald Rivest, Adi Shamir and Leonard Adleman. It can be used with any hash functions. `DSA' DSA is the USA's Digital Signature Standard. It uses only the SHA-1 hash algorithm. `MD2' MD2 is a cryptographic hash algorithm designed by Ron Rivest. It is optimized for 8-bit processors. Outputs 128 bits of data. There are no known weaknesses of this algorithm but since this algorithm is rarely used and not really studied it should not be used today. `MD5' MD5 is a cryptographic hash algorithm designed by Ron Rivest. Outputs 128 bits of data. It is considered to be broken. `SHA-1' SHA is a cryptographic hash algorithm designed by NSA. Outputs 160 bits of data. It is also considered to be broken, though no practical attacks have been found. `RMD160' RIPEMD is a cryptographic hash algorithm developed in the framework of the EU project RIPE. Outputs 160 bits of data.  File: gnutls.info, Node: Guile Bindings, Next: Internal architecture of GnuTLS, Prev: All the supported ciphersuites in GnuTLS, Up: Top 11 Guile Bindings ***************** This chapter describes the GNU Guile (http://www.gnu.org/software/guile/) Scheme programming interface to GnuTLS. The reader is assumed to have basic knowledge of the protocol and library. Details missing from this chapter may be found in *note the C API reference: Function reference. At this stage, not all the C functions are available from Scheme, but a large subset thereof is available. * Menu: * Guile Preparations:: Note on installation and environment. * Guile API Conventions:: Naming conventions and other idiosyncrasies. * Guile Examples:: Quick start. * Guile Reference:: The Scheme GnuTLS programming interface.  File: gnutls.info, Node: Guile Preparations, Next: Guile API Conventions, Up: Guile Bindings 11.1 Guile Preparations ======================= The GnuTLS Guile bindings are by default installed under the GnuTLS installation directory (e.g., typically `/usr/local/share/guile/site/'). Normally Guile will not find the module there without help. You may experience something like this: $ guile guile> (use-modules (gnutls)) : no code for module (gnutls) guile> There are two ways to solve this. The first is to make sure that when building GnuTLS, the Guile bindings will be installed in the same place where Guile looks. You may do this by using the `--with-guile-site-dir' parameter as follows: $ ./configure --with-guile-site-dir=no This will instruct GnuTLS to attempt to install the Guile bindings where Guile will look for them. It will use `guile-config info pkgdatadir' to learn the path to use. If Guile was installed into `/usr', you may also install GnuTLS using the same prefix: $ ./configure --prefix=/usr If you want to specify the path to install the Guile bindings you can also specify the path directly: $ ./configure --with-guile-site-dir=/opt/guile/share/guile/site The second solution requires some more work but may be easier to use if you do not have system administrator rights to your machine. You need to instruct Guile so that it finds the GnuTLS Guile bindings. Either use the `GUILE_LOAD_PATH' environment variable as follows: $ GUILE_LOAD_PATH="/usr/local/share/guile/site:$GUILE_LOAD_PATH" guile guile> (use-modules (gnutls)) guile> Alternatively, you can modify Guile's `%load-path' variable (*note Guile's run-time options: (guile)Build Config.). At this point, you might get an error regarding `libguile-gnutls-v-0' similar to: gnutls.scm:361:1: In procedure dynamic-link in expression (load-extension "libguile-gnutls-v-0" "scm_init_gnutls"): gnutls.scm:361:1: file: "libguile-gnutls-v-0", message: "libguile-gnutls-v-0.so: cannot open shared object file: No such file or directory" In this case, you will need to modify the run-time linker path, for example as follows: $ LD_LIBRARY_PATH=/usr/local/lib GUILE_LOAD_PATH=/usr/local/share/guile/site guile guile> (use-modules (gnutls)) guile>  File: gnutls.info, Node: Guile API Conventions, Next: Guile Examples, Prev: Guile Preparations, Up: Guile Bindings 11.2 Guile API Conventions ========================== This chapter details the conventions used by Guile API, as well as specificities of the mapping of the C API to Scheme. * Menu: * Enumerates and Constants:: Representation of C-side constants. * Procedure Names:: Naming conventions. * Representation of Binary Data:: Binary data buffers. * Input and Output:: Input and output. * Exception Handling:: Exceptions.  File: gnutls.info, Node: Enumerates and Constants, Next: Procedure Names, Up: Guile API Conventions 11.2.1 Enumerates and Constants ------------------------------- Lots of enumerates and constants are used in the GnuTLS C API. For each C enumerate type, a disjoint Scheme type is used--thus, enumerate values and constants are not represented by Scheme symbols nor by integers. This makes it impossible to use an enumerate value of the wrong type on the Scheme side: such errors are automatically detected by type-checking. The enumerate values are bound to variables exported by the `(gnutls)' and `(gnutls extra)' modules. These variables are named according to the following convention: * All variable names are lower-case; the underscore `_' character used in the C API is replaced by hyphen `-'. * All variable names are prepended by the name of the enumerate type and the slash `/' character. * In some cases, the variable name is made more explicit than the one of the C API, e.g., by avoid abbreviations. Consider for instance this C-side enumerate: typedef enum { GNUTLS_CRD_CERTIFICATE = 1, GNUTLS_CRD_ANON, GNUTLS_CRD_SRP, GNUTLS_CRD_PSK, GNUTLS_CRD_IA } gnutls_credentials_type_t; The corresponding Scheme values are bound to the following variables exported by the `(gnutls)' module: credentials/certificate credentials/anonymous credentials/srp credentials/psk credentials/ia Hopefully, most variable names can be deduced from this convention. Scheme-side "enumerate" values can be compared using `eq?' (*note equality predicates: (guile)Equality.). Consider the following example: (let ((session (make-session connection-end/client))) ;; ;; ... ;; ;; Check the ciphering algorithm currently used by SESSION. (if (eq? cipher/arcfour (session-cipher session)) (format #t "We're using the ARCFOUR algorithm"))) In addition, all enumerate values can be converted to a human-readable string, in a type-specific way. For instance, `(cipher->string cipher/arcfour)' yields `"ARCFOUR 128"', while `(key-usage->string key-usage/digital-signature)' yields `"digital-signature"'. Note that these strings may not be sufficient for use in a user interface since they are fairly concise and not internationalized.  File: gnutls.info, Node: Procedure Names, Next: Representation of Binary Data, Prev: Enumerates and Constants, Up: Guile API Conventions 11.2.2 Procedure Names ---------------------- Unlike C functions in GnuTLS, the corresponding Scheme procedures are named in a way that is close to natural English. Abbreviations are also avoided. For instance, the Scheme procedure corresponding to `gnutls_certificate_set_dh_params' is named `set-certificate-credentials-dh-parameters!'. The `gnutls_' prefix is always omitted from variable names since a similar effect can be achieved using Guile's nifty binding renaming facilities, should it be needed (*note Using Guile Modules: (guile)Using Guile Modules.). Often Scheme procedure names differ from C function names in a way that makes it clearer what objects they operate on. For example, the Scheme procedure named `set-session-transport-port!' corresponds to `gnutls_transport_set_ptr', making it clear that this procedure applies to session.  File: gnutls.info, Node: Representation of Binary Data, Next: Input and Output, Prev: Procedure Names, Up: Guile API Conventions 11.2.3 Representation of Binary Data ------------------------------------ Many procedures operate on binary data. For instance, `pkcs3-import-dh-parameters' expects binary data as input and, similarly, procedures like `pkcs1-export-rsa-parameters' return binary data. Binary data is represented on the Scheme side using SRFI-4 homogeneous vectors (*note SRFI-4: (guile)SRFI-4.). Although any type of homogeneous vector may be used, `u8vector's (i.e., vectors of bytes) are highly recommended. As an example, generating and then exporting RSA parameters in the PEM format can be done as follows: (let* ((rsa-params (make-rsa-parameters 1024)) (raw-data (pkcs1-export-rsa-parameters rsa-params x509-certificate-format/pem))) (uniform-vector-write raw-data (open-output-file "some-file.pem"))) For an example of OpenPGP key import from a file, see *note Importing OpenPGP Keys Guile Example::.  File: gnutls.info, Node: Input and Output, Next: Exception Handling, Prev: Representation of Binary Data, Up: Guile API Conventions 11.2.4 Input and Output ----------------------- The underlying transport of a TLS session can be any Scheme input/output port (*note Ports and File Descriptors: (guile)Ports and File Descriptors.). This has to be specified using `set-session-transport-port!'. However, for better performance, a raw file descriptor can be specified, using `set-session-transport-fd!'. For instance, if the transport layer is a socket port over an OS-provided socket, you can use the `port->fdes' or `fileno' procedure to obtain the underlying file descriptor and pass it to `set-session-transport-fd!' (*note `port->fdes' and `fileno': (guile)Ports and File Descriptors.). This would work as follows: (let ((socket (socket PF_INET SOCK_STREAM 0)) (session (make-session connection-end/client))) ;; ;; Establish a TCP connection... ;; ;; Use the file descriptor that underlies SOCKET. (set-session-transport-fd! session (fileno socket))) Once a TLS session is established, data can be communicated through it (i.e., _via_ the TLS record layer) using the port returned by `session-record-port': (let ((session (make-session connection-end/client))) ;; ;; Initialize the various parameters of SESSION, set up ;; a network connection, etc... ;; (let ((i/o (session-record-port session))) (write "Hello peer!" i/o) (let ((greetings (read i/o))) ;; ... (bye session close-request/rdwr)))) A lower-level I/O API is provided by `record-send' and `record-receive!' which take an SRFI-4 vector to represent the data sent or received. While it might improve performance, it is much less convenient than the above and should rarely be needed.  File: gnutls.info, Node: Exception Handling, Prev: Input and Output, Up: Guile API Conventions 11.2.5 Exception Handling ------------------------- GnuTLS errors are implemented as Scheme exceptions (*note exceptions in Guile: (guile)Exceptions.). Each time a GnuTLS function returns an error, an exception with key `gnutls-error' is raised. The additional arguments that are thrown include an error code and the name of the GnuTLS procedure that raised the exception. The error code is pretty much like an enumerate value: it is one of the `error/' variables exported by the `(gnutls)' module (*note Enumerates and Constants::). Exceptions can be turned into error messages using the `error->string' procedure. The following examples illustrates how GnuTLS exceptions can be handled: (let ((session (make-session connection-end/server))) ;; ;; ... ;; (catch 'gnutls-error (lambda () (handshake session)) (lambda (key err function . currently-unused) (format (current-error-port) "a GnuTLS error was raised by `~a': ~a~%" function (error->string err))))) Again, error values can be compared using `eq?': ;; `gnutls-error' handler. (lambda (key err function . currently-unused) (if (eq? err error/fatal-alert-received) (format (current-error-port) "a fatal alert was caught!~%") (format (current-error-port) "something bad happened: ~a~%" (error->string err)))) Note that the `catch' handler is currently passed only 3 arguments but future versions might provide it with additional arguments. Thus, it must be prepared to handle more than 3 arguments, as in this example.  File: gnutls.info, Node: Guile Examples, Next: Guile Reference, Prev: Guile API Conventions, Up: Guile Bindings 11.3 Guile Examples =================== This chapter provides examples that illustrate common use cases. * Menu: * Anonymous Authentication Guile Example:: Simplest client and server. * OpenPGP Authentication Guile Example:: Using OpenPGP-based authentication. * Importing OpenPGP Keys Guile Example:: Importing keys from files.  File: gnutls.info, Node: Anonymous Authentication Guile Example, Next: OpenPGP Authentication Guile Example, Up: Guile Examples 11.3.1 Anonymous Authentication Guile Example --------------------------------------------- "Anonymous authentication" is very easy to use. No certificates are needed by the communicating parties. Yet, it allows them to benefit from end-to-end encryption and integrity checks. The client-side code would look like this (assuming SOME-SOCKET is bound to an open socket port): ;; Client-side. (let ((client (make-session connection-end/client))) ;; Use the default settings. (set-session-default-priority! client) ;; Don't use certificate-based authentication. (set-session-certificate-type-priority! client '()) ;; Request the "anonymous Diffie-Hellman" key exchange method. (set-session-kx-priority! client (list kx/anon-dh)) ;; Specify the underlying socket. (set-session-transport-fd! client (fileno some-socket)) ;; Create anonymous credentials. (set-session-credentials! client (make-anonymous-client-credentials)) ;; Perform the TLS handshake with the server. (handshake client) ;; Send data over the TLS record layer. (write "hello, world!" (session-record-port client)) ;; Terminate the TLS session. (bye client close-request/rdwr)) The corresponding server would look like this (again, assuming SOME-SOCKET is bound to a socket port): ;; Server-side. (let ((server (make-session connection-end/server))) (set-session-default-priority! server) (set-session-certificate-type-priority! server '()) (set-session-kx-priority! server (list kx/anon-dh)) ;; Specify the underlying transport socket. (set-session-transport-fd! server (fileno some-socket)) ;; Create anonymous credentials. (let ((cred (make-anonymous-server-credentials)) (dh-params (make-dh-parameters 1024))) ;; Note: DH parameter generation can take some time. (set-anonymous-server-dh-parameters! cred dh-params) (set-session-credentials! server cred)) ;; Perform the TLS handshake with the client. (handshake server) ;; Receive data over the TLS record layer. (let ((message (read (session-record-port server)))) (format #t "received the following message: ~a~%" message) (bye server close-request/rdwr))) This is it!  File: gnutls.info, Node: OpenPGP Authentication Guile Example, Next: Importing OpenPGP Keys Guile Example, Prev: Anonymous Authentication Guile Example, Up: Guile Examples 11.3.2 OpenPGP Authentication Guile Example ------------------------------------------- GnuTLS allows users to authenticate using OpenPGP certificates. The relevant procedures are provided by the `(gnutls extra)' module. Using OpenPGP-based authentication is not more complicated than using anonymous authentication. It requires a bit of extra work, though, to import the OpenPGP public and private key of the client/server. Key import is omitted here and is left as an exercise to the reader (*note Importing OpenPGP Keys Guile Example::). Assuming SOME-SOCKET is bound to an open socket port and PUB and SEC are bound to the client's OpenPGP public and secret key, respectively, client-side code would look like this: ;; Client-side. (define %certs (list certificate-type/openpgp)) (let ((client (make-session connection-end/client)) (cred (make-certificate-credentials))) (set-session-default-priority! client) ;; Choose OpenPGP certificates. (set-session-certificate-type-priority! client %certs) ;; Prepare appropriate client credentials. (set-certificate-credentials-openpgp-keys! cred pub sec) (set-session-credentials! client cred) ;; Specify the underlying transport socket. (set-session-transport-fd! client (fileno some-socket)) (handshake client) (write "hello, world!" (session-record-port client)) (bye client close-request/rdwr)) Similarly, server-side code would be along these lines: ;; Server-side. (define %certs (list certificate-type/openpgp)) (let ((server (make-session connection-end/server)) (rsa (make-rsa-parameters 1024)) (dh (make-dh-parameters 1024))) (set-session-default-priority! server) ;; Choose OpenPGP certificates. (set-session-certificate-type-priority! server %certs) (let ((cred (make-certificate-credentials))) ;; Prepare credentials with RSA and Diffie-Hellman parameters. (set-certificate-credentials-dh-parameters! cred dh) (set-certificate-credentials-rsa-export-parameters! cred rsa) (set-certificate-credentials-openpgp-keys! cred pub sec) (set-session-credentials! server cred)) (set-session-transport-fd! server (fileno some-socket)) (handshake server) (let ((msg (read (session-record-port server)))) (format #t "received: ~a~%" msg) (bye server close-request/rdwr))) In practice, generating RSA parameters (and Diffie-Hellman parameters) can time a long time. Thus, you may want to generate them once and store them in a file for future re-use (*note `pkcs1-export-rsa-parameters' and `pkcs1-import-rsa-parameters': Core Interface.).  File: gnutls.info, Node: Importing OpenPGP Keys Guile Example, Prev: OpenPGP Authentication Guile Example, Up: Guile Examples 11.3.3 Importing OpenPGP Keys Guile Example ------------------------------------------- The following example provides a simple way of importing "ASCII-armored" OpenPGP keys from files, using the `import-openpgp-certificate' and `import-openpgp-private-key' procedures provided by the `(gnutls extra)' module. (use-modules (srfi srfi-4) (gnutls extra)) (define (import-key-from-file import-proc file) ;; Import OpenPGP key from FILE using IMPORT-PROC. ;; Prepare a u8vector large enough to hold the raw ;; key contents. (let* ((size (stat:size (stat path))) (raw (make-u8vector size))) ;; Fill in the u8vector with the contents of FILE. (uniform-vector-read! raw (open-input-file file)) ;; Pass the u8vector to the import procedure. (import-proc raw openpgp-certificate-format/base64))) (define (import-public-key-from-file file) (import-key-from-file import-openpgp-certificate file)) (define (import-private-key-from-file file) (import-key-from-file import-openpgp-private-key file)) The procedures `import-public-key-from-file' and `import-private-key-from-file' can be passed a file name. They return an OpenPGP public key and private key object, respectively (*note OpenPGP key objects: Extra Interface.).  File: gnutls.info, Node: Guile Reference, Prev: Guile Examples, Up: Guile Bindings 11.4 Guile Reference ==================== This chapter documents GnuTLS Scheme procedures available to Guile programmers. * Menu: * Core Interface:: Bindings for core GnuTLS. * Extra Interface:: Bindings for GnuTLS-Extra.  File: gnutls.info, Node: Core Interface, Next: Extra Interface, Up: Guile Reference 11.4.1 Core Interface --------------------- This section lists the Scheme procedures exported by the `(gnutls)' module (*note The Guile module system: (guile)The Guile module system.). This module is licenced under the GNU Lesser General Public Licence, version 2.1 or later. -- Scheme Procedure: set-log-level! level Enable GnuTLS logging up to LEVEL (an integer). -- Scheme Procedure: set-log-procedure! proc Use PROC (a two-argument procedure) as the global GnuTLS log procedure. -- Scheme Procedure: x509-certificate-subject-alternative-name cert index Return two values: the alternative name type for CERT (i.e., one of the `x509-subject-alternative-name/' values) and the actual subject alternative name (a string) at INDEX. Both values are `#f' if no alternative name is available at INDEX. -- Scheme Procedure: x509-certificate-subject-key-id cert Return the subject key ID (a u8vector) for CERT. -- Scheme Procedure: x509-certificate-authority-key-id cert Return the key ID (a u8vector) of the X.509 certificate authority of CERT. -- Scheme Procedure: x509-certificate-key-id cert Return a statistically unique ID (a u8vector) for CERT that depends on its public key parameters. This is normally a 20-byte SHA-1 hash. -- Scheme Procedure: x509-certificate-version cert Return the version of CERT. -- Scheme Procedure: x509-certificate-key-usage cert Return the key usage of CERT (i.e., a list of `key-usage/' values), or the empty list if CERT does not contain such information. -- Scheme Procedure: x509-certificate-public-key-algorithm cert Return two values: the public key algorithm (i.e., one of the `pk-algorithm/' values) of CERT and the number of bits used. -- Scheme Procedure: x509-certificate-signature-algorithm cert Return the signature algorithm used by CERT (i.e., one of the `sign-algorithm/' values). -- Scheme Procedure: x509-certificate-matches-hostname? cert hostname Return true if CERT matches HOSTNAME, a string denoting a DNS host name. This is the basic implementation of RFC 2818 (http://tools.ietf.org/html/rfc2818) (aka. HTTPS). -- Scheme Procedure: x509-certificate-issuer-dn-oid cert index Return the OID (a string) at INDEX from CERT's issuer DN. Return `#f' if no OID is available at INDEX. -- Scheme Procedure: x509-certificate-dn-oid cert index Return OID (a string) at INDEX from CERT. Return `#f' if no OID is available at INDEX. -- Scheme Procedure: x509-certificate-issuer-dn cert Return the distinguished name (DN) of X.509 certificate CERT. -- Scheme Procedure: x509-certificate-dn cert Return the distinguished name (DN) of X.509 certificate CERT. The form of the DN is as described in RFC 2253 (http://tools.ietf.org/html/rfc2253). -- Scheme Procedure: pkcs8-import-x509-private-key data format [pass [encrypted]] Return a new X.509 private key object resulting from the import of DATA (a uniform array) according to FORMAT. Optionally, if PASS is not `#f', it should be a string denoting a passphrase. ENCRYPTED tells whether the private key is encrypted (`#t' by default). -- Scheme Procedure: import-x509-private-key data format Return a new X.509 private key object resulting from the import of DATA (a uniform array) according to FORMAT. -- Scheme Procedure: import-x509-certificate data format Return a new X.509 certificate object resulting from the import of DATA (a uniform array) according to FORMAT. -- Scheme Procedure: server-session-psk-username session Return the username associated with PSK server session SESSION. -- Scheme Procedure: set-psk-client-credentials! cred username key key-format Set the client credentials for CRED, a PSK client credentials object. -- Scheme Procedure: make-psk-client-credentials Return a new PSK client credentials object. -- Scheme Procedure: set-psk-server-credentials-file! cred file Use FILE as the password file for PSK server credentials CRED. -- Scheme Procedure: make-psk-server-credentials Return new PSK server credentials. -- Scheme Procedure: peer-certificate-status session Verify the peer certificate for SESSION and return a list of `certificate-status' values (such as `certificate-status/revoked'), or the empty list if the certificate is valid. -- Scheme Procedure: set-certificate-credentials-verify-flags! cred [flags...] Set the certificate verification flags to FLAGS, a series of `certificate-verify' values. -- Scheme Procedure: set-certificate-credentials-verify-limits! cred max-bits max-depth Set the verification limits of `peer-certificate-status' for certificate credentials CRED to MAX_BITS bits for an acceptable certificate and MAX_DEPTH as the maximum depth of a certificate chain. -- Scheme Procedure: set-certificate-credentials-x509-keys! cred certs privkey Have certificate credentials CRED use the X.509 certificates listed in CERTS and X.509 private key PRIVKEY. -- Scheme Procedure: set-certificate-credentials-x509-key-data! cred cert key format Use X.509 certificate CERT and private key KEY, both uniform arrays containing the X.509 certificate and key in format FORMAT, for certificate credentials CRED. -- Scheme Procedure: set-certificate-credentials-x509-crl-data! cred data format Use DATA (a uniform array) as the X.509 CRL (certificate revocation list) database for CRED. On success, return the number of CRLs processed. -- Scheme Procedure: set-certificate-credentials-x509-trust-data! cred data format Use DATA (a uniform array) as the X.509 trust database for CRED. On success, return the number of certificates processed. -- Scheme Procedure: set-certificate-credentials-x509-crl-file! cred file format Use FILE as the X.509 CRL (certificate revocation list) file for certificate credentials CRED. On success, return the number of CRLs processed. -- Scheme Procedure: set-certificate-credentials-x509-trust-file! cred file format Use FILE as the X.509 trust file for certificate credentials CRED. On success, return the number of certificates processed. -- Scheme Procedure: set-certificate-credentials-x509-key-files! cred cert-file key-file format Use FILE as the password file for PSK server credentials CRED. -- Scheme Procedure: set-certificate-credentials-rsa-export-parameters! cred rsa-params Use RSA parameters RSA_PARAMS for certificate credentials CRED. -- Scheme Procedure: set-certificate-credentials-dh-parameters! cred dh-params Use Diffie-Hellman parameters DH_PARAMS for certificate credentials CRED. -- Scheme Procedure: make-certificate-credentials Return new certificate credentials (i.e., for use with either X.509 or OpenPGP certificates. -- Scheme Procedure: pkcs1-export-rsa-parameters rsa-params format Export Diffie-Hellman parameters RSA_PARAMS in PKCS1 format according for FORMAT (an `x509-certificate-format' value). Return a `u8vector' containing the result. -- Scheme Procedure: pkcs1-import-rsa-parameters array format Import Diffie-Hellman parameters in PKCS1 format (further specified by FORMAT, an `x509-certificate-format' value) from ARRAY (a homogeneous array) and return a new `rsa-params' object. -- Scheme Procedure: make-rsa-parameters bits Return new RSA parameters. -- Scheme Procedure: set-anonymous-server-dh-parameters! cred dh-params Set the Diffie-Hellman parameters of anonymous server credentials CRED. -- Scheme Procedure: make-anonymous-client-credentials Return anonymous client credentials. -- Scheme Procedure: make-anonymous-server-credentials Return anonymous server credentials. -- Scheme Procedure: set-session-dh-prime-bits! session bits Use BITS DH prime bits for SESSION. -- Scheme Procedure: pkcs3-export-dh-parameters dh-params format Export Diffie-Hellman parameters DH_PARAMS in PKCS3 format according for FORMAT (an `x509-certificate-format' value). Return a `u8vector' containing the result. -- Scheme Procedure: pkcs3-import-dh-parameters array format Import Diffie-Hellman parameters in PKCS3 format (further specified by FORMAT, an `x509-certificate-format' value) from ARRAY (a homogeneous array) and return a new `dh-params' object. -- Scheme Procedure: make-dh-parameters bits Return new Diffie-Hellman parameters. -- Scheme Procedure: set-session-transport-port! session port Use PORT as the input/output port for SESSION. -- Scheme Procedure: set-session-transport-fd! session fd Use file descriptor FD as the underlying transport for SESSION. -- Scheme Procedure: session-record-port session Return a read-write port that may be used to communicate over SESSION. All invocations of `session-port' on a given session return the same object (in the sense of `eq?'). -- Scheme Procedure: record-receive! session array Receive data from SESSION into ARRAY, a uniform homogeneous array. Return the number of bytes actually received. -- Scheme Procedure: record-send session array Send the record constituted by ARRAY through SESSION. -- Scheme Procedure: set-session-credentials! session cred Use CRED as SESSION's credentials. -- Scheme Procedure: cipher-suite->string kx cipher mac Return the name of the given cipher suite. -- Scheme Procedure: set-session-default-export-priority! session Have SESSION use the default export priorities. -- Scheme Procedure: set-session-default-priority! session Have SESSION use the default priorities. -- Scheme Procedure: set-session-certificate-type-priority! session items Use ITEMS (a list) as the list of preferred certificate-type for SESSION. -- Scheme Procedure: set-session-protocol-priority! session items Use ITEMS (a list) as the list of preferred protocol for SESSION. -- Scheme Procedure: set-session-kx-priority! session items Use ITEMS (a list) as the list of preferred kx for SESSION. -- Scheme Procedure: set-session-compression-method-priority! session items Use ITEMS (a list) as the list of preferred compression-method for SESSION. -- Scheme Procedure: set-session-mac-priority! session items Use ITEMS (a list) as the list of preferred mac for SESSION. -- Scheme Procedure: set-session-cipher-priority! session items Use ITEMS (a list) as the list of preferred cipher for SESSION. -- Scheme Procedure: set-server-session-certificate-request! session request Tell how SESSION, a server-side session, should deal with certificate requests. REQUEST should be either `certificate-request/request' or `certificate-request/require'. -- Scheme Procedure: session-our-certificate-chain session Return our certificate chain for SESSION (as sent to the peer) in raw format (a u8vector). In the case of OpenPGP there is exactly one certificate. Return the empty list if no certificate was used. -- Scheme Procedure: session-peer-certificate-chain session Return the a list of certificates in raw format (u8vectors) where the first one is the peer's certificate. In the case of OpenPGP, there is always exactly one certificate. In the case of X.509, subsequent certificates indicate form a certificate chain. Return the empty list if no certificate was sent. -- Scheme Procedure: session-client-authentication-type session Return the client authentication type (a `credential-type' value) used in SESSION. -- Scheme Procedure: session-server-authentication-type session Return the server authentication type (a `credential-type' value) used in SESSION. -- Scheme Procedure: session-authentication-type session Return the authentication type (a `credential-type' value) used by SESSION. -- Scheme Procedure: session-protocol session Return the protocol used by SESSION. -- Scheme Procedure: session-certificate-type session Return SESSION's certificate type. -- Scheme Procedure: session-compression-method session Return SESSION's compression method. -- Scheme Procedure: session-mac session Return SESSION's MAC. -- Scheme Procedure: session-kx session Return SESSION's kx. -- Scheme Procedure: session-cipher session Return SESSION's cipher. -- Scheme Procedure: alert-send session level alert Send ALERT via SESSION. -- Scheme Procedure: alert-get session Get an aleter from SESSION. -- Scheme Procedure: rehandshake session Perform a re-handshaking for SESSION. -- Scheme Procedure: handshake session Perform a handshake for SESSION. -- Scheme Procedure: bye session how Close SESSION according to HOW. -- Scheme Procedure: make-session end Return a new session for connection end END, either `connection-end/server' or `connection-end/client'. -- Scheme Procedure: gnutls-version Return a string denoting the version number of the underlying GnuTLS library, e.g., `"1.7.2"'. -- Scheme Procedure: x509-private-key? obj Return true if OBJ is of type `x509-private-key'. -- Scheme Procedure: x509-certificate? obj Return true if OBJ is of type `x509-certificate'. -- Scheme Procedure: psk-client-credentials? obj Return true if OBJ is of type `psk-client-credentials'. -- Scheme Procedure: psk-server-credentials? obj Return true if OBJ is of type `psk-server-credentials'. -- Scheme Procedure: srp-client-credentials? obj Return true if OBJ is of type `srp-client-credentials'. -- Scheme Procedure: srp-server-credentials? obj Return true if OBJ is of type `srp-server-credentials'. -- Scheme Procedure: certificate-credentials? obj Return true if OBJ is of type `certificate-credentials'. -- Scheme Procedure: rsa-parameters? obj Return true if OBJ is of type `rsa-parameters'. -- Scheme Procedure: dh-parameters? obj Return true if OBJ is of type `dh-parameters'. -- Scheme Procedure: anonymous-server-credentials? obj Return true if OBJ is of type `anonymous-server-credentials'. -- Scheme Procedure: anonymous-client-credentials? obj Return true if OBJ is of type `anonymous-client-credentials'. -- Scheme Procedure: session? obj Return true if OBJ is of type `session'. -- Scheme Procedure: error->string enumval Return a string describing ENUMVAL, a `error' value. -- Scheme Procedure: certificate-verify->string enumval Return a string describing ENUMVAL, a `certificate-verify' value. -- Scheme Procedure: key-usage->string enumval Return a string describing ENUMVAL, a `key-usage' value. -- Scheme Procedure: psk-key-format->string enumval Return a string describing ENUMVAL, a `psk-key-format' value. -- Scheme Procedure: sign-algorithm->string enumval Return a string describing ENUMVAL, a `sign-algorithm' value. -- Scheme Procedure: pk-algorithm->string enumval Return a string describing ENUMVAL, a `pk-algorithm' value. -- Scheme Procedure: x509-subject-alternative-name->string enumval Return a string describing ENUMVAL, a `x509-subject-alternative-name' value. -- Scheme Procedure: x509-certificate-format->string enumval Return a string describing ENUMVAL, a `x509-certificate-format' value. -- Scheme Procedure: certificate-type->string enumval Return a string describing ENUMVAL, a `certificate-type' value. -- Scheme Procedure: protocol->string enumval Return a string describing ENUMVAL, a `protocol' value. -- Scheme Procedure: close-request->string enumval Return a string describing ENUMVAL, a `close-request' value. -- Scheme Procedure: certificate-request->string enumval Return a string describing ENUMVAL, a `certificate-request' value. -- Scheme Procedure: certificate-status->string enumval Return a string describing ENUMVAL, a `certificate-status' value. -- Scheme Procedure: handshake-description->string enumval Return a string describing ENUMVAL, a `handshake-description' value. -- Scheme Procedure: alert-description->string enumval Return a string describing ENUMVAL, a `alert-description' value. -- Scheme Procedure: alert-level->string enumval Return a string describing ENUMVAL, a `alert-level' value. -- Scheme Procedure: connection-end->string enumval Return a string describing ENUMVAL, a `connection-end' value. -- Scheme Procedure: compression-method->string enumval Return a string describing ENUMVAL, a `compression-method' value. -- Scheme Procedure: digest->string enumval Return a string describing ENUMVAL, a `digest' value. -- Scheme Procedure: mac->string enumval Return a string describing ENUMVAL, a `mac' value. -- Scheme Procedure: credentials->string enumval Return a string describing ENUMVAL, a `credentials' value. -- Scheme Procedure: params->string enumval Return a string describing ENUMVAL, a `params' value. -- Scheme Procedure: kx->string enumval Return a string describing ENUMVAL, a `kx' value. -- Scheme Procedure: cipher->string enumval Return a string describing ENUMVAL, a `cipher' value.  File: gnutls.info, Node: Extra Interface, Prev: Core Interface, Up: Guile Reference 11.4.2 Extra Interface ---------------------- This section lists the Scheme procedures exported by the `(gnutls extra)' module. This module is licenced under the GNU General Public Licence, version 3 or later. -- Scheme Procedure: set-certificate-credentials-openpgp-keys! cred pub sec Use certificate PUB and secret key SEC in certificate credentials CRED. -- Scheme Procedure: openpgp-keyring-contains-key-id? keyring id Return `#f' if key ID ID is in KEYRING, `#f' otherwise. -- Scheme Procedure: import-openpgp-keyring data format Import DATA (a u8vector) according to FORMAT and return the imported keyring. -- Scheme Procedure: openpgp-certificate-usage key Return a list of values denoting the key usage of KEY. -- Scheme Procedure: openpgp-certificate-version key Return the version of the OpenPGP message format (RFC2440) honored by KEY. -- Scheme Procedure: openpgp-certificate-algorithm key Return two values: the certificate algorithm used by KEY and the number of bits used. -- Scheme Procedure: openpgp-certificate-names key Return the list of names for KEY. -- Scheme Procedure: openpgp-certificate-name key index Return the INDEXth name of KEY. -- Scheme Procedure: openpgp-certificate-fingerprint key Return a new u8vector denoting the fingerprint of KEY. -- Scheme Procedure: openpgp-certificate-fingerprint! key fpr Store in FPR (a u8vector) the fingerprint of KEY. Return the number of bytes stored in FPR. -- Scheme Procedure: openpgp-certificate-id! key id Store the ID (an 8 byte sequence) of certificate KEY in ID (a u8vector). -- Scheme Procedure: openpgp-certificate-id key Return the ID (an 8-element u8vector) of certificate KEY. -- Scheme Procedure: import-openpgp-private-key data format [pass] Return a new OpenPGP private key object resulting from the import of DATA (a uniform array) according to FORMAT. Optionally, a passphrase may be provided. -- Scheme Procedure: import-openpgp-certificate data format Return a new OpenPGP certificate object resulting from the import of DATA (a uniform array) according to FORMAT. -- Scheme Procedure: openpgp-certificate-format->string enumval Return a string describing ENUMVAL, a `openpgp-certificate-format' value. -- Scheme Procedure: openpgp-keyring? obj Return true if OBJ is of type `openpgp-keyring'. -- Scheme Procedure: openpgp-private-key? obj Return true if OBJ is of type `openpgp-private-key'. -- Scheme Procedure: openpgp-certificate? obj Return true if OBJ is of type `openpgp-certificate'.  File: gnutls.info, Node: Internal architecture of GnuTLS, Next: Copying Information, Prev: Guile Bindings, Up: Top 12 Internal Architecture of GnuTLS ********************************** This chapter is to give a brief description of the way GnuTLS works. The focus is to give an idea to potential developers and those who want to know what happens inside the black box. * Menu: * The TLS Protocol:: * TLS Handshake Protocol:: * TLS Authentication Methods:: * TLS Extension Handling:: * Cryptographic Backend::  File: gnutls.info, Node: The TLS Protocol, Next: TLS Handshake Protocol, Up: Internal architecture of GnuTLS 12.1 The TLS Protocol ===================== The main needs for the TLS protocol to be used are shown in the image below. [image src="gnutls-client-server-use-case.png"] This is being accomplished by the following object diagram. Note that since GnuTLS is being developed in C object are just structures with attributes. The operations listed are functions that require the first parameter to be that object. [image src="gnutls-objects.png"]  File: gnutls.info, Node: TLS Handshake Protocol, Next: TLS Authentication Methods, Prev: The TLS Protocol, Up: Internal architecture of GnuTLS 12.2 TLS Handshake Protocol =========================== The GnuTLS handshake protocol is implemented as a state machine that waits for input or returns immediately when the non-blocking transport layer functions are used. The main idea is shown in the following figure. [image src="gnutls-handshake-state.png"] Also the way the input is processed varies per ciphersuite. Several implementations of the internal handlers are available and *note gnutls_handshake:: only multiplexes the input to the appropriate handler. For example a PSK ciphersuite has a different implementation of the `process_client_key_exchange' than a certificate ciphersuite. [image src="gnutls-handshake-sequence.png"]  File: gnutls.info, Node: TLS Authentication Methods, Next: TLS Extension Handling, Prev: TLS Handshake Protocol, Up: Internal architecture of GnuTLS 12.3 TLS Authentication Methods =============================== In GnuTLS authentication methods can be implemented quite easily. Since the required changes to add a new authentication method affect only the handshake protocol, a simple interface is used. An authentication method needs only to implement the functions as seen in the figure below. [image src="gnutls-mod_auth_st.png"] The functions that need to be implemented are the ones responsible for interpreting the handshake protocol messages. It is common for such functions to read data from one or more `credentials_t' structures(1) and write data, such as certificates, usernames etc. to `auth_info_t' structures. Simple examples of existing authentication methods can be seen in `auth_psk.c' for PSK ciphersuites and `auth_srp.c' for SRP ciphersuites. After implementing these functions the structure holding its pointers has to be registered in `gnutls_algorithms.c' in the `_gnutls_kx_algorithms' structure. ---------- Footnotes ---------- (1) such as the `gnutls_certificate_credentials_t' structures  File: gnutls.info, Node: TLS Extension Handling, Next: Cryptographic Backend, Prev: TLS Authentication Methods, Up: Internal architecture of GnuTLS 12.4 TLS Extension Handling =========================== As with authentication methods, the TLS extensions handlers can be implemented using the following interface. [image src="gnutls-extensions_st.png"] Here there are two functions, one for receiving the extension data and one for sending. These functions have to check internally whether they operate in client or server side. A simple example of an extension handler can be seen in `ext_srp.c' After implementing these functions, together with the extension number they handle, they have to be registered in `gnutls_extensions.c' in the `_gnutls_extensions' structure. 12.4.1 Adding a New TLS Extension --------------------------------- Adding support for a new TLS extension is done from time to time, and the process to do so is not difficult. Here are the steps you need to follow if you wish to do this yourself. For sake of discussion, let's consider adding support for the hypothetical TLS extension `foobar'. 1. Modify `configure.in' to add `--enable-foobar' or `--disable-foobar'. Which to chose depends on whether you intend to make the extension be enabled by default. Look at existing checks (i.e., SRP, authz) for how to model the code. For example: AC_MSG_CHECKING([whether to disable foobar support]) AC_ARG_ENABLE(foobar, AS_HELP_STRING([--disable-foobar], [disable foobar support]), ac_enable_foobar=no) if test x$ac_enable_foobar != xno; then AC_MSG_RESULT(no) AC_DEFINE(ENABLE_FOOBAR, 1, [enable foobar]) else ac_full=0 AC_MSG_RESULT(yes) fi AM_CONDITIONAL(ENABLE_FOOBAR, test "$ac_enable_foobar" != "no") 2. Add IANA extension value to `extensions_t' in `gnutls_int.h'. A good name for the value would be GNUTLS_EXTENSION_FOOBAR. Check with `http://www.iana.org/assignments/tls-extensiontype-values' for allocated values. For experiments, you could pick a number but remember that some consider it a bad idea to deploy such modified version since it will lead to interoperability problems in the future when the IANA allocates that number to someone else, or when the foobar protocol is allocated another number. 3. Add an entry to `_gnutls_extensions' in `gnutls_extensions.c'. A typical entry would be: #if ENABLE_FOOBAR GNUTLS_EXTENSION_ENTRY (GNUTLS_EXTENSION_FOOBAR, _gnutls_foobar_recv_params, _gnutls_foobar_send_params), #endif The GNUTLS_EXTENSION_FOOBAR is the integer value you added to `gnutls_int.h' earlier. The two functions are new functions that you will need to implement, most likely you'll need to add an `#include "ext_foobar.h"' as well. 4. Add new files `ext_foobar.c' and `ext_foobar.h' that implements the extension. The functions you are responsible to add are those mentioned in the previous step. As a starter, you could add this: int _gnutls_foobar_recv_params (gnutls_session_t session, const opaque * data, size_t data_size) { return 0; } int _gnutls_foobar_send_params (gnutls_session_t session, opaque * data, size_t _data_size) { return 0; } The `_gnutls_foobar_recv_params' function is responsible for parsing incoming extension data (both in the client and server). The `_gnutls_foobar_send_params' function is responsible for sending extension data (both in the client and server). If you receive length fields that doesn't match, return `GNUTLS_E_UNEXPECTED_PACKET_LENGTH'. If you receive invalid data, return `GNUTLS_E_RECEIVED_ILLEGAL_PARAMETER'. You can use other error codes too. Return 0 on success. The function typically store some information in the `session' variable for later usage. If you need to add new fields there, check `tls_ext_st' in `gnutls_int.h' and compare with existing TLS extension specific variables. Recall that both the client and server both send and receives parameters, and your code most likely will need to do different things depending on which mode it is in. It may be useful to make this distinction explicit in the code. Thus, for example, a better template than above would be: int _gnutls_foobar_recv_params (gnutls_session_t session, const opaque * data, size_t data_size) { if (session->security_parameters.entity == GNUTLS_CLIENT) return foobar_recv_client (session, data, data_size); else return foobar_recv_server (session, data, data_size); } int _gnutls_foobar_send_params (gnutls_session_t session, opaque * data, size_t data_size) { if (session->security_parameters.entity == GNUTLS_CLIENT) return foobar_send_client (session, data, data_size); else return foobar_send_server (session, data, data_size); } The functions used would be declared as `static' functions, of the appropriate prototype, in the same file. When adding the files, you'll need to add them to `Makefile.am' as well, for example: if ENABLE_FOOBAR COBJECTS += ext_foobar.c HFILES += ext_foobar.h endif 5. Add API functions to enable/disable the extension. Normally the client will have one API to request use of the extension, and setting some extension specific data. The server will have one API to let the library know that it is willing to accept the extension, often this is implemented through a callback but it doesn't have to. The APIs need to be added to `includes/gnutls/gnutls.h' or `includes/gnutls/extra.h' as appropriate. It is recommended that if you don't have a requirement to use the LGPLv2.1+ license for your extension, that you place your work under the GPLv3+ license and thus in the libgnutls-extra library. You can implement the API function in the `ext_foobar.c' file, or if that file ends up becoming rather larger, add a `gnutls_foobar.c' file. 12.5 Certificate Handling ========================= What is provided by the certificate handling functions is summarized in the following diagram. [image src="gnutls-certificate-user-use-case.png"]  File: gnutls.info, Node: Cryptographic Backend, Prev: TLS Extension Handling, Up: Internal architecture of GnuTLS 12.6 Cryptographic Backend ========================== Several new systems provide hardware assisted cryptographic algorithm implementations that offer implementations some orders of magnitude faster than the software. For this reason in current releases of GnuTLS it is possible to override parts of the crypto backend or the whole. It is possible to override them both at runtime and compile time, however here we will discuss the runtime possibility. The API available for this functionality is in `gnutls/crypto.h' header file. 12.6.1 Override specific algorithms ----------------------------------- When an optimized implementation of a single algorithm is available, say a hardware assisted version of AES-CBC then the following functions can be used to register those algorithms. * *note gnutls_crypto_single_cipher_register2:: To register a cipher algorithm. * *note gnutls_crypto_single_mac_register2:: To register a MAC algorithm. *note gnutls_crypto_single_digest_register2:: To register a digest (hash) algorithm. Those registration functions will only replace the specified algorithm and leave the rest of subsystem intact. 12.6.2 Override parts of the backend ------------------------------------ In some systems, such as embedded ones, it might be desirable to override big parts of the cryptographic backend, or even all of them. For this reason the following functions are provided. * *note gnutls_crypto_cipher_register2:: To override the cryptographic algorithms backend. * *note gnutls_crypto_mac_register2:: To override the MAC algorithms backend. * *note gnutls_crypto_digest_register2:: To override the digest algorithms backend. * *note gnutls_crypto_rnd_register2:: To override the random number generator backend. * *note gnutls_crypto_bigint_register2:: To override the big number number operations backend. * *note gnutls_crypto_pk_register2:: To override the public key encryption backend. This is tight to the big number operations so either both of them should be updated or care must be taken to use the same format. If all of them are used then GnuTLS will no longer use libgcrypt.  File: gnutls.info, Node: Copying Information, Next: Concept Index, Prev: Internal architecture of GnuTLS, Up: Top Appendix A Copying Information ****************************** * Menu: * GNU Free Documentation License:: License for copying this manual. * GNU LGPL:: License for copying the core GnuTLS library. * GNU GPL:: License for copying GNUTLS extra and tools. ./gnutls-2.8.1-i686/usr/share/info/gnutls-objects.png0000644000000000000000000050262411271476021020714 0ustar rootrootPNG  IHDR1lsBITO pHYs IDATxy\TU3 #"˰( &Zl. bfe ObJ=֣a0hYY) *tܹ ~b=9N_ΜS(l@py333jwĉ $:Y\4 <>}1"..c,H$Zp۷W"' D"QllliY>i(fff-eNô_NV tt<,t0,rOUZ9YN,/@w<-}x<vџٳ׿Xܾ} {ǏH$Zx1!Wj7n^>cJ$uova,U^-dlttի~~9]>P(r9 =uk׮uww/..J噙O< ]v-G fTTY`Mbccϝ;׎Q$['knn~uKK|KKKfkIIQ}}~cc#QN%k{7m4{{{@!X' jk:Y3coӮΈ4up,=:٢"sssBX,V.722"L!}=z499x&dfffƍ;y$sk2YnnnBoUD dαQ݁:cy///P8`nUG[NӧBӴ͏U纺;v,++_ i[놆7nܨ-H/.^844<...!!Asi3+]re~iYYY||ŋ5tɾK[lݵkiﯩٲeKC)))M mmm̞=֭[eeezzzE\\nii%5y<^xxN V\)vI +**fΜ) ]\\9zߴiShh#`ڰuX=rH@`kkё377_j׺uh d6oPU5֙d3q'pD1潳ڸqchhݫfNN'뻹rD:L{uԿ }}}|}}ӕCںuH$ڼyX'넰C-'z}}}}88849f͚ &49}ӦM/2S8{9sD?cG 9;;?|PP՚7OҮ_BBBKJJ9zOJJUvb&+ֱvUSgm߾}޼y%cT5MTUL>|իW{{{rD1j5Yo悃\\\V^͔7?䈊u0,L4)$$ѢEʇcbbTJd{6ߕ(k$_rŋ[ZZK0!%%% B*jii}ꊊ6mϷX"//r0 ࣏>\p!W^zuRRRcc;w8jr5k֜>}>##wQUgǎuuu۷oaʙu0dԿ bT*ݰa[{P5!̓ `O~sss}6mÇ5 ێRt&&&۶m .DܻF;vQGGRbɞ={HK6uX?:T[[ᘺ&  M6=x𠁁s.d6o,m޼Y$q& ׭[tG{sqqqzzz߽{jYYY:::YYYL֭<6gaTYR6ػwѮ]A7 k;|dz(d+>{=== jx@C?~^Q@ik:P{t v@.I,@ANxa)/S.l-rDPEE̙3BKvv6G5}}}|}}iattȑ#mDD-4hPZZ!$//Դ^UGqxyyzyyq;k<?wwwgduVHyfU59Sf8}Ȑ!of^כ?}ފ׈u8l^3<<%ߪO2۰aʕbhΝmXz@/f͚qrd9S|4$$ܼ$ 88M֚&M )))_h-\`Mbccϝ;G 'LG_^~e@bq^#NU {ڵ#cbbTl$&q/|qɓ'GannYoEk:um6ɓPj|kCj2ɬ>Ӵׯgddv5xQ4t\.o~H,) ߡ9&HB BQZZjbbwZPH MMMJL~a֬Y ɓibbŒ],s;kf^^Ljhll̊5륪qٳg]\\JKKgΜ)H:w58]!%%% B*jiiBoUH'm8`չwkH2LP466vTNVKKKKKBx<G`5O81l0---lLrr3D"Qxx8-6551118dXpkM D2uԺ:CC&ļk%%%Ic5jTAAA-(<ϧ:996Udr͓j*_VUm6Sx㍸8WWהaÆ:u &U**BM&5`~n̫R᰾ Ϟ=;xW.nl|נ,B~~~;w۱cS-[ӈqJJ 2 ࣏>\p!lj5bT*ݰaSsٷnݪ/++c'Nw!N;vm߾LJDU Ν;'O1"V5՟duyXK,ə3gNkOlmm먺CHNMogHoX"//rm.fGеKt:999BpݺuLbdϞ=DiCUI͛7D"z…":""#0֚{566622ڵk?_Pʧx$MsJ vuH`JNkOרk.Ǜ5kѣG총Q~Ak!' =U|\F@N ske9Y[[hu:lN5o-]DWKOOMOO</<<| w?MnfEE̙3BKvvvm* 6W.lQCCʕ+bΝ;9d奫啗Qttȑ#mDDLjXg~o&ܾ}ΎXO'|'nnnNuVHyf6I[%gnnj*//uqjŊ_~r;5T]}o e@/4iҤE1噙O< ]v--Yzwqqqmm-w .c~PfHHyIII@@@pppdռO?4--L M\\\V^т 6mTUU{9 Yg/&&QSy8R___\\۾}y̅ __SSe_bE^^^ee[ώ;oQsٷnݪ/++㨩j0rT6!!ܹs?FODpp0:Ar\&Q`h~C \.o~h޽FFFv"͞snnP(ϯo͛7D"6.\(#""ZlIǏ&&&{H*._p۶mq6eeeyxxxxxdeeqt?:T[[cayBLINNɑ:x𠁁Su BWW\yXy5nm_+=U@^}URpJEW4vUEka?YH 0S_jtd7x1dz7n>#B">}񌌌:*$֭[QFuT#8::7nBFQ!@:v`5'۪n!' NH||̙3-,,ȑ#>L)++x:::|A;}tXcmmTUUCׯѱz7O:ENVLuDD=?x.] bbb222x<\.5N͛cz͛!玎BP(⋛7o.//Iz: f֩zP ' ]aƍǏ8p`JJJYYڵkBHFF!ܹs山O?W,_v|ɒ%;w|7 !r< //*++AݺuСCEEEC&d,Y~?,''O?MLLLJJC?:f#]dъ+(71"u̦ht5 z#c'O:uow5o?xؘ?~|ƌΝ%uuu}ŋWZuVzێJGGtڣX,~葁!ÇVVVYYYmۂg͚uQ&Էzk߾};v?::PH{ӧL&'FFF;۪9V|>_P[xKݶmۢ'7^ziŊl4@]|@7Gka,t/šʤViZ)ܲe !$>>2Mk47Bϟ/,,$ :TGGi3f`w!1iftKL_{{{x c?tg}fff&7o IDAT7lpixxqA!yyyco2"BHԟdgnnj*//uBrrrtuuh5g#&uw>c}}}wwwkxۭzukHm^ɄN,t˗/B͐2DիLwiUn~#J;r޼G6lSBsNNNqfff1{|jkk M=fB;;; .[lҤIFhI&/ZHP|||BBBvvvLL !$$$ܼ$ 88~6meT>իW{{{ֶ6BȽ{.1&X !O< ]v-&L#//@ PUuDj?۷ϛ7o`ww2իW:0w]BC5XQug64*$5/dBWPt֏FFF_yBȑ#G MLL!>dO>J2;;lٲEiGeJ>wfJ !iiiL޽{ ! SBVUUїuuu{*UVB>BD"kx>xP.sԩ KBHvvr AĤNYnRhee*JknjjP(rss3s"w !%%% B*jiiq?̚5KPx{{!Ã}lqqرc®^Z^^nff6sLB6'O>\[[[(6Ym:`嗅666ZZZFFF%%%ѣGwQ333Bok"!BR.d2'N>x=өS 6lʕt|uN=1ׯI ;v찰cqttT($\vҏƍ_355Gg⌌ BxرE9::D"--UTT?c*J˕mm﬍M]]]:mlllRh##&5f̌~i:Ygg/ҟ]\\Dؤ#w-ZNwMFڑLz)_SSSf6ץR-p}qt|gV+$;3֐p!O&tm `G#'khhx+WrdWXrʊ AΞ=ۤI͛7R?lii|ҥKܽ/X`ڵtoPX}嗓'O.(((,,߾}3|DK.{}5kGOrܹs׬YS[[kjp}qtMbڵϧXiޚxXLpXCRBpL&>v8dEaǑݻwѮ]s .D-vzA<`"Cvrr:}7oDLMsss܄BuڐmhhXlA߾}{=cHP:tH__n&#bHInʢԟaU4j9ِPBiqukH_Gk;9P}z\.3h>|~t  :g|Jd֬YBNܹs5@ $X' uN: tz7dg=`I; `,Tr\!@BwذN ' uwt<}hd@{72ݰN ' u:td^i:n d@GR(:u*222:::77xxxEGGB$Z--#G;sرVVVz};@)ׯGFFFFF&''766r+++)S3112sm۶޽o)..&hkk+ LƴikkgG F݇@VZZO رci*ёܶ\P!CBRѣG% x{eeeLGFFFcƌ@CNBzjdddTTTrr2x7 . kjj޸qC"߿2`ӧܺu+11133Lzxxvp ' JJJbbb.O>sʔ)SL1bw ߿oAIOOmRH$w!+vvvIII nb<oСvvv;jJN.%.]b2[L8uIls2¢رcGΚ5B8w\XXo@:th``… W^^L/^T^okaag_xmmmnݺu7n\|W_}%jjjƏumll?bcc&wwٳg+?KPsCcW^g 4>~@$Ȕ\N˟{95 D"Qkee_\\;cƌǏB?~عs'!ógns/^H$?s]]!vҥX,8K.2[>y9/%&&&m 9Yd2٥K.W\a<;a}}c֬YkxxҥK !_}?OBȚ5kBCCxqq޽{=zD}W<<<9ɓ'nb 6`Z,TO>cz@yi$O0si6=zdgggddTPPѣ]F7oaTTTO$55=}@vMkjj.]D.\(//g{xx1ctuu; 9Yм .]boܸ|f:t(ݚ[OOOAr|^{3g}L8bmmm5`ӧOwuuMNNnrW :4w\DH=x <}tFrYh*655$0b5@ lg}'MݼysԨQb088x˖-PYmmC$˗ !|>/((襗^N Ž{- 9YPKFFݚ ..[YYi6®WVV&y<^QQQ߾}YZj~~~111Vںukǎ %ƍ .\˗/=p0QFuޓ: rT*ػwB7r)SL2YÇΝ?˗/:u'Ə̙RSS%O?DyXx%K4%E}}+Wh~6119d``Fnnn"Hq,4y̙jZد_?___Kl5a7[o۷o˖-ӧO8qb\\\߾}KKK|~W~?D"u!D[[{ڴi&M# Ž{hÇ!mm^xYBkaa8!' RWWw9K{h!{.ښ [喖o>|jn9ra*++҆ ҕqvK$_~boolٲz߿nqqqBgϞ}ݻw/]=E t!M4)((hڴi+--MJJ˗/1ȑ#@AN>ݚܹs̒X???ɓ'k6ž_hԩS+^z֭_|D"yݻwAjĕ+W$666K,ywz*lTzMLL+}H$`!' KԜ9sb=zD |3%v̘1XQ̙sȑAAA-V{-]رc?oAjPii}$ ݰX ̜9300[ӡKP1[2)B?O;v,,@v=Kl||>VB ϟڢŋ4?\YY4?,4't[wޥ[KRZ('OLw555lψ?p˖-[lQ~UU^ffy>}˟yCCñc$ɹsB//Yfecc͛7-rssCBp̘14?ѯ_? rZUUU\\MfddB--1c]bf9::޾}̙3ǏW33\ww;w 63cܹ#H~rB;ＳtRM^ 4E{/wttd88pfBN;s%6!!Ykff6y)Sh6gVffaaag\|9))i֭?`NڿD"q!DKKkԩAAA&Mf())IJJٔfgB5urr5tt'OB---WWWK( IDAT{GGH$AAA#G?kΜ9G9p@FFG}bŊ;wv^=KbbD"9z(󃝝ݲezTB󳉉%%%!CCC777uuu`5аT5ABBB}}=-k6BP6mڴ'NDDD,ZH6mrvvoF``Q4fw2[3 /@cǎ533`, ŵk̒XkkkK3LQQQ!ryAAQZXf͗_~qƏ>hΜ9G|YpqDrisرAAAfttC7nܐd9880[H] 9Y:u*222:::?? c]bY/^^^mkA"{ټyڵk]vulϲ4Do߾rB;Ｓd[[[My4?{Ū*搙=zxF ' B.%/^d֗Э ||| 4$twy'"""44t͚5mk!22^4iRLLӧ'MԱqBuu$ɵk!ZZZSL ʕGf;:t=;w\.w̙4?5qDv?d@Y=z(&&&&&… T,JKMM}Ν;ӧO777w!9 ʽ{ݻlٲpCSb55549,233cJب'| ' ʤ#++VcYMFx?{ܹ&ԄB!˽t钿kffWGGٳgA||<Ը/\PCC[KKKNNϦ3i~s%PYYI^x6jii*r988\zŋWVVN4ӧ Haݹs'22СC4uhhhf͚7N2І7n0%JJJEꎎ4?i``b 9YPPJl~~>&beeEK̙3GSS ax+//755ѩQWW}zxxddd$''{{{B޽{.^ ǏGDDBTTT͛͛r&?{uXL9MZXX'sBNKEE{E~~~4;uTv#cϞ=7n\`3gk˖-;~#GVX<ܷoڵk RYYY'OD)Slܸq͚5l6444dddmVVP(d0%hg͚b ,>$,JիWӧ*>>> wyBqfffb㹹* WWWWWם;w8p`߲eg}pB>vÇnppppp0!ʕ+4?VUUuӧOB]]]i~}ԨQl(0NzØ踸OF???EF`QkkAsssYYل kt5kOILLsvv.@n:;;/\qy+{>ohkkpVXXȔ8{.- rj\*ׯ_gf̘AKx{{cNsP.\vpprʠ?>>РiZIIݻcBѣW\󭭭mgSSSژEfffL 3f/(d@iiڨ@S'Of7B.}O?ݾ} ݻVVVSN>m>};wf͚5 55p|}}_~e$壥%;;`B=<Ƞ)lP,7nMzzz:88' c']]@8q" ܹs/^lٲA9-Vp+WBpbڷoߞ={!ZZZ˖-gf;=//g,m+Ϻ58`ANMkkkJJ M޼y6r83gΛ7o޼yZSSAGGǣG䧟~_h۷sss:::Ν;G?Ea)I$BAaa!EUUΎ)q0~xvCe,KQQ-Mp%fHѣiX]+xxx ۷~իW|b``qF3U?gSSSh jʔ)^^^4E;c g,J$%''T۷i#ñ 1$7ٳg~P?...((ҥKe׮]ކ v==jii9qDDD˗ !***|>><PMfdd<}Y4furrxgd.]jnnzzzAAA!!!!!!& cԴ##ggj49iooۜ#r#NKKKbb"[XXH9ٳiXWWW|W;55̙3 ,^.]K[V\yȍ7]\JKKٳo߾GBtuuWXmll ֖GЦUWW3ttth~ v9Y&HLLdF3fܹJ1ȈԌ5j:Zbűc?00;e$ ڌfرc=<ɉy07ntvvvkkk)S؍9Yܜ@SEEEQEEٙVurrRQQa7Hm۶۷׿5}iiiBZZZi;k׮ݷoPÌX,?#"".^H3w...|><`קlNN3W'!d„ 49ioo(dƭ[hؔVhddDΝ;c^^^LLLpp355-++{3-==ʕ+r{EFF:tɓ'1cƄYXX \:6--Y4j(777uuua1N9YOĖF.B:::bH,󫬬0aVMMzIIIIHH-BPWWWEEA>1p/lBJPP1rH$waJH^QUUupp`J't,"q-MB'o!*s;v, 3XvK/tYrʣG8p 44i9sfAAAVV|€ĉBbjjaÆu *:x6555??YdnngON[䓓Uҽ 4Kj!p\Z%v֬Y 0DOB֣!Dz/BcAA˗AСCwݺu_~ꫯ{{{ 2^{^#477geelff߿aBM:::jhh8 UAA 511 7o^PPИ1c؍`kkk344lhh())155Otdʕ+i駟׿Yf FD'㏎B̙3|Gvt0bkט>dijj:;;>q]2ڨFΚ5 ?*3g^vMΝ$%%1rF={۷2jԨ+V|[[[C9)..f7o***3f`J0DruZ --)6nܸ N`͛ᇏ>o[<077755e#ѣGBx<܂~HNNҽ_}UuuuKOOٜH,0aq9YӸ8e~*NcH,f̘q֭$uN---jjjLk222 d7n܈?((KLL3h~Ą8rŋJlEEmTSSX;;; P4tZŋ8qB]&%%0?[oz9@IKK8}tkk+!",,,44Nptljjj~~>&`JXYY@ ' \$I~~>-M|E8q"HCb?~ttÇW\)W^}}]itwwz`<~x{)..&xŋ|C555eeelfffcc#&g===Q7 D]]ŋcccՄ555OOOZ%DP(400hmm422s_|uֿLcKK.!ӧZZZr @X,>@ $899%K(X|U;!BsvvYTm,@I$+W*YYY̐I&4ܹs/KVV{?tPhhˏ=*ptwwwG݃"##x [1L2‚iD 2 N"$$$VZ+V@uJ&?{U^?!dڴiLKKK`8ANFXZ%6jhhT5PMJJ:u믿V ~~~/^ n5kV~~~ZZ[<ݻw޽˗|;;;CԔI󳙙MMM"CCC:xkҿ-PFٙC0sO2Vf7Hz###BHuuѣ #44СC{]ntu?l0{DDDbb"_{5 eqU:6--)Bк'''iXMձ.\>>>J]xחń,!̌R\\ܥi y믿[#GRSSSSS{ｵknܸqlAUUw!|xoƱcǤsrr\\\lll ؊ 577GEE |B˝?>feb=sr\[[[I؍d@TTTDGGFmmm???Z%vʔ)Fn'O駟|Mc!/>O.rssY @>}z@p-B+}}}Qړ'OVf)UQQa1N!׮]cִ4Ooа rȑ#VZlYTTTE7nܳg?w}"H#""~vB5_r%~N!rrrh~6==)EswwYLf,V{)mX333Va())͛l򿒓̙ᑖeў={6nܸ|G***ݻwއBx >vh0tvv޼y)qP\\,RWW={6Bihh^LjooOKKUb_\f̘Az{{cH, >ۼy;؎NpB|l{!vX,Ғ)q0m4vE,CYY@GOS'Of7B!fΜYPPv,K,xPe¶6]]QF!s@ 8|0-:ohhf͚7*H)322h~6++PG^^^fRSSc1NP4PikkKMM؂֖&RWWg1BiJJJtuukjj껱o߾meee˗|||X @ ? //2o޼̼,jooϧٴ*f+BbAVZZJK766F]]݀4i_{_X.v?233ɓ'E"!dʔ)aaa ޽{L;w0_\̙3'Nd7N`r0RRRh*ƍ^^^ 5$ F^zܹs e;cݺuܸqcE[~eˢX @|8n8?o߾m۶-[ʕ+g϶}6+(X@py:璃Cxxe˴َkiiɡٌ:f:;;x<!,ݾ}аJOxݫ߿ݺuK.Jx@CCÑ#G"##d/2߈Y{{+Wh~6--ѣG"mmmWWWussCe,BHKKKRR{]pf͚EĺaH,(;wnڴiŊGa;M6޽{nݚ>}zEfͲs+ $999""~koo'L>=,,lժUzzzlG_Lw2_\Sr#ڽ{hiDfH1chXv#Ǐ_d ۱,(((...:::$$":Wkkk]]ѣY `ܷoߞ={ !K. 5kۡ<괴4kkkc13f(DF2dFD-,,***f͢Ub]]]\.A FǏN֯_o>@}[VVVBBc:::@G/\PSSYKKKvv6fdd3=<ƍcPe}fff^^?+  PX&PLMMM J,3庹*NNN***(,!DEEԴں ɂ:u*- ՂBN`ܼy&HIIa̝;MMMMvvF@@۱̬ǜ!r rؘ@S%%%庻*gƐXƊ mmmc쒲t\!@?!' lnܸAĦFcc`Z%v̘1Fbl/sZZZA Bű^xXEvNN󕑑OL"iii̐XZ%&33‚Xeʔ)VprrBN 9Y!..bi!Dy g,H$ׯ_Ubiiؠ ===vN,!DSSIɐP4t D"=NEs9!CJ9Y *%UQQq!` Ç]v,p&O|Νb+X[[kkkbG dF.3555ijj3رc nqÕYt"$0 rP(p9bccaaaq1fiqqŋUUUMLL-[~ &N[vK.7nSzy$ ]<OGG'88Y56H$zw\nB,,,mll9ҥ=.x ڢieem۶@Y!0] cCwF\dXp!!ɓl}VTTTUUBΝ;G:;;B~wHTQQ#!rrިQOeggx)S޼ysҥw(K.Ι3aڵÇKr-H҇]?vu֭B*++}}}lݺMMMMMM;w$[ה(3Ј,CN`P'L¢ܜ0''EBDd %hjjN4ի}v@-ѯ]F>ybii)f~~>}Dr=9c~t<==ء;() !FFFה(3(0sLчYf>p߾}mVV]eddBi˗/BiaKÔ#&,33f?0zXTEEEhhI8P]]}>_兜,(_~eɒ%FFFB0??|WWbHG?uttH/e )L!:ŋ:thݺuni|~rЮ]FsuBٳCssǏ?zӧQQQkRqqqnnn$T2Bi")BHrrr7gMv`)l !}G}> 9YPh|AeeǏ?#BȖ-[hܹs'Ox<}}}d"cIIIƍs玫k||쎾kMMwZJ&7mtՎcǎy{{ !nsgMv`~ᇏ=vPt殈k׮ z 7qG O?=z5 }7N8e3fՅDDD5++W^zWz啖fcc\]]~?c #{gMv`/cJKK'M%;/,X>_j֭[{O_%K ZPwx IDATݥԩS6m*//ՈzdVLgg[>a| S?QpѓaѢEN:y$9@q oÌ|z0N.++~:>Q0C] UKbcc }Ã3d8cҊ/^llljbblٲgd䀩0 5Ӌe`96DɎ\999...YYYOnjj:qoF%&&߸qaѢE]Rw {X,&R4{ 2!ܸqMMMO< ۾}͛e?1t?jٽ;wn妦eeeU"8P__… ˗/ɔ}Ƥ-Zɓ{mnnrʋ/(>p%$/z{{kiiiiiyyy]pY$c[ggg/0+9sw|޽SNИ9sٳgn:auuugg|3镥[poF&tWo_e_9ٳ7aP^! ޮB]Bbbb/!\v>| !Ғ>O(- +ݥE 2CdY!FF =^<== !999aNNt9aSS!8d/.gLzMUUUBHBBBgg,(֭[=;wBz-"[nDo>KcccUTT|}}+**TTTbcc&W_}w1-tK>}-YyhooϬg$GzgggB.***|||d1\tIUUuΜ9 k׮%>|X]vݺu^v~'B /|y{!;;M2%--͛K.]??J___Sڟ{ _lOӈ tN'O0#Db"u$CXe>C^AF<>\zĉi/t߳C9e!">DݏWIeLgLzMGGGPKKw)//}@?݊g=nx˫mB1c\Ç%I]] n~}>}XXXHp8״>#r~poF&zWNSSSUUR"TVVr\W__?ɀn EO&|03a!CnH B/=zt {{BwixSSS?wyGOOO,2,z##Zv/ZZZ---"HCCڪxd>ck޿֭ ?qrrb *3!O?蠍utt0g>i=y<Mv?÷~۷oL`teXC3.]͝rssN,--̙L0AI uYQP˗/ڱc͛wXVz~dwݟ+{KKb{`mm}m >ˀ@bx۶m_~%۱ !ʡ BVi7gϞqޞ]Zd #uuuBHKK }eBodQE(g=t2eӧQQQuuC UgDE$ Keֺ oii!xl{=3c /m>0.x޽%Krrr}dlB@GvܥK!Ɔ4_B~o]3;'ĉ <s ^0Nv0a±cÇBRSS&O|)ݻwӹAz{B kjjn޼immM[ix~>_XXdɒ[nI{ײaǣ˹s^z%??ǏK$e˖Ѽɳ.-϶3&ܹs׿zxx͟? (Rmmm---tcFFBueggٮ̋ybbbN>kjjVUU쇲#QUU1^zt{Ν;o8gTw7KLL<{K/}${"""---ܹC `o HHH;wn#kzsrr!/_gY~g%zf+\d?~tt7|v,Jf˖-qqq\z5۱ 8YrW^]h_~a+cǎUUU?~e˘QK=?.kv߰KKo񔗗/X@GGGCCް{ײa礷˱cԬ:_灜=[bccx<.~bxɴ{%gʎݻspvv>u7#{{!-aVUU%h{ .z2$mtχF.Pt]0}W[n500PSSc;a=-Ztԩ'Oo#_<+3<0!9" r0pzv\0fddo& XzuYY!<44p@q!' #r!'HَgxKcP"ү&vvvfff *sqq)//755oiKddRTTXTTlklli&oo[襟}CCC}}]v1پ}M!6mھ}#re1(+V|MMMIII?666]`͛ONNNMM-//pm))))--olB[>ڐѦ_~Ν;.]JgKn|go/..`O@ @a/A Dz+&Mz뭷^|iӦӥƍ?~|}}EMM Uyy Y[[֦!ݣH$3fP(k677kkk777鵵 T]'NLLLrYzwSSӲm۶Utp@Y0e!_曟~~ظq#!T"tvvv !b?~weZ(---o{{^%jʔ)O9tĉ䗓ń{f]&mmmx1oB.\d0aݻw5445k / Fj˸q㊋+b@WOo .2XZZFEE ;v0 .~z[[[}}&m\`'|XRRrgH$~2VKn7._wީlll9 ۗ[G255d.\h"mm۷=z6~555ƍ{֎v/OsI&=<9ɀI oÌ|>4*8YF(q  ʮ`SĜ2Rcij1~ ~~n d`8S#I_%'[QQm6H##g؜|ZZZ(00PSS300HzT[[omMclli&oo[B^}UR^^άFJ]qSWW733;p*z>3AOϛV5ߣǩOe?%'*/:Oɓ'e\go((|hd''="%IGGEMdwlΤOkkk.ۥqM\.UQQ!p8.H?m]gff+'N֎q=y{S)g= b7'7Zp 9Y_Nv谕PX39'۝QUUEn^UUehhHϜ9Sٻqill,))Yr1c\|?kvpׯkjjJ/Ouر_5---B;,A i ucZ[E[[}^E%;ܙ3Ä×̜9g&dr>ܗiInxL&srrrzCܗNKK#Y|yZZ岔9٬/J$GG$Ʌ 233Aqˌ\ʕ+CBBȷw,[RƊD{K̫WJRP>K$R(#FJEYBJxWQ.5WUUM4y͚5W?xONNvvv ݵkD"|%KU----D5deeD"r_-M>|xȑٳNtT*qE-((dRO?L pAb8)Pr;D01Rq'Nu3gF|)J%= 7G%<==|xMMJ`Lpѳ^G=riݘI?#rG@@lea*++۷o3FT?ڵk7nܨ۴i;＃!;;;Kawk=:uTBB¯JHC߀eXX(jyh)kpģ1wD'JrMMM;v6w,3ʭ"7o^x,)ׯ_/:!zZh[E/%rǏٷ!p_-9Ydy3իW777 6̔2 =w7סԳ;b33K>nZxqcc#Q´NivM˳em Ps_#Krϛ7oҥJiݺu,[r_dX&Kwfߙ`i nݺ{)mHHSXXX/`INKMJ~EԸqOc:tP???oooWWW-d* g@=_Gꫯ R2,'kcLQ`0-w KVqaoX55$B P'["V}`^xᅹs;B,=lذ/ܱ9Y`GW&c,W^z@Ȣr|x7* H:}1c|||=zFd xKgvvv8qbEEQھ}{dd$իBa``R$ +++Bl4L}7#zC-y<˃֬Yql- BaJJ :ssssww?qYKX:iS4Ǘ{0 E}/_8s B(...##ܹs.]">}zrrJ9soR[rrJNHH nݚҒer㮮त$$!!!00~ĉ,qi䃦7#JCL[~7o~Wql- ɾZZ]^ZZZVVFeٝĉeSrNg&0)1ql!TQQ]啙?jmmm,8RIR|!!!)))M+JFT*݉BTJVUUd28r.}7#(["ZZZY:NiKWUUGZS*JѨj>OR3!J!9CװiN}p;@Bm+cǎ~`@obd}7,Ӽ11+:)RSS ['e{'y9b { 8gi첬g,qZuM`L2 d/gf^aΚ5K$|󍯯/1r>~7~F"'8)dB?+v2u^'ӖwڃI=duড়iދ]Qrӟ޽k:12Pwc=^giiD"3x[:N9Y'Z&c˲A0͵ѨyD 0'kclyNi3N>-{xx;vLV744WP( ,;w󵛮h4-nnnD!>YYajG[:NiKǂ;rr,u IDATE>O,}y<^WWW4)gS5L``N4(_b1F#;;{ѢE}70'koQVV*//_`Cqqq5&s&9Yc7,ELLݻw;::띜vLVSSSw^jUSSSii;w\vm߾}ׯ_}6qNNN{{{NNΌ3͛7D"qF#[b; eK pYO_ܰaC[[֭[ٷ1b[[[7l@y;>>>/_'zr$W>r<3 Qشrs 25a 4vL) ;;;e2X,a hM)m_GEEQɲ e>>gdd򠠠011111Q XbŊ<O"\p!33(ٸq?п+WV\m{8n86H-)ǂ̫WJRP>DD/B1bCȈ$ SSGg&Lidb SRRݻWTT㪪*:3dʂxz=i(L!I5e„ EEEB./@Ĩ>}:<<%$lmmm=xKBlJIlC@cLs}dpjؗ nu%Ak=cQP.岌!${즞#ocH)%YF 44oeS;&{PO]Co&<<ͰL0uT[ ,|d:裊}),%Ak؆Ja-eN0իdyl wjC!#""(4du iƌġE؀;ӌ2=RS,OOæg(睵\v++K$JNNvvv N۵kD"ćCxDGgAAL&J~)bkCV/YD*0`ӦM,}-//;NR9i$gg?g سDvOC}CǏbbU>1),,D%L!у"ή5kx7LtG2=R-Y=.3Y>CrYNVW_ű28#SH<:dmi4f aƻL|3q$55СC7^SSc@<4qƱevEllѣG9B|}\@2jcL. agp\QRUXkojjڱcGppcWPP` ,fdSs 씔bI]f+ene˖J$k?X  ӗIR\~>ȔZqx3Ԗ.x,0$}ljNKT=\ m۶ʕ+yyy>bYnQӰdp3Ԗ.x,0$},eNvСb=Accٳ'NXQQAn6nܨP(D"QVVbXR(h4 <޽{!RvwG999=z(  )))O3fO~~_Sssssww?qKCQƉ{8׮]ccDòߩ߿?==].򴴴{Zt%0w~̙{DarrJIHH^;￿|+W߼QBBBBΟ??r/222)$XӧO߾}{``'|o^x!xTr˸>`…C\bRZZZVVvС_~!(a։=ϟqN:!#]II?q/ܽ{!`sXZ{.:4qر3fh4Ǐh4uuuRTŠ lC=ٳgΜ9&88ԩS\XhڜWUUi4RIn啙?ju2mUTFV|]Ɖ{8ܔJFҵ L adlgg3F3ugϞQBmk}14o$:Y~}llvuob| d' QQQie 8pce@os`5v+<㝔ĭM7Kޥ !@@l񺻻ݱc)?۷njT*{ :O:믿>{$Qxڵ7nmڴwao]B(c։=ݹ'!z0`@EE BaРAc_E-f>y{p*jȑoߖBqyA׳f+:a񗕕/]]]2rj^|o6333,,ܱV&))ٳv킟Ӽi4^/==}رĄ,B_utt4`Ӟbx/rLx<q%… sss_zRɓ'rӧǏG9sW^uNjGG?}K a77OzxxR/h4d2=a|}}`Э[Fe  Y`X ⥗^ڷo{gX!4dȐqƙ;ʈbH$2w XJ/PxxL.&^jUSSSii дiv|||._L.j/ ڶnJܽ{IN.ɬF 6o6N,1cFNNN{{{vvvD"ܸq}L[k֬^vm\\aP.G؜ؤq:)c!=!Ӡ^Z(K ؐ[x<˗Yi_uTTv*Zfw(dJϙe' =!zWO<ɲ/󴲲2((1((8tDkdAs3fPs555r<((($$e_B!!!ǘ^I65h r̫WJRPHn+ݫkIII bĈ[bŽ6N^GVVŋ%I3tB+W %/9ro@@E R-}A\\\FFFsss.]DIBHt@u8s OZH6-dc kkkڴˉ<}jkk-ORfΜoĴ|yW_}uLFs1k6emm-rsqL|9 ]mmL&#uxfd7ti9s映;v˘Z,k`Twh/(,,9sD"پ};ӧO *J׶tSЫW_zuڴiRBĿ$be("# bGLV[[K:ujԨQٙr%$-B!ogg'b72κi-!jjj<<qd:#P^> a^6Aƶ;B=>>~ԩWfi{+**N0uTVbl<>yq8vˉ'ull, Ӽisj4 .888h`^Wnnn.**"S[X&k`؜,9$ӵN:?c!{NNΌ3lH,[o(((]Xe=(YabLJN2#""(W9?OCCC7oʲ}c񔔔{=~gi1q 3ujzƉej S.GαuVqYmV(1A.GO9ǎH LL0]E5SJ>Yc70' s,aׯ_?w\Te t;/rjj0$0p4MaaYD"Q^^#vvv![%Dvb[gVCb[{F"w1HoחOlʟGdO}?… [[[Q{cƌuxjw{qڸ=<ewF=8v{Ȳd1]ؗ )}מ7`ڈe˖J$QR! R%K #r[3cј;"}CRT.8p࣏>2e6vXZ<cy-]TT655Qbzĥujƈeiiev9r/"OqYmV(@A68 9Y`&Jm?_r%//!h"RFKHٱ`rPEE{b@a iwKY`w̕N |J+Kfdd򠠠W\>:tP???oooWWW222"##/Q`iKϐ(gee]xQ"8::o=Nlsrr CL{0/RT4JP1,Ⴅڸ=7nzHm,#lScY_2eJ`ĥ xB6l u;???{{AܹΆh'' &%*++9Xlkvv6QPGGЇτQnnT*dA?=Έ\FpEΝ h4B(?~Yڝ'|/_8s qqqΝtK**:::!!(LLL mkkc3%%޽{EEE?&R"ORfΜIn ;礤ZbI&RiiiYY4,I'֭[[ZZrrrlBKR{{Çgdd+7_~A/߿v {7_p?gd-ȶ#ϟōx]f!(70"m^^^?ZfsT*5 1mkksvv5$,ww*FCQRi4Z͞!J!Ktׯ IIIwuuݽ{7,,h(:ugψPg͚dɒڷ~i'K7([eee p3ޅd2`9q9ƾd!z=0X^l`RSSN`>Yc7OV<=={/(,,9sD"پ};˖O>U(|>_,T*PR#YTWWsooo׮] X3د1)Ļ_B˖-3^Tܗ>d!PyOmݺu˖-(6Q8cƌl͛tRRDdBd2Z%$.6lhkkۺu+!`\⤸sεkw۷oʝ;w:;;}X믿f͚k!-ZTUUvxp̂iz1'K,O?aO8755!gϞW^JBBgFFFdd$Y=D@bŊ+V3gΌ &M"f/^?rH__߀E!Ǝ/J3yd̂iz1'+ ̒L鷌 ww߹ !!!ϟG}嗑 'NLLLd{.hڐ6ɜ6g5pԄ (\>yq??p`zW&h†T*2o(VO>A[:5{lО={Ar@@>>---D r0#2dȺu{=OlePHHe:lߍ7r l)\X,锹4Oɜ Z'|ͼyzgm،_Ȍz;!q;w* 4iҵk._|xMM1qƱߍ mQcw,uBYoloT .junn9sy^2炂]Yߜ,EBY>mBJX {ٲe$!!hTTFDDBTd,{kli9YI ̝;܁9(7' k۶m?cIIIqq+WB-Q*|iwcM쀤-_!|4* wsd---%%%ƈ `i,eN6%%޽{EEE?~￿|rEEř3gocs]t%}.SIIIjZ%ݏ k֭---999[l!˥R322;tJJJGǍ/ 2dXݜ, c,eNvϞ=[n0`eU\B!ϝ;g}ڵkU*Urrrkk+SC&;k֬ٸq#BhӦMk֬ѿB@ xeee:shTV,}g...&jHMM,Jk-}7,eNֳ xjԦ5k|`:o]g) 晓_P|3gΔH$۷oq{.ijjj<<<B2L\,# fNϛ7… =z߾}9B_~---~_~8p=,?!k. 􂳳GGGg"="doܸa0^|5H^,kDK 8%%ի-PT۶m^*M:wc0A.hc6<{W֭[lR__OYS R2J!rN?x4lpcǎ%''ӣI*>y!S-|>A:GS͝;7==)__ߟ~(u֨QB'Olmm djxG.,>in߾e;R9zhsGѳ={̙3G.Nk;`7SoBK/۷|`vy.]T*֭[>>>/_R3-cbb޽Q__D"ߴ[_|qÆ mmm[nerĈommݰa!lOqΝk׮۷o& _y;wtvv_}͚5k׮C-Zɓ,hb/E=z^bxȐ! X.yqgϞX`.hPWWWmmmpp0:w\\\*6O0Ref <<8Og <``c2ALRIRsGb}* u!v_p;Y1/^lQLL Bȑ#څW//̟YVh4uuu7\^<==>>uS{&z7B ,ЮޞKǎ1cF ?~8KH: 2 i>Ü-[1+++::ܱX`N>6m;;w!4i$cD@?L2QXX8k,///HG|Bm,ˋ>>u]g8Dۺݳg4 <~7|>>'8qC/hjyILɓ^}!-~Bʼn=vㄧ6Qz)N_WWRÜlbv>x4ߤR\.?pqɘl@ѐM^]σ4_2h ?6gKK K-ܰ<i`['$.9~#΅ 644P=#6G:Dc`cƌuVP}f`jjjȑg͛/^,,,dڽ _/]ǎۿ]Cw d3V^\TTD$m&c4dGBPx?pR:D¦^jUSSSii璝%7,4,cg̘ޞm8e2ZNMMe˖J$QR! R%Kt]e=o i:;; ey\-0$} % drF65'˝R=z7m?_r%//!h"RFX!if,1$} Z% drF2'/bqNNQ8{lgg'VTTx7* HuOFؐ=z#)3Quuu``P(LIIю3//ĉdvXB:}1c|||Y$fWoɲr\.OKKۻw/Bٳ H$7o>|0ؑG;-=zN 2'r޽ǏWUU**:::!!A{gΜA6o i*j̙o&K,sLJJ U奥eeeIII,cCŠhnn>wܥKXܺukvvvKKKNNΖ-[rTjoo?| bEq/6z}#Orܱo d=GfY*le^^^/^vC.߼yOS}}aȔ<ӓ^bC"K$VݙgjãH.WWWrb{RbqGGP(FK7{ｈÇ;88GJd^~vgJJJ-[6zl>iggt%hBvuu%''ܹiu:Xܷp,Z vvvmmm@}/^2a„ׯ)< a4k2jcL< /U*C9ÆtԩQF gg綶6YrPkjj<<<B2L\,# #/(,,9sD"پ};ͻpkF)G޷oׯ_KK B~hjjׯB(//Ç=zs=Gt ;w@OrR}޽ ia晓/8-?liiyFXĆpֆ{6TӧOٷ{H=pcǎ%''6wtHOD[F8ydkkkUUG`` S+ؑgÝLߟH?<*t3o޼Kر_~6lBѫVZ~JZv={+H$7nܘ0aBjoodj:55u_ܰaCzz֭[ٷ1b_y 6D|_WϘuwrrbiΝ;׮]s玟۷ǎzWVZT*/_z׬YsڵkB-ZnX,>{l||ѣGŽ< ݰg_Ǐ\ƍw7o/1FlHJJ"2;`4ĥ ZdT:`M6---Db+D5ؐv%Hb11U:S,kS*&Mrvv9\ʎ d2T*OC">[|'SLao;ǝ-(&P kbM6!yG Xӑ#Gz 8nRr|&uuuÇNk* z ڵK}ǏX>3wѣgΜiooG 8pٳf͒H$ 2dK`ELd-W|||jjjnnnaacl* 9{_x .oSS}cc1,A]]믿"fϞ#((ܡ4|7O/T*裏L.Ɗ2Y^B1BVC/M,/[޽{gΜ>tPpp'|d>Ytpttt8;;ٵ :T۷o~mcXO?>S*!y~~~ з}Vӳ7!tMCX.//>/Bsssnn1c:a`NYdY.\{BXfMYYð9Y^V.#5`/{Z6lT5j\YY7v'O2d֬YO6wK.HFc5&-[*HFJeDDP(JK,y왡b00 3'ۯ_#Gvttܽ{װQ֥_~NQQ˗_{5@PPP0s?ϛ6mRTz d-F Qm۶ʕ+yyyE(466fgg5j ߜ, vv IDAT6eʔ|ׯ;:Йfff? !8{lgg'VTT <޽{!R:ՁB0%%幹8q,$ޒ>}z̘1>>>,[FFF۷odrr\.ݻ!tH$͛7>|iwzjPH$$7nܨP(D"QVVbXaСaÆQ*7>ł9Yݓ~'OZ&Lj+˚߽{w}JNNPT 6!!!ϟG}嗑\kkk) eff&%%N޵zqqqΝt˖[nniiٲe Y.JAHPRRO<:nܸ_~&.߿VWWWmmmpp0˗+**Μ9ԻpӧOk?灣>2Ȝ7 `#|~DDĩS|>mݓ&M"6xӧ;vܡi>f7Kũy_'Yb>L twwx<"bee?1c(J{{{@ xڑb^v-33ƍuuu6mzwX߇ v#F}ȑ# PQQA܋0hР'O?wkRR҇~Sl+<ٳgDXC/oll.--U(GOo`@)!fVxxLYLVd鹺.]_~9{,ޑ#G^x??m۶[,hN!4dȐuֽ{ğ555r<((($$,$$),,Mdff^zU* B9\"ߗB'rʐdaLLLllH$JKKۻw/KC`Ŋ+V gΜ+ 'ME /^ȑ-B;_*feeٳg,mxx"zʔ)?̙hŖדՇZ͝3gNkojjڱcGpp?pu>YP zv%K 0_믿P(VZUZZj}:99 sT*8G0h!e s w˖-~?:t/ߒIجrS* rvvh4 .ܹsիW?䓣GjСCy7|ܡ.bٳg彫O|Fw+V~7]ft' 5z.]t^:`Pcco%1w_{5PhX7|5 tvvv/_o\R&ݺu뭷|߿o6֓Kg(|G^r!M;(PeE"xK4mb HKVJb7MMV#BFhbT1ZI#&iX Z䣩Si!6 X]@,|:qaYvgsۜ3sxfv/LTwȈ{V2aMӁ5Ypf1Ν+..޻wo{{;B(:: 6Ю & 5Y8K@?i{vɺƻ.nӹِUoܸ=(|[d}||RȶwbZǎ{(jl1|ddXիW|>,,lBޟXG:YXd(| ,p,8C\\ܜ9s>Áv[5YޣǕ<|||ii)=*j lGܷM&SBBBPPкu򒒒NwajPPPBBl~!%%%000%%~6~e>>>W>}ڵk7oׄ0dx{6x455p֯_}Q0nƸ-%". SRSO9rW#G^t !tҥ{ O0}t6ph0w)u7oy'N:yyyV5---;; 1rrr-Kgg'W^__Ղ\W===%99mcYٳg?ƧO>sLCCç~Jiqm۶=S{ s…z*p=܄bQDqg%E&M:w mee`섄ɓ's0W OSPPP]]mYСClҝHDDlfd2!*jen+ ۸lt*۸!ގQ*Bx_%L&0{H_). y%`m}QVV6k,a áCPѰyj %}vDQ89gvw,dVUU͞=;<<ƍ_P(jjuԖjt!EV#{{{pGVkXS**W*2((uXଟ60%` Lsssdd$Hoϰtl6 ogϞmii9{̙3Yml臹XY}&ČVVVj9..KL۷vu:]SS#[v+ĖEFFV*bKߥ+an^'J۳Cd>( <]&̞p- 0AG >ILLNJJb%lu %}vDPtp^+oF3 {d.\x@,LKK[f͍7333ÿkYfm߾^۷o5ktuuiZݞO+%1pLjjjyyy<཮/,,ܱcѣQXXDEgΜo0bۗJy,B`0ܹ},BHuuum۶MS:aBu_ cǎU*&L8~8gffƖroٲ%88d:uJ¿8/KSTSLaݹgϞpZ)-n8bՠpGltfΦM|||(ᔗkZF;GѾ}BBBX!%ޞa"]rKDBUUU8m4??iӦFVp3| ނ OΨE4\(0]tCoɱꞡ`KZOyÆ xF6XVy)a?ڋXB~Et:BSO>}o#sʕZחwȑ#?:caӧOL83IÃ>裏6}B6/^\xСCxVia>Ñ#Gw}>ЧLHH 6 [y])߷o=zڵK- X 0]C6d5!|x`6VZֶe˖x`dI&!˻L&޽{&<Ba~"222M CnZR ƞs@+Oظlٲ#mIM '(}>݂?>}:,,,$$ѣts <N4Y \O8gQ8KHmmŋu:ZMRH\*7BN61\%3-eMV< ARRBhÆ 6aVgnO@ifgRy>na? =|Axi=0rpϢp<ֽ{"8b/_%b>|؞۷^[oŽ561fΜn~< ?BJEi(gOP(?dbdYIܝkSlذaѢE\ q7N1o޼|آ {<{JX#Lk׮>b?5jԹsnݺe4?}`fЖ-[Xy 9rٳg/_IC7{4?*qm$""!7tt?~ܸqܭϔL(΀GؚlO!RRR},$NNa.@0-VOUdžW EpWAwr@N"t?O1cư?6%xYQF3 #7]ra-_| 0 1E;wt3\N5 & )<[.]RǏYApXÆPzر & >|Xښ8i$xHؠ1Cuuuz> @Q]JMM-..f$555fJ5uT!))?))[X*SzDCb ["t:]VVVRRҫ*7^O&s@qqFjpN:] w0 .`Mw`TUU͟??&&&887V( !)4OB4tqg\E]|kavW(#%L! -_b0d6)<Lj!]"*di3ĈJuȐ!6-$$ suHs[5\d@i(`@]8yrI фJZ?uuu}b"##v{kk+=b.-[,==4BBa}I4$p勅7 }DCNKk"ZX'+APv5aJcǧGhOQu޴y;zh'0Lbbbvv6ebgNǶ5YR`Ma>݉WS… /^iiik֬qF}}}ff&}xx_*C]]]Znӻ]p??/<А$$ Z^^ާ^C"sǎtӣG޻woGGGaa!oqlǟ9sFKR!m߾}}:k;....88x˖-!ɔnݺ>%[GwmmmO|K$믯^!z_Q~GՋaa4uMv`qmZ| \s0yqqqs஦b$''bc=gZgϞVkfddl޼͛'N8uꔘpܹ򊊊?222;;;!!e999\N>}̙O?!lX:;;鞳7ܻGwyyyV5---;;I s]rd2W.4t #'D<ɱc&L7|ݻwcakkkZZZ``IF#b{fzȑXmaaalllPPPAAא0ަaL&FTi~z fԩSU*kƶ'?ubFjEvօu&DI6ڵkCQz)I0 +b$$DSz|}!d61:SR111ܓPxɓ'777+ O3 h!ɤj444pFDD-FpС l6Fgw}Єjen+ Vn>R<իWBFqٲe}ȇLӴo~3qĶ6FU"ݖDWZVTTĚ^68mh\p!BhѢE89;}:Yb]47MD '4 ^Q?3>3_s$ybTnnnBBba.\C jyKu}&DI6yJ'Mt9)Y"RDu:BHZ,,JJbGfϞo kkk?##G;vl!͆ t:u ::j-eqqq BV\ 1MMM#Fj5B߿KbbccB111{q0 `PQZZ;v,$$\:y? <\5])M$ĺ*'Kf͚0`8t]'T!Q  $''WTT,j)NK;:RBZt^3y:.u5zu!bB ȁ'j)BMMM 455c&22n 5TVVjpɒ%C7o^tttJJ FDD`C:Y*NǶ1H_⺺/FLLLmm-.Y,px22MgÇ׳BⅫ|7,y~(p߾}G"y,LOOW:;;/^uRFFv zK SpĈ'Od\2++ʕ+}v瑛;gֶn:aG31dwODVp/\a! )wpRP( MwbNRd!sK(I۷oi:111;;;))tfMaQFxgtIL',X-ju,’4d]&+< q׮]Rt]"$'kk}O!bBg YSTSLaOVwj8pرcJ ?Nl^F܌Fqڴi~~~ӦMdrebwۇ_333cccKKK):+Vh4Э[ ;h(ܶ&KlSWW7iҤgϲBoX%'k>م ^x%00 ֬YsƍLnOaΝ;4:a̙wNKK뷆3gΰ_Zng?xaaagg']SIMM|QK{4M;4;uwa%,=8Ƈ5dGTVΟ?{lQF5772??fnJ"ҝwyM8^, b>Jяo!BX>ގLӴպ'Qdzʻ ^\\`7ʺqd)ׯ_9 :<%" ,^)Mq RP.` }t7hރD;@=%p-a@ O]oyw= H)g'ywCBB"~ŸKn08 x:P''n ǻv 7dӀ:Y}T}P31bl6KYful2шjhhxg@.\{)EK.ڥ?$^zA88޺&N۫V  f9555((HѬXW&\sgϞ- :oZwڵ}vN7#Gnc`g 'yWf3))))))?VVV>񥥥b1c\tyڵӧL>5~edJHH Zn[neeeiZZ͞ӈ|||JJJ"""t:ÇY!.Rr[[O DEEV3 3enX,ɹXcYٳg+##c7oy~(p߾}G"y,LOOW:;;/^uRFFv _|nn9sL&S[[ۺu(˕D#70 rʬ+Wddd8j&1"⎓h!4-T˽{/x1̽e[::?k~Wʵ4)&DX$F$@:!="KO2BH&;BHVC7pZ[[ bBBBZ[[Nt\+[ %T!۷4lٲLׯ2a)S:u ?3>Y.;w.ݖ%IGt5VaM0Ą˲x%~$pы?c7 "Z~P^^J2e [2gϞpZcVÁƎT*'LpqfEDDj4f,4ӦM6m`s رcfl6'&&[ lll8|aþ 9K¨Ǎ{vNJ%&^UTT|rNgLbXrd={`@{5Y#C'N-)WK\^5?r-MxEt^,u#igyfժUyyytaRw1)bwCD'-??? `ƍġB8d!rK(C[l {n0pR{3fRz饗:::]rehhhXXXVV[oRY(]W^^j5;n%.=L-t'M˲, Z1Ϙ.Z-wd={sΜ9@>QKD@DiZZ#C'N-)WK\9嚟wN&F":/:lƻcӦM݉a;Ɉ;?UpƟ*PUU+q88prvÚAeRVL߿̙3׭[7cƌvϢR{p5g<iklFjnnhGӨ{faXt}XX -E(4 i=`/jg,ٵkW_}USSsҥ%%%˗Ǜ>d$..nΜ9~VO%nxi]8P~=$ G BXhr)ݹJkjj1Lnk֬QTSN5LekkkZZZ``Id$bk"ɍR}=v؄ {nK ÔaLrIĉ `by uwwZ*""",,yaaalllPPPAA=LĖ!NꫯC7 IDAT:SQQa0(}wN}.Dnoݜ~rI'6ŋhEPyȻF04"Y؅:\^ZPP+;Wό3>3_scyOObINNfuEFFZִlf^-LnnnBBbHFF͛o޼yĉSNQZر}o&+h4~~~Fڼysoo/B桇['N7ߠ&._,fh~s\b2N>}̙O?ԡ0Znܸq۶mO=޽{]!4iҤsKu>8 O@i`,t.x PYYi0N#1<87%]I6x*\o߾͕5ų>m0LSSV¸.)jZbOBu^vMOa|||zzz+++j5ݫe˖gff^~}Ȑ! L2ԩSXgrٿܹsŬ bXKW~(|'77377wҥXrʬ+WdddP\zgVZёG_7nݻqaOaF0O> v(Q?~ܸqn;vs0==O>s=0̎;On6fsbb[oSqaÆ}brss̙c2֭['"zD$JWHlt;vM;$qt?=v_P(:P( /B rp/"l"ѣGǍP(AqVUU͟??&&&88DnHl-I(KĈT*t'Y BH:huȐ!6-$$D8LڔJ&s0aÆEQtz8-#wFe= f6d5t'۠O%[l ܿPPPGGWO^^J2e [7ޞZs}OMwZVѼ;<%B?ٷo_HH+Ѳjժ-[9 <OX^Mj7Lߋ' ѝ`={j;x]NtXhOt^,u#2ӦM6mh3KR>O ֒&+|BN.yBUUU [#piZرc&L>|ݻ5---00pҤI/<4H׉0 s=TWW3 S]]=rHG^jUDDDXXXQQ;Pcc)bFj)#fN:&);tDCbgF'BCOcOcdcbb %Cmlldf&Ot"xkCeeefb`0:tDDCfeĖ!v3WETT$S,e0(nzwJBqfpqbBɓ''OܬP(l6OѣƍS(!JL2)։B`X'K7&]#&Px֭bR?aD&vg$IGR-:ѐذBd#}ôxNu2\8gQ8K@qÚ,WHl\YYV縸.1oߖDXC݅JN4CYYIlI_&22n6I }Mg2x%thM'?$+\dСC͛ĽI8l""":YJB?GDDCbYrrOh<XE/ۿ!!!¯D秧StOpS,Ypŋ[ZZ0--m͚57nܨ]S`عs``%utҕ+W7nkDCfھ}{WWWQQQ].VkyϜ9~%&% QLMM-//wi۷Ϛ5 K !NΝ;ollQE"{û"^_TTյm6^O 郖2lo߾TPM)0a Kjz??&iΜ9**<<׿5r;?lذ/VbjLr6 B[4; ܯ;vR0aDZ=33388866~˖-toITUUUb%ubWXhBCCnJN4d2NR֮]v!D偼={j;x Ibcg2xwD=STSLa߂JL1vfEDDj4f,$Mac4M7m4H GDDCbFYʕ+j w),Ç5Uϸ~:ܹ}Bh/¼ybccxެggguG}kun߾Rr6\;dٲe6m3֭۳gkgQ~˧igϯٿ<6a޼y'NW]Ө[gaY}&xcǎM0owִI&q%T%%%D)SqDBB0AAA---XhX~a1CݫV +**XXXTPP ;byBb07u"5V-//d)φ$$ǧHN4TWWz}]]]a4.\ZhOn`"4 3EXpru,)ؼy͛7O8q),ˋZiiil*nر}o&+h4~~~Fڼysoo/B桇['N7ߠue1Cׯoϝ;wqӧO9sO?u$0 :̅ `):^ZPPK1dɫ#2y䜜J)}(eIh˳Zg~gJ$%(xG@{.9v{w_WF¨Æ kii{źԩ 6p彽555V?~|QQBu떯O:ӓiӦݻwĜ>>VUVwww\aZ:tlG,vɃh䮮11<@։+2M0;@w{M?a|6m֭/BJo}5{ˣGnvرcm6[hhhCC~zkk[ZZ]sϝ8q",,,77wӦMׯ_'ZQ*v]P':5YJt:]uuNt~{SZ|ooo@@^%NHN4TQQWpK Pdd#G:::L&SdddBB+W ^qs!<=׿\eͱKSx?Oxx8;q|9g?o*=v<x߈ώ_BagϞ~uȐjݵk):"{Q )]pŋ[ZZ0--m͚57nܨ:/\?/ϟ?/p­[^ /,Z!O]iݺu˗L#GdeeQ^tҕ+W7nH3g!x:)KMM-//w]7.=Lޝ$O^_TTյm6^OK)CQzZnϧt@ fy,X **ʵjXlhD544^nոX6w q&]m2#phqoܸѵ:Š8?x?#'D<ɁƎT*'Lpq,loo ---߲eKpp0s{ ,ܳgϘ1cJeTTK/0Looʕ+CCC²n߾0[oRY+Vh4Э[Ȳo>N^餤bhZDщD*$v9u$i4M7m4H8>1R":О={j;>9sLbb3Ec&L7|ݻwcakkkZZZ``IEN0666((a{a#G:ڝHwwU"""Š(݉NR֮].bFj)#fN:&);tDCbgF'BC#$S~GRVv;%!Ž8/21!؅իWC͘1ٛDf999YYYO?4%L>r 6A"X) 7-EPTT|r#v95فmgyի!Ѹl2;wV?5Ylj` k111v:aͦh(݉8![*++5k0СCv'w DCfaf!dZ?ȳEtpggJ$&Bd)ATvwwӻS"숓l6u:o+7!؅“'ONr6M@;dyx}Eس#OƸt[EnnnBBb)}#zzz,Krr2kҽ?v~џtph#8:'Mt9P;q,]":O^Ok-k'Y/RhhZ^z5~ad3gJ B$ -o2, IDAT@(QJZ?uuuC] RtILLNJJb%uS[[+;~)sge%%W!O91u6eeevLJx>&$e0f:) vInjjbO) aDb ,Y2tyEGG`!qo!;NO):c㣨ƏeCMlB̅ }I [ V'V֟O}& 4H_*> f@I,(hEJ]MB c>䲗$={93e.fxô3WͫX?6uނw+~͇{]{LL|^fSoS[i_B ŅONN.--Uo][b][کkݍⶤb*yӕ2g$~;ۍ]lذa„ eeeeee)))$I{4E_ӕ!'__Ov8;w /^uՒs7L|zjSq^xgIs=]zuٲe*+v4wܜF_wUj|W:: ^֐!C=|8*Nu1(]+9Yysrr̙#*N o.8x7ސ צbann`7n QbaUUUttt[[[TTTEE\6#Tl,?~xۙy6G+vmr &h >:Lk9:;qJG*^/%#8^ѽW(閱q~Kq;OֳMޝu<](]믿w?q*-ήͮr.O|Ii[R I1헲u죃b/d:&ϿV\|…$I/ 'ekh|Ɇ~3Nvzuuu#F׿ld2 6lժU_zuu$ItPeeu]#W"ٸqW^INNz2@JzZ}OQ>k+Vp42e(,W#W9rӦM2U6uGY^X[fnnz](]ƿ;RbZvmEsٰazGxnK!)r)g0dv.(t{K/^?ѣGludXX|!$I׮]t׮]օ^oii SS%xű~'Oz饗~ӟ _װa >K.1jVU|۶m )HNN>~eFFƙ3gU::}uO>> |ӧO\pg?Yff⡇z˗-[6w\!ĢE8㭣9s,^fjSfWhoPۧOV>po;Qۂ ,j.\Yt=lݺ5pC# Ɛ/=DEE7yٯ/{nKA屣ToU~%/-9;v숈hhhpm8*r7sw1o޼-[|!!!qqqO<<mmm/0` ꫱a„ iώ0ߜX=kvF38SOiw!ke6ۧ3|JSSĉz-®oO>իW׬Y3{.6,dxG/h$Il9F PPPpYYxѱcVTT^$)::ZL}/ v%'Ŏ'Dw-T_qCx? eo߿q*Ӝ,. 9Yt'!}|]###o6߄>Ս{;66pfUG[ Olmmu&<8rH^18qb֬Y 7nVb2^{z+""˒$ّzHzխuqg*Բv# b)^ϓNƧGQ/]Cxú"M|cv?EwW|山.]5j˗ z瞦-{=v[C=7ɓ#G_!Dllӧcccm6 7ܠRbbѣGZh6Ϟ=+/~mq S}ؑtk׮?wBwŎ-ct*..~:8ϧtiӦ%MMMfp9edd9s:<<\pƌ>ŋۛ !M&w~zx̙xbV[[˅ׯojjZn]jjjF(bGcL'Oػ"Q۷o>}[/2Zt;rt:YsщL&ǂh̙NNNvV̌U ӣӣ>p͚5G5Laaa :tԨQ ׮]^}Qaaa')]OO2E}u(HqutHii̙Ӊe;i;wA7еx_'S+B{ yyyw͠ r=ewwGb_0s1cƨ 29Ԝl!7rڵ-[.,,t6 zhΧUtW0튏?tзvkjn1>rC{F@;rf Qz'+8K^y啿/_|GmܸQhѢd_^zfӒ쐷zlbBz X,!j]paJ!u%sСѣG&''o޼Y.z}g0ƎkZ jM،3믿>c ۶m[jU\\\\\&k^jՀL&Ӻu\;Nmm r9!fnnn֔<:I\Gb3gtȭMNq蘘tҒe6FcQQz:nڵIIIk֬Y-#xI&Mdٜ{Β▬} !<;:|ZZZxxxZZ]'m󳳳&yT$z`9OvܹW;rȱcX>{%Kȅ_Aڰa닊^~egyTTToիW !;C~w̘1߅G6o??u]-)SB3f ֚0T]vi`U,--pBAAANNJG˗/?wܩSJJJ>8~j} S&-I8%KTWW;vҥʞ%kbM:577n6ɞc@yэp+IHH(((8{p4ŋ$UUUEEE,͊+L|r3gΤ=$ׯM'zIf͚TVV>r߿?99T=x$M<PeBBBBvI%I/ .ZGVSqDQQQ6M2\sd8(: keI? eƀ j?8g|)'I\PPpɪ^z?"$$D~ڵk:ڵkmj_װa >K.1jVU>f՗.]zG92p+W^rF#YWW󓗗B]loc^ݲޡn1k֬;6Q ^}\Fesp `Ǎw^ŲgϞ\r|||}}|gM?VR|W͎9o\׿[nB8p,666%%EO?ѣ'Np(o4WXqN'Tz=kwWRRVu}B(d2˗/L&dvػ~xժU 555Z;~3:?^˗/ܽ +wmb6ݲڝksÆ /ruuuWՈ] SO6##̙3rٳyy7L'OTo֭[?>L.|O>r…gBz+/////_lܹs-*++kll~M>}߾}9s/^ljkk0H(_qDׯojjZn]jjJ[L0{Wd6G^^z*Țpcپo:6{؁N{EaZ]ot=lݺ5p;tbn%;w1bDHHȨQ>,ϛ7/22211qͮ׬Yw-/y[.ܲe7O444Hֶx 80++ڵk$꫱a„ ΐ PwܹsՃ߱cGDDoֶo.{AwI*++fsYYJ͞?5`^zIwoMiY-t˄-8"2~?bx.[qK>L;ڲed26lо\?~|„ +#|ASw5jTi&fw]w m&&&FDDHt7={Vg:+jnn~'~z;xwi0{9ؽke6ۧ2u3_~׮oiYqW:#Z'N 8qʳ#YjjFmq?]f_Tֻ[Mm^3 ;ӹɮͮk[, !Dff۝񋋋;Dq[g]G]i=ȶmfΜVX6ܔ)S@GM|)ؾ[l>pꫯ͛'EV^%)1cFiin뮻$IZhѺu$Iz饗~utqE?VkuuҥKUW?SO=АŚBM69ݩs+:tÇ Td*>̋gަN|K644dee=C*9uҥv"?}O>dCCO?ަb/ wo5=y!y?Sh]][}׶X,k9+WĨwHq[R IM;2d{'[@O 9لg:gA.^(IRUUUTT:ԦW={M&Iw߽wގ.(>>/,\\h&IRYYsk !v$IcR @1FRSqUhLxmV:٬ґ,$$-%N_=&&F>/fŜ6/בfL&6= .!,˂ \imm߿(nK!)c^lw !~{[UTϗK2s̼Л&'ϧߞ'f͚qF^<ڵvP \UUU]w]MMMGW[[[==W_~[[[(J P <8rH^$Piu#,6uG:uZϓUwtn)T,Ծ޽EṎɮͮrP|X.7o^dddbb͛]Y&22R=ԉ''NpthqO0`K/bGeeeV)&6u{֖-[L&hS{o߾s*N g6x א<{:#X,Ǐ߿]a-J9TYocwkf[ʕ+կvW]suz{k0ƍ~ WvmٵڞJJJF|Yy-y 3xu) . _S U-/iӦ#F\rE.T|… _yI~_=AKH ?^Qc-by{ xZ/YXSe ag_)hŊn=nw{,^Sqv~a^?w3E>]$n戈ܿ?~ر$0..O? VQQ!x;|{~С*X3!!ѣÆ sm-::ٳ lv˗MHbbc=6}n)448(>MMM&Yj;+,X`ʕIIIeٲe[lqf0;bM8 |)ʧ47YYYyyyډ'p:w29J7K`:h4>#/0$$D!Iҵkt:ݵkׄ/^?ѣGlw($텊+ q8Χz}KKݰ09ۨ8!qAAɓ'^z饟qj]%Klkk.^+**nVQ} G/]aH~ӗ VZ_bذa?T׻{nKA?vesp_O?ѣdmmmrbYh4WXqN''+UzWWRRVh2\"|dRY|ܸq{X,{u{]WwE?U0KO>oײxn<tDg}ԩSLȊX!M_;@ODN]5dȐ;v?z\IwuצMfϞݽ=X9n(>JXxUyIڟf2vl_ĜN{L~zꊊI&M2Ymʔ)iiiիg̘,ֻC5*11qrڵk?믿>*,,TY<###333222??v}駟2e|*h̙NNNVsIJB/~7v~@3g3Fl\~?Yz12< HKK{GΝX,A( B8Kt!} Ey?' }'Aܹs֭[z@'8O $'' !JJJ!' D9Y BNr@t:_w@ٿ~s/A`0677:>AN pw#' \9YBNr@FN z@EN'$ɇ}.5ѿ^p>Dd7?rnf]p!111б}rO p#' t9YCNr@/FN 9:ݏ,@2d((z_~yu ><б𪠠 ---Q!>mO?4QPS[[~ @zrN3t9Ynj(aFcC=!' CN,9Yr?dt:nl6|:(τ~@N'$ $:q,^%%%<@lllHHȠA~[MMMO|…s111 Nzg͚Z5ծL5ʜKRhPоHt46䩐-v'|"x|s+Auw8p`0FMPҥKm6˗~i!DNNzիW'ZZZΟ?_}+WfgggVu֭&M8h!_|n͎Ʀ<O=ԥK˟z) W_mll<}O~otn=9Y}ٷ~{ȑa…=Ў;]j…SLIHH())yƍnj3k֬E&N?[oMMM5 ƍj*Zbh[UuclM>}֭.\HLLv9{˗?sJz}'A/(ކ,OH6*Wysk0 c>!nǽ e\1}ȑ#ϝ; =hkk[l /X@d)>Np8=U}}}C= 9YFeZ  =LNNÇG@@CNo}[Boq̘1h4 !"##ax9Y}w,݃.@ rtՂ ,j.\09Y@;\Ot}СѣG&''o޼Y.z}g0ƎkZ]ZvmRRRdd5k䒍7FGG߿_v𴴴;Ξ4is=ҋF---YYYfh495ƣ8l!Dvvv~~~GC)d1wիW9rرcrannnlln={%K\ǏZ\RZZz…dԩv===l^xaݺu?яmۦދ,_ܹsN*)))++skGq8ܸѿ@J8{]veddx震 ߉=oPݸO?n6lXEEs)ڦn7=655Lf}}}ddd}}7 G6l5ƣ8 \2))b,[l˖-1z-Qг':Yyzwyĉ&_ \FnwF!Dhhh[[\R\\|- Fg͈---h9j2ij\{>Mk׮u~xժU 555*պK\\\III7E'-1|m۶544: 322Μ9\]].Ξ=g---7o^G;jjj2#//OJ/Zn:gΜŋl!d{4|pgaFFFfffddd~~o-^"..nҤISLhGEEE3g---<<<--rCFyfo7|l966ҥK/^4iRXXؤI]6)))22r͚5Be˖ubD---YYYfh497n~a*-DT>,}'OɑKNkӝΝ;wuuuG9v옷3f۷xqqdɒc.]5>VB,]tɕnj{ϝ;wԩ2gyii  ԇƮGI 233w޽k׮ out:f4hPyymv%wL&SCC"11>}M7*W,{Al6mvegV5>>٩l>s\np=tvj G6l0vhlnnhmm6LŐ,Xrʤ$Ųlٲ-[F@"md)111B\YY)r-!!!y;sĉt{+0aW_}{nNww}BTUUv\Bgyy!C<ˍF"44Me!曉BdAk+W&I.yWZPSS6nܸ{Z,={z+ IOO˻{rssǏo6&IΎEGG;kvbqqq%%%Zj*SםENоiӦ%MMMfp9edd9s:<<\pƌ>ŋ333755[.55U%iӦ!_--7u3gŋm6[mm?RSqt9Y@t:dXPP ͜9sjoJazzztttzzzTT}']??Bx֬YsQ։ :tԨQT8Lg|@_&3}x6d FdJFW:}uuoЅ/t$J+#u=kmo"' ,Znt+IR|?{_N(-*qv1d?9Yaپo: gc?Ғe6FcQQ\ӭ]6)))22r͚5BWw}aرVUVVVl2粊5u:ƍcbb,OstZJϧ?^eD=zthhhrr͛UjʽHֻkN.^8iҤI&l6+//WՃ6Lido5=70NFDD8'D֓wqPHGG@cΝ;uTIIIYY[|ǭV{'͍g^d\gҥ'Olllt.XSQZZz…yѴӊWRO:577n/\PeDs]zu]]ݑ#G;RSwo;GH>)##Ck.:_~gj 4ŋ$UUUEEEɅ6M$9RSa%Ir8zޭ/nll4 *5 Ξ=p8 Z#ח% [aTTsfJG*m)++$I>aPMaj^${鹁 ! l111*mvqed!ZgOd!C(Vw}yʕ$^o4v\hcbbUj !F"44r-!!!\BOΉ'M&믿ю ^e괨rNYr~{PQQQ+0wIV鶁o"\YYfg'Fߏ? ' n6(+))Ѳl|||}}}[[$I׮] \"|zvSZ-Nv7n޽{-˞={rssJHԵ;":8EEE]tI!B}wz;:+**'DeTMޏ."' hǜ9s/^ljkkyg~gjkkKKK͛'N6i5UL'Oijj2#//Ǐ;_fdd9s:<< >|۶m 5UNˈRSSׯ_Դnݺvr?ʠ IDAT6lP2L;=ZTTT4m4j*3"_lGnv?׷H'-7s8?xTTԀ^z%g᣾~޼y7o Ns9Q)t͚5妓G-[L&(g]߾}u],ܹs#BBBFuvgɭ}樨7x5$ަN,?~x,i9l6yu\Rө8Ledo5=#5 ƍswSq滸}v($`ۏ~>I@ߓ{]vɿ*wTUUtM$raG?=w}KVVVmm~ɓ':By'^|>fTTT\\ܰayI!M_;!' ­=uuuN6l?${.+.C[o3fLc1B@zCN,tP|tZF5&//hG5p@7t{BbNtH~UNnW>쳎v 8O>筷޺ق ,j.\0PFNtC=:44499yrիW>0vX\P^[ZZfh,**RƳ5ooܸ1:::&&fN[vmRRRdd5k^VVlٲSqϟOKK OKK;ʈW̙3'Y1NE :־IV]q:.666;;{ҤI=J/Wŋ'M6i$ͦ2c&q󖟟-W@cܹW;rȱcX>{%Kȅ$WL;fΝ;uTIIIYYJMŦ{B^p ''C?nZ{=o/]tɕbSN͵'B*8ӧKov7$+m/ºu~m۶M$J_dIJJJuuرc.]2c&}iCIB]v Ξ=p8 x$IUUUQQQ*+/R\ܭPw!n$p IaZ=::fI$'׺1No766 +NܬޑJ* :f9꽻]Q__/*xQqGEE9WlVGe;i4oϿpb,XtahIr,\/`ww9qDzzdzW\IJJFnw!Ct:ToF!Dhhh[[[7nv=&&F!wqr-!!!\O+@UUU}u%Ύn6nػGDDmiiQEWWzUUsU5&}c|D!DBB–-[: ' 7t{ܸq{X,{͕+׷It5Ϧ+))Q|KӵT]QWB{tt+W/_i?Ujjjr:'=z_W-hϱwbi]iEqL&4L*̰MNw ڑq̙pp|۶m wtBܨݕJ/nZU\驩ׯojjZn]jjJG*3ܽƁ>@ ' hGFFFfffddd~~o-^"..nҤISLqOO2E=7tQF%&&8իWϘ1ùSUzWŐ(f͚GL0T{QQ̙3)8ټy~l6F4|pgaG7-TJ{/+}ڵ~_Gf=pnrOӄ :,n \}Sffݻw%?}G^^_|cǎ@뮻-[։<8uF}S+|, i 8-_8~j}K.}7l ޾}{ܸqaaa}cۚ3gzzz\hykz_nߞ={*$Jjժ ww+VX꽰0<?j?U* H/m^ֿSSSg͚%5kVjjq#&Mڻw-ٳsΝ Q-[iBHH)K8yi:zӦM3nњMܹ366VڵK!$6e,(hl,%' IKhwرcv}ݺuҎ:tBH5P[[+ɚ74eeHޡC:^_[[kإI4)ꫯz!3Cčy=M㩳&/{F9nBb}Ge ?j"0?Fxi['/mkf͛ `Iiiǭ[:vXZZ]'' @{cd)k dAvڕsdrn˥M)pM*NyweKHsM!č75~ٲe&LNYAd)O]Ge://֧OESݘׅ`ݻ|67"]TT|xi7:N^ڲ <<+W|뭷ݻ|67"=322bccntem۶mԨQ&֬'+y 6($r\@dz|Ƀ>VCCC|ԩ6l0b wwwKUUz{{wiƛmֱcGaZlOb%$d{/,,|\]],XTqʎ}ƍ^^^RjOadvd^_hZ3;::<8??T\\+jMm6v65 Yte{>}-41!DrrAL`5Kۚ8yifʕ+ #رcBcǎJ,dq=Ɵ Ѝ?&L>S[%*HcܺuW^EEE$@3f̘+_lwFh{4`u/^lc̙)))|AddcZ^vڮd3y-w@@@HHn~㸷R fZ)rf-0$ico ϟ?|{ݼ\j!L{;@+@;BNl,9Yr`;j{sXQ\t!V,؎J^otҭ[|9w͛77aCSaGM233jŋ/_OeoƆ JJJ-Z9yd|嗓'O ?xƍlܸo 2eW_}IZ_W*IVp @A{>YܹsouP6lC:}thhBz{{~SQasȐ!}O?4`!DNN "]T+䓧~ϯɓoرc+lLUaǻ)K!! @9Yl߿ÇvzСW_}5ٳmۮ_^ZZuV!ӧMaaaBأ>jI23gH 3(mvZ;r;u'N 2 X IDATٻwoqq=+XtӬYN:U[[[PPe˖آE:t萔h_>gΜ:,\^3w\!ٳ_~ڵٳgבzqƜ9s 9Y]yyɓ̜9]twPh}ϟyzu>ۥM~hWWA\l]wTd,&&g]]]Ϟ=1112QFmٲ%///00pذa=yӧGEEuʕ+7o9r hxjO .?̙3;v\~}BB0`{Ʊͧu@;_L6ڱcC=dv@ QhJuuuƍ+--MHH8~8 Y ' Xrʕ'.]<3G5l=z#<<<\\\ gY&J%]/#""܆ i$ܱc]]] .4th7oƦ988^O>ر@e쉜, o„ ~|P^^/5jҦÇ?555Νyf~&LiӦXfff\\Zx˗x 㴬7ذaCIIɢE233'Oܜa?޿F^9s&([z `O X[[{СaÆ$SuP!Vݻo&׋t~iB2DVyɾ} !>ڵk_{!C|']vUfZ]@S9Y@ހN8!pssݻСCu&pww0oȊ*쨰VYY霝UUU...RRZk^kh6o,xWW\x׽ @+hr=]xqqT2`~I-))ԩSvTؤt&9YW5jm |ǟ:u~i+wdYh>ml6RYO׳gm۶]~t֭BӧOK„YYY QaG}xGt|޽{ pԩ:v Y@;DNwbWWWOOO{*VtR''Yf:u`˖-wQaEu!))I\~}Μ9:tXp F ,X0f̘q?p#ڱt$@4>@b@ޑ#G>|X >|ŊگBe˖=zoذa3f̈TQa%33sҥⳏ>EbbbM]6U?y景ZV/_<11 wW8' hZ⧟~zꩧmոvZ @Kƻ+h֓z#""|ĉF'dmƷkl6nӧO1cFUU+V5=Y6+j+ݬ-FS;ZK.=S򋻻{;"@uXe߾} _z?2![SS3sL___OOό Çwqq>|˗)88xÆ ֭[gn߾=n8WWװp֭B{G U*5PbҬJZjUPP+,o׸6^aܻÔ%ۑlqp/=z[ƎO?2ŋ'OrJaaT8bĈdV7}tpʔ)˗/s9bh!777///--mܹ %''kDJOO///x7 kkk### mzK.((̴awvdLLL /)) KJJ0ɜZ ޼M8z()ZɢxwppHMM3gN^i t!!![u:WEE"00W^5jT^ ]hZOOj77ZK8qk׮%%%!!!EEERyJJʑ#G"##,YbhStڵk}~LR d5>>>gϞҥF۷7)ۦ,M&h2SDdĉO=ԕ+W|}}m] 'PCZrpp0q߾}ϟ3T>~xZZZNNέ[V^=c CLZWTRŋCBB~޽{کСC]]rҼD6xM jjjLz~ s$' pd@㐓-;_yN7hР>,009z|x={veڵ#Gt:u2i!33駟j!=z?٤|镕}k׮_~=44TRR% K`u]={:YdrcO;˚48:_|u:/L Y+M~-[~SN*gddt؆v$+''GytNfk.^n̩5q,rʐ!C֯_GY%%%gϞ;w 322ƌӣG`C̈́ &n޼-_( """**J*LJJJJJRճgϞ={Jo %R%K̙e]UV=z_reC)eq/='O\\\ܳg;v۷{li3`%VSµwW`wmd{@׿#G,..=ztNN vdV'Ν;1ȑ#M&Euѣ/^RRSSwmX"MRwDЎ@#%sKKK{-[ 2N/SO]t?1b#jv3~ fd8ЧO'' 6Ho7nkXXXAABMBK~^h 5׭[gϞF۩SѣGokK. 8ĉ!! /;dL|;w^:zhPP}9~hM_yQFI* 8qD׮]KJJBBB,Ք-4nܵٳgth{ Vvssú:{yyyO=O?N64t $evZ!/{_@kgO6N|U?رcqqq^^^Tx͠ OOOVPSP֭[~~~6B'':+GQZZکS'k hyO>~޼yeeeSNU)[(+:::==]ӭY&::q޾}/_:gΜƵ1c,X@קݻWDWXXpB =c T绹R',*jժUAAA+VhP={}Hԅf߾}_nɤkJUPPЭ[7Fzv{߿?66_;vpM6e9mڴK/\pƍ1/#ql),dQ]]k]V /;k؞ . 5:88tСNVruuuRsmmBjd}8n߾TPParüO|cOg4T~~~ddڵk]\\>?%depJRaQQr7l˖-۷ ͦa6m`wdm^x5^lllFFNKOO7. 322[0Ԍ5.ɱ&+uy Ɋf0!' hkz}ZZZll͛7rrroɊ+>l\V۴4T*l9sDEE5Mbccsٔa@z{jEiiiӾ:,X`:XC|cOfmK)mgΜ?~ <==lO;"LKlB֚l~׹sѣG_tK6Z[_pGi Y{GѾrBo?駟w8/ɓ˧Mw=f `9)88xÆ R۷ǍVPP ̜93##C*4UVXB]:dܻ F_Uh|||w_dɩS/_>|/_лlMJ?k֬ Xl5eahK^;8;;{7ntuuwPXd)S/_~Ν9rD*LNNj񉉉Rŋד'O^r-geeeggdff/2c(4u!!Ď;Fdח,Yҷo_!Ĉ#Zm\\zT__fͤInjiA֔Zvo=z^wDd^}@ɿ?4ǯUVܤ,00W^5jT^ π'Ntڵ$$$Hѽ{ÇtahnݺdI͛w:tܹO<0cǎC y뭷#t^^^ʽTT;wljw-;rXsWZ5o޼#F|>>>`#q͇[@C5[jzgkiii999nZz3jZS__Rª*.,d-9٫WԩS}h4vܷo_bbe^YTmRMegZƝn߾=};wTy楤 Zۜ4N*|駵ZGϟwvv6x={rgg7n7:'+e6 %{6lXmmaVtvڑ#GtN:).[<'+;p -մ4p3 -G#vΝ?~oֹsM6=٢xwcOv^O6!!̙3%%%...Ra||yrssN*NN hږ jwdcAH-aԲY [n{G.^h vvA TUUv;eee?;;;000++-%dۤM6?m۴iӧOw8hzAAA#Gܲe@@N֔Z6%.z5k]}ĉA;(PTV rww_bƍsuu +((0T]|w_.˶ٳgs !Ν;PS_3ƸkT*պu|||٣0p77 /\+,,T绹k4Β, zjDDsDDIG&cQjjYfJMMUѽ̧AZZڀʄyBFS]]mk׮I#Zx!̶0w>}899n*Kv/_<|pi}˗/+n)NYfEDD,XR Ù4i޽{¶6fpZ2rz~d@+++8qYΝ{___{eOYYYBdV(Ol Xݼ6cbb]8PSrG}P#!Dnnn^^4¨"##+++˫:{l݅ő%IGvBKJJ’niDVfq>%6l裏߱cGahFEE:tHcǎѣG42 uܹUUUIp2eܹs#G(Ԕ#F$''kڸ8.x׬Y3iҤ[6b822r߾} zaw4]ٽ{gVUU)Qoa *++]]]:SQ^^.Q9֚h˟ke4m>Ep/=ɞ,>^x,44tǎzSt`>L MfIVKuU*U}}BeK1)mہAAAʽ={O#㇖b888tСNVW]]T\[[kiwϒ 1S#5(ϧJ|x CѼzj~N:էOFhMK<$8e6)<~xZZZNNέ[V^=cƌo߾ חBԻ=ׯ_W0w}e4m>Eٵ X^ ZYfM8gvBVNu֭NJ7҈e ]lY߾}r}ѻ,7o !nܸa\.y{{+`eq$;!^^^8;2fiDN8qcǎJdfn<==,Y?I!!+Ҹ888H7R7<4hЮ]wܙБ$?˖-(--U]9N+ׯ_#belZ6StΝ;1By!-Cu0!k͚5o-[T?o޼ܩS] IDAToi6cbb~mکʽ5jݍ]VlllFFNKOO7. 322[0Ԍ5.~餻5bD~۷}Tbh>ׯW'\reee[ou޽nZQQrJM#888;;0!!̙3%%%... NNJIIQ]!N+g۶mF2)2.в4|уksIIɞ={zqQkp8zh׮]ݺuXy4S^^>uTww 6oZbV]6k*;fMž:RXaac=*݇ݰ˂ \]] dH"99YiV5d|B8x|ˎȒ?&|~SLt4oVQQaFFtRBڽ{o҈۶mB&=O|AZ7( Sv7n)e6zSO3`|8W\V5f˟6';;|sNv=zX~TXZZ2p@÷ٚ&R$C qrr2dĵkz{{޽PhkΝO>^tRttsttKL:2N&-4##Cqaî]flMf ,Y2qD{G׷::t落zߺu1cjMn?O)))3 m؀m>Ey)S,_Ν;4,jjOAbbbxxxIIIXXXRR<777///--mܹEFF?~\1bĈdV7}t{ Pk&%%}j۷owmCuUUڵkǏoM3g}X+{E5zwfs5mM_yQFI* 8qD׮]KJJBBB,Ք-4nܵٳgth+O@RiZOOj777;չt^^^:R 0',<<<6n8n8{cI/ʩ7 =DR 6&d-[o[HHb${nD׼Ʊͧd  ǏOKKɹuիg̘!PRzJ%Wl/jjj:tPWWl~5m\j{]TTo߾K5Csҩ?aX샬4]@̧~Z !zqyggT(4I={:Y_|۷K.k׮9rNԩINVKjI*j߾}qqq@s4m>Ey=ل3gTWWH+++͝:uBMBY:n͚5w _~_9s!t:oUUUJJIM//CKz?/-V@f SSS7o,._( ""p_ ٚ*pՕUV=z_rrT**000==}CBddd3G&̙eH&Cj4^zށRRR&Nh\bc#ilF!F ]&iڒv}N}-))_x{eSxl{Xi|ԩSM۲JAޚ`MH-!lYH5ye4NX!DPP;#x.^hpڻM6?m۴iӧOw8Z4rg4iҝ;wLR[[kpZ)88xÆ RZ=W^pvvh4T*ժUWX!}q\]] /njcoU*պu|||٣|aaaxx… .\c*Rϟne)gϞΝB;w.$$D*:ٱˎ(55u֬YBYf* --meeeW!F񩮮Եkפ/^l@12.a 4'T%;K/_>|/_л8g͚`K][?^Zw}700~X|ciYL|;wjxhܾܼs*Y\\\YYi\^]]]\\?kwKAbx/իׂ y{|5LӮfMkk̵LVjҥp̙3}P2hР]vܹ399ټo//7o !nܸKn<>}M0!>>>˥¢"ooo 5GԸI˖-۷ :K#>'N>|رcѭ[7OO%KORH !_.~+/ dg_lYEEEiirqZ,zps=?aӦMWZm45M06d9;;oٲ>ؽ{iΜ9S]]]RRb+''0:::==]ӭY&::Zy敕N:xӨQpccc322t:]zzqT܂fllqqbbb~mb!SgiD~o߾۷K_~}||rO>ʕ++++z-`zu֊+WllC YtUUU)))ʽ+i%٣׿G-T,🚯eKx&ٽ ~=mEFFWZ t'裚FZ&ۤ4휓_ӹst}W\斖KKK]\\htU5k׮ݽ{q_2#tRttsttKLip=zX~}C&MH~~~BBb„ 7c~X:YK0>flso%KL8Q->uСFu1cX__՚ܱ x,꘿ְw4;]x_ɓW\nk]PP)HNNj񉉉RJÎ5yyyiiisΕJ m>&q1"99YM>]aDSLY|;wboAAAn %'NڵkIIIHHHQQ̙3]th4]vRZguu]- !t:WEEʨQzdMpBMtҠ nܸQyZa';v}7lؠPP i…B Rf͊n)Ka8&MڻwBmfiLu!3 l9ٔ={*nEEE3X^^^5̙3'**J[FFƘ1czlѣ 5&Lyfk&IJꝘOx{oeir E].5}Ϝ= s^qgX.zӷX>wFjt\rss3]ļ'XBgrzFCB2}b'瑽gs7n܈z7+5|5k<^^^t"=bzف=RT޺u !D?Ē[{l҉}&CXۜgώ1vr`NxקMVWW`D][laE]ywܼa&ISLٰaCKK͛Ab+a_RbIV8y6g޽SNe%ZI\| #YX'_|񅷷ɓ'ʼnF9Y{?x`</t }fk4oc;8,|ͭ[>ٳ䟙>8\v*999##c֭BtYQY&.`L}}2eʍ7BzW^h4&L8v_~'O>}t/C}ѣ>zʕe˖  8RgϞ[^3T V3@O}r?Cލ)۷o/ϟ?;lذBq>|/ٵkWXXXo BܹsǏ@hV%XS'k"裏>\nB4**#**ɖR4͡C  77\&{'BBBt:X]]$bk/X!566Κ5K*WUUrk7l$졇z׮^:u|KGua&[߾}M+ vl3ڒj\.>(33sCf CHFrJ,X{fURE:30Ǐ#&Occcl#锄k޿ɓ?-ooo`rj'gNRZZ^KII!&r#!KX;z޽{YYYFB=))):X?wm6sŊ׮]xbYYV5-$77wǎ~m>}as=#ywª.\(t,( _27B E*2z=EQFQ,Ӊ~~~%%%FѴ@NGQNh4tRZZvlsOuu5EQuuuJ"l/9M(˗/ӑ+j_}6vDbLl۱߿׹!:t( Il 67ozyy!^ʚ=\ Oݒ] Sz4ҋF|5kx zB!P(82"?+..fRr|ʕӧO'L"J%=HF F#6xl6vTVV秥*K/f͚fqmٳgM([Yd ~i`N"((hڵE=5111DCd=sԩm2ydll,"i|I~%e˖h&'͵8iҤm۶ő˜2eʆ ZZZ { 6'k$eN'ls;uTV%?8SYuu>,W2zlڴiXV;n8TJ?VN$5OGjZT~BOd 0Oڱq?9eeer^ϥ/ǓN3 E8zl%UUUAAAuuu999-m.322~} ݯ9iҤ'vo={|䙿.00ݻݫα͘1'|>;teufaY,†d{ޯ̱\n? ܻ.53FcTTki䌌[[!<l, x3?~O(̙Ԕ&t8ࡔ\dΜ9|2+J__={_ҁp֙'[y)O }0bĈUVzHp,`MNqV dLbiiiTTGTTTii)`z6'B(==]&7Nr҉f͒JUUU]m29=u:3''GRi4C<NwΝbxڵ&gp<ɦFDDֶ0'ONKKIIIt"H2?DN0aɒ% k׮ɓ'O>M'y{{h؜D&3RRRBBB냃SSS򊊊̥K<~/Y#!!޽{BtD j+W|||t:?l0 EssiMsD"NSSStms9 [oM:500͍{~~РA)~ebsbTx "HVLF89<,֐ .$%%1?)Z kp5 Bvر{L"HR],rҥj^O7*>Ns玿X,4>;؜D:L!77؞G{nL}<z3 8hjjj(W/FcCCЃ؜!̚FiEroн&wLӜDV*:ZC|lc,r!S1BHTVWW[NqO׶6zfnr``;ڄ, ?[Edcbb CVVh0jh`W(Ν4']fvvvll,!ٳ\Z__A'-[޽{剉YO؜DȬ,iӦNcĉtbSSSbbrssY-&bwVeeehhkhhhee%7Br؞vXC,:NV#P?3Yw8zD[~'g̓EAA̙3=<<Ν;7l0+X? .$p+WljjoKJJ'OxPs$xjf̘ꫯ yF,V3 OOϓ'O>㰈pB0'yi-ڴiS``ŋӅ FӲ93(8z諯H$7n?)t8e,,pN0' ;6==ϯ:`f``Z8!? 蔕oooΝgkV I\vHx< DW_=C{ݽ{l- 7xضm+ү_K.[?@Xy,\H$nY 8O_~9..>11BX3 Ap,pp,! {{nPPN[nݒ%Ks,\H$V\y &`mjjڹs۷~j+'k)V{9sz0685B0ݎӮ{If 3g\jUOJ JD 3 z܄,BW^AiZ+8}":Q*C t钯E+vKc`쥗l C***Fd ~{˖-=عsR@{fm`#u4;w Y{`JPUUURR.gv%t u=c?+t,YҬ='ٲH$裏===׭[jll5kT* %''j\M'VWWt:BZ6$$D&#,,, rss ͥ!DJh:D'*:rȌ3Lz[&Ҩ(RӊL0kW^E]zuРAt"-ƹzŋ#/^zjBKac.xSt"v [Chs=|0a[r|&v,A*ڵ?o 23 |/4x; лl>4ooo^BYbŵk.^XVV,&R__J(3555""LBBڵk߿ӧOӉؐBK.S]|yԨQKwAsV4y䴴4^TdZ#6'ux0::Nph繛c?~EEBrfb˴^bBgΜ0 KnneɧL޴G5; uUGG8clQ[[=3Kwֻtzn=lY^:^rACsud bX,vqqA}ғYߍ7X*'ʩh<[XX( !a"## 1W&"oo|-KBNǧ1)zv7z.zf:l㏦f :v.EK<'˭8[;͢aCq:`XnfsK.mjjڶmСC7|s…k׮3gV>l4oܸHȉ5p'N455mذa„ L6\O4e=UUUs6'wslbRR'|BQԖ-[?j|SSS_|E%K477/YNv]7w`C-ۃp;'hѢƲ:qҥ{lΝw)..nٲe+//OLLgϞ}ʕzBN,VFcFFF7j_y-Zݻ:V(Νc^kuZT*?s&޽{i}d2Yss3!rviiiRtرZ:u^Ř [#v0tVpqnՅ朄^,f'bNH$P-,^:zhp3f`gٳzׯ#/_ /H$V|n$_4ooo^BYbŵk.^XVVjĔd IDATTB--- )::ޤ0::ڴ˗/5yI(~is͜;KӧW_}%ׯ_33_ѫXV>OĊ+~G:E4p`KƦTUUTWWSUWWT*_~RtEiZZM(SR19;moOBϏ(*::oI$Vr𦱱䳛liiJ|4'vwslϯ@UVV.XrGSe4b1aC_fffIIh$O;sLDD`_bGvsU-ՕON>e>,wzcA[[ۉ'x "oB jE7.$D?.‘XEVؿŽ(@:Js`nbX,?C'rtttPn:q-4'9nUWWקOӷj[pṆG:T,s5%!'f܊'x< Z/Ϝ93''P&EQ#GjL v [2)sFt[e?/uJHH:cǎ*B8p v,~]]]ym۶щ qqqcƌ$&bg˜3g֭[JZ.(( {/PjJ%};BhٲeRtܸqLE=h%%%L6Ѩhjjj3 8'BhÆ  d]%l/͛7######o޼I'KXFEZ?qI˗N`/fVћ8-– ;ʾ.ðbMMMكD__߲2VNBq۷ !JFC>|5kx ///ӷ.\@^,Fsq:mK/f͚憆r䜝6WvGm9رc8PYYFi0Νczwv [Ξ=;b> 渺~W_}3 11{ʔ)۶m{!C{ .ܸqcͱkvaW䗹xƺ'Nx)P^^޴iڈLkmѴi ǎ6l7vu8Yba{XؐK<\, Jvҥ!!!qonK'w%IYhQrrrcccYYs#ҥKyVؘN'Ι3wmiiIIIy e&$$,]4nDQTFFUXdee-\y ~С۶mkjj?L7W(gϞ%Gmf߾}Ϝ9ؘL.'fͻ;sM_˴\/<쳗/_6%}vQraay6oJoCݸupB̙ӧO"4(((##VMfv%.lNK~[hji2wOQTDDıcǘ!LW?/gE',}~47P;-Y̽b52uww^,{ggdmŊ: ;sԩ'  )((yh4m۶De˖]|Ypݺu>y饗=SOmٲ_Wrr#<ғ*fϞ}ʕz:1..nٲe+//OLL$&bEFFfee M6EFFv/ZBq9ӔI&m۶-..41;;`0dggZDD ۢiӦԼk=-[0ɒ<6$VFcFFXD= >&&6YYYݨhʔ)6lhii)H<23ӽ+WX3px-̮o>|xKKб¨ڼy WFGGgnFs]ؕ9/enY6 ;mwѭ}dfrҤRرcE/bpwJb[TWWR:::Jݻwɵs3Kv'†]}X2'P];Vћ|`dl溎;ʮ/1pgaz%pv}hnn5jԯ;lڴIp)++ˣ'B'O>}Bvv}n@gϞL =#&`H޽{rUp|W9ex80Lk׮)SDEE `Y={bU&O:Kmhܺuk&t 䌌o<d0' tѣW\{-X=-Y%%%T+W>}<3O?4f@SO͙3G@@JwРA|j1k/5E!edd_Μ9sԨQ=y<HO=TQQٳkzͅ _NӦM&?&[:d{^2dȥK|}}锊#G_N-9iVii# }Eyyy7oޤj̙3g͚j+d\ sٿ֭[Mz-tÜfرc^^^/^ӟ$t8@ttt_bD__YfGDDbD0  <ETNNJh4SJKK<<%*P]֙|Ⱶ+Z숵d+**233.]JL<9--M&%%rFDDֶ0֮]{'O>}!rssw!RRRLs^|yԨQF3ŋD>dEa39mrrr_TTn:cHZ[[;/L<9''fРAٳg6m4~x/-p=: &X!=Dxe` ,k~k/z\.ommd Bhnn6SV_rG=t x뭷N֍:o>}ߟ{~~РAweuuumnnf!J[[[ m'w^ ~tĉhD{B¼Ç744Љ=X|||||Oߟ2;wb\M&X3Փ}  ߶y__=gFk׮#F|?իWWZe#dVD}'ks|`4]S[;v=4F6'6$H{dNG:ܪ<;:<<=<< !.ƍjMCb&lEmmmjZ.gggɏ>իW޷n2!vA;urOvEBⶈ9YiNo^zi͚57T;w n߾$;iiiUtI߿SSSGGEQ<0tVgϞ1b9MYvWZ7544ڵ+..N̙3믿njj ^n,_|СB{zǏ#s|`Xaה֎]y3ͭDžiCkkk#"",dlNR__ʤN0aɒ%L"w7a+Zbŵk.^XVVLbӦM+((`^;vlذaacnA]#trwEBⶈQ-pӵ}=sLcccrr2|4tҖN|g/_l4۽~QF544Љ-JNNnll,++KHH0mBVV… Y͜7o͛m'K4BqY aH@.]rwwDG:Nݻ۶m2e KXXXVVVyyuϹAKKT*5ݤ4Ouu5EQuuuJO&effFrNl*JQEO v$΂͉ !D4 v rR:KT2Vq2غbS}]ppݻwbq]]ݬYnjLl"BHSe4b1N;q:';h.$nZX:do߮P(r͛sZvܸqRtL "H~ĉnWtAf)11sMUZI)++8  ;WN]n'|B엣fmܸ!DMX8Nu֨(DB^%ɤI>ӫG878zСCb1+7X,3%2;3gyzzrbkwqqyI?  Y9!!y4l.'2%&$lغvluw6BuVDsNLvmsebk8lZGX61dʕ+̙ü>}zFFqԃEGGGdd$BhڴiBUVV`fX\]]ccc¹w~~hW3݄`0T$q̅QXX(Y9'9X\p!)))77Wp؊.//nݢyqƹ9ɹ@s3عsg||Nڣ TVV"v-ɶoߞ't8f4=K/DGGgn \tO?TZZqP'L30((- oq֬YR488(iE:əR4͡Ca󏓩V dLbiiiTTGTTTii)LlNڑ#Gf̘v%.>\ 8իW4<8W^xbŋW^M` ~z믿jyD`cIZZZ80o88855I///\tiԎ TjjjDDDmmmKK 8y䴴4^/-vQF1/EmvY?YǏGFGG6'Cz7LR[[q޽?sjz֬Ywnhh9rի嗒 Q-痙YRRb4DjJ%!'6[RtEiZZEFXLh 8cT*&$nTʧLnNDmvY?Y9cbb(>p!x8ϟ_QQ\`8lNSl[H=WWWs3fxxx)Ǝ~7n/ uǷiSϜ93'',b1vH$9L/]\\:::(joogL;|J?zСCg$TշnbUG(.>\444xyyӧ|$pӬ"<<|'ĦDOOrbM uuu Cq֭[I.SՎ7N*._ɹ}vB!7oڜU&!gmmZjDۅGOnb&\fb4h<;l\qqD"qqq9u贽ADvƍ׏;cƌ;w::tu΂DL5v}vbA222~} I&O8Q@ g>XZjŊ |r~s'ֵk)SL2eJ>} =g  $g>XGDDsݳgrD2uez*իtJ߾}N+J d][ak{!OkzS̙3Gwu#F]^|E' MO$Ο?OO^~NT(3f̈rww6BXM|a!#GT[v<`m۶W^y_~.]zGsó€wS"{=bz*N9sf||SO=*l(`N[o R;pp@͚5&L8}4rpl0' "{l=q̙|VK'֬YaaabX`9 rhJQTСC rssYfIપ*BNl"6pwwpN8ZmHHL&KOOgKKK<<s___zB86BG?~_'Nkڀŋܼy `B d˿򊊊̥K6OHHXvO<y{{BNl"6ԮƙQ[[$N<9--M&%%j7 `[D!'')u4֌*n-|̘1/^d3sjyT\ZBeeesH$>>>/™3gwϜ93yd///ѣG o?.d2YXXǙyyyRaV4)ܴ"oZڷoǣ>n4iw9l0wwAڵ4N̊"zh49r$))'&&?}Ν;w͏>($$F,˕ /Bz(( effF&