snmp_inc_sysuptime(). You should call this from a timer interrupt
or a timer signal handler depending on your runtime environment.
+You _must_ create the following support functions for non-volatile storage
+since lwIP does not have notion of files or other non-volatile memories.
+
+void snmp_store_syscontact(u8_t* ocstr, u8_t ocstrlen);
+void snmp_store_sysname(u8_t* ocstr, u8_t ocstrlen);
+void snmp_store_syslocation(u8_t* ocstr, u8_t ocstrlen);
+
+
+
Private MIBs
============
If you need to create your own private MIB you'll need
to apply for your own enterprise ID with IANA: http://www.iana.org/numbers.html
-You can supply it in your lwipopts.h #define SNMP_ENTERPRISE_ID your_id
+You can set it by passing a struct snmp_obj_id to the agent
+using snmp_set_sysobjid(&my_object_id), just before snmp_init().
Agent internals [advanced use]
==============================
#include "lwip/ip_addr.h"
#include "lwip/netif.h"
#include "lwip/tcp.h"
+#if LWIP_SNMP
+#include "lwip/snmp.h"
+#endif
struct netif *netif_list = NULL;
struct netif *netif_default = NULL;
+u16_t netif_cnt = 0;
/**
* Add a network interface to the list of lwIP netifs.
/* add this netif to the list */
netif->next = netif_list;
netif_list = netif;
+ netif_cnt++;
LWIP_DEBUGF(NETIF_DEBUG, ("netif: added interface %c%c IP addr ",
netif->name[0], netif->name[1]));
ip_addr_debug_print(NETIF_DEBUG, ipaddr);
/* is it the first netif? */
if (netif_list == netif) {
netif_list = netif->next;
+ netif_cnt--;
}
else {
/* look for netif further down the list */
for (tmpNetif = netif_list; tmpNetif != NULL; tmpNetif = tmpNetif->next) {
if (tmpNetif->next == netif) {
tmpNetif->next = netif->next;
+ netif_cnt--;
break;
- }
+ }
}
if (tmpNetif == NULL)
return; /* we didn't find any netif today */
void netif_set_up(struct netif *netif)
{
netif->flags |= NETIF_FLAG_UP;
+#if LWIP_SNMP
+ snmp_get_sysuptime(&netif->ts);
+#endif
}
/**
void netif_set_down(struct netif *netif)
{
netif->flags &= ~NETIF_FLAG_UP;
+#if LWIP_SNMP
+ snmp_get_sysuptime(&netif->ts);
+#endif
}
void
netif_init(void)
{
netif_list = netif_default = NULL;
+ netif_cnt = 0;
}
#define __LWIP_SNMP_H__
#include "lwip/opt.h"
+#include "lwip/netif.h"
/* SNMP support available? */
#if defined(LWIP_SNMP) && (LWIP_SNMP > 0)
};
/* system */
+void snmp_set_sysdesr(char* str, u8_t strlen);
+void snmp_set_sysobjid(struct snmp_obj_id *oid);
+void snmp_get_sysobjid_ptr(struct snmp_obj_id **oid);
void snmp_inc_sysuptime(void);
void snmp_get_sysuptime(u32_t *value);
-void snmp_get_sysobjid(const struct snmp_obj_id **oid);
+void snmp_set_syscontact(u8_t *ocstr, u8_t ocstrlen);
+void snmp_set_sysname(u8_t *ocstr, u8_t ocstrlen);
+void snmp_set_syslocation(u8_t *ocstr, u8_t ocstrlen);
+/** externally supplied system functions
+ @see lwip/doc/snmp_agent.txt */
+void snmp_store_syscontact(u8_t* ocstr, u8_t ocstrlen);
+void snmp_store_sysname(u8_t* ocstr, u8_t ocstrlen);
+void snmp_store_syslocation(u8_t* ocstr, u8_t ocstrlen);
/* network interface */
-void snmp_add_ifinoctets(u32_t value);
-void snmp_inc_ifinucastpkts(void);
-void snmp_inc_ifinnucastpkts(void);
-void snmp_inc_ifindiscards(void);
-void snmp_add_ifoutoctets(u32_t value);
-void snmp_inc_ifoutucastpkts(void);
-void snmp_inc_ifoutnucastpkts(void);
-void snmp_inc_ifoutdiscards(void);
+void snmp_add_ifinoctets(struct netif *ni, u32_t value);
+void snmp_inc_ifinucastpkts(struct netif *ni);
+void snmp_inc_ifinnucastpkts(struct netif *ni);
+void snmp_inc_ifindiscards(struct netif *ni);
+void snmp_add_ifoutoctets(struct netif *ni, u32_t value);
+void snmp_inc_ifoutucastpkts(struct netif *ni);
+void snmp_inc_ifoutnucastpkts(struct netif *ni);
+void snmp_inc_ifoutdiscards(struct netif *ni);
/* IP */
void snmp_inc_ipinreceives(void);
void snmp_inc_snmpoutsetrequests(void);
void snmp_inc_snmpoutgetresponses(void);
void snmp_inc_snmpouttraps(void);
-void snmp_get_snmpgrpid(const struct snmp_obj_id **oid);
+void snmp_get_snmpgrpid_ptr(struct snmp_obj_id **oid);
/* LWIP_SNMP support not available */
/* define everything to be empty */
/* system */
#define snmp_inc_sysuptime()
#define snmp_get_sysuptime(value)
-#define snmp_get_sysobjid(oid)
+#define snmp_get_sysobjid_ptr(oid)
/* network interface */
-#define snmp_add_ifinoctets(value)
-#define snmp_inc_ifinucastpkts()
-#define snmp_inc_ifinnucastpkts()
-#define snmp_inc_ifindiscards()
-#define snmp_add_ifoutoctets(value)
-#define snmp_inc_ifoutucastpkts()
-#define snmp_inc_ifoutnucastpkts()
-#define snmp_inc_ifoutdiscards()
+#define snmp_add_ifinoctets(ni,value)
+#define snmp_inc_ifinucastpkts(ni)
+#define snmp_inc_ifinnucastpkts(ni)
+#define snmp_inc_ifindiscards(ni)
+#define snmp_add_ifoutoctets(ni,value)
+#define snmp_inc_ifoutucastpkts(ni)
+#define snmp_inc_ifoutnucastpkts(ni)
+#define snmp_inc_ifoutdiscards(ni)
/* IP */
#define snmp_inc_ipinreceives()
#define snmp_inc_snmpoutsetrequests()
#define snmp_inc_snmpoutgetresponses()
#define snmp_inc_snmpouttraps()
-#define snmp_get_snmpgrpid()
+#define snmp_get_snmpgrpid_ptr(oid)
#endif