author | Mikael Berthe <mikael@lilotux.net> |
Sun, 14 May 2017 12:12:09 +0200 | |
changeset 722 | 80579726ccb4 |
parent 701 | bbbe2d24eea4 |
child 729 | e63d00271473 |
permissions | -rw-r--r-- |
1 | 1 |
Introduction: |
2 |
============= |
|
3 |
||
4 |
Loudmouth is a lightweight and easy-to-use C library for programming with the |
|
5 |
Jabber protocol. It's designed to be easy to get started with and yet |
|
6 |
extensible to let you do anything the Jabber protocol allows. |
|
7 |
||
8 |
The goal is to fully support Linux, *BSD, Mac OSX and Windows. It has |
|
9 |
currently only been tested on Linux (Red Hat 8.0, Debian Unstable) and FreeBSD |
|
10 |
that I know of. If someone with access to other machines can provide |
|
11 |
feedback I would be most grateful. |
|
12 |
||
13 |
||
14 |
Requirements: |
|
15 |
============= |
|
16 |
||
589
5ed52ee1e2d9
Made Tests Optional to Allow Older glib
Jayson Vantuyl <jvantuyl@engineyard.com>
parents:
481
diff
changeset
|
17 |
Glib >= 2.12.4: |
481
91c75e6b3190
Updated reference to GLib in README
Mikael Hallendal <micke@imendio.com>
parents:
480
diff
changeset
|
18 |
http://ftp.gnome.org/pub/GNOME/sources/glib/2.16/ |
1 | 19 |
|
20 |
gtk-doc (optional, if you want documentation built): |
|
21 |
ftp://ftp.gnome.org/pub/GNOME/sources/gtk-doc/1.0 |
|
22 |
||
589
5ed52ee1e2d9
Made Tests Optional to Allow Older glib
Jayson Vantuyl <jvantuyl@engineyard.com>
parents:
481
diff
changeset
|
23 |
If you want our unit tests through the g_test framework: |
5ed52ee1e2d9
Made Tests Optional to Allow Older glib
Jayson Vantuyl <jvantuyl@engineyard.com>
parents:
481
diff
changeset
|
24 |
Glib >= 2.16.0 |
5ed52ee1e2d9
Made Tests Optional to Allow Older glib
Jayson Vantuyl <jvantuyl@engineyard.com>
parents:
481
diff
changeset
|
25 |
|
29
06a0e0c2e2eb
2003-08-04 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents:
7
diff
changeset
|
26 |
If you want SSL-support you'll also need: |
701
bbbe2d24eea4
Update required GnuTLS version number
Frank Zschockelt <lm@freakysoft.de>
parents:
673
diff
changeset
|
27 |
GnuTLS >= 3.0.20 with libtasn support. |
1 | 28 |
|
29 |
Building: |
|
30 |
========= |
|
31 |
||
596
9096d2549372
Removed Dangerous Instructions
Jayson Vantuyl <jvantuyl@engineyard.com>
parents:
589
diff
changeset
|
32 |
./configure |
1 | 33 |
make |
34 |
make install |
|
35 |
||
480
89568ffc9265
Added comment about SSL in README
Mikael Hallendal <micke@imendio.com>
parents:
314
diff
changeset
|
36 |
SSL Support: |
89568ffc9265
Added comment about SSL in README
Mikael Hallendal <micke@imendio.com>
parents:
314
diff
changeset
|
37 |
============ |
89568ffc9265
Added comment about SSL in README
Mikael Hallendal <micke@imendio.com>
parents:
314
diff
changeset
|
38 |
You can choose between using GnuTLS (recommended) and OpenSSL to enable SSL |
89568ffc9265
Added comment about SSL in README
Mikael Hallendal <micke@imendio.com>
parents:
314
diff
changeset
|
39 |
support in Loudmouth. You choose which backend to use by passing the |
89568ffc9265
Added comment about SSL in README
Mikael Hallendal <micke@imendio.com>
parents:
314
diff
changeset
|
40 |
--with-ssl= flag to configure. GnuTLS is the default and will be used unless |
89568ffc9265
Added comment about SSL in README
Mikael Hallendal <micke@imendio.com>
parents:
314
diff
changeset
|
41 |
you pass the flag, use "openssl" for OpenSSL. |
1 | 42 |
|
43 |
Debugging: |
|
44 |
========== |
|
45 |
||
664
f57b1b61e1fe
Remove trailing whitespace and mixed indenting
Till Maas <opensource@till.name>
parents:
640
diff
changeset
|
46 |
You can get debug information printed to STDOUT by using the environment |
1 | 47 |
variable LM_DEBUG. |
48 |
||
49 |
export LM_DEBUG=<keyword> |
|
50 |
||
51 |
Where keyword is one or more (separated by :) of the following: |
|
52 |
||
53 |
* "NET": Shows all the data sent over the network. |
|
54 |
* "PARSER": Shows debug output from the parser. |
|
55 |
* "VERBOSE": Shows various verbose output. |
|
56 |
* "ALL": Enables all output. |
|
57 |
||
58 |
||
59 |
Questions, remarks, bug reports: |
|
60 |
================================ |
|
61 |
||
638
bdfa8e1da006
Update contacts in README
Myhailo Danylenko <isbear@ukrpost.net>
parents:
596
diff
changeset
|
62 |
This fork of loudmouth is lazily maintained by MCabber community, members |
640
abe35c907b20
Fix MUC room address in README
Myhailo Danylenko <isbear@ukrpost.net>
parents:
638
diff
changeset
|
63 |
of which can be found in official mcabber chatroom: <xmpp:mcabber@conf.lilotux.net>. |
638
bdfa8e1da006
Update contacts in README
Myhailo Danylenko <isbear@ukrpost.net>
parents:
596
diff
changeset
|
64 |
|
673
1144e05fdde3
Update README wrt new release
Mikael Berthe <mikael@lilotux.net>
parents:
666
diff
changeset
|
65 |
New releases from the MCabber team are available at |
1144e05fdde3
Update README wrt new release
Mikael Berthe <mikael@lilotux.net>
parents:
666
diff
changeset
|
66 |
<https://mcabber.com/files/loudmouth/> |
1144e05fdde3
Update README wrt new release
Mikael Berthe <mikael@lilotux.net>
parents:
666
diff
changeset
|
67 |
|
638
bdfa8e1da006
Update contacts in README
Myhailo Danylenko <isbear@ukrpost.net>
parents:
596
diff
changeset
|
68 |
Bugs can be also reported (to not lose track of them) to github bugtracker: |
666
685631ef717b
Link to TLS-secured issue tracker at GitHub.
Hanno Heinrichs <hanno.heinrichs@rwth-aachen.de>
parents:
664
diff
changeset
|
69 |
<https://github.com/mcabber/loudmouth/issues> |
638
bdfa8e1da006
Update contacts in README
Myhailo Danylenko <isbear@ukrpost.net>
parents:
596
diff
changeset
|
70 |
|
673
1144e05fdde3
Update README wrt new release
Mikael Berthe <mikael@lilotux.net>
parents:
666
diff
changeset
|
71 |
|
1144e05fdde3
Update README wrt new release
Mikael Berthe <mikael@lilotux.net>
parents:
666
diff
changeset
|
72 |
Official loudmouth project is no more maintained - both |
1144e05fdde3
Update README wrt new release
Mikael Berthe <mikael@lilotux.net>
parents:
666
diff
changeset
|
73 |
<http://projects.imendio.com/loudmouth> and |
1144e05fdde3
Update README wrt new release
Mikael Berthe <mikael@lilotux.net>
parents:
666
diff
changeset
|
74 |
<http://loudmouth-project.org>. |