Debian Codegraph @

agent/mibgroup/disman/event/mteTrigger.h

raw
1 #ifndef MTETRIGGER_H
2 #define MTETRIGGER_H
3
4 extern oid _sysUpTime_instance[];
5 extern size_t _sysUpTime_inst_len;
6 /*
7 * Flags relating to the mteTriggerTable and related tables
8 */
9 #define MTE_TRIGGER_FLAG_DELTA 0x01 /* for mteTriggerSampleType */
10 #define MTE_TRIGGER_FLAG_VWILD 0x02 /* for mteTriggerValueIDWildcard */
11 #define MTE_TRIGGER_FLAG_CWILD 0x04 /* for mteTriggerContextWildcard */
12 #define MTE_TRIGGER_FLAG_DWILD 0x08 /* for mteTriggerDeltaDIDWildcard */
13 #define MTE_TRIGGER_FLAG_SYSUPT 0x10 /* using default mteTriggerDeltaID */
14
15 #define MTE_TRIGGER_FLAG_BSTART 0x20 /* for mteTriggerBooleanStartup */
16
17 #define MTE_TRIGGER_FLAG_ENABLED 0x0100 /* for mteTriggerEnabled */
18 #define MTE_TRIGGER_FLAG_ACTIVE 0x0200 /* for mteTriggerEntryStatus */
19 #define MTE_TRIGGER_FLAG_FIXED 0x0400 /* for snmpd.conf persistence */
20 #define MTE_TRIGGER_FLAG_VALID 0x0800 /* for row creation/undo */
21
22
23 /*
24 * Values for the mteTriggerTest field
25 */
26 #define MTE_TRIGGER_EXISTENCE 0x80 /* mteTriggerTest values */
27 #define MTE_TRIGGER_BOOLEAN 0x40
28 #define MTE_TRIGGER_THRESHOLD 0x20
29
30 /*
31 * Values for the mteTriggerSampleType field
32 */
33 #define MTE_SAMPLE_ABSOLUTE 1 /* mteTriggerSampleType values */
34 #define MTE_SAMPLE_DELTA 2
35
36 /*
37 * Values for the mteTriggerDeltaDiscontinuityIDType field
38 */
39 #define MTE_DELTAD_TTICKS 1
40 #define MTE_DELTAD_TSTAMP 2
41 #define MTE_DELTAD_DATETIME 3
42
43 /*
44 * Values for the mteTriggerExistenceTest
45 * and mteTriggerExistenceStartup fields
46 */
47 #define MTE_EXIST_PRESENT 0x80
48 #define MTE_EXIST_ABSENT 0x40
49 #define MTE_EXIST_CHANGED 0x20
50
51 /*
52 * Values for the mteTriggerBooleanComparison field
53 */
54 #define MTE_BOOL_UNEQUAL 1
55 #define MTE_BOOL_EQUAL 2
56 #define MTE_BOOL_LESS 3
57 #define MTE_BOOL_LESSEQUAL 4
58 #define MTE_BOOL_GREATER 5
59 #define MTE_BOOL_GREATEREQUAL 6
60
61 /*
62 * Values for the mteTriggerThresholdStartup field
63 */
64 #define MTE_THRESH_START_RISE 1
65 #define MTE_THRESH_START_FALL 2
66 #define MTE_THRESH_START_RISEFALL 3
67 /* Note that RISE and FALL values can be used for bit-wise
68 tests as well, since RISEFALL = RISE | FALL */
69
70
71 /*
72 * Flags to indicate which triggers are armed, and ready to fire.
73 */
74 #define MTE_ARMED_TH_RISE 0x01
75 #define MTE_ARMED_TH_FALL 0x02
76 #define MTE_ARMED_TH_DRISE 0x04
77 #define MTE_ARMED_TH_DFALL 0x08
78 #define MTE_ARMED_BOOLEAN 0x10
79 #define MTE_ARMED_ALL 0x1f
80
81 /*
82 * All Event-MIB OCTET STRING objects are either short (32-character)
83 * tags, or SnmpAdminString/similar values (i.e. 255 characters)
84 */
85 #define MTE_STR1_LEN 32
86 #define MTE_STR2_LEN 255
87
88 /*
89 * Data structure for a (combined) trigger row. Covers delta samples,
90 * and all types (Existence, Boolean and Threshold) of trigger.
91 */
92 struct mteTrigger {
93 /*
94 * Index values
95 */
96 char mteOwner[MTE_STR1_LEN+1];
97 char mteTName[MTE_STR1_LEN+1];
98
99 /*
100 * Column values for the main mteTriggerTable
101 */
102 char mteTriggerComment[MTE_STR2_LEN+1];
103 char mteTriggerTest;
104 oid mteTriggerValueID[MAX_OID_LEN];
105 size_t mteTriggerValueID_len;
106 char mteTriggerTarget[ MTE_STR2_LEN+1];
107 char mteTriggerContext[MTE_STR2_LEN+1];
108 u_long mteTriggerFrequency;
109 char mteTriggerOOwner[ MTE_STR1_LEN+1];
110 char mteTriggerObjects[MTE_STR1_LEN+1];
111
112 netsnmp_session *session;
113 long flags;
114
115 /*
116 * Column values for the mteTriggerDeltaTable
117 */
118 oid mteDeltaDiscontID[MAX_OID_LEN];
119 size_t mteDeltaDiscontID_len;
120 long mteDeltaDiscontIDType;
121
122 /*
123 * Column values for Existence tests (mteTriggerExistenceTable)
124 */
125 u_char mteTExTest;
126 u_char mteTExStartup;
127 char mteTExObjOwner[MTE_STR1_LEN+1];
128 char mteTExObjects[ MTE_STR1_LEN+1];
129 char mteTExEvOwner[ MTE_STR1_LEN+1];
130 char mteTExEvent[ MTE_STR1_LEN+1];
131
132 /*
133 * Column values for Boolean tests (mteTriggerBooleanTable)
134 */
135 long mteTBoolComparison;
136 long mteTBoolValue;
137 char mteTBoolObjOwner[MTE_STR1_LEN+1];
138 char mteTBoolObjects[ MTE_STR1_LEN+1];
139 char mteTBoolEvOwner[ MTE_STR1_LEN+1];
140 char mteTBoolEvent[ MTE_STR1_LEN+1];
141
142 /*
143 * Column values for Threshold tests (mteTriggerThresholdTable)
144 */
145 long mteTThStartup;
146 long mteTThRiseValue;
147 long mteTThFallValue;
148 long mteTThDRiseValue;
149 long mteTThDFallValue;
150 char mteTThObjOwner[ MTE_STR1_LEN+1];
151 char mteTThObjects[ MTE_STR1_LEN+1];
152 char mteTThRiseOwner[ MTE_STR1_LEN+1];
153 char mteTThRiseEvent[ MTE_STR1_LEN+1];
154 char mteTThFallOwner[ MTE_STR1_LEN+1];
155 char mteTThFallEvent[ MTE_STR1_LEN+1];
156 char mteTThDRiseOwner[MTE_STR1_LEN+1];
157 char mteTThDRiseEvent[MTE_STR1_LEN+1];
158 char mteTThDFallOwner[MTE_STR1_LEN+1];
159 char mteTThDFallEvent[MTE_STR1_LEN+1];
160
161 /*
162 * Additional fields for operation of the Trigger tables:
163 * monitoring...
164 */
165 unsigned int alarm;
166 long sysUpTime;
167 netsnmp_variable_list *old_results;
168 netsnmp_variable_list *old_deltaDs;
169
170 /*
171 * ... stats...
172 */
173 long count;
174
175 /*
176 * ... and firing.
177 */
178 char *mteTriggerXOwner;
179 char *mteTriggerXObjects;
180 netsnmp_variable_list *mteTriggerFired;
181 };
182
183 /*
184 * Container structure for the (combined) mteTrigger*Tables,
185 * and routine to create this.
186 */
187 extern long mteTriggerFailures;
188 extern netsnmp_tdata *trigger_table_data;
189 extern void init_trigger_table_data(void);
190
191 void init_mteTrigger(void);
192 void mteTrigger_removeEntry(netsnmp_tdata_row *row);
193 netsnmp_tdata_row *mteTrigger_createEntry(const char *mteOwner,
194 char *mteTriggerName, int fixed);
195 void mteTrigger_enable( struct mteTrigger *entry );
196 void mteTrigger_disable( struct mteTrigger *entry );
197
198 long mteTrigger_getNumEntries(int max);
199
200 #endif /* MTETRIGGER_H */