##
#§ libmsgque - README
#§
#§ (C) 2007 - LibMsgque - Project - Group
#§ ------------------------------------------------------
#§ EMail: aotto1968 at users.sourceforge.net
#§ ------------------------------------------------------
#§ this software has GPL permissions to copy
#§ please contact AUTHORS for additional information
#§
libmsgque overview
==================
The msgque project is an infrastructure to link applications together
to act like a single application. To link mean distributing work from
one application to an other application an wait or not wait for an
answer.
The linking is done using unix or inet domain sockets and is based on
packages send from one application to an other application and back.
The libmsgque project is used to handle all the different aspects for
setup and maintain the link and is responsible for:
* starting and stopping the different applications
* starting and stopping the communication interface
* sending and receiving packages
* reading and writing data from or into packages
* setup and maintain the event-handling for asynchronous transfers
* propagate warnings or errors
build the project
=================
The project is setup using the GNU project environment including:
> automake, autoconf, libtool ...
please refer to INSTALL for the steps to build the software
the next steps
==============
The project provides a dynamic/static library ready for linking
into your software and a tcl software package.
To get an overview about the API and the additional tools please
refer to the HTML documentation:
> make doxygen-doc
> firefox doxygen-doc/html/index.html
To step into with the library the 'acmds' are a good starting point:
> firefox doxygen-doc/html/overview.html
> cd acmds
example:
scan /etc/passwd for user-name, user-id and group-id, sort for
user-id and format for output:
> cat /etc/passwd | asplit -d ":" @ asort -2 I @ \
acut -f 0,2,3 @ ajoin -d ' | ' -0 "%-15s" -1 "%-5i" -2 "%-5i"
