Writing Monitors for the Event Monitoring Service (December 1999)

6
Contents
Function Prototype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Returned Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Usage Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
3. Creating a Resource Monitor
Implementing a Resource Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Writing the Monitor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Resource Monitor Minimums. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Man Page Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Log File Recommendations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Startup and Initialization Considerations. . . . . . . . . . . . . . . . . . . . . . 63
Registrar Considerations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
File Descriptor Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Environment Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Terminal Considerations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Monitor Info Object Considerations . . . . . . . . . . . . . . . . . . . . . . . . . 65
Sample Code. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Defining the Resource Dictionary Hierarchy . . . . . . . . . . . . . . . . . . . . . 69
Resource Discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
File Naming. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Wildcarding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Resource Dictionary Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Naming Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Default Resource Dictionary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Processing a Subclass Request Event. . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Replying to Subclass Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Subclass Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Sample Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86