# $Id: README,v 1.1 2012/10/31 20:17:26 ksb Exp $

Authorization host where we run			Client host (where op runs)
	viz. auth.example.com				viz. joe.example.com

							----------------
							| domain socket |
							----------------
								!
						stampctl -MR auth.example.com
						+ fork for new connection
  tcpmux listens on TCP/1	<--------------- connect to auth.example.com
     ||
  roapmux [options]
     + mk -sl0 -m joe.example.com -d10.5.8.13 my.rev
	+ echo joe.example.com
     				 --- +joe.example.com[\r]\n ->
				<--- ksb:staff:workstation::thing[\r]\n
     ||
     hxmd -G joe.example.c -Csite.cf \
	-D!ROAP_HOST=joe.example.com \
	-D!ROAP_IP=10.5.8.13 \
	-D!ROAP_LOGIN=ksb \
	-D!ROAP_GROUPS=staff \
	-D!ROAP_NETGROUPS=workstation \
	-D!ROAP_QUERY=thing \
	[-Z ... -X ...] \
	"--" generator files.m4
     + generator files.txt	--- +max-connects,timeout,idle[\r]\n
				--- tableau ---------------> read tableau
				[EOF]		<fake being a running stamp>
						<exit when client disconnects>
     [if failed]		--- -hxmd: code\r\n -------> failed message

The tableau stream should have the from:
	+max-connects,timeout,idle[\r]\n
	entry[=value][\r]\n <repeated for each entry>
	"entry=C-like-string"[\r]\n <for enties with ["\n] in them
	[EOF]
or
	-failure message \r\n
max is the max number of connections to accept, which is presently ignored.
end is the number of seconds until we stop emulation of stampctl
idle is the idle timeout (ignored)
Note that the plus header is part of the mux protocol, never put a
comment line before it.  (Since a "#" might be specail to the mux.)

For example:
	+10,600,60\r\n
	ALLOW_HELP\r\n
	ADMIN_LEVEL=3\r\n
	SU=yes\r\n
	# comments\r\n
	CAN_DO_THIS\r\n
	MAY_DO_THAT\r\n
	START_APP_TIGER\r\n

--
ksb, Kevin Braunsdorf, Oct 2012