Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for netsnmp_table_array (redhat section 3)

table_array: Helps you implement a table when data canbbe_stored locally.uThepdatanisastoredrinyaFsortednarray,ausinglacbinaryTsearchafor lookups.(3) sorted array, using a binary search for lookups.(3)

NAME
       table_array: Helps you implement a table when data can be stored locally. The data is
       stored in a sorted array, using a binary search for lookups. - The table_array handler is
       used (automatically) in conjuntion with the table handler.  More...

   Functions
       int netsnmp_table_container_register (netsnmp_handler_registration *reginfo,
	   netsnmp_table_registration_info *tabreg, netsnmp_table_array_callbacks *cb,
	   netsnmp_container *container, int group_rows)
	   register specified callbacks for the specified table/oid.
       netsnmp_mib_handler * netsnmp_find_table_array_handler (netsnmp_handler_registration
	   *reginfo)
	   find the handler for the table_array helper.
       netsnmp_container * netsnmp_extract_array_context (netsnmp_request_info *request)
	   find the context data used by the table_array helper.
       int netsnmp_table_array_check_row_status (netsnmp_table_array_callbacks *cb,
	   netsnmp_request_group *ag, long *rs_new, long *rs_old)
	   this function is called to validate RowStatus transitions.

DETAILED DESCRIPTION
       The table_array handler is used (automatically) in conjuntion with the table handler.

       It is primarily intended to be used with the mib2c configuration file mib2c.array-
       user.conf.

       The code generated by mib2c is useful when you have control of the data for each row. If
       you cannot control when rows are added and deleted (or at least be notified of changes to
       row data), then this handler is probably not for you.

       This handler makes use of callbacks (function pointers) to handle various tasks. Code is
       generated for each callback, but will need to be reviewed and flushed out by the user.

       NOTE NOTE NOTE: Once place where mib2c is somewhat lacking is with regards to tables with
       external indices. If your table makes use of one or more external indices, please review
       the generated code very carefully for comments regarding external indices.

       NOTE NOTE NOTE: This helper, the API and callbacks are still being tested and may change.

       The generated code will define a structure for storage of table related data. This
       structure must be used, as it contains the index OID for the row, which is used for
       keeping the array sorted. You can add addition fields or data to the structure for your
       own use.

       The generated code will also have code to handle SNMP-SET processing. If your table does
       not support any SET operations, simply comment out the define <PREFIX>_SET_HANDLING (where
       <PREFIX> is your table name) in the header file.

       SET processing modifies the row in-place. The duplicate_row callback will be called to
       save a copy of the original row. In the event of a failure before the commite phase, the
       row_copy callback will be called to restore the original row from the copy.

       Code will be generated to handle row creation. This code may be disabled by commenting out
       the define <PREFIX>_ROW_CREATION in the header file.

       If your table contains a RowStatus object, by default the code will not allow object in an
       active row to be modified. To allow active rows to be modified, remove the comment block
       around the define <PREFIX>_CAN_MODIFY_ACTIVE_ROW in the header file.

       Code will be generated to maintain a secondary index for all rows, stored in a binary
       tree. This is very useful for finding rows by a key other than the OID index. By default,
       the functions for maintaining this tree will be based on a character string. NOTE: this
       will likely be made into a more generic mechanism, using new callback methods, in the near
       future.

       The generated code contains many TODO comments. Make sure you check each one to see if it
       applies to your code. Examples include checking indices for syntax (ranges, etc),
       initializing default values in newly created rows, checking for row activation and
       deactivation requirements, etc.

FUNCTION DOCUMENTATION
   netsnmp_container* netsnmp_extract_array_context (netsnmp_request_info * request)
       find the context data used by the table_array helper.

       Definition at line 213 of file table_array.c.

   netsnmp_mib_handler* netsnmp_find_table_array_handler (netsnmp_handler_registration * reginfo)
       find the handler for the table_array helper.

       Definition at line 196 of file table_array.c.

   int netsnmp_table_array_check_row_status (netsnmp_table_array_callbacks * cb,
       netsnmp_request_group * ag, long * rs_new, long * rs_old)
       this function is called to validate RowStatus transitions.

       Definition at line 220 of file table_array.c.

   int netsnmp_table_container_register (netsnmp_handler_registration * reginfo,
       netsnmp_table_registration_info * tabreg, netsnmp_table_array_callbacks * cb,
       netsnmp_container * container, int group_rows)
       register specified callbacks for the specified table/oid.

       If the group_rows parameter is set, the row related callbacks will be called once for each
       unique row index. Otherwise, each callback will be called only once, for all objects.

       Definition at line 152 of file table_array.c.

table_array: Helps you implement a table when data cantbenstored locally. The data is stored in a sorted0array, using a binary search for lookups.(3)


All times are GMT -4. The time now is 06:50 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password