diff options
Diffstat (limited to 'agent/mibgroup/ip-mib/ipv4InterfaceTable/ipv4InterfaceTable.c')
-rw-r--r-- | agent/mibgroup/ip-mib/ipv4InterfaceTable/ipv4InterfaceTable.c | 959 |
1 files changed, 959 insertions, 0 deletions
diff --git a/agent/mibgroup/ip-mib/ipv4InterfaceTable/ipv4InterfaceTable.c b/agent/mibgroup/ip-mib/ipv4InterfaceTable/ipv4InterfaceTable.c new file mode 100644 index 0000000..351ddd1 --- /dev/null +++ b/agent/mibgroup/ip-mib/ipv4InterfaceTable/ipv4InterfaceTable.c @@ -0,0 +1,959 @@ +/* + * Note: this file originally auto-generated by mib2c using + * version : 1.48 $ of : mfd-top.m2c,v $ + * + * $Id$ + */ +/** \page MFD helper for ipv4InterfaceTable + * + * \section intro Introduction + * Introductory text. + * + */ +/* + * standard Net-SNMP includes + */ +#include <net-snmp/net-snmp-config.h> +#include <net-snmp/net-snmp-includes.h> +#include <net-snmp/agent/net-snmp-agent-includes.h> + +/* + * include our parent header + */ +#include "ipv4InterfaceTable.h" + +#include <net-snmp/agent/mib_modules.h> + +#include "ipv4InterfaceTable_interface.h" + +const oid ipv4InterfaceTable_oid[] = { IPV4INTERFACETABLE_OID }; +const int ipv4InterfaceTable_oid_size = +OID_LENGTH(ipv4InterfaceTable_oid); + +ipv4InterfaceTable_registration ipv4InterfaceTable_user_context; +static ipv4InterfaceTable_registration *ipv4InterfaceTable_user_context_p; + +void initialize_table_ipv4InterfaceTable(void); +void shutdown_table_ipv4InterfaceTable(void); + + +/** + * Initializes the ipv4InterfaceTable module + */ +void +init_ipv4InterfaceTable(void) +{ + DEBUGMSGTL(("verbose:ipv4InterfaceTable:init_ipv4InterfaceTable", + "called\n")); + + /* + * TODO:300:o: Perform ipv4InterfaceTable one-time module initialization. + */ + + /* + * we depend on the ifTable, so we put our init in with it + * to guarantee order of execution. + */ + init_ifTable(); + + /* + * last changed should be 0 at startup + */ + ipv4InterfaceTable_lastChange_set(0); + +} /* init_ipv4InterfaceTable */ + +/** + * Shut-down the ipv4InterfaceTable module (agent is exiting) + */ +void +shutdown_ipv4InterfaceTable(void) +{ + if (should_init("ipv4InterfaceTable")) + shutdown_table_ipv4InterfaceTable(); + +} + +/** + * Initialize the table ipv4InterfaceTable + * (Define its contents and how it's structured) + */ +void +initialize_table_ipv4InterfaceTable(void) +{ + u_long flags; + + DEBUGMSGTL(("verbose:ipv4InterfaceTable:initialize_table_ipv4InterfaceTable", "called\n")); + + /* + * TODO:301:o: Perform ipv4InterfaceTable one-time table initialization. + */ + + /* + * TODO:302:o: |->Initialize ipv4InterfaceTable user context + * if you'd like to pass in a pointer to some data for this + * table, allocate or set it up here. + */ + /* + * a netsnmp_data_list is a simple way to store void pointers. A simple + * string token is used to add, find or remove pointers. + */ + ipv4InterfaceTable_user_context_p = + netsnmp_create_data_list("ipv4InterfaceTable", NULL, NULL); + + /* + * No support for any flags yet, but in the future you would + * set any flags here. + */ + flags = 0; + + /* + * call interface initialization code + */ + _ipv4InterfaceTable_initialize_interface + (ipv4InterfaceTable_user_context_p, flags); +} /* initialize_table_ipv4InterfaceTable */ + +/** + * Shutdown the table ipv4InterfaceTable + */ +void +shutdown_table_ipv4InterfaceTable(void) +{ + /* + * call interface shutdown code + */ + _ipv4InterfaceTable_shutdown_interface + (ipv4InterfaceTable_user_context_p); + netsnmp_free_all_list_data(ipv4InterfaceTable_user_context_p); + ipv4InterfaceTable_user_context_p = NULL; +} + +/** + * extra context initialization (eg default values) + * + * @param rowreq_ctx : row request context + * @param user_init_ctx : void pointer for user (parameter to rowreq_ctx_allocate) + * + * @retval MFD_SUCCESS : no errors + * @retval MFD_ERROR : error (context allocate will fail) + */ +int +ipv4InterfaceTable_rowreq_ctx_init(ipv4InterfaceTable_rowreq_ctx * + rowreq_ctx, void *user_init_ctx) +{ + DEBUGMSGTL(("verbose:ipv4InterfaceTable:ipv4InterfaceTable_rowreq_ctx_init", "called\n")); + + netsnmp_assert(NULL != rowreq_ctx); + + /* + * TODO:210:o: |-> Perform extra ipv4InterfaceTable rowreq initialization. (eg DEFVALS) + */ + rowreq_ctx->data.ipv4InterfaceRetransmitTime = 1000; + + + return MFD_SUCCESS; +} /* ipv4InterfaceTable_rowreq_ctx_init */ + +/** + * extra context cleanup + * @param rowreq_ctx + * + */ +void +ipv4InterfaceTable_rowreq_ctx_cleanup(ipv4InterfaceTable_rowreq_ctx * + rowreq_ctx) +{ + DEBUGMSGTL(("verbose:ipv4InterfaceTable:ipv4InterfaceTable_rowreq_ctx_cleanup", "called\n")); + + netsnmp_assert(NULL != rowreq_ctx); + + /* + * TODO:211:o: |-> Perform extra ipv4InterfaceTable rowreq cleanup. + */ +} /* ipv4InterfaceTable_rowreq_ctx_cleanup */ + +/** + * pre-request callback + * + * @param user_context + * + * @retval MFD_SUCCESS : success. + * @retval MFD_ERROR : other error + */ +int +ipv4InterfaceTable_pre_request(ipv4InterfaceTable_registration * + user_context) +{ + DEBUGMSGTL(("verbose:ipv4InterfaceTable:ipv4InterfaceTable_pre_request", "called\n")); + + /* + * TODO:510:o: Perform ipv4InterfaceTable pre-request actions. + */ + + return MFD_SUCCESS; +} /* ipv4InterfaceTable_pre_request */ + +/** + * post-request callback + * + * Note: + * New rows have been inserted into the container, and + * deleted rows have been removed from the container and + * released. + * + * @param user_context + * @param rc : MFD_SUCCESS if all requests succeeded + * + * @retval MFD_SUCCESS : success. + * @retval MFD_ERROR : other error (ignored) + */ +int +ipv4InterfaceTable_post_request(ipv4InterfaceTable_registration * + user_context, int rc) +{ + DEBUGMSGTL(("verbose:ipv4InterfaceTable:ipv4InterfaceTable_post_request", "called\n")); + + /* + * TODO:511:o: Perform ipv4InterfaceTable post-request actions. + */ + + /* + * check to set if any rows were changed. + */ + if (ipv4InterfaceTable_dirty_get()) { + /* + * check if request was successful. If so, this would be + * a good place to save data to its persistent store. + */ + if (MFD_SUCCESS == rc) { + /* + * save changed rows, if you haven't already + */ + } + + ipv4InterfaceTable_dirty_set(0); /* clear table dirty flag */ + } + + return MFD_SUCCESS; +} /* ipv4InterfaceTable_post_request */ + + +/********************************************************************** + ********************************************************************** + *** + *** Table ipv4InterfaceTable + *** + ********************************************************************** + **********************************************************************/ +/* + * IP-MIB::ipv4InterfaceTable is subid 28 of ip. + * Its status is Current. + * OID: .1.3.6.1.2.1.4.28, length: 8 + */ + +/* + * --------------------------------------------------------------------- + * * TODO:200:r: Implement ipv4InterfaceTable data context functions. + */ + + +/*--------------------------------------------------------------------- + * IP-MIB::ipv4InterfaceEntry.ipv4InterfaceReasmMaxSize + * ipv4InterfaceReasmMaxSize is subid 2 of ipv4InterfaceEntry. + * Its status is Current, and its access level is ReadOnly. + * OID: .1.3.6.1.2.1.4.28.1.2 + * Description: +The size of the largest IPv4 datagram which this entity can + re-assemble from incoming IPv4 fragmented datagrams received + on this interface. + * + * Attributes: + * accessible 1 isscalar 0 enums 0 hasdefval 0 + * readable 1 iscolumn 1 ranges 1 hashint 0 + * settable 0 + * + * Ranges: 0 - 65535; + * + * Its syntax is INTEGER32 (based on perltype INTEGER32) + * The net-snmp type is ASN_INTEGER. The C type decl is long (long) + */ +/** + * Extract the current value of the ipv4InterfaceReasmMaxSize data. + * + * Set a value using the data context for the row. + * + * @param rowreq_ctx + * Pointer to the row request context. + * @param ipv4InterfaceReasmMaxSize_val_ptr + * Pointer to storage for a long variable + * + * @retval MFD_SUCCESS : success + * @retval MFD_SKIP : skip this node (no value for now) + * @retval MFD_ERROR : Any other error + */ +int +ipv4InterfaceReasmMaxSize_get(ipv4InterfaceTable_rowreq_ctx * rowreq_ctx, + long *ipv4InterfaceReasmMaxSize_val_ptr) +{ + /** we should have a non-NULL pointer */ + netsnmp_assert(NULL != ipv4InterfaceReasmMaxSize_val_ptr); + + + DEBUGMSGTL(("verbose:ipv4InterfaceTable:ipv4InterfaceReasmMaxSize_get", + "called\n")); + + netsnmp_assert(NULL != rowreq_ctx); + + if (! + (rowreq_ctx->data.ifentry-> + ns_flags & NETSNMP_INTERFACE_FLAGS_HAS_V4_REASMMAX)) + return MFD_SKIP; + + /* + * TODO:231:o: |-> Extract the current value of the ipv4InterfaceReasmMaxSize data. + * copy (* ipv4InterfaceReasmMaxSize_val_ptr ) from rowreq_ctx->data + */ + (*ipv4InterfaceReasmMaxSize_val_ptr) = + rowreq_ctx->data.ipv4InterfaceReasmMaxSize; + + return MFD_SUCCESS; +} /* ipv4InterfaceReasmMaxSize_get */ + +/*--------------------------------------------------------------------- + * IP-MIB::ipv4InterfaceEntry.ipv4InterfaceEnableStatus + * ipv4InterfaceEnableStatus is subid 3 of ipv4InterfaceEntry. + * Its status is Current, and its access level is ReadWrite. + * OID: .1.3.6.1.2.1.4.28.1.3 + * Description: +The indication of whether IPv4 is enabled (up) or disabled + (down) on this interface. This object does not affect the + state of the interface itself, only its connection to an + IPv4 stack. The IF-MIB should be used to control the state + of the interface. + * + * Attributes: + * accessible 1 isscalar 0 enums 1 hasdefval 0 + * readable 1 iscolumn 1 ranges 0 hashint 0 + * settable 1 + * + * Enum range: 1/8. Values: up(1), down(2) + * + * Its syntax is INTEGER (based on perltype INTEGER) + * The net-snmp type is ASN_INTEGER. The C type decl is long (u_long) + */ +/** + * Extract the current value of the ipv4InterfaceEnableStatus data. + * + * Set a value using the data context for the row. + * + * @param rowreq_ctx + * Pointer to the row request context. + * @param ipv4InterfaceEnableStatus_val_ptr + * Pointer to storage for a long variable + * + * @retval MFD_SUCCESS : success + * @retval MFD_SKIP : skip this node (no value for now) + * @retval MFD_ERROR : Any other error + */ +int +ipv4InterfaceEnableStatus_get(ipv4InterfaceTable_rowreq_ctx * rowreq_ctx, + u_long * ipv4InterfaceEnableStatus_val_ptr) +{ + /** we should have a non-NULL pointer */ + netsnmp_assert(NULL != ipv4InterfaceEnableStatus_val_ptr); + + + DEBUGMSGTL(("verbose:ipv4InterfaceTable:ipv4InterfaceEnableStatus_get", + "called\n")); + + netsnmp_assert(NULL != rowreq_ctx); + + /* + * TODO:231:o: |-> Extract the current value of the ipv4InterfaceEnableStatus data. + * copy (* ipv4InterfaceEnableStatus_val_ptr ) from rowreq_ctx->data + */ + (*ipv4InterfaceEnableStatus_val_ptr) = + rowreq_ctx->data.ipv4InterfaceEnableStatus; + + return MFD_SUCCESS; +} /* ipv4InterfaceEnableStatus_get */ + +/*--------------------------------------------------------------------- + * IP-MIB::ipv4InterfaceEntry.ipv4InterfaceRetransmitTime + * ipv4InterfaceRetransmitTime is subid 4 of ipv4InterfaceEntry. + * Its status is Current, and its access level is ReadOnly. + * OID: .1.3.6.1.2.1.4.28.1.4 + * Description: +The time between retransmissions of ARP requests to a + neighbor when resolving the address or when probing the + reachability of a neighbor. + * + * Attributes: + * accessible 1 isscalar 0 enums 0 hasdefval 1 + * readable 1 iscolumn 1 ranges 0 hashint 0 + * settable 0 + * defval: 1000 + * + * + * Its syntax is UNSIGNED32 (based on perltype UNSIGNED32) + * The net-snmp type is ASN_UNSIGNED. The C type decl is u_long (u_long) + */ +/** + * Extract the current value of the ipv4InterfaceRetransmitTime data. + * + * Set a value using the data context for the row. + * + * @param rowreq_ctx + * Pointer to the row request context. + * @param ipv4InterfaceRetransmitTime_val_ptr + * Pointer to storage for a u_long variable + * + * @retval MFD_SUCCESS : success + * @retval MFD_SKIP : skip this node (no value for now) + * @retval MFD_ERROR : Any other error + */ +int +ipv4InterfaceRetransmitTime_get(ipv4InterfaceTable_rowreq_ctx * rowreq_ctx, + u_long * + ipv4InterfaceRetransmitTime_val_ptr) +{ + /** we should have a non-NULL pointer */ + netsnmp_assert(NULL != ipv4InterfaceRetransmitTime_val_ptr); + + + DEBUGMSGTL(("verbose:ipv4InterfaceTable:ipv4InterfaceRetransmitTime_get", "called\n")); + + netsnmp_assert(NULL != rowreq_ctx); + + if (! + (rowreq_ctx->data.ifentry-> + ns_flags & NETSNMP_INTERFACE_FLAGS_HAS_V4_RETRANSMIT)) + return MFD_SKIP; + + /* + * TODO:231:o: |-> Extract the current value of the ipv4InterfaceRetransmitTime data. + * copy (* ipv4InterfaceRetransmitTime_val_ptr ) from rowreq_ctx->data + */ + (*ipv4InterfaceRetransmitTime_val_ptr) = + rowreq_ctx->data.ipv4InterfaceRetransmitTime; + + return MFD_SUCCESS; +} /* ipv4InterfaceRetransmitTime_get */ + + + +/** @} */ +/********************************************************************** + ********************************************************************** + *** + *** Table ipv4InterfaceTable + *** + ********************************************************************** + **********************************************************************/ +/* + * IP-MIB::ipv4InterfaceTable is subid 28 of ip. + * Its status is Current. + * OID: .1.3.6.1.2.1.4.28, length: 8 + */ + /* + * NOTE: if you update this chart, please update the versions in + * local/mib2c-conf.d/parent-set.m2i + * agent/mibgroup/helpers/baby_steps.c + * while you're at it. + */ + /* + *********************************************************************** + * Baby Steps Flow Chart (2004.06.05) * + * * + * +--------------+ +================+ U = unconditional path * + * |optional state| ||required state|| S = path for success * + * +--------------+ +================+ E = path for error * + *********************************************************************** + * + * +--------------+ + * | pre | + * | request | + * +--------------+ + * | U + * +==============+ + * +----------------|| object || + * | E || lookup || + * | +==============+ + * | | S + * | +==============+ + * | E || check || + * |<---------------|| values || + * | +==============+ + * | | S + * | +==============+ + * | +<-------|| undo || + * | | E || setup || + * | | +==============+ + * | | | S + * | | +==============+ + * | | || set ||-------------------------->+ + * | | || value || E | + * | | +==============+ | + * | | | S | + * | | +--------------+ | + * | | | check |-------------------------->| + * | | | consistency | E | + * | | +--------------+ | + * | | | S | + * | | +==============+ +==============+ | + * | | || commit ||-------->|| undo || | + * | | || || E || commit || | + * | | +==============+ +==============+ | + * | | | S U |<--------+ + * | | +--------------+ +==============+ + * | | | irreversible | || undo || + * | | | commit | || set || + * | | +--------------+ +==============+ + * | | | U U | + * | +-------------->|<------------------------+ + * | +==============+ + * | || undo || + * | || cleanup || + * | +==============+ + * +---------------------->| U + * +--------------+ + * | post | + * | request | + * +--------------+ + * + */ + +/** + * Setup up context with information needed to undo a set request. + * + * This function will be called before the individual node undo setup + * functions are called. If you need to do any undo setup that is not + * related to a specific column, you can do it here. + * + * Note that the undo context has been allocated with + * ipv4InterfaceTable_allocate_data(), but may need extra + * initialization similar to what you may have done in + * ipv4InterfaceTable_rowreq_ctx_init(). + * Note that an individual node's undo_setup function will only be called + * if that node is being set to a new value. + * + * If there is any setup specific to a particular column (e.g. allocating + * memory for a string), you should do that setup in the node's undo_setup + * function, so it won't be done unless it is necessary. + * + * @param rowreq_ctx + * Pointer to the table context (ipv4InterfaceTable_rowreq_ctx) + * + * @retval MFD_SUCCESS : success + * @retval MFD_ERROR : error. set will fail. + */ +int +ipv4InterfaceTable_undo_setup(ipv4InterfaceTable_rowreq_ctx * rowreq_ctx) +{ + int rc = MFD_SUCCESS; + + DEBUGMSGTL(("verbose:ipv4InterfaceTable:ipv4InterfaceTable_undo_setup", + "called\n")); + + /** we should have a non-NULL pointer */ + netsnmp_assert(NULL != rowreq_ctx); + + /* + * TODO:451:M: |-> Setup ipv4InterfaceTable undo. + * set up ipv4InterfaceTable undo information, in preparation for a set. + * Undo storage is in (* ipv4InterfaceRetransmitTime_val_ptr )* + */ + + return rc; +} /* ipv4InterfaceTable_undo_setup */ + +/** + * Undo a set request. + * + * This function will be called before the individual node undo + * functions are called. If you need to do any undo that is not + * related to a specific column, you can do it here. + * + * Note that an individual node's undo function will only be called + * if that node is being set to a new value. + * + * If there is anything specific to a particular column (e.g. releasing + * memory for a string), you should do that setup in the node's undo + * function, so it won't be done unless it is necessary. + * + * @param rowreq_ctx + * Pointer to the table context (ipv4InterfaceTable_rowreq_ctx) + * + * @retval MFD_SUCCESS : success + * @retval MFD_ERROR : error. set will fail. + */ +int +ipv4InterfaceTable_undo(ipv4InterfaceTable_rowreq_ctx * rowreq_ctx) +{ + int rc = MFD_SUCCESS; + + DEBUGMSGTL(("verbose:ipv4InterfaceTable:ipv4InterfaceTable_undo", + "called\n")); + + /** we should have a non-NULL pointer */ + netsnmp_assert(NULL != rowreq_ctx); + + /* + * TODO:451:M: |-> ipv4InterfaceTable undo. + * ipv4InterfaceTable undo information, in response to a failed set. + * Undo storage is in (* ipv4InterfaceRetransmitTime_val_ptr )* + */ + + return rc; +} /* ipv4InterfaceTable_undo_setup */ + +/** + * Cleanup up context undo information. + * + * This function will be called after set/commit processing. If you + * allocated any resources in undo_setup, this is the place to release + * those resources. + * + * This function is called regardless of the success or failure of the set + * request. If you need to perform different steps for cleanup depending + * on success or failure, you can add a flag to the rowreq_ctx. + * + * @param rowreq_ctx + * Pointer to the table context (ipv4InterfaceTable_rowreq_ctx) + * + * @retval MFD_SUCCESS : success + * @retval MFD_ERROR : error + */ +int +ipv4InterfaceTable_undo_cleanup(ipv4InterfaceTable_rowreq_ctx * rowreq_ctx) +{ + int rc = MFD_SUCCESS; + + DEBUGMSGTL(("verbose:ipv4InterfaceTable:ipv4InterfaceTable_undo_cleanup", "called\n")); + + /** we should have a non-NULL pointer */ + netsnmp_assert(NULL != rowreq_ctx); + + /* + * TODO:452:M: |-> Cleanup ipv4InterfaceTable undo. + * Undo storage is in (* ipv4InterfaceRetransmitTime_val_ptr )* + */ + + return rc; +} /* ipv4InterfaceTable_undo_cleanup */ + +/** + * commit new values. + * + * At this point, you should have done everything you can to ensure that + * this commit will not fail. + * + * Should you need different behavior depending on which columns were + * set, rowreq_ctx->column_set_flags will indicate which writeable columns were + * set. The definitions for the COLUMN_*_FLAG bits can be found in + * ipv4InterfaceTable.h. + * A new row will have the MFD_ROW_CREATED bit set in rowreq_flags. + * + * @param rowreq_ctx + * Pointer to the users context. + * + * @retval MFD_SUCCESS : success + * @retval MFD_ERROR : error + */ +int +ipv4InterfaceTable_commit(ipv4InterfaceTable_rowreq_ctx * rowreq_ctx) +{ + int rc = MFD_SUCCESS; + int save_flags; + + DEBUGMSGTL(("verbose:ipv4InterfaceTable:ipv4InterfaceTable_commit", + "called\n")); + + /** we should have a non-NULL pointer */ + netsnmp_assert(NULL != rowreq_ctx); + + /* + * save flags, then clear until we actually do something + */ + save_flags = rowreq_ctx->column_set_flags; + rowreq_ctx->column_set_flags = 0; + + /* + * commit ipv4InterfaceTable data + * 1) check the column's flag in save_flags to see if it was set. + * 2) clear the flag when you handle that column + * 3) set the column's flag in column_set_flags if it needs undo + * processing in case of a failure. + */ + if (save_flags & COLUMN_IPV4INTERFACEENABLESTATUS_FLAG) { + save_flags &= ~COLUMN_IPV4INTERFACEENABLESTATUS_FLAG; /* clear ipv4InterfaceEnableStatus */ + /* + * TODO:482:o: |-> commit column ipv4InterfaceEnableStatus. + */ + rc = -1; + if (-1 == rc) { + snmp_log(LOG_ERR, + "ipv4InterfaceTable column ipv4InterfaceEnableStatus commit failed\n"); + } else { + /* + * set flag, in case we need to undo ipv4InterfaceEnableStatus + */ + rowreq_ctx->column_set_flags |= + COLUMN_IPV4INTERFACEENABLESTATUS_FLAG; + } + } + + /* + * if we successfully commited this row, set the dirty flag. + */ + if (MFD_SUCCESS == rc) { + rowreq_ctx->rowreq_flags |= MFD_ROW_DIRTY; + } + + if (save_flags) { + snmp_log(LOG_ERR, "unhandled columns (0x%x) in commit\n", + save_flags); + return MFD_ERROR; + } + + return rc; +} /* ipv4InterfaceTable_commit */ + +/** + * undo commit new values. + * + * Should you need different behavior depending on which columns were + * set, rowreq_ctx->column_set_flags will indicate which writeable columns were + * set. The definitions for the COLUMN_*_FLAG bits can be found in + * ipv4InterfaceTable.h. + * A new row will have the MFD_ROW_CREATED bit set in rowreq_flags. + * + * @param rowreq_ctx + * Pointer to the users context. + * + * @retval MFD_SUCCESS : success + * @retval MFD_ERROR : error + */ +int +ipv4InterfaceTable_undo_commit(ipv4InterfaceTable_rowreq_ctx * rowreq_ctx) +{ + int rc = MFD_SUCCESS; + + DEBUGMSGTL(("verbose:ipv4InterfaceTable:ipv4InterfaceTable_undo_commit", "called\n")); + + /** we should have a non-NULL pointer */ + netsnmp_assert(NULL != rowreq_ctx); + + /* + * TODO:485:M: |-> Undo ipv4InterfaceTable commit. + * check the column's flag in rowreq_ctx->column_set_flags to see + * if it was set during commit, then undo it. + * + * eg: if (rowreq_ctx->column_set_flags & COLUMN__FLAG) {} + */ + + + /* + * if we successfully un-commited this row, clear the dirty flag. + */ + if (MFD_SUCCESS == rc) { + rowreq_ctx->rowreq_flags &= ~MFD_ROW_DIRTY; + } + + return rc; +} /* ipv4InterfaceTable_undo_commit */ + +/* + * TODO:440:M: Implement ipv4InterfaceTable node value checks. + * TODO:450:M: Implement ipv4InterfaceTable undo functions. + * TODO:460:M: Implement ipv4InterfaceTable set functions. + * TODO:480:M: Implement ipv4InterfaceTable commit functions. + */ +/*--------------------------------------------------------------------- + * IP-MIB::ipv4InterfaceEntry.ipv4InterfaceEnableStatus + * ipv4InterfaceEnableStatus is subid 3 of ipv4InterfaceEntry. + * Its status is Current, and its access level is ReadWrite. + * OID: .1.3.6.1.2.1.4.28.1.3 + * Description: +The indication of whether IPv4 is enabled (up) or disabled + (down) on this interface. This object does not affect the + state of the interface itself, only its connection to an + IPv4 stack. The IF-MIB should be used to control the state + of the interface. + * + * Attributes: + * accessible 1 isscalar 0 enums 1 hasdefval 0 + * readable 1 iscolumn 1 ranges 0 hashint 0 + * settable 1 + * + * Enum range: 1/8. Values: up(1), down(2) + * + * Its syntax is INTEGER (based on perltype INTEGER) + * The net-snmp type is ASN_INTEGER. The C type decl is long (u_long) + */ +/** + * Check that the proposed new value is potentially valid. + * + * @param rowreq_ctx + * Pointer to the row request context. + * @param ipv4InterfaceEnableStatus_val + * A long containing the new value. + * + * @retval MFD_SUCCESS : incoming value is legal + * @retval MFD_NOT_VALID_NOW : incoming value is not valid now + * @retval MFD_NOT_VALID_EVER : incoming value is never valid + * + * This is the place to check for requirements that are not + * expressed in the mib syntax (for example, a requirement that + * is detailed in the description for an object). + * + * You should check that the requested change between the undo value and the + * new value is legal (ie, the transistion from one value to another + * is legal). + * + *@note + * This check is only to determine if the new value + * is \b potentially valid. This is the first check of many, and + * is one of the simplest ones. + * + *@note + * this is not the place to do any checks for values + * which depend on some other value in the mib. Those + * types of checks should be done in the + * ipv4InterfaceTable_check_dependencies() function. + * + * The following checks have already been done for you: + * The syntax is ASN_INTEGER + * The value is one of up(1), down(2) + * + * If there a no other checks you need to do, simply return MFD_SUCCESS. + * + */ +int +ipv4InterfaceEnableStatus_check_value(ipv4InterfaceTable_rowreq_ctx * + rowreq_ctx, + u_long ipv4InterfaceEnableStatus_val) +{ + DEBUGMSGTL(("verbose:ipv4InterfaceTable:ipv4InterfaceEnableStatus_check_value", "called\n")); + + /** should never get a NULL pointer */ + netsnmp_assert(NULL != rowreq_ctx); + + /* + * TODO:441:o: |-> Check for valid ipv4InterfaceEnableStatus value. + */ + /* + * did the access code set the flag indicating that we can control + * individual protocols on this interface? + */ + if (rowreq_ctx->data.ifentry->ns_flags & + NETSNMP_INTERFACE_FLAGS_CAN_DOWN_PROTOCOL); + else + return MFD_NOT_VALID_EVER; + + return MFD_SUCCESS; /* ipv4InterfaceEnableStatus value not illegal */ +} /* ipv4InterfaceEnableStatus_check_value */ + +/** + * Save old value information + * + * @param rowreq_ctx + * Pointer to the table context (ipv4InterfaceTable_rowreq_ctx) + * + * @retval MFD_SUCCESS : success + * @retval MFD_ERROR : error. set will fail. + * + * This function will be called after the table level undo setup function + * ipv4InterfaceTable_undo_setup has been called. + * + *@note + * this function will only be called if a new value is set for this column. + * + * If there is any setup specific to a particular column (e.g. allocating + * memory for a string), you should do that setup in this function, so it + * won't be done unless it is necessary. + */ +int +ipv4InterfaceEnableStatus_undo_setup(ipv4InterfaceTable_rowreq_ctx * + rowreq_ctx) +{ + DEBUGMSGTL(("verbose:ipv4InterfaceTable:ipv4InterfaceEnableStatus_undo_setup", "called\n")); + + /** should never get a NULL pointer */ + netsnmp_assert(NULL != rowreq_ctx); + + /* + * TODO:455:o: |-> Setup ipv4InterfaceEnableStatus undo. + */ + /* + * copy ipv4InterfaceEnableStatus data + * set rowreq_ctx->undo->ipv4InterfaceEnableStatus from rowreq_ctx->data.ipv4InterfaceEnableStatus + */ + rowreq_ctx->undo->ipv4InterfaceEnableStatus = + rowreq_ctx->data.ipv4InterfaceEnableStatus; + + + return MFD_SUCCESS; +} /* ipv4InterfaceEnableStatus_undo_setup */ + +/** + * Set the new value. + * + * @param rowreq_ctx + * Pointer to the users context. You should know how to + * manipulate the value from this object. + * @param ipv4InterfaceEnableStatus_val + * A long containing the new value. + */ +int +ipv4InterfaceEnableStatus_set(ipv4InterfaceTable_rowreq_ctx * rowreq_ctx, + u_long ipv4InterfaceEnableStatus_val) +{ + + DEBUGMSGTL(("verbose:ipv4InterfaceTable:ipv4InterfaceEnableStatus_set", + "called\n")); + + /** should never get a NULL pointer */ + netsnmp_assert(NULL != rowreq_ctx); + + /* + * TODO:461:M: |-> Set ipv4InterfaceEnableStatus value. + * set ipv4InterfaceEnableStatus value in rowreq_ctx->data + */ + rowreq_ctx->data.ipv4InterfaceEnableStatus = + ipv4InterfaceEnableStatus_val; + + return MFD_SUCCESS; +} /* ipv4InterfaceEnableStatus_set */ + +/** + * undo the previous set. + * + * @param rowreq_ctx + * Pointer to the users context. + */ +int +ipv4InterfaceEnableStatus_undo(ipv4InterfaceTable_rowreq_ctx * rowreq_ctx) +{ + + DEBUGMSGTL(("verbose:ipv4InterfaceTable:ipv4InterfaceEnableStatus_undo", "called\n")); + + netsnmp_assert(NULL != rowreq_ctx); + + /* + * TODO:456:o: |-> Clean up ipv4InterfaceEnableStatus undo. + */ + /* + * copy ipv4InterfaceEnableStatus data + * set rowreq_ctx->data.ipv4InterfaceEnableStatus from rowreq_ctx->undo->ipv4InterfaceEnableStatus + */ + rowreq_ctx->data.ipv4InterfaceEnableStatus = + rowreq_ctx->undo->ipv4InterfaceEnableStatus; + + + return MFD_SUCCESS; +} /* ipv4InterfaceEnableStatus_undo */ + +/** @} */ +/** @{ */ |