evmfilterfile(4)					     Kernel Interfaces Manual						  evmfilterfile(4)

NAME

       evmfilterfile - Event Manager filter file

SYNOPSIS

DESCRIPTION

       A  filter file contains one or more filter descriptions, which can be referenced through certain EVM commands by using indirect filter syn-
       tax.  An indirect filter specifier has the following form:

       In the previous indirect filter specifier, filename is the name of a filter file, and filter_name is the name of a filter contained in  the
       file.  If no filter_name is specified, the first filter in the file is used.

       By  convention, filter file names should have the suffix If a command cannot find the file with the name as specified, it appends and tries
       again.

       If a relative pathname is given for a file, commands search for the file in each location specified by the environment variable	if  it	is
       present.  Otherwise the search is performed in the following standard locations in turn, stopping as soon as the file is found:

	      o  The current working directory

	      o

	      o

       Several	supplied  filter  files,  containing  shortcut filters for many system events, can be found in the directory System administrators
       should place site-specific filter files in

       The filter file is made up of a series of keyword/value and keyword/group pairs.  Values containing  spaces  must  be  enclosed	in  double
       quotes.	 Strings  may  be  continued  across  a  newline  by finishing the line with a backslash character.  Any portion of a line from an
       unquoted number sign to the end of line is a comment.  Blank lines are ignored.

       The following keywords are recognized:

       Introduces a filter group.

       Names the filter.

       The		   filter_value is a string that conforms to EVM filter syntax.  See the EvmFilter(5) manpage for information about filter
			   syntax.

       Modifies the current
			   filter_value.  See the description of the and keywords below.

       Modifies the current
			   filter_value.  See the description of the and keywords below.

       The		   filter_title  is  a	text string that describes the purpose of the filter.  The title is not currently used, but always
			   should be included.

       The and keywords can appear multiple times in a filter group, allowing you to build and maintain a filter in simple single-line increments.
       Each  filter_element  must  be  a  valid  filter string, conforming to the syntax described in the EvmFilter(5) manpage.  A complete filter
       string is assembled by surrounding the initial filter with parentheses and appending the filter_elements to it, separating each with a log-
       ical (for or (for operator.  For example:

       The previous filter lines are equivalent to this more complex single filter line:

       The  first  line  selects  all  events with a priority of 200 or greater, the next modifies this by selecting all events from regardless of
       their priorities, and the last line excludes all events regardless of their priorities.

       If you prefer, you can omit the command, and build the complete filter string from and lines.

   Notes
       If you are concerned with allowing your file to be used on other systems that support EVM in the future, you should use the built-in  macro
       in place of the first two components of the name of any system event.  This will make it unnecessary to change the file if the other system
       uses a different event name prefix.

EXTERNAL INFLUENCES

   Environment Variables
       A colon-separated set of directory pathnames to be searched for a requested filter file.  If this variable is present  in  the  environment
       the directories are searched in place of the standard directories.

EXAMPLES

       1. The following is an example of a pair of entries in a filter file:

       2. The following command finds and displays all EVM events, using a filter stored in the supplied filter file

       3. Assuming  that  the filter file shown in the first example is named and is located in a standard filter directory, the following command
	  displays the value of the filter from that file:

FILES

       Site-specific filter files.

       System filter files.

SEE ALSO

   Commands
       evmget(1), evmshow(1), evmwatch(1).

   Routines
       EvmFilterCreate(3), EvmFilterDestroy(3), EvmFilterIsFile(3), EvmFilterReadFile(3), EvmFilterSet(3), EvmFilterTest(3).

   Event Management
       EVM(5).

   EVM Events
       EvmEvent(5).

   Event Filter
       EvmFilter(5).

																  evmfilterfile(4)