osf1 man page for evmeventnamematch

Query: evmeventnamematch

OS: osf1

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

EvmEventNameMatch(3)					     Library Functions Manual					      EvmEventNameMatch(3)

NAME
EvmEventNameMatch, EvmEventNameMatchStr - Match event name
LIBRARY
EVM Support Library (libevm.so, libevm.a)
SYNOPSIS
#include <evm/evm.h> EvmStatus_t EvmEventNameMatch( const char *pattern, EvmEvent_t event, EvmBoolean_t *match); EvmStatus_t EvmEventNameMatchStr( const char *pattern, const char *candidate, EvmBoolean_t *match);
OPERANDS
The event name pattern sought. The pattern may be any valid event name string. It may include wildcard characters in place of any compo- nent. The event containing the event name to be compared against the pattern. The result of the match. This parameter is set to EvmTRUE if the name matches the pattern, and to EvmFALSE if it does not. A character string to be matched against the pattern
DESCRIPTION
Because special matching rules apply when deciding whether a candidate event name matches a known name, the EVM name matching functions should be used for matching purposes, rather than the C string comparison functions (memcpm(), strcmp()) . The EVM functions match an event name against a supplied pattern, ignoring any trailing appended components in the candidate name, and correctly matching wildcard characters. The EvmEventNameMatch function takes an event and an event name pattern as input, and returns an indication of whether the event contains a name which matches the pattern in the match output argument. The pattern may be any valid event name string, and may also include wildcard characters in place of any component. A wildcard * in the pattern matches zero or more name components. A ? matches exactly one compo- nent. A match occurs if the event name matches all components indicated by the pattern, even if the name has additional trailing elements. The EvmEventNameMatchStr function performs the same check as EvmEventNameMatch, but takes a character string as the candidate event name, rather than extracting it from a supplied event. Both functions set the match output argument to EvmTRUE if the name matches the pattern, and to EvmFALSE if it does not.
RETURN VALUES
The comparison was successful. The value of the match parameter indicates whether the name matches the pattern. The supplied pattern con- tains invalid characters. The supplied event does not contain a name.
ERRORS
None
FILES
None
SEE ALSO
Routines: memccpy(3), strcat(3) Event Management: EVM(5) EVM Events: EvmEvent(5) Programmer's Guide delim off EvmEventNameMatch(3)
Related Man Pages
evmeventnamematch(3) - hpux
evmeventdestroy(3) - osf1
evmeventnamematchstr(3) - osf1
evmfilterdestroy(3) - osf1
evmfilterisfile(3) - osf1
Similar Topics in the Unix Linux Community
Unix wildcard character question
pattern matching w/ unexpected characters
pattern matching on any special character in Unix
Match first pattern first then extract second pattern match
If pattern in column 3 matches pattern in column 2 (any row), print value in column 1