--------------------------------------------------
BIG BROTHER PORTING INFORMATION
Sean MacGuire
Version 1.9b
May 01st, 2002

(c) Copyright Quest Software, Inc.  1997-2002  All rights reserved.
--------------------------------------------------

1.	Look at the Makefile...

2.	Type "make"

	If there are complaints that "bzero" is undefined, edit the
	Makefile, add -DZERO to the CFLAGS and try again.

	*** NOTE ***

	bbnet.c is new, and may not port immediately.  Please send
	and changes back to me...

--------------------------------------------------
Testing the port
--------------------------------------------------

1. 	Set up the environment:
	The environment variable BBHOME must be defined.  It's where
	all this stuff was installed (top level).
		sh: 	BBHOME="/home/sean/bb"; export BBHOME
		csh:	setenv BBHOME "/home/sean/bb"

2.	Try running bbd.  It should exit immediately and the daemon 
	should be up and running.

3.	Now make sure that the log directory exists (it should already).
	The log directory is $BBLOGS (usually in $BBVAR/logs or
	$BBHOME/../bbvar/logs)

4.	Run bb by hand as follows:
		bb <IP-ADDRESS-OF-MACHINE> "status test.test green hello world"

	This should create the file test.test in the BBLOG directory containing
	the phrase "hello world".  Note the quotes are mandatory!

5.	Check for zombie processes. 
		ps -ef | grep bbd       on System V derived machines
		ps -ef | grep defunct   on DEC Unix (OSF/1)
		ps -lax | grep bbd      on BSD-type machines
		ps -lax | grep exiting  on DEC Ultrix


	There should be only one bbd process.  If there is more than one,
	edit the Makefile and add -DZOMBIE to CFLAGS and compile again.
	This is known to occur on FreeBSD machines.

	(On Ultrix check for processes marked <exiting> with the bbd process
	as parent process. On DEC Unix (OSF/1) check for processes marked
	<defunct> with the bbd process as parent process.)

6.	If it doesn't work, then in src/Makefile , add the -DDEBUG=1
	compiler directive to the CFLAGS entry. Run a "make clean",
	"make bbd" and finally copy bbd to bin/.  When you'll
	restart BB, debug output will be sent to BBOUT.
	
7.	If all of this works, then install it by typing:
		make install

8.	Now configure Big Brother for your system.  Two things need
	to be done:

		edit the runbb.sh and define where BBHOME is and
		modify etc/bb-hosts.

	Please refer to the Web page for the most up-to-date information.

9.	Compile directives
	-DREGEXEC, -DREGEX, -DREXEC - Regular expression constructs
		REGEXEC - if the OS supports regexec()
		REGEX - support for regex()
		RE_EXEC - support for re_exec()
		Check you man pages for the one support by your OS.

	-DZOMBIE - If your platform gets bbd zombie processes

	-DBZERO - If your OS doesn't have a bzero() call

	-DDEBUG - Enables debug tracing

	-DSIGSETJMP - Fixes some setjmp() problems under RedHat

	-DTIMEH - Use time.h instead of sys/time.h

	-DGETTIMEOFDAY - The OS supports gettimeofday() and
				you want timing stats.
