Sets the value of quick_print within the NET-SNMP library. When this is set (1), the SNMP library will return 'quick printed' values. This means that just the value will be printed. When quick_print is not enabled (default) the UCD SNMP library prints extra information including the type of the value (i.e. IpAddress or OID). Additionally, if quick_print is not enabled, the library prints additional hex values for all strings of three characters or less. * @link https://secure.php.net/manual/en/class.snmp.php#snmp.props.quick-print */ public $quick_print; /** * @var bool Controls the way enum values are printed *

Parameter toggles if walk/get etc. should automatically lookup enum values in the MIB and return them together with their human readable string. * @link https://secure.php.net/manual/en/class.snmp.php#snmp.props.enum-print */ public $enum_print; /** * @var int Controls OID output format *

OID .1.3.6.1.2.1.1.3.0 representation for various oid_output_format values *

*

SNMP_OID_OUTPUT_FULL

.iso.org.dod.internet.mgmt.mib-2.system.sysUpTime.sysUpTimeInstance

*

SNMP_OID_OUTPUT_NUMERIC

.1.3.6.1.2.1.1.3.0

*

SNMP_OID_OUTPUT_MODULE

DISMAN-EVENT-MIB::sysUpTimeInstance

*

SNMP_OID_OUTPUT_SUFFIX

sysUpTimeInstance

*

SNMP_OID_OUTPUT_UCD

system.sysUpTime.sysUpTimeInstance

*

SNMP_OID_OUTPUT_NONE

Undefined

*

Some SNMP agents are known for returning OIDs out of order but can complete the walk anyway. Other agents return OIDs that are out of order and can cause SNMP::walk() to loop indefinitely until memory limit will be reached. PHP SNMP library by default performs OID increasing check and stops walking on OID tree when it detects possible loop with issuing warning about non-increasing OID faced. Set oid_increasing_check to FALSE to disable this check. * @link https://secure.php.net/manual/en/class.snmp.php#snmp.props.oid-increasing-check */ public $oid_increasing_check; /** * @var int Controls which failures will raise SNMPException instead of warning. Use bitwise OR'ed SNMP::ERRNO_* constants. By default all SNMP exceptions are disabled. * @link https://secure.php.net/manual/en/class.snmp.php#snmp.props.exceptions-enabled */ public $exceptions_enabled; /** * @var array Read-only property with remote agent configuration: hostname, port, default timeout, default retries count * @link https://secure.php.net/manual/en/class.snmp.php#snmp.props.info */ public $info; public const VERSION_1 = 0; public const VERSION_2c = 1; public const VERSION_2C = 1; public const VERSION_3 = 3; public const ERRNO_NOERROR = 0; public const ERRNO_ANY = 126; public const ERRNO_GENERIC = 2; public const ERRNO_TIMEOUT = 4; public const ERRNO_ERROR_IN_REPLY = 8; public const ERRNO_OID_NOT_INCREASING = 16; public const ERRNO_OID_PARSING_ERROR = 32; public const ERRNO_MULTIPLE_SET_QUERIES = 64; /** * Creates SNMP instance representing session to remote SNMP agent * @link https://php.net/manual/en/snmp.construct.php * @param int $version

SNMP protocol version: * SNMP::VERSION_1, * SNMP::VERSION_2C, * SNMP::VERSION_3.

The purpuse of community is * SNMP version specific:

* The SNMP object (OID) or objects *

Root of subtree to be fetched

By default full OID notation is used for keys in output array. If set to TRUE subtree prefix will be removed from keys leaving only suffix of object_id.

This specifies the maximum number of iterations over the repeating variables. The default is to use this value from SNMP object.

This specifies the number of supplied variables that should not be iterated over. The default is to use this value from SNMP object.

The SNMP object id

When count of OIDs in object_id array is greater than * max_oids object property set method will have to use multiple queries * to perform requested value updates. In this case type and value checks * are made per-chunk so second or subsequent requests may fail due to * wrong type or value for OID requested. To mark this a warning is * raised when count of OIDs in object_id array is greater than max_oids. * When count of OIDs in object_id array is greater than max_oids object property set method will have to use multiple queries to perform requested value updates. In this case type and value checks are made per-chunk so second or subsequent requests may fail due to wrong type or value for OID requested. To mark this a warning is raised when count of OIDs in object_id array is greater than max_oids.

