Войти через VK Войти через FB Войти через Google Войти через Яндекс
Поиск по сайту
The SNMP class
(Информация о версии неизвестна, возможно, только в SVN)
Введение
Represents SNMP session.
Обзор классов
SNMP {
/* Свойства */
public int $max_oids ;
public int $valueretrieval ;
public bool $quick_print ;
public bool $enum_print ;
public int $oid_output_format ;
public bool $oid_increasing_check ;
public int $exceptions_enabled ;
public array $info ;
/* Методы */
__construct ( int $version , string $hostname , string $community [, int $timeout = 1000000 [, int $retries = 5 ]] )
bool close ( void )
mixed get ( mixed $object_id [, bool $preserve_keys = false ] )
int getErrno ( void )
string getError ( void )
mixed getnext ( mixed $object_id )
bool set ( mixed $object_id , mixed $type , mixed $value )
bool setSecurity ( string $sec_level [, string $auth_protocol = [, string $auth_passphrase = [, string $priv_protocol = [, string $priv_passphrase = [, string $contextName = [, string $contextEngineID = ]]]]]] )
array walk ( string $object_id [, bool $suffix_as_key = FALSE [, int $max_repetitions [, int $non_repeaters ]]] )
/* Константы */
const integer ERRNO_NOERROR = 0 ;
const integer ERRNO_GENERIC = 2 ;
const integer ERRNO_TIMEOUT = 4 ;
const integer ERRNO_ERROR_IN_REPLY = 8 ;
const integer ERRNO_OID_NOT_INCREASING = 16 ;
const integer ERRNO_OID_PARSING_ERROR = 32 ;
const integer ERRNO_MULTIPLE_SET_QUERIES = 64 ;
const integer ERRNO_ANY = 126 ;
const integer VERSION_1 = 0 ;
const integer VERSION_2C = 1 ;
const integer VERSION_2c = 1 ;
const integer VERSION_3 = 3 ;
}
Свойства
max_oids -
Maximum OID per GET/SET/GETBULK request
valueretrieval -
Controls the method how the SNMP values will be returned
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 properties "value" and "type", where the latter is one of the SNMP_OCTET_STR, SNMP_COUNTER etc. constants. The way "value" is returned is based on which one of SNMP_VALUE_LIBRARY, SNMP_VALUE_PLAIN is set |
quick_print -
Value of quick_print within the NET-SNMP library
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.
enum_print -
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.
oid_output_format -
Controls OID output format
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 |
oid_increasing_check -
Controls disabling check for increasing OID while walking OID tree
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.
exceptions_enabled -
Controls which failures will raise SNMPException instead of warning. Use bitwise OR'ed SNMP::ERRNO_* constants. By default all SNMP exceptions are disabled.
info -
Read-only property with remote agent configuration: hostname, port, default timeout, default retries count
Предопределенные константы
SNMP Error Types
SNMP::ERRNO_NOERROR -
No SNMP-specific error occured.
SNMP::ERRNO_GENERIC -
A generic SNMP error occured.
SNMP::ERRNO_TIMEOUT -
Request to SNMP agent timed out.
SNMP::ERRNO_ERROR_IN_REPLY -
SNMP agent returned an error in reply.
SNMP::ERRNO_OID_NOT_INCREASING -
SNMP agent faced OID cycling reporning non-increasing OID while executing (BULK)WALK command. This indicates bogus remote SNMP agent.
SNMP::ERRNO_OID_PARSING_ERROR -
Library failed while parsing OID (and/or type for SET command). No queries has been made.
SNMP::ERRNO_MULTIPLE_SET_QUERIES -
Library will use multiple queries for SET operation requested. That means that operation will be performed in a non-transaction manner and second or subsequent chunks may fail if a type or value failure will be faced.
SNMP::ERRNO_ANY -
All SNMP::ERRNO_* codes bitwise OR'ed.
SNMP Protocol Versions
SNMP::VERSION_1 -
SNMP::VERSION_2C, SNMP::VERSION_2c -
SNMP::VERSION_3 -
Содержание
- SNMP::close — Close SNMP session
- SNMP::__construct — Creates SNMP instance representing session to remote SNMP agent
- SNMP::get — Fetch an SNMP object
- SNMP::getErrno — Get last error code
- SNMP::getError — Get last error message
- SNMP::getnext — Fetch an SNMP object which follows the given object id
- SNMP::set — Set the value of an SNMP object
- SNMP::setSecurity — Configures security-related SNMPv3 session parameters
- SNMP::walk — Fetch SNMP object subtree
Описание класса snmp, примеры использования класса snmp.
Смотрите также:
Описание на ru2.php.net
Описание на php.ru