php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Request #54502 Add support for the "BITS" datatype
Submitted: 2011-04-10 15:34 UTC Modified: 2011-08-05 08:48 UTC
Votes:1
Avg. Score:3.0 ± 0.0
Reproduced:1 of 1 (100.0%)
Same Version:1 (100.0%)
Same OS:1 (100.0%)
From: [email protected] Assigned: lytboris (profile)
Status: Closed Package: SNMP related
PHP Version: trunk-SVN-2011-04-10 (SVN) OS:
Private report: No CVE-ID: None
 [2011-04-10 15:34 UTC] [email protected]
Description:
------------
The SNMP command line tools are able to translate the numeric return values for OIDs of the "BITS" datatype back to meaningful string values by parsing the relevant parts of the MIB. The PHP functions currently seem unable to do that.

I.e. in the following example I would like to get the string "notification" or "set" as return value but only get "0" or "1". As there is no other method to find and parse the MIB I'm left with hardcoding the values in the PHP script:

$ snmptranslate -Td DISMAN-EVENT-MIB::mteEventActions
DISMAN-EVENT-MIB::mteEventActions
mteEventActions OBJECT-TYPE
  -- FROM       DISMAN-EVENT-MIB
  SYNTAX        BITS {notification(0), set(1)} 


Test script:
---------------
From commandline (mind the strange quotes, they're neccessary!):

$ snmpwalk -v2c -c private localhost "DISMAN-EVENT-MIB::mteEventActions.\"_snmpd\".'_linkDown'"
DISMAN-EVENT-MIB::mteEventActions."_snmpd".'_linkDown' = BITS: 80 notification(0) 

With PHP:
        snmp_set_valueretrieval(SNMP_VALUE_OBJECT);
        $snmp = new SNMP(SNMP_VERSION_2C, 'localhost', 'private');
        $x = $snmp->get("DISMAN-EVENT-MIB::mteEventActions.\"_snmpd\".'_linkDown'");
        var_dump($x);
        var_dump(bin2hex($x->value));
I get:
        object(stdClass)#190 (2) {
          ["type"]=> int(4)
          ["value"]=> string(1) "�"
        }
        string(2) "80"

The value is not even numerical, it has to be converted to 0x80 using bin2hex()!


Expected result:
----------------
Maybe 

* the SNMP_VALUE_OBJECT representation object can be enhanced to include alternative representations:

        object(stdClass)#190 (2) {
          ["type"]=> int(4)
          ["value"]=> string(1) "�"
          ["bits_value"]=> string(15) "notification(0)"
        }

* or the the snmp_set_enum_print() function is used to toggle BITS, too
* or a snmp_set_bits_print() function is introduced
* or a snmp_translate() function is introduced that returns the "snmptranslate" output as PHP data structure



Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2011-07-17 09:18 UTC] [email protected]
-Assigned To: +Assigned To: lytboris
 [2011-07-17 09:18 UTC] [email protected]
There is support for BITS datatype actually when SNMP_VALUE_LIBRARY is enabled for value processing. When you enable other SNMP_VALUE_* modes no value processing is performed and output from remote SNMP agent is passed through SNMP library.
 [2011-07-17 13:18 UTC] [email protected]
Automatic comment from SVN on behalf of lytboris
Revision: http://svn.php.net/viewvc/?view=revision&revision=313331
Log: fix FR #54502: allow user to change OID value output mode when SNMP_VALUE_OBJECT is used.
 [2011-07-17 13:25 UTC] [email protected]
-Status: Assigned +Status: Feedback
 [2011-07-17 13:25 UTC] [email protected]
Please try using this snapshot:

  http://snaps.php.net/php5.4-latest.tar.gz

For Windows:

  http://windows.php.net/snapshots/

Now you can combine SNMP_VALUE_OBJECT with one of SNMP_VALUE_PLAIN or SNMP_VALUE_LIBRARY to alter 'value' output mode.
As for
>The value is not even numerical, it has to be converted to 0x80 using bin2hex()!
This is normal, because this is exactly what php-snmp receives from remote SNMP agent.
 [2011-07-17 13:26 UTC] [email protected]
Automatic comment from SVN on behalf of lytboris
Revision: http://svn.php.net/viewvc/?view=revision&revision=313333
Log: fix FR #54502: allow user to change OID value output mode when SNMP_VALUE_OBJECT is used.
 [2011-07-29 00:27 UTC] [email protected]
The new default SNMP->valueretrieval = SNMP_VALUE_LIBRARY gives at least the amount of information that snmpwalk does.

Still, before you close this bug, please consider at least adding something like the following method. It would add a bit of the convenience that one expects from a PHP class while still leave the low-level methods untouched.


    /** Returns the name of a bit value.
     * 
     * The NetSNMP library returns values of OIDs of the BIT type like
     * "BITS: 80 notification(0)". This method can be used to extract
     * just the name "notification" from this output.
     *
     * @param string $raw_value     The return of a walk() or get() request.
     * @return string               The name of the BIT value.
     */
    public static function parseBitName($raw_value) {
        preg_match('/^BITS: [0-9a-f]+ (.*)\(\d+\)\s+$/i', $raw_value, $match);
        if (!isset($match[1])) {
            throw new Exception("Cannot parse BIT value from '$raw_value'!");
        }
        return $match[1];
    }
 [2011-08-05 08:48 UTC] [email protected]
-Status: Feedback +Status: Closed
 [2011-08-05 08:48 UTC] [email protected]
This bug has been fixed in SVN.

Snapshots of the sources are packaged every three hours; this change
will be in the next snapshot. You can grab the snapshot at
http://snaps.php.net/.

 For Windows:

http://windows.php.net/snapshots/
 
Thank you for the report, and for helping us make PHP better.

It seems that parseBitName should not go into php-snmp library, at least it works only for "BITS: " string. Not sure that general parsing function will be sufficient for all users though, not taking into account the fact that this function will be complicated.

As an example of such complicated function you may take a look on format_snmp_string() function in Cacti's repo lib/snmp.php [ http://svn.cacti.net/viewvc/cacti/branches/0.8.7/lib/snmp.php?view=log ].
 
PHP Copyright © 2001-2025 The PHP Group
All rights reserved.
Last updated: Wed Dec 31 05:00:01 2025 UTC