Merge branch 'master' of github.com:otcshare/murphy

Merge branch 'documentation'

sample-config: minor commenting.

transport: consolidated IP{v4,v6}/unix transports to {stream,dgram}-transpor

The recognized address prefixes are now tcp4, tcp6, udp4, udp6, unxstrm,
and unxdgrm. If you omit the type-specifier prefix, the address resolver
code will try to figure out the type based on the address itself ('[',
']', '@', '/'). However, a prefix specifies both the address family and
the connection-oriented vs. connectionlessness of the transport. The
resolver cannot guess which one you want if you omit the prefix and you
will always end up with connection-oriented transports in this case (as
these are registered before the datagram ones).

If you are careless and try to use prefixless string addresses for datagram
transports, you will get quite difficult to understand errors (as you end
up polling an unconnected, unlistened socket for readability).

One way to get around this would be to change the API so that
  - only the address family is passed to the address resolver
  - the socket type (dgram/stream) is passed to the transport creation

Although, this would be a more natural abstraction... maybe another day.

console: for the sake of testing, a UDP-capable console/console-client.

No, it does not need to always make sense... I just wanted to check how
big chunk of code you need to write in addition to handling the connection-
oriented/connectionless differences.

common/transport: some minor API cleanup, saner address resolving

There's plenty of things to write and clean up in the transport layer.
For a starter,

1) The message API is not sane. Fields should be tagged by integers
   and not strings. It was a quick hack just to test the transports.
   The basic encoder/decoder needs to be changed to an integer-tagged,
   typed, TLV.

2) We also need unix-domain stream and dgram transports, maybe also IPv6
   TCP and UDP transports. Once we have those, it'd make sense to combine
   (or otherwise consolidate) the connection-oriented and connectionless
   transport code as largely they would end up being identical anyway...
   So IOW IPv4/v6 UDP, unix-domain dgram would share a large part of
   their code, and similarly IPv4/v6 TCP and unix-domain stream would
   share a large part of their code.

3) We need to write a DBUS transport to check if the current abstraction
   is generic enough (or rather how far it is from being generic enough
   and fix any remaining diffs).

4) While we're at it, an SHM-based transport wouldn't hurt either...

documentation-tools: eliminating/supressing some garbage prints

documentation-tools: doxygen automatic dependency generation

Some primitive doxygen depency generation added. Based on the doxygen
configuration file we try to guess the .h.c dependencies. However,
doxygen can have directories + patterns in which case we are living
on our wild guesses how doxygen finds the dependencies that are
not in the same directory.

MRP_DOCINIT autoconf macro was also introduced to initiate the
documentation building

documentation: oops, this Makefile.am was forgotten

documentation: plugin-developer-guide content update

documentation-tools: doc-tools finalized + makefiles

* plugin developer guide can be generated
* faking shavings and hiding the flood of doc-toolchain garbage
* manual dependencies (automatic dependency generation will be
  the next big step)

documentation-tools: fixing doxml2db to open the output file for writing

documentation: some doxygen comments were added

some initial doxygen comments were added to be able to test the documentation
toolchain

documentation-tools: doxml2db.py introduced

doxml2db.py is to convert doxml files into docbook fragments
ie. chapters or sections. These chapters or sections in turn can be included
to the main docbook.

tcp-transport: update leftover misleading comment.

sample config: load two instances of test for command testing.

daemon/config: kludge for partial-line comment support.

common,core: support automatic console command registration for plugins

common/transport: address is const for resolve.

common: receive-side buffering fixes, added tcp_resolve.

common: added a UDP transport to check if the abstraction is generic enough.

common: preliminary resolve and bind support for transport layer.

murphy.conf: try-load the console plugin in the sample config file.

plugins-test: added a few commands for console testing.

Added murphy-console, a client for the TCP console (plugin).

plugins: added a TCP-transport based console plugin.

common,core: include msg,transport,console to the convenience headers.

core: added core console infra, a few basic commands for test.

common: added a TCP transport implementation.

common: added generic transport layer.

common: added msg.[hc], a (preliminary) message interface for transports.

daemon: fix stupid array sizing thinko.

common: comment type fix.

build: removed a bunch commented out conditionals.

mainloop: handle more gracefully if fd is closed before delete_io_watch.

EPOLL_CTL_DEL sets errno to ENOENT if w->fd is closed (by the user)
after mrp_del_io_watch is called but before delete_io_watch gets around
to purge the watch and update our epoll bookkeeping. Don't treat this as
an error and avoid printing an error message.

