This is source code to CASL (Custom Audit Scripting Language)

Copyright 1998 Secure Networks, Inc.
Copyright 1999 Network Associates, Inc.
All Rights Reserved

BEFORE YOU INSTALL, USE, OR MODIFY THIS SOFTWARE PRODUCT,
CAREFULLY READ THE TERMS AND CONDITIONS IN THE FILE
"LICENSE.TXT" ACCOMPANYING THIS DOCUMENT. IF THE FILE
"LICENSE.TXT" IS MISSING, IT MAY BE OBTAINED FROM
NETWORK ASSOCIATES. NETWORK ASSOCIATES IS PERMITTING
THE USE, DISTRIBUTION, AND LIMITED MODIFICATION OF THIS
SOFTWARE PRODUCT ON A NON-COMMERCIAL BASIS SUBJECT TO
ALL OF THE CONDITIONS IN THE FILE "LICENSE.TXT." BY INSTALLING,
USING, OR MODIFYING THE SOFTWARE PRODUCT, YOU AND ANY
SUBSEQUENT USER ARE AGREEING TO BE BOUND BY ALL OF THE
TERMS AND CONDITIONS IN THE FILE "LICENSE.TXT." IF YOU DO
NOT AGREE TO ALL OF THOSE TERMS AND CONDITIONS, DO NOT
INSTALL, USE, OR MODIFY THIS SOFTWARE PRODUCT.

___________________
WHAT'S IN THIS FILE

- Included Files
- Building CASL
- Porting

______________
INCLUDED FILES

The source distribution includes the following files and directories.

README			This file.
LICENSE.TXT		Important license information.
Makefile, arch.mk	Build instructions for make.
make_dist.sh		Shell script to make a binary package of CASL.
*.c, *.y, *.l		Core CASL files.
lib/*			Various non-CASL related code.
cape/*			Files related to network IO.
misc-builtins/*		Specific components of CASL besides network IO.
include/*		Header files required to compile CASL.
build/*			Directory where the produced executables will go.
gnu-cpp/*		Source code to the GNU C Preprocessor.
casl-basedir/*		Files to be included in a CASL binary package.
text/*			Text files to be included in a CASL binary package.
os/*			OS dependent code.
libpcap-0.4/*		LBL libpcap 0.4, patched with pcap_write.
text/libpcap-0.4.diff	Patch applied to libpcap 0.4.

_____________
BUILDING CASL

This distribution of CASL includes all the source code needed to
compile and use CASL.  To compile CASL on a RedHat 5.x system,
simply go to the casl-2.0-src directory and type:

	make

Other operating systems will need modifications to work right.  Once
the compile has completed successfully, type:

	sh make_dist.sh

Follow the prompts and a directory will be created with a binary
distribution inside it.  This can be used in place, or installed with
the included "install.sh" file following the regular install
instructions.

_______
PORTING

The CASL language itself is completely platform independent.  However, the
interpreter is not so lucky, since it has to be written in C.  To bring
CASL to a new platform a few requirements must be met.

 - The OS dependent parts of CASL must be written for the new platform.
This includes os/<os>/arp.c to perform ARP requests, and os/<os>/ostab.c
to perform various functions on the network tables the kernel keeps.

 - The OS must have a port of libpcap available.  In addition, pcap_write
will need to be written for the OS.

Once these requirements are met, most of the rest of the CASL code will
compile with little to no changes to the code or Makefile on most
platforms.
