snmp_set_enum_print(3) [php man page]

SNMP_SET_ENUM_PRINT(3)							 1						    SNMP_SET_ENUM_PRINT(3)

snmp_set_enum_print - Return all values that are enums with their enum value instead of the raw integer

SYNOPSIS

       bool snmp_set_enum_print (int  $enum_print)

DESCRIPTION

	This  function	toggles  if  snmpwalk/snmpget  etc. should automatically lookup enum values in the MIB and return them together with their
       human readable string.

PARAMETERS

	      o $enum_print
		- As the value is interpreted as boolean by the Net-SNMP library, it can only be "0" or "1".

EXAMPLES

       Example #1

	      Using snmp_set_enum_print(3)

	      <?php
	       snmp_set_enum_print(0);
	       echo snmpget('localhost', 'public', 'IF-MIB::ifOperStatus.3') . "
";
	       snmp_set_enum_print(1);
	       echo snmpget('localhost', 'public', 'IF-MIB::ifOperStatus.3') . "
";
	      ?>

	The above would return

       INTEGER: up(1)
	INTEGER: 1

NOTES

       Note

	      snmp_set_enum_print(3) is only available when using the UCD SNMP library. This function is not available when using the Windows SNMP
	      library.

PHP Documentation Group 												    SNMP_SET_ENUM_PRINT(3)

SNMP_SET_VALUERETRIEVAL(3)						 1						SNMP_SET_VALUERETRIEVAL(3)

snmp_set_valueretrieval - Specify the method how the SNMP values will be returned

SYNOPSIS

       bool snmp_set_valueretrieval (int  $method = SNMP_VALUE_LIBRARY)

DESCRIPTION

PARAMETERS

	      o $method
		-

	      types

	      +-------------------+---------------------------------------------------+
	      |SNMP_VALUE_LIBRARY |						      |
	      | 		  |						      |
	      | 		  | The return values will be as returned by the Net- |
	      | 		  | SNMP library.				      |
	      | 		  |						      |
	      | SNMP_VALUE_PLAIN  |						      |
	      | 		  |						      |
	      | 		  | The return values will be the plain value without |
	      | 		  | the SNMP type hint. 			      |
	      | 		  |						      |
	      |SNMP_VALUE_OBJECT  |						      |
	      | 		  |						      |
	      | 		  |  The return values will be objects with the prop- |
	      | 		  | erties "value" and "type", where  the  latter  is |
	      | 		  | one of the SNMP_OCTET_STR, SNMP_COUNTER etc. con- |
	      | 		  | stants. The way "value" is returned is  based  on |
	      | 		  | which   one   of   constants  SNMP_VALUE_LIBRARY, |
	      | 		  | SNMP_VALUE_PLAIN is set.			      |
	      | 		  |						      |
	      +-------------------+---------------------------------------------------+
EXAMPLES

       Example #1

	      Using snmp_set_valueretrieval(3)

	      <?php
	       snmp_set_valueretrieval(SNMP_VALUE_LIBRARY);
	       $ret = snmpget('localhost', 'public', 'IF-MIB::ifName.1');
	       // $ret = "STRING: lo"

	       snmp_set_valueretrieval(SNMP_VALUE_PLAIN);
	       $ret = snmpget('localhost', 'public', 'IF-MIB::ifName.1');
	       // $ret = "lo";

	       snmp_set_valueretrieval(SNMP_VALUE_OBJECT);
	       $ret = snmpget('localhost', 'public', 'IF-MIB::ifName.1');
	       // stdClass Object
	       // (
	       //   [type] => 4        <-- SNMP_OCTET_STR, see constants
	       //   [value] => lo
	       // )

	       // PHP 5.4+ examples
	       snmp_set_valueretrieval(SNMP_VALUE_OBJECT | SNMP_VALUE_PLAIN);
	       $ret = snmpget('localhost', 'public', 'IF-MIB::ifName.1');
	       // stdClass Object
	       // (
	       //   [type] => 4        <-- SNMP_OCTET_STR, see constants
	       //   [value] => lo
	       // )

	       snmp_set_valueretrieval(SNMP_VALUE_OBJECT | SNMP_VALUE_LIBRARY);
	       $ret = snmpget('localhost', 'public', 'IF-MIB::ifName.1');
	       // stdClass Object
	       // (
	       //   [type] => 4        <-- SNMP_OCTET_STR, see constants
	       //   [value] => STRING: lo
	       // )

	      ?>

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.4.0	|						    |
       |	|						    |
       |	|  Constants SNMP_VALUE_PLAIN or SNMP_VALUE_LIBRARY |
       |	| may  be combined with SNMP_VALUE_OBJECT resulting |
       |	| different way of representing contents of  $value |
       |	| array element in return value of GET-function. If |
       |	| no SNMP_VALUE_{PLAIN,LIBRARY} constant is  accom- |
       |	| panying  SNMP_VALUE_OBJECT, SNMP_VALUE_LIBRARY is |
       |	| used.  Prior	to  5.4.0  SNMP_VALUE_OBJECT  effe- |
       |	| cively meant SNMP_VALUE_OBJECT| SNMP_VALUE_PLAIN. |
       |	|						    |
       +--------+---------------------------------------------------+
SEE ALSO

       snmp_get_valueretrieval(3), "Predefined Constants".

PHP Documentation Group 												SNMP_SET_VALUERETRIEVAL(3)