This package contains event-logging templates for the following drivers:

1. e100 (Ethernet)
2. emulex (lpfc fiber channel driver)
3. ipr (SCSI)
4. bcm5700 (Broadcom ethernet)
5. e1000 (Ethernet)
6. pcnet32 (Ethernet)
7. olympic (Token-ring)

Prerequisites
-------------
To build the templates, you need:
- evlog-1.6.0

To use the installed templates, you need to do the following:
- The kernel should be patched with the following kernel patches:
        - evlog-2.6.x.patch (basic evlog capabilities)
        - dev_evlog-2.6.x.patch (makes the dev_printk macro log to evlog
           as well as printk)
- In the *config menu system, under General Setup, the options
   "Event logging support" and "Forward printk messages to event log"
   should be enabled.

Installation
------------

1. Change to the driver directory and then run 'make'.  make creates binary
   templates (with the *.to extension) and (for some drivers) puts them
   in a subdirectory.  It also creates one or more 'ela rules' files
   (with .rules extension).  For example:

	cd templates/ipr
	make

   Note: If make fails with a message such as "Unknown facility", then you need
	to use 'evlfacility -a <facility name>' to register the facility.

2. As root,

	make install


3. The ela rules files are also created by make.  (In this example, the
   ipr_main.rules and ipr_sub.rules are created.)  One can load the ela
   rules using the ela_add utility (as root).

	/usr/sbin/ela_add -f ipr_main.rules
	/usr/sbin/ela_add -f ipr_sub.rules

4. Note that the ela rules need to be reloaded after each system reboot. One
   can reload the ela rules automatically with a startup script, as follows.
  (This script must be run as root.)

	a) Make the ela_rules directory:
	   mkdir -p /var/lib/evlog/ela_rules

	b) Copy in the desired rules that you created above in steps 1 and 2.

	c) Create a simple script to load those rules -- for example:

	#!/bin/sh
	/usr/sbin/ela_add -f /var/lib/evlog/ela_rules/ipr_main.rules
	/usr/sbin/ela_add -f /var/lib/evlog/ela_rules/ipr_sub.rules

	Save the script to /usr/share/evlog/load_ela_rules.sh
	
	chmod +x /usr/share/evlog/load_ela_rules.sh

	d) This load_ela_rules.sh script should be executed right after
	   evlactiond is started.  Under SLES9, evlactiond is started
	   with the evlog startup script.  Simply add this near the
	   end of the start section:

		if [ "$daemon" = "evlactiond" ]; then
			/usr/share/evlog/load_ela_rules.sh
		fi

 
