GnuTLS README -- Important introductory notes. Copyright (C) 2000-2012 Free Software Foundation, Inc. See the end of this document for copying conditions. GnuTLS implements the TLS/SSL (Transport Layer Security aka Secure Sockets Layer) protocol. GnuTLS is a GNU project. Additional information can be found at <http://www.gnutls.org/> and <http://www.gnutls.org/>. README ------ This README is targeted for users of the library who build from sources but do not necessarily develop. If you are interested in developing and contributing to the GnuTLS project, please see README-alpha and visit http://www.gnutls.org/manual/html_node/Contributing.html. COMPILATION ----------- A typical command sequence for building the library is shown below. A complete list of options available for configure can be found by running './configure --help'. cd gnutls-<version> ./configure --prefix=/usr make sudo make install The commands above build and install the static archive (libgnutls.a), the shared object (libgnutls.so), and additional binaries such as certtool and gnutls-cli. The library depends on libnettle and gmplib. * gmplib: for big number arithmetic http://gmplib.org/ * nettle: for cryptographic algorithms http://www.lysator.liu.se/~nisse/nettle/ Versions 2.10.3 and prior used libgcrypt as the default cryptographic library. Optionally it may use the following libraries: * libtasn1: For ASN.1 parsing (a copy is included, if not found) http://www.gnu.org/software/libtasn1/ * p11-kit: for smart card support http://p11-glue.freedesktop.org/p11-kit.html * libtspi: for Trusted Platform Module (TPM) support, http://trousers.sourceforge.net/ * libunbound: For DNSSEC/DANE support, http://unbound.net/ * libz: For compression support. http://www.zlib.net/ To configure libnettle for installation and use by GnuTLS, a typical command sequence would be: cd nettle-<version> ./configure --prefix=/usr --disable-openssl --enable-shared make sudo make install For the Nettle project, --enable-shared will instruct automake and friends to build and install both the static archive (libnettle.a) and the shared object (libnettle.so). In case you are compiling for an embedded system, you can disable unneeded features of GnuTLS. In general, it is usually best not to disable anything (for future mailing list questions and possible bugs). Depending on your installation, additional libraries, such as libtasn1 and zlib, may be required. DOCUMENTATION ------------- See the documentation in doc/ and online at http://www.gnutls.org/manual. EXAMPLES -------- See the examples in doc/examples/ and online at 'How To Use GnuTLS in Applications' at http://www.gnutls.org/manual. SECURITY ADVISORIES ------------------- The project collects and publishes information on past security incidents and vulnerabilities. Open information exchange, including information which is [sometimes] suppressed in non-open or non-free projects, is one of the goals of the GnuTLS project. Please visit http://www.gnutls.org/security.html. MAILING LISTS ------------- The GnuTLS project maintains mailing lists for users, developers, and commits. Please see http://www.gnutls.org/lists.html. LICENSING --------- Since GnuTLS version 3.1.10, the core library has been released under the GNU Lesser General Public License (LGPL) version 2.1 or later. Note, however, that new versions of the gmplib library used by GnuTLS are distributed under LGPLv3, and as such binaries of this library need to be distributed under LGPLv3. If this is undesirable older versions of the gmplib which are under LGPLv2.1 (e.g., version 4.2.1) may be used instead. The GNU LGPL applies to the main GnuTLS library, while the included applications as well as gnutls-openssl library are under the GNU GPL version 3. The gnutls library is located in the lib/ directory, while the applications in src/ and gnutls-openssl library is at extra/. For any copyright year range specified as YYYY-ZZZZ in this package note that the range specifies every single year in that closed interval. BUGS ---- Thorough testing is very important and expensive. Often, the developers do not have access to a particular piece of hardware or configuration to reproduce a scenario. Notifying the developers about a possible bug will greatly help the project. If you believe you have found a bug, please report it to firstname.lastname@example.org together with any applicable information. Applicable information would include why the issue is a GnuTLS bug (if not readily apparent), output from 'uname -a', the version of the library or tool being used, a stack trace if available ('bt full' if under gdb or valgrind output), and perhaps a network trace. Vague queries or piecemeal messages are difficult to act upon and don't help the development effort. Additional information can be found at the project's manual. PATCHES ------- Patches are welcome and encouraged. Patches can be submitted through the bug tracking system or the mailing list. When submitting patches, please be sure to use sources from the git repository, and preferrably from the master branch. To create a patch for the project from a local git repository, please use the following commands. 'gnutls' should be the local directory of a previous git clone. cd gnutls git add the-file-you-modified.c another-file.c git commit the-file-you-modified.c another-file.c git format-patch For more information on use of Git, visit http://git-scm.com/ ---------------------------------------------------------------------- Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.