scalar: process scalars easily.(3)          scalar: process scalars easily.(3)



NAME
       netsnmpscalar - process scalars easily.

   Functions
       netsnmpmibhandler * netsnmpgetscalarhandler (void)
           Creates a scalar handler calling netsnmpcreatehandler with a
           handler name defaulted to 'scalar' and access method,
           netsnmpscalarhelperhandler.
       int netsnmpregisterscalar (netsnmphandlerregistration *reginfo)
           This function registers a scalar helper handler.
       int netsnmpregisterreadonlyscalar (netsnmphandlerregistration
           *reginfo)
           This function registers a read only scalar helper handler.
       int netsnmpscalarhelperhandler (netsnmpmibhandler *handler,
           netsnmphandlerregistration *reginfo, netsnmpagentrequestinfo
           *reqinfo, netsnmprequestinfo *requests)

Function Documentation
   netsnmpmibhandler** netsnmpgetscalarhandler (void)
       Creates a scalar handler calling netsnmpcreatehandler with a handler
       name defaulted to 'scalar' and access method,
       netsnmpscalarhelperhandler. Parameters::
           void .RE

           Returns::
               Returns a pointer to a netsnmpmibhandler struct which
               contains the handler's name and the access method

           See also::
               netsnmpgetscalarhandler

               netsnmpregisterscalar

           Definition at line 51 of file scalar.c.

           References netsnmpcreatehandler().

           Referenced by netsnmpregisterreadonlyscalar(), and
           netsnmpregisterscalar().

   int netsnmpregisterreadonlyscalar (netsnmphandlerregistration **
       reginfo)
       This function registers a read only scalar helper handler. This
       function is very similar to netsnmpregisterscalar the only addition
       is that the 'readonly' handler is injected into the handler chain
       prior to injecting the serialize handler and registering reginfo.

       Parameters::
           reginfo a handler registration structure which could get created
           using netsnmpcreatehandlerregistration. Used to register a read
           only scalar helper handler.

       Returns::
           MIBREGISTEREDOK is returned if the registration was a success.
           Failures are MIBREGISTRATIONFAILURE and
           MIBDUPLICATEREGISTRATION.

       See also::
           netsnmpregisterscalar

           netsnmpgetscalarhandler

       Definition at line 114 of file scalar.c.

       References netsnmpgetinstancehandler(),
       netsnmpgetreadonlyhandler(), netsnmpgetscalarhandler(),
       netsnmphandlerregistration, netsnmpinjecthandler(),
       netsnmpregisterserialize(), netsnmphandlerregistrations::rootoid,
       and netsnmphandlerregistrations::rootoidlen.

   int netsnmpregisterscalar (netsnmphandlerregistration ** reginfo)
       This function registers a scalar helper handler. The registered OID,
       reginfo->rootoid, space is extended for the instance subid using
       realloc() but the reginfo->rootoidlen length is not extended just yet.
       .This function subsequently injects the instance, scalar, and serialize
       helper handlers before actually registering reginfo.

       Each handler is injected/pushed to the top of the handler chain list
       and will be processed last in first out, LIFO.

       Parameters::
           reginfo a handler registration structure which could get created
           using netsnmpcreatehandlerregistration. Used to register a
           scalar helper handler.

       Returns::
           MIBREGISTEREDOK is returned if the registration was a success.
           Failures are MIBREGISTRATIONFAILURE and
           MIBDUPLICATEREGISTRATION.

       See also::
           netsnmpregisterreadonlyscalar

           netsnmpgetscalarhandler

       Definition at line 79 of file scalar.c.

       References netsnmpgetinstancehandler(),
       netsnmpgetscalarhandler(), netsnmphandlerregistration,
       netsnmpinjecthandler(), netsnmpregisterserialize(),
       netsnmphandlerregistrations::rootoid, and
       netsnmphandlerregistrations::rootoidlen.



net-snmp                          24 Jan 200scalar: process scalars easily.(3)