/**
* container initialization
*
* @param container_ptr_ptr A pointer to a container pointer. If you
* create a custom container, use this parameter to return it
* to the MFD helper. If set to NULL, the MFD helper will
* allocate a container for you.
* @param cache A pointer to a cache structure. You can set the timeout
* and other cache flags using this pointer.
*
* This function is called at startup to allow you to customize certain
* aspects of the access method. For the most part, it is for advanced
* users. The default code should suffice for most cases. If no custom
* container is allocated, the MFD code will create one for your.
*
* This is also the place to set up cache behavior. The default, to
* simply set the cache timeout, will work well with the default
* container. If you are using a custom container, you may want to
* look at the cache helper documentation to see if there are any
* flags you want to set.
*
* @remark
* This would also be a good place to do any initialization needed
* for you data source. For example, opening a connection to another
* process that will supply the data, opening a database, etc.
*/
void
ipSystemStatsTable_container_init(netsnmp_container **container_ptr_ptr,
netsnmp_cache * cache)
{
DEBUGMSGTL(("verbose:ipSystemStatsTable:ipSystemStatsTable_container_init", "called\n"));
if (NULL == container_ptr_ptr) {
snmp_log(LOG_ERR,
"bad container param to ipSystemStatsTable_container_init\n");
return;
}
/*
* For advanced users, you can use a custom container. If you
* do not create one, one will be created for you.
*/
*container_ptr_ptr = netsnmp_container_find("ipSystemStatsTable:table_container");
if (NULL == cache) {
snmp_log(LOG_ERR,
"bad cache param to ipSystemStatsTable_container_init\n");
return;
}
/*
* TODO:345:A: Set up ipSystemStatsTable cache properties.
*
* Also for advanced users, you can set parameters for the
* cache. Do not change the magic pointer, as it is used
* by the MFD helper. To completely disable caching, set
* cache->enabled to 0.
*/
cache->timeout = IPSYSTEMSTATSTABLE_CACHE_TIMEOUT; /* seconds */
/*
* don't release resources
*/
cache->flags |=
(NETSNMP_CACHE_DONT_AUTO_RELEASE | NETSNMP_CACHE_DONT_FREE_EXPIRED
| NETSNMP_CACHE_DONT_FREE_BEFORE_LOAD |
NETSNMP_CACHE_AUTO_RELOAD);
ipSystemStatsTable_container_load(*container_ptr_ptr);
} /* ipSystemStatsTable_container_init */
/**
* @internal
*/
static int
_cache_load(netsnmp_cache * cache, void *vmagic)
{
DEBUGMSGTL(("internal:ipSystemStatsTable:_cache_load", "called\n"));
if ((NULL == cache) || (NULL == cache->magic)) {
snmp_log(LOG_ERR,
"invalid cache for ipSystemStatsTable_cache_load\n");
return -1;
}
/** should only be called for an invalid or expired cache */
netsnmp_assert((0 == cache->valid) || (1 == cache->expired));
/*
* call user code
*/
return ipSystemStatsTable_container_load((netsnmp_container *) cache->
magic);
} /* _cache_load */