The MIB defines the type of each object id. It has to be specified as a single character from the below list.

* If OPAQUE_SPECIAL_TYPES was defined while compiling the SNMP library, the following are also valid: *

* Most of these will use the obvious corresponding ASN.1 type. 's', 'x', 'd' and 'b' are all different ways of specifying an OCTET STRING value, and * the 'u' unsigned type is also used for handling Gauge32 values. *

* If the MIB-Files are loaded by into the MIB Tree with "snmp_read_mib" or by specifying it in the libsnmp config, '=' may be used as * the type parameter for all object ids as the type can then be automatically read from the MIB. *

* Note that there are two ways to set a variable of the type BITS like e.g. * "SYNTAX BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}": *

*
• * Using type "b" and a list of bit numbers. This method is not recommended since GET query for the same OID would return e.g. 0xF8. *
*
• * Using type "x" and a hex number but without(!) the usual "0x" prefix. *
*

* See examples section for more details. *

* The new value.

* The SNMP agent. *

* The read community. *

* The SNMP object. *

* The number of microseconds until the first timeout. *

* The number of times to retry if timeouts occur. *

The hostname of the SNMP agent (server).

The read community.

The SNMP object id which precedes the wanted one.

The number of microseconds until the first timeout.

The number of times to retry if timeouts occur.

* The SNMP agent (server). *

* The read community. *

* If NULL, object_id is taken as the root of * the SNMP objects tree and all objects under that tree are returned as * an array. *

* If object_id is specified, all the SNMP objects * below that object_id are returned. *

* The number of microseconds until the first timeout. *

The number of times to retry if timeouts occur.

The hostname of the SNMP agent (server).

The read community.

The SNMP object id which precedes the wanted one.

The number of microseconds until the first timeout.

The number of times to retry if timeouts occur.

* The SNMP agent. *

* The read community. *

* If NULL, object_id is taken as the root of * the SNMP objects tree and all objects under that tree are returned as * an array. *

* If object_id is specified, all the SNMP objects * below that object_id are returned. *

* The number of microseconds until the first timeout. *

* The number of times to retry if timeouts occur. *

* The hostname of the SNMP agent (server). *

* The write community. *

* The SNMP object id. *

* The new value. *

* The number of microseconds until the first timeout. *

* The number of times to retry if timeouts occur. *

* If the SNMP host rejects the data type, an E_WARNING message like "Warning: Error in packet. Reason: (badValue) The value given has the wrong type or length." is shown. * If an unknown or invalid OID is specified the warning probably reads "Could not add variable". *

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

Begining from PHP 5.4.0 four additional constants available: * * * * * *

SNMP_OID_OUTPUT_MODULE	DISMAN-EVENT-MIB::sysUpTimeInstance
SNMP_OID_OUTPUT_SUFFIX	sysUpTimeInstance
SNMP_OID_OUTPUT_UCD	system.sysUpTime.sysUpTimeInstance
SNMP_OID_OUTPUT_NONE	Undefined

*

* The SNMP agent. *

* The read community. *

* The SNMP object. *

* The number of microseconds until the first timeout. *

* The number of times to retry if timeouts occur. *

* The hostname of the SNMP agent (server). *

* The read community. *

* The SNMP object id which precedes the wanted one. *

* The number of microseconds until the first timeout. *

* The number of times to retry if timeouts occur. *

* The SNMP agent (server). *

* The read community. *

* If NULL, object_id is taken as the root of * the SNMP objects tree and all objects under that tree are returned as * an array. *

* If object_id is specified, all the SNMP objects * below that object_id are returned. *

* The number of microseconds until the first timeout. *

* The number of times to retry if timeouts occur. *

* The hostname of the SNMP agent (server). *

* The read community. *

* The SNMP object id which precedes the wanted one. *

* The number of microseconds until the first timeout. *

* The number of times to retry if timeouts occur. *

* The hostname of the SNMP agent (server). *

* The write community. *

* The SNMP object id. *

The MIB defines the type of each object id. It has to be specified as a single character from the below list. *

types:

If OPAQUE_SPECIAL_TYPES was defined while compiling the SNMP library, the following are also valid: *

types:

