This directory contains two sets of additional routines for Paul
Hsieh's very nice 'bstring' safe string library for C, as well as a
set of various illustrative and functional programs that demonstrate
their usage.

 All of these pieces are written for Unix (including Mac OS X). Some
of them will still work on other platforms, but you're on your own
there.

 In order to compile them, you will need the bstring package itself,
from
	http://sourceforge.net/projects/bstring/
(I developed against the 'rc16' release.)

 Put it somewhere. Edit the Makefile here to have that location in
BSTRDIR (you will notice that I just put these files into a
subdirectory).

 'make' will make everything.

WHAT IS WHAT:

bstrutil.h
bstrutil.c	some additional utility routines and suchlike that I use.

bstrio.h
bstrio.c	an alternative bstring IO package intended to operate
		on network connections and direct Unix file descriptors.

bstrcat.c	simple test program for bstrio.c.

bsmtp.c		a do-nothing SMTP server, suitable for letting
		spammers connect to so they waste their time and/or
		leave you alone.

btcp.c		'cat', but for networks: 'btcp host port' opens a
		connection to port on host, then copies stdin to it,
		and copies its output to stdout.

		This is a full-scale demonstration of the network IO
		oriented pieces of bstrio.c.

bindlogsplit.c	basic usage of the bstring library to split up query
		logs from our bind daemon and filter them in various
		ways.

		This is a good demonstration of text mangling with
		bstring.


COPYRIGHT

 Uh. GPL or something. I wave my hands.

	- cks, May 2nd 2005.