common: changed realloc macro to preserve ptr upon failure akin to reallocz.

daemon: potentially uninitialized var. fix.

common: fix calloc-like macro to set memory to zero.

common: added mrp_datadup.

common: fix copy-paste typo in pkg-config file.

common: fix incorrect include paths in log.[hc].

murphy-db: make pkg-config link also against the base library.

documentation: dblyxfix.py is now filtering <dummy> tags

documentation: fixing some bugs to get the first version work

documentation: make clean will delete the copied svg files

documentation: first version of document generation

* pdf generation
* no doxygen support yet

murphy-db: some cosmetic changes in mql-scanner.l

Some of the regexp's in mql-scanner.l got a facelift in order to produce
prettier ABNF description using abnf.py

murphy: abnf.py script now uses both the flex and bison file to generate ABNF

* flex support added for the automatic document generation, ie. ABNF is
  generated from the regexp's in the definition section
* more correct ABNF description is generated
* the output is directly includable into DocBook xml file

build: shave linker script generation.

common,core: added top-level convenience include files.

mainloop-test: enable logging.

mainloop: I/O watch removal fix (thinko + incorrect EPOLL_CTL_DEL).

mainloop: fix I/O watch HUP processing.

(e)poll uses (E)POLLRDHUP for input direction close/shutdown. The event
enum now has HUP for (POLLHUP|POLLRDHUP).  RDHUP and WRHUP has been added
for POLLRDHUP and POLLHUP, respectively. Let's see if this will confuse
people...

build: don't PKG_CHECK for dbus-glib.

build: glib plugin needs glib, not dbus-glib.

daemon: updated test config.

build: generate/use linker scripts for murphy-db.

build: clean up built linker-scripts during clean.

build: linker-script generator pattern argument handling fix.

shave: add support for lex/flex and yacc/bison.

murphy-db: mql syntax documentation

First incarnation of the abnf.py which produces the grammar description
directly from mql-scanner.l and mql-parser.y. The lexer regexp's are not
translated to ABNF yet.

murphy-db: mql transaction support

Use of transaction names (eg. BEGIN foo; COMMIT foo; etc)
precompiled transaction statements (begin, commit and rollback).

murphy-db: rest of mql transaction create routines

Test cases for string results only, ie. event result based
test cases are missing.

murphy-db: triggers introduced

mqi is fairily completei.
mql is just to see how the API will look like (only column change works)
cosmetic changes to confirm the agreed coding style (mostly typedef stuff).

murphy-db: pkg-config support for murphy-db

murphy-db: cleanup the include file names and dependencies

murphy-db: initial commit of the MurphyDB

build: install .pc files & non-existing docs, honour libdir for plugins.

Generate and install pkgconfig files. Honour ${libdir} in the default
plugin directory and make ${libdir} available also as a macro. Install
(the non-existing) documentation.

plugins: add some of the missing functionality (plugin metadata, checks)

Added plugin and API versioning, singletons, author et al metadata,
API version check and singletonnes check. Started adding plugin states.

common: a simple directory scanning routine.

plugins: don't hardcode 'plugin-' prefix twice.

plugins: added basic support for plugin arguments.

common: more pedantic array allocation macros.

core: don't log low-level load errors for non-existing plugins.

build: added brindging Makefiles to common, core, daemon and plugins.

daemon: unified config directive handling, added info/warning/error directives.

doc: added author info and coding style guide.

build: removed unused Makefile.am's.

daemon: added a config file for testing the parser.

plugins: added glib plugin.

plugins: added dbus core plugin.

plugins: a primitive plugin to test the loading/unloading infra.

daemon: skeleton of the daemon, config parsing.

common: added utils for misc. routines (currently just daemonization).

core: initial parts of the murphy plugin implementation.

core: added murphy context.

common/tests: ad-hoc mainloop test, with a GLIB and a DBUS pumps.

common/tests: added and ad-hoc hash table test.

common/tests: added and ad-hoc memory management test.

common: first implementation of the murphy mainloop.

common: added a simple hash table implementation.

common: added a simple memory management wrapper/module

By default, it passes calls through to malloc et al. If run in
debugging mode (by setting the __MURPHY_MM_CONFIG=debug) the
module keeps track of memory allocations, and can be used to
detect and report memory leaks.

The same memory management module currently also provides a page-
based object pool implementation.

common: added a simple logging implementation.

common: added a simple doubly-linked list implementation.

common: added some commonly used macros.

Skeleton repo.