PF_PARSERINFO structure

The PF_PARSERINFO structure defines one parser at a time. In the PF_PARSERINFO structure, a parser is defined by the information about the protocol that the parser detects.

Syntax

typedef struct _PF_PARSERINFO {
  char           szProtocolName[MAX_PROTOCOL_NAME_LEN];
  char           szComment[MAX_PROTOCOL_COMMENT_LEN];
  char           szHelpFile[MAX_PATH];
  PPF_FOLLOWSET  pWhoCanPrecedeMe;
  PPF_FOLLOWSET  pWhoCanFollowMe;
  PPF_HANDOFFSET pWhoHandsOffToMe;
  PPF_HANDOFFSET pWhoDoIHandOffTo;
} PF_PARSERINFO, *PPF_PARSERINFO;

Members

szProtocolName

Name of the protocol that the parser detects.

szComment

Brief description of the protocol.

szHelpFile

Name of the protocol Help file, if any.

pWhoCanPrecedeMe

Pointer to a PF_FOLLOWSET structure that lists the protocols that can precede the protocol the PF_PARSERINFO structure describes. Network Monitor adds the parser protocol to the follow set of all the protocols in the set.

pWhoCanFollowMe

Pointer to a PF_FOLLOWSET structure that lists the protocol that can follow the protocol the PF_PARSERINFO structure describes. Network Monitor adds the protocols of the set to the follow set of the parser protocol.

pWhoHandsOffToMe

Pointer to a PF_HANDOFFSET structure that hands-off to the protocol that the PF_PARSERINFO structure describes. Network Monitor adds the parser protocol to the handoff sets of all the protocols in the set.

pWhoDoIHandOffTo

Pointer to a PF_HANDOFFSET structure that lists the protocols that the parser protocol hands off to. Network Monitor adds the protocols of this set to the handoff set of the parser protocol.

Remarks

The PF_PARSERINFO structure is used in the PF_PARSERDLLINFO structure to provide a description of a parser. Network Monitor uses the parser description to update the Parser.ini file, and the INI files of the parsers that precede and follow the protocol described in the PF_PARSERINFO structure.

A follow set specifies the protocols that follow a protocol. Network Monitor uses a follow set when the parser cannot identify the next protocol from the data in a protocol instance. A follow set is stored in the Parser.ini file. When the parser is installed for the first time, Network Monitor updates the follow set of the parser protocols that are listed in pWhoCanPrecedeMe and pWhoCanFollowMe.

A handoff set specifies the protocols that follow a protocol. The parser uses a handoff set only when the parser can identify the next protocol from the data in a protocol instance. A handoff set is stored in the INI files of each parser. When the parser is installed for the first time, Network Monitor updates the handoff set of the parser protocols that are listed in pWhoHandsOffToMe and pWhoDoIHandOffTo.

Requirements

See also

ParserAutoInstallInfo

PF_FOLLOWSET

PF_HANDOFFSET

PF_PARSERDLLINFO