Prusa MINI Firmware overview
snmp.h
Go to the documentation of this file.
1 /**
2  * @file
3  * SNMP support API for implementing netifs and statitics for MIB2
4  */
5 
6 /*
7  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
8  * All rights reserved.
9  *
10  * Redistribution and use in source and binary forms, with or without modification,
11  * are permitted provided that the following conditions are met:
12  *
13  * 1. Redistributions of source code must retain the above copyright notice,
14  * this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright notice,
16  * this list of conditions and the following disclaimer in the documentation
17  * and/or other materials provided with the distribution.
18  * 3. The name of the author may not be used to endorse or promote products
19  * derived from this software without specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
22  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
23  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
24  * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
25  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
26  * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
29  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
30  * OF SUCH DAMAGE.
31  *
32  * This file is part of the lwIP TCP/IP stack.
33  *
34  * Author: Dirk Ziegelmeier <dziegel@gmx.de>
35  *
36  */
37 #ifndef LWIP_HDR_SNMP_H
38 #define LWIP_HDR_SNMP_H
39 
40 #include "lwip/opt.h"
41 #include "lwip/ip_addr.h"
42 
43 #ifdef __cplusplus
44 extern "C" {
45 #endif
46 
47 struct udp_pcb;
48 struct netif;
49 
50 /**
51  * @defgroup netif_mib2 MIB2 statistics
52  * @ingroup netif
53  */
54 
55 /* MIB2 statistics functions */
56 #if MIB2_STATS /* don't build if not configured for use in lwipopts.h */
57 /**
58  * @ingroup netif_mib2
59  * @see RFC1213, "MIB-II, 6. Definitions"
60  */
61 enum snmp_ifType {
62  snmp_ifType_other=1, /* none of the following */
63  snmp_ifType_regular1822,
64  snmp_ifType_hdh1822,
65  snmp_ifType_ddn_x25,
66  snmp_ifType_rfc877_x25,
67  snmp_ifType_ethernet_csmacd,
68  snmp_ifType_iso88023_csmacd,
69  snmp_ifType_iso88024_tokenBus,
70  snmp_ifType_iso88025_tokenRing,
71  snmp_ifType_iso88026_man,
72  snmp_ifType_starLan,
73  snmp_ifType_proteon_10Mbit,
74  snmp_ifType_proteon_80Mbit,
75  snmp_ifType_hyperchannel,
76  snmp_ifType_fddi,
77  snmp_ifType_lapb,
78  snmp_ifType_sdlc,
79  snmp_ifType_ds1, /* T-1 */
80  snmp_ifType_e1, /* european equiv. of T-1 */
81  snmp_ifType_basicISDN,
82  snmp_ifType_primaryISDN, /* proprietary serial */
83  snmp_ifType_propPointToPointSerial,
84  snmp_ifType_ppp,
85  snmp_ifType_softwareLoopback,
86  snmp_ifType_eon, /* CLNP over IP [11] */
87  snmp_ifType_ethernet_3Mbit,
88  snmp_ifType_nsip, /* XNS over IP */
89  snmp_ifType_slip, /* generic SLIP */
90  snmp_ifType_ultra, /* ULTRA technologies */
91  snmp_ifType_ds3, /* T-3 */
92  snmp_ifType_sip, /* SMDS */
93  snmp_ifType_frame_relay
94 };
95 
96 /** This macro has a precision of ~49 days because sys_now returns u32_t. \#define your own if you want ~490 days. */
97 #ifndef MIB2_COPY_SYSUPTIME_TO
98 #define MIB2_COPY_SYSUPTIME_TO(ptrToVal) (*(ptrToVal) = (sys_now() / 10))
99 #endif
100 
101 /**
102  * @ingroup netif_mib2
103  * Increment stats member for SNMP MIB2 stats (struct stats_mib2_netif_ctrs)
104  */
105 #define MIB2_STATS_NETIF_INC(n, x) do { ++(n)->mib2_counters.x; } while(0)
106 /**
107  * @ingroup netif_mib2
108  * Add value to stats member for SNMP MIB2 stats (struct stats_mib2_netif_ctrs)
109  */
110 #define MIB2_STATS_NETIF_ADD(n, x, val) do { (n)->mib2_counters.x += (val); } while(0)
111 
112 /**
113  * @ingroup netif_mib2
114  * Init MIB2 statistic counters in netif
115  * @param netif Netif to init
116  * @param type one of enum @ref snmp_ifType
117  * @param speed your link speed here (units: bits per second)
118  */
119 #define MIB2_INIT_NETIF(netif, type, speed) do { \
120  (netif)->link_type = (type); \
121  (netif)->link_speed = (speed);\
122  (netif)->ts = 0; \
123  (netif)->mib2_counters.ifinoctets = 0; \
124  (netif)->mib2_counters.ifinucastpkts = 0; \
125  (netif)->mib2_counters.ifinnucastpkts = 0; \
126  (netif)->mib2_counters.ifindiscards = 0; \
127  (netif)->mib2_counters.ifinerrors = 0; \
128  (netif)->mib2_counters.ifinunknownprotos = 0; \
129  (netif)->mib2_counters.ifoutoctets = 0; \
130  (netif)->mib2_counters.ifoutucastpkts = 0; \
131  (netif)->mib2_counters.ifoutnucastpkts = 0; \
132  (netif)->mib2_counters.ifoutdiscards = 0; \
133  (netif)->mib2_counters.ifouterrors = 0; } while(0)
134 #else /* MIB2_STATS */
135 #ifndef MIB2_COPY_SYSUPTIME_TO
136 #define MIB2_COPY_SYSUPTIME_TO(ptrToVal)
137 #endif
138 #define MIB2_INIT_NETIF(netif, type, speed)
139 #define MIB2_STATS_NETIF_INC(n, x)
140 #define MIB2_STATS_NETIF_ADD(n, x, val)
141 #endif /* MIB2_STATS */
142 
143 /* LWIP MIB2 callbacks */
144 #if LWIP_MIB2_CALLBACKS /* don't build if not configured for use in lwipopts.h */
145 /* network interface */
146 void mib2_netif_added(struct netif *ni);
147 void mib2_netif_removed(struct netif *ni);
148 
149 #if LWIP_IPV4 && LWIP_ARP
150 /* ARP (for atTable and ipNetToMediaTable) */
151 void mib2_add_arp_entry(struct netif *ni, ip4_addr_t *ip);
152 void mib2_remove_arp_entry(struct netif *ni, ip4_addr_t *ip);
153 #else /* LWIP_IPV4 && LWIP_ARP */
154 #define mib2_add_arp_entry(ni,ip)
155 #define mib2_remove_arp_entry(ni,ip)
156 #endif /* LWIP_IPV4 && LWIP_ARP */
157 
158 /* IP */
159 #if LWIP_IPV4
160 void mib2_add_ip4(struct netif *ni);
161 void mib2_remove_ip4(struct netif *ni);
162 void mib2_add_route_ip4(u8_t dflt, struct netif *ni);
163 void mib2_remove_route_ip4(u8_t dflt, struct netif *ni);
164 #endif /* LWIP_IPV4 */
165 
166 /* UDP */
167 #if LWIP_UDP
168 void mib2_udp_bind(struct udp_pcb *pcb);
169 void mib2_udp_unbind(struct udp_pcb *pcb);
170 #endif /* LWIP_UDP */
171 
172 #else /* LWIP_MIB2_CALLBACKS */
173 /* LWIP_MIB2_CALLBACKS support not available */
174 /* define everything to be empty */
175 
176 /* network interface */
177 #define mib2_netif_added(ni)
178 #define mib2_netif_removed(ni)
179 
180 /* ARP */
181 #define mib2_add_arp_entry(ni,ip)
182 #define mib2_remove_arp_entry(ni,ip)
183 
184 /* IP */
185 #define mib2_add_ip4(ni)
186 #define mib2_remove_ip4(ni)
187 #define mib2_add_route_ip4(dflt, ni)
188 #define mib2_remove_route_ip4(dflt, ni)
189 
190 /* UDP */
191 #define mib2_udp_bind(pcb)
192 #define mib2_udp_unbind(pcb)
193 #endif /* LWIP_MIB2_CALLBACKS */
194 
195 /* for source-code compatibility reasons only, can be removed (not used internally) */
196 #define NETIF_INIT_SNMP MIB2_INIT_NETIF
197 #define snmp_add_ifinoctets(ni,value) MIB2_STATS_NETIF_ADD(ni, ifinoctets, value)
198 #define snmp_inc_ifinucastpkts(ni) MIB2_STATS_NETIF_INC(ni, ifinucastpkts)
199 #define snmp_inc_ifinnucastpkts(ni) MIB2_STATS_NETIF_INC(ni, ifinnucastpkts)
200 #define snmp_inc_ifindiscards(ni) MIB2_STATS_NETIF_INC(ni, ifindiscards)
201 #define snmp_inc_ifinerrors(ni) MIB2_STATS_NETIF_INC(ni, ifinerrors)
202 #define snmp_inc_ifinunknownprotos(ni) MIB2_STATS_NETIF_INC(ni, ifinunknownprotos)
203 #define snmp_add_ifoutoctets(ni,value) MIB2_STATS_NETIF_ADD(ni, ifoutoctets, value)
204 #define snmp_inc_ifoutucastpkts(ni) MIB2_STATS_NETIF_INC(ni, ifoutucastpkts)
205 #define snmp_inc_ifoutnucastpkts(ni) MIB2_STATS_NETIF_INC(ni, ifoutnucastpkts)
206 #define snmp_inc_ifoutdiscards(ni) MIB2_STATS_NETIF_INC(ni, ifoutdiscards)
207 #define snmp_inc_ifouterrors(ni) MIB2_STATS_NETIF_INC(ni, ifouterrors)
208 
209 #ifdef __cplusplus
210 }
211 #endif
212 
213 #endif /* LWIP_HDR_SNMP_H */
mib2_udp_bind
#define mib2_udp_bind(pcb)
Definition: snmp.h:191
opt.h
mib2_netif_added
#define mib2_netif_added(ni)
Definition: snmp.h:177
mib2_remove_arp_entry
#define mib2_remove_arp_entry(ni, ip)
Definition: snmp.h:182
mib2_udp_unbind
#define mib2_udp_unbind(pcb)
Definition: snmp.h:192
u8_t
uint8_t u8_t
Definition: arch.h:119
mib2_add_route_ip4
#define mib2_add_route_ip4(dflt, ni)
Definition: snmp.h:187
mib2_remove_route_ip4
#define mib2_remove_route_ip4(dflt, ni)
Definition: snmp.h:188
netif
Definition: netif.h:225
mib2_add_arp_entry
#define mib2_add_arp_entry(ni, ip)
Definition: snmp.h:181
mib2_netif_removed
#define mib2_netif_removed(ni)
Definition: snmp.h:178
mib2_add_ip4
#define mib2_add_ip4(ni)
Definition: snmp.h:185
mib2_remove_ip4
#define mib2_remove_ip4(ni)
Definition: snmp.h:186
ip_addr.h