File	Date	Author	Commit
doc	2007-03-19	nhumfrey	[7510ab] Improved/updated README file and ChangeLog.
examples	2007-03-09	nhumfrey	[3fb507] Unlink Unix server socket when it is close (tha...
lo	2007-03-09	nhumfrey	[b8e4d9] Changed lo_blob_new() to take const void* (than...
src	2007-03-13	nhumfrey	[097183] Bug fix for pattern matching
AUTHORS	2007-03-15	nhumfrey	[0b8642] Removed Steve's email address as he is no-longe...
COPYING	2004-08-07	theno23	[e68bc5] Initial revision
ChangeLog	2007-03-19	nhumfrey	[7510ab] Improved/updated README file and ChangeLog.
INSTALL	2004-08-07	theno23	[e68bc5] Initial revision
Makefile.am	2005-03-31	theno23	[3e4511] 2005-03-31 Steve Harris <steve@...>
NEWS	2004-08-07	theno23	[e68bc5] Initial revision
README	2007-03-19	nhumfrey	[7510ab] Improved/updated README file and ChangeLog.
TODO	2005-08-19	theno23	[5d64a7] 2005-08-19 Steve Harris <steve@...>
autogen.sh	2006-05-23	nhumfrey	[84ad86] Removed superfluous things from autogen.sh and ...
configure.ac	2007-03-19	nhumfrey	[7510ab] Improved/updated README file and ChangeLog.
liblo.pc.in	2007-03-09	nhumfrey	[b34c90] Changed @VERSION@ to @PACKAGE_VERSION@

Read Me

liblo is a lightweight library that provides an easy to use implementation of
the OSC protocol. For more information about the OSC protocol, please see:

- http://www.cnmat.berkeley.edu/OpenSoundControl/
- http://www.opensoundcontrol.org/


The official liblo homepage is here:

- http://liblo.sourceforge.net/

liblo is portable to most UNIX systems (including OS X) and Windows. It is
released under the GNU General Public Licence (GPL).


---


To build and install liblo, read INSTALL in the main liblo directory.
liblo is configured as a dynamically-linked library. To use liblo
in a new application, you should install liblo with "make install"
so that the liblo library can be located by your application.

See examples for example source code for a simple client and two
servers:

 - example_server.c uses lo_server_thread_start() to create
a liblo server in an separate thread.

 - nonblocking_server_example.c uses select() to wait for either
console input or OSC messages, all in a single thread.

 - example_client.c uses liblo to send OSC messages to a server.

These examples will work without installing liblo. This is accomplished by a shell script. For example, examples/client_example is a shell
script that runs the "real" program examples/.libs/example_client.
Because of this indirection, you cannot run example_client with
a debugger.

To debug applications using liblo, one option is to include all the liblo source code in the application rather than linking with the liblo library. For more information about this, please see the libtool's manual:

http://www.gnu.org/software/libtool/manual.html#Debugging-executables


---


IPv6 NOTICE:
liblo was written to support both IPv4 and IPv6, however it has caused various problems along the way because most of the currently available OSC applications
like Pd and SuperCollider doesn't listen on ipv6 sockets. IPv6 is currently disabled by default, but you can enable it using ./configure --enable-ipv6