Most of these will use the obvious corresponding ASN.1 type. 's', 'x', 'd' and 'b' are all different ways of specifying an OCTET STRING value, and * the 'u' unsigned type is also used for handling Gauge32 values. *

* If the MIB-Files are loaded by into the MIB Tree with "snmp_read_mib" or by specifying it in the libsnmp config, '=' may be used as * the type parameter for all object ids as the type can then be automatically read from the MIB. *

* The new value. *

* The number of microseconds until the first timeout. *

* The number of times to retry if timeouts occur. *

* If the SNMP host rejects the data type, an E_WARNING message like "Warning: Error in packet. Reason: (badValue) The value given has the wrong type or length." is shown. * If an unknown or invalid OID is specified the warning probably reads "Could not add variable". *

* The hostname of the SNMP agent (server). *

* the security name, usually some kind of username *

* the security level (noAuthNoPriv|authNoPriv|authPriv) *

* the authentication protocol (MD5 or SHA) *

* the authentication pass phrase *

* the privacy protocol (DES or AES) *

* the privacy pass phrase *

* The SNMP object id. *

* The number of microseconds until the first timeout. *

* The number of times to retry if timeouts occur. *

* The hostname of the * SNMP agent (server). *

* the security name, usually some kind of username *

* the security level (noAuthNoPriv|authNoPriv|authPriv) *

* the authentication protocol (MD5 or SHA) *

* the authentication pass phrase *

* the privacy protocol (DES or AES) *

* the privacy pass phrase *

* The SNMP object id. *

* The number of microseconds until the first timeout. *

* The number of times to retry if timeouts occur. *

* The hostname of the SNMP agent (server). *

* the security name, usually some kind of username *

* the security level (noAuthNoPriv|authNoPriv|authPriv) *

* the authentication protocol (MD5 or SHA) *

* the authentication pass phrase *

* the privacy protocol (DES or AES) *

* the privacy pass phrase *

* If NULL, object_id is taken as the root of * the SNMP objects tree and all objects under that tree are returned as * an array. *

* If object_id is specified, all the SNMP objects * below that object_id are returned. *

* The number of microseconds until the first timeout. *

* The number of times to retry if timeouts occur. *

* The hostname of the * SNMP agent (server). *

* the security name, usually some kind of username *

* the security level (noAuthNoPriv|authNoPriv|authPriv) *

* the authentication protocol (MD5 or SHA) *

* the authentication pass phrase *

* the privacy protocol (DES or AES) *

* the privacy pass phrase *

* The SNMP object id. *

* The number of microseconds until the first timeout. *

* The number of times to retry if timeouts occur. *

* The hostname of the SNMP agent (server). *

* the security name, usually some kind of username *

* the security level (noAuthNoPriv|authNoPriv|authPriv) *

* the authentication protocol (MD5 or SHA) *

* the authentication pass phrase *

* the privacy protocol (DES or AES) *

* the privacy pass phrase *

* The SNMP object id. *

The MIB defines the type of each object id. It has to be specified as a single character from the below list.

types:

If OPAQUE_SPECIAL_TYPES was defined while compiling the SNMP library, the following are also valid: *

types:

Most of these will use the obvious corresponding ASN.1 type. 's', 'x', 'd' and 'b' are all different ways of specifying an OCTET STRING value, and * the 'u' unsigned type is also used for handling Gauge32 values. *

* If the MIB-Files are loaded by into the MIB Tree with "snmp_read_mib" or by specifying it in the libsnmp config, '=' may be used as * the type parameter for all object ids as the type can then be automatically read from the MIB. *

* Note that there are two ways to set a variable of the type BITS like e.g. * "SYNTAX BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}": *

* Using type "b" and a list of bit numbers. This method is not recommended since GET query for the same OID would return e.g. 0xF8. * Using type "x" and a hex number but without(!) the usual "0x" prefix. * See examples section for more details. *

* The new value *

* The number of microseconds until the first timeout. *

* The number of times to retry if timeouts occur. *

* If the SNMP host rejects the data type, an E_WARNING message like "Warning: Error in packet. Reason: (badValue) The value given has the wrong type or length." is shown. * If an unknown or invalid OID is specified the warning probably reads "Could not add variable". *

The filename of the MIB.