snmp_core.cc
Go to the documentation of this file.
1 /*
2  * Copyright (C) 1996-2025 The Squid Software Foundation and contributors
3  *
4  * Squid software is distributed under GPLv2+ license and includes
5  * contributions from numerous individuals and organizations.
6  * Please see the COPYING and CONTRIBUTORS files for details.
7  */
8 
9 /* DEBUG: section 49 SNMP support */
10 
11 #include "squid.h"
12 #include "acl/FilledChecklist.h"
13 #include "base/AsyncCallbacks.h"
14 #include "base/CbcPointer.h"
15 #include "base/RunnersRegistry.h"
16 #include "CachePeer.h"
17 #include "CachePeers.h"
18 #include "client_db.h"
19 #include "comm.h"
20 #include "comm/Connection.h"
21 #include "comm/Loops.h"
22 #include "fatal.h"
23 #include "ip/Address.h"
24 #include "ip/tools.h"
25 #include "ipc/StartListening.h"
26 #include "snmp/Forwarder.h"
27 #include "snmp_agent.h"
28 #include "snmp_core.h"
29 #include "SnmpRequest.h"
30 #include "SquidConfig.h"
31 #include "SquidMath.h"
32 #include "tools.h"
33 
34 static void snmpPortOpened(Ipc::StartListeningAnswer&);
35 
36 mib_tree_entry *mib_tree_head;
37 mib_tree_entry *mib_tree_last;
38 
39 Comm::ConnectionPointer snmpIncomingConn;
40 Comm::ConnectionPointer snmpOutgoingConn;
41 
42 static mib_tree_entry * snmpAddNodeStr(const char *base_str, int o, oid_ParseFn * parsefunction, instance_Fn * instancefunction, AggrType aggrType = atNone);
43 static mib_tree_entry *snmpAddNode(oid * name, int len, oid_ParseFn * parsefunction, instance_Fn * instancefunction, AggrType aggrType, int children,...);
44 static oid *snmpCreateOid(int length,...);
45 mib_tree_entry * snmpLookupNodeStr(mib_tree_entry *entry, const char *str);
46 bool snmpCreateOidFromStr(const char *str, oid **name, int *nl);
47 SQUIDCEXTERN void (*snmplib_debug_hook) (int, char *);
48 static oid *static_Inst(oid * name, snint * len, mib_tree_entry * current, oid_ParseFn ** Fn);
49 static oid *time_Inst(oid * name, snint * len, mib_tree_entry * current, oid_ParseFn ** Fn);
50 static oid *peer_Inst(oid * name, snint * len, mib_tree_entry * current, oid_ParseFn ** Fn);
51 static oid *client_Inst(oid * name, snint * len, mib_tree_entry * current, oid_ParseFn ** Fn);
52 static void snmpDecodePacket(SnmpRequest * rq);
53 static void snmpConstructReponse(SnmpRequest * rq);
54 
55 static oid_ParseFn *snmpTreeNext(oid * Current, snint CurrentLen, oid ** Next, snint * NextLen);
56 static oid_ParseFn *snmpTreeGet(oid * Current, snint CurrentLen);
57 static mib_tree_entry *snmpTreeEntry(oid entry, snint len, mib_tree_entry * current);
58 static mib_tree_entry *snmpTreeSiblingEntry(oid entry, snint len, mib_tree_entry * current);
59 extern "C" void snmpSnmplibDebug(int lvl, char *buf);
60 
61 /*
62  * Turns the MIB into a Tree structure. Called during the startup process.
63  */
64 static void
65 snmpInit()
66 {
67  if (!IamWorkerProcess())
68  return;
69 
70  debugs(49, 5, "snmpInit: Building SNMP mib tree structure");
71 
72  snmplib_debug_hook = snmpSnmplibDebug;
73 
74  /*
75  * This following bit of evil is to get the final node in the "squid" mib
76  * without having a "search" function. A search function should be written
77  * to make this and the other code much less evil.
78  */
79  mib_tree_head = snmpAddNode(snmpCreateOid(1, 1), 1, nullptr, nullptr, atNone, 0);
80 
81  assert(mib_tree_head);
82  debugs(49, 5, "snmpInit: root is " << mib_tree_head);
83  snmpAddNodeStr("1", 3, nullptr, nullptr);
84 
85  snmpAddNodeStr("1.3", 6, nullptr, nullptr);
86 
87  snmpAddNodeStr("1.3.6", 1, nullptr, nullptr);
88  snmpAddNodeStr("1.3.6.1", 4, nullptr, nullptr);
89  snmpAddNodeStr("1.3.6.1.4", 1, nullptr, nullptr);
90  snmpAddNodeStr("1.3.6.1.4.1", 3495, nullptr, nullptr);
91  mib_tree_entry *m2 = snmpAddNodeStr("1.3.6.1.4.1.3495", 1, nullptr, nullptr);
92 
93  mib_tree_entry *n = snmpLookupNodeStr(nullptr, "1.3.6.1.4.1.3495.1");
94  assert(m2 == n);
95 
96  /* SQ_SYS - 1.3.6.1.4.1.3495.1.1 */
97  snmpAddNodeStr("1.3.6.1.4.1.3495.1", 1, nullptr, nullptr);
98  snmpAddNodeStr("1.3.6.1.4.1.3495.1.1", SYSVMSIZ, snmp_sysFn, static_Inst, atSum);
99  snmpAddNodeStr("1.3.6.1.4.1.3495.1.1", SYSSTOR, snmp_sysFn, static_Inst, atSum);
100  snmpAddNodeStr("1.3.6.1.4.1.3495.1.1", SYS_UPTIME, snmp_sysFn, static_Inst, atMax);
101 
102  /* SQ_CONF - 1.3.6.1.4.1.3495.1.2 */
103  snmpAddNodeStr("1.3.6.1.4.1.3495.1", 2, nullptr, nullptr);
104  snmpAddNodeStr("1.3.6.1.4.1.3495.1.2", CONF_ADMIN, snmp_confFn, static_Inst);
105  snmpAddNodeStr("1.3.6.1.4.1.3495.1.2", CONF_VERSION, snmp_confFn, static_Inst);
106  snmpAddNodeStr("1.3.6.1.4.1.3495.1.2", CONF_VERSION_ID, snmp_confFn, static_Inst);
107  snmpAddNodeStr("1.3.6.1.4.1.3495.1.2", CONF_LOG_FAC, snmp_confFn, static_Inst);
108 
109  /* SQ_CONF + CONF_STORAGE - 1.3.6.1.4.1.3495.1.5 */
110  snmpAddNodeStr("1.3.6.1.4.1.3495.1.2", CONF_STORAGE, nullptr, nullptr);
111  snmpAddNodeStr("1.3.6.1.4.1.3495.1.2.5", CONF_ST_MMAXSZ, snmp_confFn, static_Inst, atSum);
112  snmpAddNodeStr("1.3.6.1.4.1.3495.1.2.5", CONF_ST_SWMAXSZ, snmp_confFn, static_Inst, atSum);
113  snmpAddNodeStr("1.3.6.1.4.1.3495.1.2.5", CONF_ST_SWHIWM, snmp_confFn, static_Inst, atMin);
114  snmpAddNodeStr("1.3.6.1.4.1.3495.1.2.5", CONF_ST_SWLOWM, snmp_confFn, static_Inst, atMin);
115 
116  snmpAddNodeStr("1.3.6.1.4.1.3495.1.2", CONF_UNIQNAME, snmp_confFn, static_Inst);
117 
118  /* SQ_PRF - 1.3.6.1.4.1.3495.1.3 */
119  snmpAddNodeStr("1.3.6.1.4.1.3495.1", 3, nullptr, nullptr); /* SQ_PRF */
120 
121  /* PERF_SYS - 1.3.6.1.4.1.3495.1.3.1 */
122  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3", PERF_SYS, nullptr, nullptr);
123  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.1", PERF_SYS_PF, snmp_prfSysFn, static_Inst, atSum);
124  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.1", PERF_SYS_NUMR, snmp_prfSysFn, static_Inst, atSum);
125  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.1", PERF_SYS_MEMUSAGE, snmp_prfSysFn, static_Inst, atSum);
126  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.1", PERF_SYS_CPUTIME, snmp_prfSysFn, static_Inst, atSum);
127  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.1", PERF_SYS_CPUUSAGE, snmp_prfSysFn, static_Inst, atSum);
128  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.1", PERF_SYS_MAXRESSZ, snmp_prfSysFn, static_Inst, atSum);
129  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.1", PERF_SYS_NUMOBJCNT, snmp_prfSysFn, static_Inst, atSum);
130  /*
131  Amos comments:
132  The meaning of LRU is "oldest timestamped object in cache, if LRU algorithm is
133  used"...
134  What this SMP support needs to do is aggregate via a special filter equivalent to
135  min() to retain the semantic oldest-object meaning. A special one is needed that
136  works as unsigned and ignores '0' values.
137  */
138  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.1", PERF_SYS_CURLRUEXP, snmp_prfSysFn, static_Inst);
139  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.1", PERF_SYS_CURUNLREQ, snmp_prfSysFn, static_Inst, atSum);
140  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.1", PERF_SYS_CURUNUSED_FD, snmp_prfSysFn, static_Inst, atSum);
141  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.1", PERF_SYS_CURRESERVED_FD, snmp_prfSysFn, static_Inst, atSum);
142  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.1", PERF_SYS_CURUSED_FD, snmp_prfSysFn, static_Inst, atSum);
143  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.1", PERF_SYS_CURMAX_FD, snmp_prfSysFn, static_Inst, atMax);
144 
145  /* PERF_PROTO - 1.3.6.1.4.1.3495.1.3.2 */
146  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3", PERF_PROTO, nullptr, nullptr);
147  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2", PERF_PROTOSTAT_AGGR, nullptr, nullptr);
148  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.1", PERF_PROTOSTAT_AGGR_HTTP_REQ, snmp_prfProtoFn, static_Inst, atSum);
149  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.1", PERF_PROTOSTAT_AGGR_HTTP_HITS, snmp_prfProtoFn, static_Inst, atSum);
150  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.1", PERF_PROTOSTAT_AGGR_HTTP_ERRORS, snmp_prfProtoFn, static_Inst, atSum);
151  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.1", PERF_PROTOSTAT_AGGR_HTTP_KBYTES_IN, snmp_prfProtoFn, static_Inst, atSum);
152  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.1", PERF_PROTOSTAT_AGGR_HTTP_KBYTES_OUT, snmp_prfProtoFn, static_Inst, atSum);
153  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.1", PERF_PROTOSTAT_AGGR_ICP_S, snmp_prfProtoFn, static_Inst, atSum);
154  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.1", PERF_PROTOSTAT_AGGR_ICP_R, snmp_prfProtoFn, static_Inst, atSum);
155  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.1", PERF_PROTOSTAT_AGGR_ICP_SKB, snmp_prfProtoFn, static_Inst, atSum);
156  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.1", PERF_PROTOSTAT_AGGR_ICP_RKB, snmp_prfProtoFn, static_Inst, atSum);
157  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.1", PERF_PROTOSTAT_AGGR_REQ, snmp_prfProtoFn, static_Inst, atSum);
158  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.1", PERF_PROTOSTAT_AGGR_ERRORS, snmp_prfProtoFn, static_Inst, atSum);
159  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.1", PERF_PROTOSTAT_AGGR_KBYTES_IN, snmp_prfProtoFn, static_Inst, atSum);
160  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.1", PERF_PROTOSTAT_AGGR_KBYTES_OUT, snmp_prfProtoFn, static_Inst, atSum);
161  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.1", PERF_PROTOSTAT_AGGR_CURSWAP, snmp_prfProtoFn, static_Inst, atSum);
162  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.1", PERF_PROTOSTAT_AGGR_CLIENTS, snmp_prfProtoFn, static_Inst, atSum);
163 
164  /* Note this is time-series rather than 'static' */
165  /* cacheMedianSvcTable */
166  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2", PERF_PROTOSTAT_MEDIAN, nullptr, nullptr);
167 
168  /* cacheMedianSvcEntry */
169  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.2", 1, nullptr, nullptr);
170  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.2.1", PERF_MEDIAN_TIME, snmp_prfProtoFn, time_Inst, atAverage);
171  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.2.1", PERF_MEDIAN_HTTP_ALL, snmp_prfProtoFn, time_Inst, atAverage);
172  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.2.1", PERF_MEDIAN_HTTP_MISS, snmp_prfProtoFn, time_Inst, atAverage);
173  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.2.1", PERF_MEDIAN_HTTP_NM, snmp_prfProtoFn, time_Inst, atAverage);
174  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.2.1", PERF_MEDIAN_HTTP_HIT, snmp_prfProtoFn, time_Inst, atAverage);
175  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.2.1", PERF_MEDIAN_ICP_QUERY, snmp_prfProtoFn, time_Inst, atAverage);
176  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.2.1", PERF_MEDIAN_ICP_REPLY, snmp_prfProtoFn, time_Inst, atAverage);
177  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.2.1", PERF_MEDIAN_DNS, snmp_prfProtoFn, time_Inst, atAverage);
178  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.2.1", PERF_MEDIAN_RHR, snmp_prfProtoFn, time_Inst, atAverage);
179  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.2.1", PERF_MEDIAN_BHR, snmp_prfProtoFn, time_Inst, atAverage);
180  snmpAddNodeStr("1.3.6.1.4.1.3495.1.3.2.2.1", PERF_MEDIAN_HTTP_NH, snmp_prfProtoFn, time_Inst, atAverage);
181 
182  /* SQ_NET - 1.3.6.1.4.1.3495.1.4 */
183  snmpAddNodeStr("1.3.6.1.4.1.3495.1", 4, nullptr, nullptr);
184 
185  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4", NET_IP_CACHE, nullptr, nullptr);
186  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.1", IP_ENT, snmp_netIpFn, static_Inst, atSum);
187  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.1", IP_REQ, snmp_netIpFn, static_Inst, atSum);
188  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.1", IP_HITS, snmp_netIpFn, static_Inst, atSum);
189  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.1", IP_PENDHIT, snmp_netIpFn, static_Inst, atSum);
190  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.1", IP_NEGHIT, snmp_netIpFn, static_Inst, atSum);
191  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.1", IP_MISS, snmp_netIpFn, static_Inst, atSum);
192  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.1", IP_GHBN, snmp_netIpFn, static_Inst, atSum);
193  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.1", IP_LOC, snmp_netIpFn, static_Inst, atSum);
194 
195  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4", NET_FQDN_CACHE, nullptr, nullptr);
196  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.2", FQDN_ENT, snmp_netFqdnFn, static_Inst, atSum);
197  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.2", FQDN_REQ, snmp_netFqdnFn, static_Inst, atSum);
198  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.2", FQDN_HITS, snmp_netFqdnFn, static_Inst, atSum);
199  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.2", FQDN_PENDHIT, snmp_netFqdnFn, static_Inst, atSum);
200  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.2", FQDN_NEGHIT, snmp_netFqdnFn, static_Inst, atSum);
201  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.2", FQDN_MISS, snmp_netFqdnFn, static_Inst, atSum);
202  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.2", FQDN_GHBN, snmp_netFqdnFn, static_Inst, atSum);
203 
204  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4", NET_DNS_CACHE, nullptr, nullptr);
205  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.3", DNS_REQ, snmp_netDnsFn, static_Inst, atSum);
206  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.3", DNS_REP, snmp_netDnsFn, static_Inst, atSum);
207  snmpAddNodeStr("1.3.6.1.4.1.3495.1.4.3", DNS_SERVERS, snmp_netDnsFn, static_Inst, atSum);
208 
209  /* SQ_MESH - 1.3.6.1.4.1.3495.1.5 */
210  snmpAddNodeStr("1.3.6.1.4.1.3495.1", 5, nullptr, nullptr);
211 
212  /* cachePeerTable - 1.3.6.1.4.1.3495.1.5.1 */
213  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5", MESH_PTBL, nullptr, nullptr);
214 
215  /* CachePeerEntry (version 3) - 1.3.6.1.4.1.3495.1.5.1.3 */
216  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.1", 3, nullptr, nullptr);
217  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.1.3", MESH_PTBL_INDEX, snmp_meshPtblFn, peer_Inst);
218  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.1.3", MESH_PTBL_NAME, snmp_meshPtblFn, peer_Inst);
219  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.1.3", MESH_PTBL_ADDR_TYPE, snmp_meshPtblFn, peer_Inst);
220  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.1.3", MESH_PTBL_ADDR, snmp_meshPtblFn, peer_Inst);
221  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.1.3", MESH_PTBL_HTTP, snmp_meshPtblFn, peer_Inst);
222  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.1.3", MESH_PTBL_ICP, snmp_meshPtblFn, peer_Inst);
223  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.1.3", MESH_PTBL_TYPE, snmp_meshPtblFn, peer_Inst);
224  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.1.3", MESH_PTBL_STATE, snmp_meshPtblFn, peer_Inst);
225  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.1.3", MESH_PTBL_SENT, snmp_meshPtblFn, peer_Inst);
226  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.1.3", MESH_PTBL_PACKED, snmp_meshPtblFn, peer_Inst);
227  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.1.3", MESH_PTBL_FETCHES, snmp_meshPtblFn, peer_Inst);
228  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.1.3", MESH_PTBL_RTT, snmp_meshPtblFn, peer_Inst);
229  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.1.3", MESH_PTBL_IGN, snmp_meshPtblFn, peer_Inst);
230  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.1.3", MESH_PTBL_KEEPAL_S, snmp_meshPtblFn, peer_Inst);
231  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.1.3", MESH_PTBL_KEEPAL_R, snmp_meshPtblFn, peer_Inst);
232 
233  /* cacheClientTable - 1.3.6.1.4.1.3495.1.5.2 */
234  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5", MESH_CTBL, nullptr, nullptr);
235 
236  /* BUG 2811: we NEED to create a reliable index for the client DB and make version 3 of the table. */
237  /* for now we have version 2 table with OID capable of mixed IPv4 / IPv6 clients and upgraded address text format. */
238 
239  /* cacheClientEntry - 1.3.6.1.4.1.3495.1.5.2.2 */
240  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.2", 2, nullptr, nullptr);
241  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.2.2", MESH_CTBL_ADDR_TYPE, snmp_meshCtblFn, client_Inst);
242  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.2.2", MESH_CTBL_ADDR, snmp_meshCtblFn, client_Inst);
243  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.2.2", MESH_CTBL_HTREQ, snmp_meshCtblFn, client_Inst);
244  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.2.2", MESH_CTBL_HTBYTES, snmp_meshCtblFn, client_Inst);
245  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.2.2", MESH_CTBL_HTHITS, snmp_meshCtblFn, client_Inst);
246  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.2.2", MESH_CTBL_HTHITBYTES, snmp_meshCtblFn, client_Inst);
247  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.2.2", MESH_CTBL_ICPREQ, snmp_meshCtblFn, client_Inst);
248  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.2.2", MESH_CTBL_ICPBYTES, snmp_meshCtblFn, client_Inst);
249  snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.2.2", MESH_CTBL_ICPHITS, snmp_meshCtblFn, client_Inst);
250  mib_tree_last = snmpAddNodeStr("1.3.6.1.4.1.3495.1.5.2.2", MESH_CTBL_ICPHITBYTES, snmp_meshCtblFn, client_Inst);
251 
252  debugs(49, 9, "snmpInit: Completed SNMP mib tree structure");
253 }
254 
255 static void
256 snmpOpenPorts()
257 {
258  if (!IamWorkerProcess())
259  return;
260 
261  if (Config.Port.snmp <= 0)
262  return;
263 
264  snmpIncomingConn = new Comm::Connection;
265  snmpIncomingConn->local = Config.Addrs.snmp_incoming;
266  snmpIncomingConn->local.port(Config.Port.snmp);
267 
268  if (!Ip::EnableIpv6 && !snmpIncomingConn->local.setIPv4()) {
269  debugs(49, DBG_CRITICAL, "ERROR: IPv6 is disabled. " << snmpIncomingConn->local << " is not an IPv4 address.");
270  fatal("SNMP port cannot be opened.");
271  }
272  /* split-stack for now requires IPv4-only SNMP */
273  if (Ip::EnableIpv6&IPV6_SPECIAL_SPLITSTACK && snmpIncomingConn->local.isAnyAddr()) {
274  snmpIncomingConn->local.setIPv4();
275  }
276 
277  auto call = asyncCallbackFun(49, 2, snmpPortOpened);
278  Ipc::StartListening(SOCK_DGRAM, IPPROTO_UDP, snmpIncomingConn, Ipc::fdnInSnmpSocket, call);
279 
280  if (!Config.Addrs.snmp_outgoing.isNoAddr()) {
281  snmpOutgoingConn = new Comm::Connection;
282  snmpOutgoingConn->local = Config.Addrs.snmp_outgoing;
283  snmpOutgoingConn->local.port(Config.Port.snmp);
284 
285  if (!Ip::EnableIpv6 && !snmpOutgoingConn->local.setIPv4()) {
286  debugs(49, DBG_CRITICAL, "ERROR: IPv6 is disabled. " << snmpOutgoingConn->local << " is not an IPv4 address.");
287  fatal("SNMP port cannot be opened.");
288  }
289  /* split-stack for now requires IPv4-only SNMP */
290  if (Ip::EnableIpv6&IPV6_SPECIAL_SPLITSTACK && snmpOutgoingConn->local.isAnyAddr()) {
291  snmpOutgoingConn->local.setIPv4();
292  }
293  // TODO: Add/use snmpOutgoingPortOpened() instead of snmpPortOpened().
294  auto c = asyncCallbackFun(49, 2, snmpPortOpened);
295  Ipc::StartListening(SOCK_DGRAM, IPPROTO_UDP, snmpOutgoingConn, Ipc::fdnOutSnmpSocket, c);
296  } else {
297  snmpOutgoingConn = snmpIncomingConn;
298  debugs(1, DBG_IMPORTANT, "Sending SNMP messages from " << snmpOutgoingConn->local);
299  }
300 }
301 
302 static void
303 snmpPortOpened(Ipc::StartListeningAnswer &answer)
304 {
305  const auto &conn = answer.conn;
306 
307  if (!Comm::IsConnOpen(conn))
308  fatalf("Cannot open SNMP %s Port",(conn->fd == snmpIncomingConn->fd?"receiving":"sending"));
309 
310  Comm::SetSelect(conn->fd, COMM_SELECT_READ, snmpHandleUdp, nullptr, 0);
311 
312  if (conn->fd == snmpIncomingConn->fd)
313  debugs(1, DBG_IMPORTANT, "Accepting SNMP messages on " << snmpIncomingConn->local);
314  else if (conn->fd == snmpOutgoingConn->fd)
315  debugs(1, DBG_IMPORTANT, "Sending SNMP messages from " << snmpOutgoingConn->local);
316  else
317  fatalf("Lost SNMP port (%d) on FD %d", (int)conn->local.port(), conn->fd);
318 }
319 
320 static void
321 snmpClosePorts()
322 {
323  if (!IamWorkerProcess())
324  return;
325 
326  if (Comm::IsConnOpen(snmpIncomingConn)) {
327  debugs(49, DBG_IMPORTANT, "Closing SNMP receiving port " << snmpIncomingConn->local);
328  snmpIncomingConn->close();
329  }
330  snmpIncomingConn = nullptr;
331 
332  if (Comm::IsConnOpen(snmpOutgoingConn)) {
333  debugs(49, DBG_IMPORTANT, "Closing SNMP sending port " << snmpOutgoingConn->local);
334  snmpOutgoingConn->close();
335  }
336  snmpOutgoingConn = nullptr;
337 }
338 
339 class SnmpRr : public RegisteredRunner
340 {
341 public:
342  void finalizeConfig() override { snmpInit(); }
343  void useConfig() override { snmpOpenPorts(); }
344  void startReconfigure() override { snmpClosePorts(); }
345  void syncConfig() override { snmpOpenPorts(); }
346  void startShutdown() override { snmpClosePorts(); }
347 };
348 DefineRunnerRegistrator(SnmpRr);
349 
350 /*
351  * Accept the UDP packet
352  */
353 void
354 snmpHandleUdp(int sock, void *)
355 {
356  static char buf[SNMP_REQUEST_SIZE];
357  Ip::Address from;
358  SnmpRequest *snmp_rq;
359  int len;
360 
361  debugs(49, 5, "snmpHandleUdp: Called.");
362 
363  Comm::SetSelect(sock, COMM_SELECT_READ, snmpHandleUdp, nullptr, 0);
364 
365  memset(buf, '\0', sizeof(buf));
366 
367  len = comm_udp_recvfrom(sock, buf, sizeof(buf)-1, 0, from);
368 
369  if (len > 0) {
370  debugs(49, 3, "snmpHandleUdp: FD " << sock << ": received " << len << " bytes from " << from << ".");
371 
372  snmp_rq = (SnmpRequest *)xcalloc(1, sizeof(SnmpRequest));
373  snmp_rq->buf = (u_char *) buf;
374  snmp_rq->len = len;
375  snmp_rq->sock = sock;
376  snmp_rq->outbuf = (unsigned char *)xmalloc(snmp_rq->outlen = SNMP_REQUEST_SIZE);
377  snmp_rq->from = from;
378  snmpDecodePacket(snmp_rq);
379  xfree(snmp_rq->outbuf);
380  xfree(snmp_rq);
381  } else {
382  int xerrno = errno;
383  debugs(49, DBG_IMPORTANT, "snmpHandleUdp: FD " << sock << " recvfrom: " << xstrerr(xerrno));
384  }
385 }
386 
387 /*
388  * Turn SNMP packet into a PDU, check available ACL's
389  */
390 static void
391 snmpDecodePacket(SnmpRequest * rq)
392 {
393  struct snmp_pdu *PDU;
394  u_char *Community;
395  u_char *buf = rq->buf;
396  int len = rq->len;
397 
398  if (!Config.accessList.snmp) {
399  debugs(49, DBG_IMPORTANT, "WARNING: snmp_access not configured. agent query DENIED from : " << rq->from);
400  return;
401  }
402 
403  debugs(49, 5, "Called.");
404  PDU = snmp_pdu_create(0);
405  /* Always answer on SNMPv1 */
406  rq->session.Version = SNMP_VERSION_1;
407  Community = snmp_parse(&rq->session, PDU, buf, len);
408 
409  /* Check if we have explicit permission to access SNMP data.
410  * default (set above) is to deny all */
411  if (Community) {
412  ACLFilledChecklist checklist(Config.accessList.snmp, nullptr);
413  checklist.src_addr = rq->from;
414  checklist.snmp_community = (char *) Community;
415 
416  if (checklist.fastCheck().allowed() && (snmp_coexist_V2toV1(PDU))) {
417  rq->community = Community;
418  rq->PDU = PDU;
419  debugs(49, 5, "snmpAgentParse: reqid=[" << PDU->reqid << "]");
420  snmpConstructReponse(rq);
421  } else {
422  debugs(49, DBG_IMPORTANT, "WARNING: SNMP agent query DENIED from : " << rq->from);
423  snmp_free_pdu(PDU);
424  }
425  xfree(Community);
426 
427  } else {
428  debugs(49, DBG_IMPORTANT, "WARNING: Failed SNMP agent query from : " << rq->from);
429  snmp_free_pdu(PDU);
430  }
431 }
432 
433 /*
434  * Packet OK, ACL Check OK, Create response.
435  */
436 static void
437 snmpConstructReponse(SnmpRequest * rq)
438 {
439 
440  struct snmp_pdu *RespPDU;
441 
442  debugs(49, 5, "snmpConstructReponse: Called.");
443 
444  if (UsingSmp() && IamWorkerProcess()) {
445  AsyncJob::Start(new Snmp::Forwarder(static_cast<Snmp::Pdu&>(*rq->PDU),
446  static_cast<Snmp::Session&>(rq->session), rq->sock, rq->from));
447  snmp_free_pdu(rq->PDU);
448  return;
449  }
450 
451  RespPDU = snmpAgentResponse(rq->PDU);
452  snmp_free_pdu(rq->PDU);
453 
454  if (RespPDU != nullptr) {
455  if (snmp_build(&rq->session, RespPDU, rq->outbuf, &rq->outlen) == 0)
456  comm_udp_sendto(rq->sock, rq->from, rq->outbuf, rq->outlen);
457  else
458  debugs(49, DBG_IMPORTANT, "ERROR: Failed to encode a response to SNMP agent query from " << rq->from);
459  snmp_free_pdu(RespPDU);
460  }
461 }
462 
463 /*
464  * Decide how to respond to the request, construct a response and
465  * return the response to the requester.
466  */
467 
468 struct snmp_pdu *
469 snmpAgentResponse(struct snmp_pdu *PDU) {
470 
471  struct snmp_pdu *Answer = nullptr;
472 
473  debugs(49, 5, "snmpAgentResponse: Called.");
474 
475  if ((Answer = snmp_pdu_create(SNMP_PDU_RESPONSE))) {
476  Answer->reqid = PDU->reqid;
477  Answer->errindex = 0;
478 
479  if (PDU->command == SNMP_PDU_GET || PDU->command == SNMP_PDU_GETNEXT) {
480  /* Indirect way */
481  int get_next = (PDU->command == SNMP_PDU_GETNEXT);
482  variable_list *VarPtr_;
483  variable_list **RespVars = &(Answer->variables);
484  oid_ParseFn *ParseFn;
485  int index = 0;
486  /* Loop through all variables */
487 
488  for (VarPtr_ = PDU->variables; VarPtr_; VarPtr_ = VarPtr_->next_variable) {
489  variable_list *VarPtr = VarPtr_;
490  variable_list *VarNew = nullptr;
491  oid *NextOidName = nullptr;
492  snint NextOidNameLen = 0;
493 
494  ++index;
495 
496  if (get_next)
497  ParseFn = snmpTreeNext(VarPtr->name, VarPtr->name_length, &NextOidName, &NextOidNameLen);
498  else
499  ParseFn = snmpTreeGet(VarPtr->name, VarPtr->name_length);
500 
501  if (ParseFn == nullptr) {
502  Answer->errstat = SNMP_ERR_NOSUCHNAME;
503  debugs(49, 5, "snmpAgentResponse: No such oid. ");
504  } else {
505  if (get_next) {
506  VarPtr = snmp_var_new(NextOidName, NextOidNameLen);
507  xfree(NextOidName);
508  }
509 
510  int * errstatTmp = &(Answer->errstat);
511 
512  VarNew = (*ParseFn) (VarPtr, (snint *) errstatTmp);
513 
514  if (get_next)
515  snmp_var_free(VarPtr);
516  }
517 
518  if ((Answer->errstat != SNMP_ERR_NOERROR) || (VarNew == nullptr)) {
519  Answer->errindex = index;
520  debugs(49, 5, "snmpAgentResponse: error.");
521 
522  if (VarNew)
523  snmp_var_free(VarNew);
524 
525  while ((VarPtr = Answer->variables) != nullptr) {
526  Answer->variables = VarPtr->next_variable;
527  snmp_var_free(VarPtr);
528  }
529 
530  /* Steal the original PDU list of variables for the error response */
531  Answer->variables = PDU->variables;
532 
533  PDU->variables = nullptr;
534 
535  return (Answer);
536  }
537 
538  /* No error. Insert this var at the end, and move on to the next.
539  */
540  *RespVars = VarNew;
541 
542  RespVars = &(VarNew->next_variable);
543  }
544  }
545  }
546 
547  return (Answer);
548 }
549 
550 static oid_ParseFn *
551 snmpTreeGet(oid * Current, snint CurrentLen)
552 {
553  oid_ParseFn *Fn = nullptr;
554  mib_tree_entry *mibTreeEntry = nullptr;
555  int count = 0;
556 
557  debugs(49, 5, "snmpTreeGet: Called");
558 
559  MemBuf tmp;
560  debugs(49, 6, "snmpTreeGet: Current : " << snmpDebugOid(Current, CurrentLen, tmp) );
561 
562  mibTreeEntry = mib_tree_head;
563 
564  if (Current[count] == mibTreeEntry->name[count]) {
565  ++count;
566 
567  while ((mibTreeEntry) && (count < CurrentLen) && (!mibTreeEntry->parsefunction)) {
568  mibTreeEntry = snmpTreeEntry(Current[count], count, mibTreeEntry);
569  ++count;
570  }
571  }
572 
573  if (mibTreeEntry && mibTreeEntry->parsefunction)
574  Fn = mibTreeEntry->parsefunction;
575 
576  debugs(49, 5, "snmpTreeGet: return");
577 
578  return (Fn);
579 }
580 
581 AggrType
582 snmpAggrType(oid* Current, snint CurrentLen)
583 {
584  debugs(49, 5, MYNAME);
585 
586  mib_tree_entry* mibTreeEntry = mib_tree_head;
587  AggrType type = atNone;
588  int count = 0;
589 
590  if (Current[count] == mibTreeEntry->name[count]) {
591  ++count;
592 
593  while (mibTreeEntry != nullptr && count < CurrentLen) {
594  mibTreeEntry = snmpTreeEntry(Current[count], count, mibTreeEntry);
595  if (mibTreeEntry != nullptr)
596  type = mibTreeEntry->aggrType;
597  ++count;
598  }
599  }
600 
601  return type;
602 }
603 
604 static oid_ParseFn *
605 snmpTreeNext(oid * Current, snint CurrentLen, oid ** Next, snint * NextLen)
606 {
607  oid_ParseFn *Fn = nullptr;
608  int count = 0;
609 
610  debugs(49, 5, "snmpTreeNext: Called");
611 
612  MemBuf tmp;
613  debugs(49, 6, "snmpTreeNext: Current : " << snmpDebugOid(Current, CurrentLen, tmp));
614 
615  mib_tree_entry *mibTreeEntry = mib_tree_head;
616 
617  if (mibTreeEntry && Current[count] == mibTreeEntry->name[count]) {
618  ++count;
619 
620  while ((mibTreeEntry) && (count < CurrentLen) && (!mibTreeEntry->parsefunction)) {
621  mib_tree_entry *nextmibTreeEntry = snmpTreeEntry(Current[count], count, mibTreeEntry);
622 
623  if (!nextmibTreeEntry)
624  break;
625  else
626  mibTreeEntry = nextmibTreeEntry;
627 
628  ++count;
629  }
630  debugs(49, 5, "snmpTreeNext: Recursed down to requested object");
631  } else {
632  return nullptr;
633  }
634 
635  if (mibTreeEntry == mib_tree_last)
636  return (Fn);
637 
638  if ((mibTreeEntry) && (mibTreeEntry->parsefunction)) {
639  *NextLen = CurrentLen;
640  *Next = (*mibTreeEntry->instancefunction) (Current, NextLen, mibTreeEntry, &Fn);
641  if (*Next) {
642  debugs(49, 6, "snmpTreeNext: Next : " << snmpDebugOid(*Next, *NextLen, tmp));
643  return (Fn);
644  }
645  }
646 
647  if ((mibTreeEntry) && (mibTreeEntry->parsefunction)) {
648  --count;
649  mib_tree_entry *nextoid = snmpTreeSiblingEntry(Current[count], count, mibTreeEntry->parent);
650  if (nextoid) {
651  debugs(49, 5, "snmpTreeNext: Next OID found for sibling" << nextoid );
652  mibTreeEntry = nextoid;
653  ++count;
654  } else {
655  debugs(49, 5, "snmpTreeNext: Attempting to recurse up for next object");
656 
657  while (!nextoid) {
658  --count;
659 
660  if (mibTreeEntry->parent->parent) {
661  nextoid = mibTreeEntry->parent;
662  mibTreeEntry = snmpTreeEntry(Current[count] + 1, count, nextoid->parent);
663 
664  if (!mibTreeEntry) {
665  mibTreeEntry = nextoid;
666  nextoid = nullptr;
667  }
668  } else {
669  nextoid = mibTreeEntry;
670  mibTreeEntry = nullptr;
671  }
672  }
673  }
674  }
675  while ((mibTreeEntry) && (!mibTreeEntry->parsefunction)) {
676  mibTreeEntry = mibTreeEntry->leaves[0];
677  }
678 
679  if (mibTreeEntry) {
680  *NextLen = mibTreeEntry->len;
681  *Next = (*mibTreeEntry->instancefunction) (mibTreeEntry->name, NextLen, mibTreeEntry, &Fn);
682  }
683 
684  if (*Next) {
685  debugs(49, 6, "snmpTreeNext: Next : " << snmpDebugOid(*Next, *NextLen, tmp));
686  return (Fn);
687  } else
688  return nullptr;
689 }
690 
691 static oid *
692 static_Inst(oid * name, snint * len, mib_tree_entry * current, oid_ParseFn ** Fn)
693 {
694  oid *instance = nullptr;
695  if (*len <= current->len) {
696  instance = (oid *)xmalloc(sizeof(*name) * (*len + 1));
697  memcpy(instance, name, sizeof(*name) * (*len));
698  instance[*len] = 0;
699  *len += 1;
700  }
701  *Fn = current->parsefunction;
702  return (instance);
703 }
704 
705 static oid *
706 time_Inst(oid * name, snint * len, mib_tree_entry * current, oid_ParseFn ** Fn)
707 {
708  oid *instance = nullptr;
709  int identifier = 0, loop = 0;
710  int index[TIME_INDEX_LEN] = {TIME_INDEX};
711 
712  if (*len <= current->len) {
713  instance = (oid *)xmalloc(sizeof(*name) * (*len + 1));
714  memcpy(instance, name, sizeof(*name) * (*len));
715  instance[*len] = *index;
716  *len += 1;
717  } else {
718  identifier = name[*len - 1];
719 
720  while ((loop < TIME_INDEX_LEN) && (identifier != index[loop]))
721  ++loop;
722 
723  if (loop < (TIME_INDEX_LEN - 1)) {
724  instance = (oid *)xmalloc(sizeof(*name) * (*len));
725  memcpy(instance, name, sizeof(*name) * (*len));
726  instance[*len - 1] = index[++loop];
727  }
728  }
729 
730  *Fn = current->parsefunction;
731  return (instance);
732 }
733 
734 static oid *
735 peer_Inst(oid * name, snint * len, mib_tree_entry * current, oid_ParseFn ** Fn)
736 {
737  oid *instance = nullptr;
738  const auto peersAvailable = CurrentCachePeers().size();
739 
740  if (!peersAvailable) {
741  debugs(49, 6, "snmp peer_Inst: No Peers.");
742  current = current->parent->parent->parent->leaves[1];
743  while ((current) && (!current->parsefunction))
744  current = current->leaves[0];
745 
746  if (!current)
747  return (instance);
748 
749  instance = client_Inst(current->name, len, current, Fn);
750  } else if (*len <= current->len) {
751  debugs(49, 6, "snmp peer_Inst: *len <= current->len ???");
752  instance = (oid *)xmalloc(sizeof(*name) * ( *len + 1));
753  memcpy(instance, name, sizeof(*name) * (*len));
754  instance[*len] = 1 ;
755  *len += 1;
756  } else {
757  int no = name[current->len] ;
758  int i;
759  // Note: This works because the Config.peers keeps its index according to its position.
760  for (i = 0; Less(i, peersAvailable) && Less(i, no); ++i);
761 
762  if (Less(i, peersAvailable)) {
763  debugs(49, 6, "snmp peer_Inst: Encode peer #" << i);
764  instance = (oid *)xmalloc(sizeof(*name) * (current->len + 1 ));
765  memcpy(instance, name, (sizeof(*name) * current->len ));
766  instance[current->len] = no + 1 ; // i.e. the next index on cache_peeer table.
767  *len = current->len + 1;
768  } else {
769  debugs(49, 6, "snmp peer_Inst: We have " << i << " peers. Can't find #" << no);
770  return (instance);
771  }
772  }
773  *Fn = current->parsefunction;
774  return (instance);
775 }
776 
777 static oid *
778 client_Inst(oid * name, snint * len, mib_tree_entry * current, oid_ParseFn ** Fn)
779 {
780  oid *instance = nullptr;
781  Ip::Address laddr;
782  Ip::Address *aux;
783  int size = 0;
784  int newshift = 0;
785 
786  if (*len <= current->len) {
787  aux = client_entry(nullptr);
788  if (aux)
789  laddr = *aux;
790  else
791  laddr.setAnyAddr();
792 
793  if (laddr.isIPv4())
794  size = sizeof(in_addr);
795  else
796  size = sizeof(in6_addr);
797 
798  debugs(49, 6, "len" << *len << ", current-len" << current->len << ", addr=" << laddr << ", size=" << size);
799 
800  instance = (oid *)xmalloc(sizeof(*name) * (*len + size ));
801  memcpy(instance, name, (sizeof(*name) * (*len)));
802 
803  if ( !laddr.isAnyAddr() ) {
804  addr2oid(laddr, &instance[ *len]); // the addr
805  *len += size ;
806  }
807  } else {
808  int shift = *len - current->len ; // i.e 4 or 16
809  oid2addr(&name[*len - shift], laddr,shift);
810  aux = client_entry(&laddr);
811  if (aux)
812  laddr = *aux;
813  else
814  laddr.setAnyAddr();
815 
816  if (!laddr.isAnyAddr()) {
817  if (laddr.isIPv4())
818  newshift = sizeof(in_addr);
819  else
820  newshift = sizeof(in6_addr);
821 
822  debugs(49, 6, "len" << *len << ", current-len" << current->len << ", addr=" << laddr << ", newshift=" << newshift);
823 
824  instance = (oid *)xmalloc(sizeof(*name) * (current->len + newshift));
825  memcpy(instance, name, (sizeof(*name) * (current->len)));
826  addr2oid(laddr, &instance[current->len]); // the addr.
827  *len = current->len + newshift ;
828  }
829  }
830 
831  *Fn = current->parsefunction;
832  return (instance);
833 }
834 
835 /*
836  * Utility functions
837  */
838 
839 /*
840  * Tree utility functions.
841  */
842 
843 /*
844  * Returns a sibling object for the requested child object or NULL
845  * if it does not exit
846  */
847 static mib_tree_entry *
848 snmpTreeSiblingEntry(oid entry, snint len, mib_tree_entry * current)
849 {
850  for (int i = 0; i < current->children; ++i) {
851  if (current->leaves[i]->name[len] == entry)
852  return (i + 1 < current->children) ? current->leaves[i + 1] : nullptr;
853  }
854  return nullptr;
855 }
856 
857 /*
858  * Returns the requested child object or NULL if it does not exist
859  */
860 static mib_tree_entry *
861 snmpTreeEntry(oid entry, snint len, mib_tree_entry * current)
862 {
863  mib_tree_entry *next = nullptr;
864  int count = 0;
865 
866  while ((!next) && current && (count < current->children)) {
867  if (current->leaves[count]->name[len] == entry) {
868  next = current->leaves[count];
869  }
870 
871  ++count;
872  }
873 
874  return (next);
875 }
876 
877 static void
878 snmpAddNodeChild(mib_tree_entry *entry, mib_tree_entry *child)
879 {
880  debugs(49, 5, "snmpAddNodeChild: assigning " << child << " to parent " << entry);
881  entry->leaves = (mib_tree_entry **)xrealloc(entry->leaves, sizeof(mib_tree_entry *) * (entry->children + 1));
882  entry->leaves[entry->children] = child;
883  entry->leaves[entry->children]->parent = entry;
884  ++ entry->children;
885 }
886 
887 mib_tree_entry *
888 snmpLookupNodeStr(mib_tree_entry *root, const char *str)
889 {
890  oid *name;
891  int namelen;
892  mib_tree_entry *e;
893 
894  if (root)
895  e = root;
896  else
897  e = mib_tree_head;
898 
899  if (! snmpCreateOidFromStr(str, &name, &namelen))
900  return nullptr;
901 
902  /* I wish there were some kind of sensible existing tree traversal
903  * routine to use. I'll worry about that later */
904  if (namelen <= 1) {
905  xfree(name);
906  return e; /* XXX it should only be this? */
907  }
908 
909  int i, r = 1;
910  while (r < namelen) {
911 
912  /* Find the child node which matches this */
913  for (i = 0; i < e->children && e->leaves[i]->name[r] != name[r]; ++i) ; // seek-loop
914 
915  /* Are we pointing to that node? */
916  if (i >= e->children)
917  break;
918  assert(e->leaves[i]->name[r] == name[r]);
919 
920  /* Skip to that node! */
921  e = e->leaves[i];
922  ++r;
923  }
924 
925  xfree(name);
926  return e;
927 }
928 
929 bool
930 snmpCreateOidFromStr(const char *str, oid **name, int *nl)
931 {
932  char const *delim = ".";
933 
934  *name = nullptr;
935  *nl = 0;
936  const char *s = str;
937 
938  /* Parse the OID string into oid bits */
939  while (size_t len = strcspn(s, delim)) {
940  *name = (oid*)xrealloc(*name, sizeof(oid) * ((*nl) + 1));
941  (*name)[*nl] = atoi(s); // stops at the '.' delimiter
942  ++(*nl);
943  // exit with true when the last octet has been parsed
944  if (s[len] == '\0')
945  return true;
946  s += len+1;
947  }
948 
949  // if we aborted before the lst octet was found, return false.
950  safe_free(*name);
951  return false;
952 }
953 
954 /*
955  * Create an entry. Return a pointer to the newly created node, or NULL
956  * on failure.
957  */
958 static mib_tree_entry *
959 snmpAddNodeStr(const char *base_str, int o, oid_ParseFn * parsefunction, instance_Fn * instancefunction, AggrType aggrType)
960 {
961  mib_tree_entry *m, *b;
962  oid *n;
963  int nl;
964  char s[1024];
965 
966  /* Find base node */
967  b = snmpLookupNodeStr(mib_tree_head, base_str);
968  if (! b)
969  return nullptr;
970  debugs(49, 5, "snmpAddNodeStr: " << base_str << ": -> " << b);
971 
972  /* Create OID string for new entry */
973  snprintf(s, 1024, "%s.%d", base_str, o);
974  if (! snmpCreateOidFromStr(s, &n, &nl))
975  return nullptr;
976 
977  /* Create a node */
978  m = snmpAddNode(n, nl, parsefunction, instancefunction, aggrType, 0);
979 
980  /* Link it into the existing tree */
981  snmpAddNodeChild(b, m);
982 
983  /* Return the node */
984  return m;
985 }
986 
987 /*
988  * Adds a node to the MIB tree structure and adds the appropriate children
989  */
990 static mib_tree_entry *
991 snmpAddNode(oid * name, int len, oid_ParseFn * parsefunction, instance_Fn * instancefunction, AggrType aggrType, int children,...)
992 {
993  MemBuf tmp;
994  debugs(49, 6, "snmpAddNode: Children : " << children << ", Oid : " << snmpDebugOid(name, len, tmp));
995 
996  const auto entry = static_cast<mib_tree_entry *>(xmalloc(sizeof(mib_tree_entry)));
997  entry->name = name;
998  entry->len = len;
999  entry->parsefunction = parsefunction;
1000  entry->instancefunction = instancefunction;
1001  entry->children = children;
1002  entry->leaves = nullptr;
1003  entry->parent = nullptr;
1004  entry->aggrType = aggrType;
1005 
1006  if (children > 0) {
1007  entry->leaves = static_cast<mib_tree_entry **>(xmalloc(sizeof(mib_tree_entry *) * children));
1008 
1009  va_list args;
1010  va_start(args, children);
1011  for (int loop = 0; loop < children; ++loop) {
1012  entry->leaves[loop] = va_arg(args, mib_tree_entry *);
1013  entry->leaves[loop]->parent = entry;
1014  }
1015  va_end(args);
1016  }
1017 
1018  return (entry);
1019 }
1020 /* End of tree utility functions */
1021 
1022 /*
1023  * Returns the list of parameters in an oid
1024  */
1025 static oid *
1026 snmpCreateOid(int length,...)
1027 {
1028  va_list args;
1029  oid *new_oid;
1030  int loop;
1031  va_start(args, length);
1032 
1033  new_oid = (oid *)xmalloc(sizeof(oid) * length);
1034 
1035  if (length > 0) {
1036  for (loop = 0; loop < length; ++loop) {
1037  new_oid[loop] = va_arg(args, int);
1038  }
1039  }
1040 
1041  va_end(args);
1042  return (new_oid);
1043 }
1044 
1045 /*
1046  * Debug calls, prints out the OID for debugging purposes.
1047  */
1048 const char *
1049 snmpDebugOid(oid * Name, snint Len, MemBuf &outbuf)
1050 {
1051  char mbuf[16];
1052  int x;
1053  outbuf.reset();
1054 
1055  for (x = 0; x < Len; ++x) {
1056  size_t bytes = snprintf(mbuf, sizeof(mbuf), ".%u", (unsigned int) Name[x]);
1057  outbuf.append(mbuf, bytes);
1058  }
1059  return outbuf.content();
1060 }
1061 
1062 void
1063 snmpSnmplibDebug(int lvl, char *buf)
1064 {
1065  debugs(49, lvl, buf);
1066 }
1067 
1068 /*
1069  IPv4 address: 10.10.0.9 ==>
1070  oid == 10.10.0.9
1071  IPv6 address : 20:01:32:ef:a2:21:fb:32:00:00:00:00:00:00:00:00:OO:01 ==>
1072  oid == 32.1.50.239.162.33.251.20.50.0.0.0.0.0.0.0.0.0.1
1073 */
1074 void
1075 addr2oid(Ip::Address &addr, oid * Dest)
1076 {
1077  u_int i ;
1078  u_char *cp = nullptr;
1079  struct in_addr i4addr;
1080  struct in6_addr i6addr;
1081  oid code = addr.isIPv6()? INETADDRESSTYPE_IPV6 : INETADDRESSTYPE_IPV4 ;
1082  u_int size = (code == INETADDRESSTYPE_IPV4) ? sizeof(struct in_addr):sizeof(struct in6_addr);
1083  // Dest[0] = code ;
1084  if ( code == INETADDRESSTYPE_IPV4 ) {
1085  addr.getInAddr(i4addr);
1086  cp = (u_char *) &(i4addr.s_addr);
1087  } else {
1088  addr.getInAddr(i6addr);
1089  cp = (u_char *) &i6addr;
1090  }
1091  for ( i=0 ; i < size ; ++i) {
1092  // OID's are in network order
1093  Dest[i] = *cp;
1094  ++cp;
1095  }
1096  MemBuf tmp;
1097  debugs(49, 7, "addr2oid: Dest : " << snmpDebugOid(Dest, size, tmp));
1098 }
1099 
1100 /*
1101  oid == 10.10.0.9 ==>
1102  IPv4 address: 10.10.0.9
1103  oid == 32.1.50.239.162.33.251.20.50.0.0.0.0.0.0.0.0.0.1 ==>
1104  IPv6 address : 20:01:32:ef:a2:21:fb:32:00:00:00:00:00:00:00:00:OO:01
1105 */
1106 void
1107 oid2addr(oid * id, Ip::Address &addr, u_int size)
1108 {
1109  struct in_addr i4addr;
1110  struct in6_addr i6addr;
1111  u_int i;
1112  u_char *cp;
1113  if ( size == sizeof(struct in_addr) )
1114  cp = (u_char *) &(i4addr.s_addr);
1115  else
1116  cp = (u_char *) &(i6addr);
1117  MemBuf tmp;
1118  debugs(49, 7, "oid2addr: id : " << snmpDebugOid(id, size, tmp) );
1119  for (i=0 ; i<size; ++i) {
1120  cp[i] = id[i];
1121  }
1122  if ( size == sizeof(struct in_addr) )
1123  addr = i4addr;
1124  else
1125  addr = i6addr;
1126 }
1127 
1128 int
1129 Acl::SnmpCommunityCheck::match(ACLChecklist * const ch)
1130 {
1131  const auto checklist = Filled(ch);
1132 
1133  return data->match (checklist->snmp_community);
1134 }
1135 
MESH_PTBL_FETCHES
@ MESH_PTBL_FETCHES
Definition: cache_snmp.h:246
fatal
void fatal(const char *message)
Definition: fatal.cc:28
xstrerr
const char * xstrerr(int error)
Definition: xstrerror.cc:83
SYSSTOR
@ SYSSTOR
Definition: cache_snmp.h:59
SYSVMSIZ
@ SYSVMSIZ
Definition: cache_snmp.h:58
PERF_SYS_CURMAX_FD
@ PERF_SYS_CURMAX_FD
Definition: cache_snmp.h:125
PERF_PROTOSTAT_AGGR_HTTP_ERRORS
@ PERF_PROTOSTAT_AGGR_HTTP_ERRORS
Definition: cache_snmp.h:142
AggrType
AggrType
Definition: snmp_core.h:29
snmp_core.h
SNMP_PDU_RESPONSE
#define SNMP_PDU_RESPONSE
Definition: snmp_pdu.h:94
snmp_build
int snmp_build(struct snmp_session *, struct snmp_pdu *, u_char *, int *)
Definition: snmp_api.c:106
PERF_PROTOSTAT_AGGR_ICP_SKB
@ PERF_PROTOSTAT_AGGR_ICP_SKB
Definition: cache_snmp.h:147
xcalloc
void * xcalloc(size_t n, size_t sz)
Definition: xalloc.cc:71
client_Inst
static oid * client_Inst(oid *name, snint *len, mib_tree_entry *current, oid_ParseFn **Fn)
Definition: snmp_core.cc:778
oid2addr
void oid2addr(oid *id, Ip::Address &addr, u_int size)
Definition: snmp_core.cc:1107
static_Inst
static oid * static_Inst(oid *name, snint *len, mib_tree_entry *current, oid_ParseFn **Fn)
Definition: snmp_core.cc:692
MESH_PTBL_IGN
@ MESH_PTBL_IGN
Definition: cache_snmp.h:248
snmpDebugOid
const char * snmpDebugOid(oid *Name, snint Len, MemBuf &outbuf)
Definition: snmp_core.cc:1049
DBG_CRITICAL
#define DBG_CRITICAL
Definition: Stream.h:37
SNMP_VERSION_1
#define SNMP_VERSION_1
Definition: snmp_msg.h:40
xmalloc
#define xmalloc
Definition: negotiate_wrapper.cc:44
mib_tree_last
mib_tree_entry * mib_tree_last
Definition: snmp_core.cc:37
PERF_PROTOSTAT_AGGR_CURSWAP
@ PERF_PROTOSTAT_AGGR_CURSWAP
Definition: cache_snmp.h:153
snmpDecodePacket
static void snmpDecodePacket(SnmpRequest *rq)
Definition: snmp_core.cc:391
MESH_CTBL_ICPHITS
@ MESH_CTBL_ICPHITS
Definition: cache_snmp.h:265
PERF_SYS_CURRESERVED_FD
@ PERF_SYS_CURRESERVED_FD
Definition: cache_snmp.h:123
Snmp::Session
snmp_session wrapper add pack/unpack feature
Definition: Session.h:22
TIME_INDEX_LEN
#define TIME_INDEX_LEN
Definition: cache_snmp.h:38
ACLFilledChecklist::src_addr
Ip::Address src_addr
Definition: FilledChecklist.h:97
snmpAddNodeChild
static void snmpAddNodeChild(mib_tree_entry *entry, mib_tree_entry *child)
Definition: snmp_core.cc:878
SnmpRr::syncConfig
void syncConfig() override
Definition: snmp_core.cc:345
PERF_PROTOSTAT_AGGR_ICP_S
@ PERF_PROTOSTAT_AGGR_ICP_S
Definition: cache_snmp.h:145
MESH_CTBL_HTHITS
@ MESH_CTBL_HTHITS
Definition: cache_snmp.h:261
snmp_free_pdu
void snmp_free_pdu(struct snmp_pdu *)
Definition: snmp_pdu.c:284
snmpOpenPorts
static void snmpOpenPorts()
Definition: snmp_core.cc:256
_mib_tree_entry::name
oid * name
Definition: snmp_core.h:32
snmp_netIpFn
variable_list * snmp_netIpFn(variable_list *Var, snint *ErrP)
Definition: ipcache.cc:1173
_mib_tree_entry::parent
struct _mib_tree_entry * parent
Definition: snmp_core.h:40
IP_MISS
@ IP_MISS
Definition: cache_snmp.h:194
Ip::Address::isAnyAddr
bool isAnyAddr() const
Definition: Address.cc:190
MESH_CTBL_ICPREQ
@ MESH_CTBL_ICPREQ
Definition: cache_snmp.h:263
client_db.h
comm_udp_sendto
int comm_udp_sendto(int fd, const Ip::Address &to_addr, const void *buf, int len)
Definition: comm.cc:911
PERF_PROTOSTAT_AGGR_ICP_R
@ PERF_PROTOSTAT_AGGR_ICP_R
Definition: cache_snmp.h:146
SquidConfig::Port
struct SquidConfig::@78 Port
PERF_PROTOSTAT_AGGR_REQ
@ PERF_PROTOSTAT_AGGR_REQ
Definition: cache_snmp.h:149
MESH_PTBL_ADDR
@ MESH_PTBL_ADDR
Definition: cache_snmp.h:239
SquidConfig::Addrs
struct SquidConfig::@85 Addrs
PERF_PROTOSTAT_AGGR_HTTP_REQ
@ PERF_PROTOSTAT_AGGR_HTTP_REQ
Definition: cache_snmp.h:140
IP_LOC
@ IP_LOC
Definition: cache_snmp.h:196
PERF_MEDIAN_DNS
@ PERF_MEDIAN_DNS
Definition: cache_snmp.h:168
PERF_SYS
@ PERF_SYS
Definition: cache_snmp.h:105
_mib_tree_entry::children
int children
Definition: snmp_core.h:36
NET_DNS_CACHE
@ NET_DNS_CACHE
Definition: cache_snmp.h:182
_mib_tree_entry::parsefunction
oid_ParseFn * parsefunction
Definition: snmp_core.h:34
PERF_SYS_CURLRUEXP
@ PERF_SYS_CURLRUEXP
Definition: cache_snmp.h:120
PERF_SYS_CURUNLREQ
@ PERF_SYS_CURUNLREQ
Definition: cache_snmp.h:121
PERF_MEDIAN_BHR
@ PERF_MEDIAN_BHR
Definition: cache_snmp.h:170
time_Inst
static oid * time_Inst(oid *name, snint *len, mib_tree_entry *current, oid_ParseFn **Fn)
Definition: snmp_core.cc:706
FQDN_REQ
@ FQDN_REQ
Definition: cache_snmp.h:204
variable_list
Definition: snmp_vars.h:44
FQDN_ENT
@ FQDN_ENT
Definition: cache_snmp.h:203
Ip::Address::getInAddr
bool getInAddr(struct in_addr &) const
Definition: Address.cc:1032
PERF_MEDIAN_ICP_REPLY
@ PERF_MEDIAN_ICP_REPLY
Definition: cache_snmp.h:167
Acl::SnmpCommunityCheck::match
int match(ACLChecklist *) override
Matches the actual data in checklist against this Acl::Node.
Definition: snmp_core.cc:1129
client_entry
Ip::Address * client_entry(Ip::Address *current)
Definition: client_db.cc:421
atAverage
@ atAverage
Definition: snmp_core.h:29
snmp_parse
u_char * snmp_parse(struct snmp_session *, struct snmp_pdu *, u_char *, int)
Definition: snmp_api.c:129
PERF_PROTOSTAT_MEDIAN
@ PERF_PROTOSTAT_MEDIAN
Definition: cache_snmp.h:133
DNS_REQ
@ DNS_REQ
Definition: cache_snmp.h:216
Comm::IsConnOpen
bool IsConnOpen(const Comm::ConnectionPointer &conn)
Definition: Connection.cc:27
SnmpRr::startReconfigure
void startReconfigure() override
Definition: snmp_core.cc:344
snmpHandleUdp
void snmpHandleUdp(int sock, void *)
Definition: snmp_core.cc:354
PERF_SYS_CPUTIME
@ PERF_SYS_CPUTIME
Definition: cache_snmp.h:116
PERF_MEDIAN_HTTP_NM
@ PERF_MEDIAN_HTTP_NM
Definition: cache_snmp.h:164
INETADDRESSTYPE_IPV4
#define INETADDRESSTYPE_IPV4
Definition: snmp_vars.h:93
IamWorkerProcess
bool IamWorkerProcess()
whether the current process handles HTTP transactions and such
Definition: stub_tools.cc:47
PERF_SYS_NUMOBJCNT
@ PERF_SYS_NUMOBJCNT
Definition: cache_snmp.h:119
SnmpRequest::from
Ip::Address from
Definition: SnmpRequest.h:28
snmpOutgoingConn
Comm::ConnectionPointer snmpOutgoingConn
Definition: snmp_core.cc:40
Ip::Address::isIPv4
bool isIPv4() const
Definition: Address.cc:178
MESH_PTBL_PACKED
@ MESH_PTBL_PACKED
Definition: cache_snmp.h:245
snmpAddNode
static mib_tree_entry * snmpAddNode(oid *name, int len, oid_ParseFn *parsefunction, instance_Fn *instancefunction, AggrType aggrType, int children,...)
Definition: snmp_core.cc:991
snmp_confFn
variable_list * snmp_confFn(variable_list *Var, snint *ErrP)
Definition: snmp_agent.cc:83
SnmpRequest::buf
u_char * buf
Definition: SnmpRequest.h:21
_mib_tree_entry::aggrType
AggrType aggrType
Definition: snmp_core.h:41
MESH_PTBL_INDEX
@ MESH_PTBL_INDEX
Definition: cache_snmp.h:236
snmp_netDnsFn
variable_list * snmp_netDnsFn(variable_list *Var, snint *ErrP)
Definition: dns_internal.cc:1854
CONF_LOG_FAC
@ CONF_LOG_FAC
Definition: cache_snmp.h:75
IP_HITS
@ IP_HITS
Definition: cache_snmp.h:191
SnmpRr::finalizeConfig
void finalizeConfig() override
Definition: snmp_core.cc:342
IP_PENDHIT
@ IP_PENDHIT
Definition: cache_snmp.h:192
atNone
@ atNone
Definition: snmp_core.h:29
variable_list::name_length
int name_length
Definition: snmp_vars.h:71
CONF_ST_SWLOWM
@ CONF_ST_SWLOWM
Definition: cache_snmp.h:92
variable_list::name
oid * name
Definition: snmp_vars.h:70
snmp_prfProtoFn
variable_list * snmp_prfProtoFn(variable_list *Var, snint *ErrP)
Definition: snmp_agent.cc:432
MESH_CTBL
@ MESH_CTBL
Definition: cache_snmp.h:229
snmplib_debug_hook
SQUIDCEXTERN void(* snmplib_debug_hook)(int, char *)
Definition: snmp_core.cc:47
CONF_ADMIN
@ CONF_ADMIN
Definition: cache_snmp.h:72
Ipc::StartListeningAnswer
StartListening() result.
Definition: StartListening.h:27
PERF_SYS_MAXRESSZ
@ PERF_SYS_MAXRESSZ
Definition: cache_snmp.h:118
Ipc::StartListening
void StartListening(int sock_type, int proto, const Comm::ConnectionPointer &listenConn, FdNoteId, StartListeningCallback &)
Definition: StartListening.cc:32
CONF_ST_SWHIWM
@ CONF_ST_SWHIWM
Definition: cache_snmp.h:91
snint
int64_t snint
Definition: cache_snmp.h:14
size
int size
Definition: ModDevPoll.cc:70
MemBuf::append
void append(const char *c, int sz) override
Definition: MemBuf.cc:209
Ipc::StartListeningAnswer::conn
Comm::ConnectionPointer conn
opened listening socket
Definition: StartListening.h:30
snmp_var_new
struct variable_list * snmp_var_new(oid *, int)
Definition: snmp_vars.c:109
snmp_pdu::variables
struct variable_list * variables
Definition: snmp_pdu.h:86
snmpTreeSiblingEntry
static mib_tree_entry * snmpTreeSiblingEntry(oid entry, snint len, mib_tree_entry *current)
Definition: snmp_core.cc:848
PERF_MEDIAN_RHR
@ PERF_MEDIAN_RHR
Definition: cache_snmp.h:169
snmp_pdu::errindex
int errindex
Definition: snmp_pdu.h:80
mib_tree_head
mib_tree_entry * mib_tree_head
Definition: snmp_core.cc:36
snmp_meshPtblFn
variable_list * snmp_meshPtblFn(variable_list *Var, snint *ErrP)
Definition: snmp_agent.cc:189
Filled
ACLFilledChecklist * Filled(ACLChecklist *checklist)
convenience and safety wrapper for dynamic_cast<ACLFilledChecklist*>
Definition: FilledChecklist.h:146
snmpAgentResponse
struct snmp_pdu * snmpAgentResponse(struct snmp_pdu *PDU)
Definition: snmp_core.cc:469
ACLChecklist::fastCheck
const Acl::Answer & fastCheck()
Definition: Checklist.cc:298
Ipc::fdnOutSnmpSocket
@ fdnOutSnmpSocket
Definition: FdNotes.h:22
PERF_SYS_MEMUSAGE
@ PERF_SYS_MEMUSAGE
Definition: cache_snmp.h:115
SnmpRequest::session
struct snmp_session session
Definition: SnmpRequest.h:33
SQUIDCEXTERN
#define SQUIDCEXTERN
Definition: squid.h:21
Ip::Address::isIPv6
bool isIPv6() const
Definition: Address.cc:184
MemBuf
Definition: MemBuf.h:23
snmpTreeGet
static oid_ParseFn * snmpTreeGet(oid *Current, snint CurrentLen)
Definition: snmp_core.cc:551
MESH_PTBL
@ MESH_PTBL
Definition: cache_snmp.h:228
MESH_PTBL_KEEPAL_S
@ MESH_PTBL_KEEPAL_S
Definition: cache_snmp.h:249
FQDN_NEGHIT
@ FQDN_NEGHIT
Definition: cache_snmp.h:207
snmp_pdu_create
struct snmp_pdu * snmp_pdu_create(int)
Definition: snmp_pdu.c:113
PERF_MEDIAN_ICP_QUERY
@ PERF_MEDIAN_ICP_QUERY
Definition: cache_snmp.h:166
snmp_pdu::command
int command
Definition: snmp_pdu.h:75
safe_free
#define safe_free(x)
Definition: xalloc.h:73
snmp_pdu::reqid
int reqid
Definition: snmp_pdu.h:78
SquidConfig::snmp
unsigned short snmp
Definition: SquidConfig.h:148
MESH_CTBL_ADDR
@ MESH_CTBL_ADDR
Definition: cache_snmp.h:258
PERF_MEDIAN_HTTP_NH
@ PERF_MEDIAN_HTTP_NH
Definition: cache_snmp.h:171
IP_NEGHIT
@ IP_NEGHIT
Definition: cache_snmp.h:193
PERF_PROTOSTAT_AGGR_KBYTES_IN
@ PERF_PROTOSTAT_AGGR_KBYTES_IN
Definition: cache_snmp.h:151
assert
#define assert(EX)
Definition: assert.h:17
NET_IP_CACHE
@ NET_IP_CACHE
Definition: cache_snmp.h:180
IP_GHBN
@ IP_GHBN
Definition: cache_snmp.h:195
NET_FQDN_CACHE
@ NET_FQDN_CACHE
Definition: cache_snmp.h:181
Security::Connection
SSL Connection
Definition: Session.h:49
IPV6_SPECIAL_SPLITSTACK
#define IPV6_SPECIAL_SPLITSTACK
Definition: tools.h:22
CONF_VERSION
@ CONF_VERSION
Definition: cache_snmp.h:73
fatalf
void fatalf(const char *fmt,...)
Definition: fatal.cc:68
snmp_agent.h
TIME_INDEX
#define TIME_INDEX
Definition: cache_snmp.h:37
identifier
static char identifier[MAXLINE]
Definition: basic_radius_auth.cc:103
atSum
@ atSum
Definition: snmp_core.h:29
CONF_ST_SWMAXSZ
@ CONF_ST_SWMAXSZ
Definition: cache_snmp.h:90
COMM_SELECT_READ
#define COMM_SELECT_READ
Definition: defines.h:24
snmpIncomingConn
Comm::ConnectionPointer snmpIncomingConn
Definition: snmp_core.cc:39
MESH_PTBL_STATE
@ MESH_PTBL_STATE
Definition: cache_snmp.h:243
SNMP_PDU_GET
#define SNMP_PDU_GET
Definition: snmp_pdu.h:92
snmpConstructReponse
static void snmpConstructReponse(SnmpRequest *rq)
Definition: snmp_core.cc:437
PERF_PROTOSTAT_AGGR_ERRORS
@ PERF_PROTOSTAT_AGGR_ERRORS
Definition: cache_snmp.h:150
IP_REQ
@ IP_REQ
Definition: cache_snmp.h:190
snmp_netFqdnFn
variable_list * snmp_netFqdnFn(variable_list *Var, snint *ErrP)
Definition: fqdncache.cc:716
PERF_MEDIAN_TIME
@ PERF_MEDIAN_TIME
Definition: cache_snmp.h:161
PERF_PROTOSTAT_AGGR_HTTP_KBYTES_IN
@ PERF_PROTOSTAT_AGGR_HTTP_KBYTES_IN
Definition: cache_snmp.h:143
Ip::Address::isNoAddr
bool isNoAddr() const
Definition: Address.cc:304
xfree
#define xfree
Definition: negotiate_wrapper.cc:50
MESH_PTBL_TYPE
@ MESH_PTBL_TYPE
Definition: cache_snmp.h:242
Snmp::Pdu
Definition: Pdu.h:23
PERF_SYS_PF
@ PERF_SYS_PF
Definition: cache_snmp.h:113
snmp_var_free
void snmp_var_free(struct variable_list *)
Definition: snmp_vars.c:227
Ipc::fdnInSnmpSocket
@ fdnInSnmpSocket
Definition: FdNotes.h:22
FQDN_GHBN
@ FQDN_GHBN
Definition: cache_snmp.h:209
SnmpRequest::outbuf
u_char * outbuf
Definition: SnmpRequest.h:22
SquidConfig::snmp_outgoing
Ip::Address snmp_outgoing
Definition: SquidConfig.h:239
SnmpRequest::PDU
struct snmp_pdu * PDU
Definition: SnmpRequest.h:30
snmpClosePorts
static void snmpClosePorts()
Definition: snmp_core.cc:321
snmpLookupNodeStr
mib_tree_entry * snmpLookupNodeStr(mib_tree_entry *entry, const char *str)
Definition: snmp_core.cc:888
_mib_tree_entry::instancefunction
instance_Fn * instancefunction
Definition: snmp_core.h:35
MESH_CTBL_ICPHITBYTES
@ MESH_CTBL_ICPHITBYTES
Definition: cache_snmp.h:266
oid
u_int oid
Definition: asn1.h:42
MESH_PTBL_SENT
@ MESH_PTBL_SENT
Definition: cache_snmp.h:244
snmpPortOpened
static void snmpPortOpened(Ipc::StartListeningAnswer &)
Definition: snmp_core.cc:303
FQDN_HITS
@ FQDN_HITS
Definition: cache_snmp.h:205
snmp_sysFn
variable_list * snmp_sysFn(variable_list *Var, snint *ErrP)
Definition: snmp_agent.cc:44
peer_Inst
static oid * peer_Inst(oid *name, snint *len, mib_tree_entry *current, oid_ParseFn **Fn)
Definition: snmp_core.cc:735
Acl::Answer::allowed
bool allowed() const
Definition: Acl.h:82
SNMP_PDU_GETNEXT
#define SNMP_PDU_GETNEXT
Definition: snmp_pdu.h:93
DNS_SERVERS
@ DNS_SERVERS
Definition: cache_snmp.h:218
snmpTreeEntry
static mib_tree_entry * snmpTreeEntry(oid entry, snint len, mib_tree_entry *current)
Definition: snmp_core.cc:861
PERF_PROTOSTAT_AGGR_CLIENTS
@ PERF_PROTOSTAT_AGGR_CLIENTS
Definition: cache_snmp.h:154
PERF_MEDIAN_HTTP_ALL
@ PERF_MEDIAN_HTTP_ALL
Definition: cache_snmp.h:162
snmp_meshCtblFn
variable_list * snmp_meshCtblFn(variable_list *Var, snint *ErrP)
Definition: client_db.cc:442
FQDN_PENDHIT
@ FQDN_PENDHIT
Definition: cache_snmp.h:206
MESH_CTBL_HTREQ
@ MESH_CTBL_HTREQ
Definition: cache_snmp.h:259
Comm::SetSelect
void SetSelect(int, unsigned int, PF *, void *, time_t)
Mark an FD to be watched for its IO status.
Definition: ModDevPoll.cc:220
snmp_session::Version
int Version
Definition: snmp_session.h:59
MemBuf::content
char * content()
start of the added data
Definition: MemBuf.h:41
SquidConfig::accessList
struct SquidConfig::@91 accessList
atMin
@ atMin
Definition: snmp_core.h:29
CONF_VERSION_ID
@ CONF_VERSION_ID
Definition: cache_snmp.h:74
PERF_SYS_CURUNUSED_FD
@ PERF_SYS_CURUNUSED_FD
Definition: cache_snmp.h:122
CachePeers::size
auto size() const
the number of currently stored (i.e. added and not removed) cache_peers
Definition: CachePeers.h:33
_mib_tree_entry
Definition: snmp_core.h:31
snmpAggrType
AggrType snmpAggrType(oid *Current, snint CurrentLen)
Definition: snmp_core.cc:582
SquidConfig::snmp_incoming
Ip::Address snmp_incoming
Definition: SquidConfig.h:238
Ip::Address::setAnyAddr
void setAnyAddr()
NOTE: Does NOT clear the Port stored. Only the Address and Type.
Definition: Address.cc:197
PERF_PROTOSTAT_AGGR_KBYTES_OUT
@ PERF_PROTOSTAT_AGGR_KBYTES_OUT
Definition: cache_snmp.h:152
oid_ParseFn
variable_list *() oid_ParseFn(variable_list *, snint *)
Definition: snmp_core.h:26
PERF_MEDIAN_HTTP_MISS
@ PERF_MEDIAN_HTTP_MISS
Definition: cache_snmp.h:163
_mib_tree_entry::leaves
struct _mib_tree_entry ** leaves
Definition: snmp_core.h:38
DBG_IMPORTANT
#define DBG_IMPORTANT
Definition: Stream.h:38
_mib_tree_entry::len
int len
Definition: snmp_core.h:33
snmpAddNodeStr
static mib_tree_entry * snmpAddNodeStr(const char *base_str, int o, oid_ParseFn *parsefunction, instance_Fn *instancefunction, AggrType aggrType=atNone)
Definition: snmp_core.cc:959
DNS_REP
@ DNS_REP
Definition: cache_snmp.h:217
MYNAME
#define MYNAME
Definition: Stream.h:219
SnmpRr::startShutdown
void startShutdown() override
Definition: snmp_core.cc:346
MemBuf::reset
void reset()
Definition: MemBuf.cc:129
SnmpRr::useConfig
void useConfig() override
Definition: snmp_core.cc:343
snmp_pdu
Definition: snmp_pdu.h:50
CONF_UNIQNAME
@ CONF_UNIQNAME
Definition: cache_snmp.h:77
PERF_SYS_CPUUSAGE
@ PERF_SYS_CPUUSAGE
Definition: cache_snmp.h:117
CONF_ST_MMAXSZ
@ CONF_ST_MMAXSZ
Definition: cache_snmp.h:89
MESH_PTBL_ADDR_TYPE
@ MESH_PTBL_ADDR_TYPE
Definition: cache_snmp.h:238
snmpTreeNext
static oid_ParseFn * snmpTreeNext(oid *Current, snint CurrentLen, oid **Next, snint *NextLen)
Definition: snmp_core.cc:605
atMax
@ atMax
Definition: snmp_core.h:29
INETADDRESSTYPE_IPV6
#define INETADDRESSTYPE_IPV6
Definition: snmp_vars.h:94
IP_ENT
@ IP_ENT
Definition: cache_snmp.h:189
MESH_PTBL_RTT
@ MESH_PTBL_RTT
Definition: cache_snmp.h:247
MESH_PTBL_HTTP
@ MESH_PTBL_HTTP
Definition: cache_snmp.h:240
PERF_PROTO
@ PERF_PROTO
Definition: cache_snmp.h:106
comm_udp_recvfrom
int comm_udp_recvfrom(int fd, void *buf, size_t len, int flags, Ip::Address &from)
Definition: comm.cc:128
MESH_PTBL_NAME
@ MESH_PTBL_NAME
Definition: cache_snmp.h:237
SYS_UPTIME
@ SYS_UPTIME
Definition: cache_snmp.h:60
PERF_PROTOSTAT_AGGR_HTTP_HITS
@ PERF_PROTOSTAT_AGGR_HTTP_HITS
Definition: cache_snmp.h:141
SNMP_REQUEST_SIZE
#define SNMP_REQUEST_SIZE
Definition: snmp_core.h:23
CONF_STORAGE
@ CONF_STORAGE
Definition: cache_snmp.h:76
SNMP_ERR_NOSUCHNAME
#define SNMP_ERR_NOSUCHNAME
Definition: snmp_error.h:44
CurrentCachePeers
const CachePeers & CurrentCachePeers()
Definition: CachePeers.cc:43
FQDN_MISS
@ FQDN_MISS
Definition: cache_snmp.h:208
instance_Fn
oid *() instance_Fn(oid *name, snint *len, mib_tree_entry *current, oid_ParseFn **Fn)
Definition: snmp_core.h:28
snmp_prfSysFn
variable_list * snmp_prfSysFn(variable_list *Var, snint *ErrP)
Definition: snmp_agent.cc:324
snmpInit
static void snmpInit()
Definition: snmp_core.cc:65
PERF_SYS_CURUSED_FD
@ PERF_SYS_CURUSED_FD
Definition: cache_snmp.h:124
UsingSmp
bool UsingSmp()
Whether there should be more than one worker process running.
Definition: tools.cc:697
MESH_CTBL_ADDR_TYPE
@ MESH_CTBL_ADDR_TYPE
Definition: cache_snmp.h:257
MESH_CTBL_HTBYTES
@ MESH_CTBL_HTBYTES
Definition: cache_snmp.h:260
MESH_PTBL_KEEPAL_R
@ MESH_PTBL_KEEPAL_R
Definition: cache_snmp.h:250
variable_list::next_variable
struct variable_list * next_variable
Definition: snmp_vars.h:69
asyncCallbackFun
#define asyncCallbackFun(dbgSection, dbgLevel, function)
AsyncCall for calling back a function.
Definition: AsyncCallbacks.h:201
PERF_PROTOSTAT_AGGR
@ PERF_PROTOSTAT_AGGR
Definition: cache_snmp.h:132
Less
constexpr bool Less(const A a, const B b)
whether integer a is less than integer b, with correct overflow handling
Definition: SquidMath.h:48
Ip::EnableIpv6
int EnableIpv6
Whether IPv6 is supported and type of support.
Definition: tools.h:25
PERF_PROTOSTAT_AGGR_HTTP_KBYTES_OUT
@ PERF_PROTOSTAT_AGGR_HTTP_KBYTES_OUT
Definition: cache_snmp.h:144
xrealloc
void * xrealloc(void *s, size_t sz)
Definition: xalloc.cc:126
MESH_CTBL_HTHITBYTES
@ MESH_CTBL_HTHITBYTES
Definition: cache_snmp.h:262
PERF_MEDIAN_HTTP_HIT
@ PERF_MEDIAN_HTTP_HIT
Definition: cache_snmp.h:165
DefineRunnerRegistrator
DefineRunnerRegistrator(SnmpRr)
snmpSnmplibDebug
void snmpSnmplibDebug(int lvl, char *buf)
Definition: snmp_core.cc:1063
snmpCreateOidFromStr
bool snmpCreateOidFromStr(const char *str, oid **name, int *nl)
Definition: snmp_core.cc:930
debugs
#define debugs(SECTION, LEVEL, CONTENT)
Definition: Stream.h:192
addr2oid
void addr2oid(Ip::Address &addr, oid *Dest)
Definition: snmp_core.cc:1075
MESH_CTBL_ICPBYTES
@ MESH_CTBL_ICPBYTES
Definition: cache_snmp.h:264
MESH_PTBL_ICP
@ MESH_PTBL_ICP
Definition: cache_snmp.h:241
SnmpRequest::community
u_char * community
Definition: SnmpRequest.h:31
SNMP_ERR_NOERROR
#define SNMP_ERR_NOERROR
Definition: snmp_error.h:42
snmp_coexist_V2toV1
int snmp_coexist_V2toV1(struct snmp_pdu *)
Definition: coexistance.c:108
snmpCreateOid
static oid * snmpCreateOid(int length,...)
Definition: snmp_core.cc:1026
Config
class SquidConfig Config
Definition: SquidConfig.cc:12
int
int unsigned int
Definition: stub_fd.cc:19
AsyncJob::Start
static void Start(const Pointer &job)
Definition: AsyncJob.cc:37
snmp_pdu::errstat
int errstat
Definition: snmp_pdu.h:79
PERF_SYS_NUMR
@ PERF_SYS_NUMR
Definition: cache_snmp.h:114
PERF_PROTOSTAT_AGGR_ICP_RKB
@ PERF_PROTOSTAT_AGGR_ICP_RKB
Definition: cache_snmp.h:148

 

Introduction

Documentation

Support

Miscellaneous