An asynchronous XMPP library
C
Pull request Compare This branch is 17 commits ahead of wyhaines:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
build Added support for Dolt in the build process. Oct 22, 2008
docs Removed lm-soup-socket.[ch] Oct 27, 2008
examples Moved Makefile.decl to build sub directory and created a Makefile.am.lm Oct 11, 2008
loudmouth Fix g_log issue when configured with --enable-debug=no. Apr 23, 2009
tests Silence git from generated files Oct 22, 2008
.gitignore Update release information files. Mar 9, 2009
AUTHORS Update release information files. Mar 9, 2009
COPYING
INSTALL Initial revision May 19, 2003
KNOWN_BUGS Added File Listing Known Bugs Feb 25, 2009
MAINTAINERS Update release information files. Mar 9, 2009
Makefile.am Update release information files. Mar 9, 2009
NEWS Updated requirements and obsoleted NEWS file. Feb 24, 2007
README Removed Dangerous Instructions Mar 25, 2009
README.WIN32 2003-10-01 Mikael Hallendal <micke@imendio.com> Oct 1, 2003
acinclude.m4 Migrated test suite to GLib unit test framework Jun 7, 2008
autogen.sh Gut autogen.sh and replace most of it with autoreconf. Jan 29, 2009
configure.ac Applied parallel make and asyncns patches from the mailing list. Apr 15, 2009
loudmouth-1.0.pc.in 2006-06-16 Mikael Hallendal <micke@imendio.com> Jun 16, 2006
win32-config.h

README

Introduction:
=============

Loudmouth is a lightweight and easy-to-use C library for programming with the
Jabber protocol. It's designed to be easy to get started with and yet
extensible to let you do anything the Jabber protocol allows.

The goal is to fully support Linux, *BSD, Mac OSX and Windows. It has
currently only been tested on Linux (Red Hat 8.0, Debian Unstable) and FreeBSD
that I know of. If someone with access to other machines can provide
feedback I would be most grateful.


Requirements:
=============

Glib >= 2.12.4:
http://ftp.gnome.org/pub/GNOME/sources/glib/2.16/

gtk-doc (optional, if you want documentation built):
ftp://ftp.gnome.org/pub/GNOME/sources/gtk-doc/1.0

If you want our unit tests through the g_test framework:
Glib >= 2.16.0

If you want SSL-support you'll also need:
GnuTLS >= 1.2.0 with libtasn support.

Building:
=========

./configure
make
make install

SSL Support:
============
You can choose between using GnuTLS (recommended) and OpenSSL to enable SSL
support in Loudmouth. You choose which backend to use by passing the
--with-ssl= flag to configure. GnuTLS is the default and will be used unless
you pass the flag, use "openssl" for OpenSSL.

Debugging:
==========

You can get debug information printed to STDOUT by using the environment 
variable LM_DEBUG.

export LM_DEBUG=<keyword>

Where keyword is one or more (separated by :) of the following:

* "NET": Shows all the data sent over the network.
* "PARSER": Shows debug output from the parser.
* "VERBOSE": Shows various verbose output.
* "ALL": Enables all output.


Questions, remarks, bug reports:
================================

See the web page for more information and issue reporting.

http://projects.imendio.com/loudmouth

Questions and others can be sent to me at:
email: micke@imendio.com
jabber: micke@imendio.com