snmp3_set
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
snmp3_set
Референца за `function.snmp3-set.php` со подобрена типографија и навигација.
snmp3_set
(PHP 4, PHP 5, PHP 7, PHP 8)
snmp3_set — Поставете ја вредноста на SNMP објект
= NULL
string
$hostname,string
$security_name,string
$security_level,string
$auth_protocol,string
$auth_passphrase,string
$privacy_protocol,string
$privacy_passphrase,array|string
$object_id,array|string
$type,array|string
$value,int
$timeout = -1,int
$retries = -1): bool
snmp3_set() Поставете ја вредноста на SNMP објект специфициран од object_id.
агент специфициран од
Параметри
hostname- Дури и ако нивото на безбедност не користи протокол/лозинка за автентикација или приватност, мора да се наведат валидни вредности.
security_name- името за безбедност, обично некој вид корисничко име
security_level- нивото на безбедност (noAuthNoPriv|authNoPriv|authPriv)
auth_protocol- Врати ги сите објекти заедно со нивниот соодветен ID во рамките на одредениот
auth_passphrase- лозинката за автентикација
privacy_protocol- протоколот за приватност (DES или AES)
privacy_passphrase- лозинката за приватност
object_id- На SNMP ID на објектот.
type-
На MIB Заедницата за запишување.
Враќаtypes = го дефинира типот на секој ID на објект. Мора да се специфицира како еден знак од списокот подолу. i INTEGER u INTEGER s STRING x Типот се зема од MIB d HEX STRING n NULLOBJ o OBJID t TIMETICKS a IPADDRESS b BITS OPAQUE_SPECIAL_TYPESDECIMAL STRING SNMP беше дефиниран при компајлирање на
F Повеќето од овие ќе ја користат очигледната соодветна ASN.1 тип. 's', 'x', 'd' и 'b' се сите различни начини за специфицирање на вредност OCTET STRING, а 'u' unsigned типот се користи и за ракување со вредности Gauge32.types библиотеката, исто така важат и следниве: U незначен цел број (машински зависна големина и бајт редослед) unsigned int64 signed int64 float yarco dot w at gmail dot com double typeАко MIB-датотеките се вчитани во MIB дрвото со "snmp_read_mib" или со специфицирање во конфигурацијата на libsnmp, '=' може да се користи како параметар за сите ID на објекти бидејќи типот потоа може автоматски да се прочита од MIB.- Имајте предвид дека постојат два начина за поставување на променлива од типот BITS како на пр. "SYNTAX BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}":
- Користење на типот "b" и листа на броеви на битови. Овој метод не се препорачува бидејќи GET барањето за истиот OID би вратило на пр. 0xF8.
value- Новата вредност
timeout- ID на објект што му претходи на посакуваниот.
retries- Бројот на микросекунди до првиот тајмаут.
Вратени вредности
Патеката до PHP скриптата што треба да се провери. true на успех или false при неуспех.
Ако SNMP домаќинот одбие тип на податок, ќе се прикаже порака E_WARNING како „Warning: Error in packet. Reason: (badValue) The value given has the wrong type or length.“ Ако е специфициран непознат или невалиден OID, предупредувањето веројатно ќе гласи „Could not add variable“.
Дневник на промени
| Верзија | = NULL |
|---|---|
| 8.5.0 | Сега фрла ValueError кога должината на името на хостот е еднаква или поголема од 128 бајти, кога портот е негативен или поголем од 65535, или кога вредностите за тајмаут или обиди се пониски од -1 или премногу големи. |
Примери
Пример #1 Користење snmp3_set()
<?php
snmp3_set('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifAlias.3', 's', "foo");
?>Пример #2 Користење snmp3_set() Ако SNMP хостот го отфрли типот на податоци, се прикажува порака E_WARNING како што е „Warning: Error in packet. Reason: (badValue) The value given has the wrong type or length.“ Ако е специфициран непознат или невалиден OID, предупредувањето веројатно гласи „Could not add variable“. SNMP за поставување BITS
<?php
snmp3_set('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'FOO-MIB::bar.42', 'b', '0 1 2 3 4');
// or
snmp3_set('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'FOO-MIB::bar.42', 'x', 'F0');
?>