snmp2_set
(PHP >= 5.2.0, PHP 7, PHP 8)
snmp2_set — Встановлює значення об'єкта SNMP
Опис
snmp2_set( string $hostname, string $community, array|string $object_id, array|string $type, array|string $value, int $timeout = -1, int $retries = -1): bool
snmp2_set() використовується для встановлення значення об'єкта SNMP, зазначеного в object_id
Список параметрів
hostname
Ім'я хоста агента (сервера) SNMP.
community
Write-спільнота.
object_id
Ідентифікатор об'єкта SNMP.
type
MIB визначає тип ідентифікатора кожного об'єкта. Він має бути вказаний у вигляді одного символу з наступного списку.
| = | Тип, який приймає MIB |
| i | INTEGER |
| u | INTEGER |
| s | STRING |
| x | HEX STRING |
| d | DECIMAL STRING |
| n | NULLOBJ |
| o | OBJID |
| t | TIMETICKS |
| a | IPADDRESS |
| b | BITS |
Якщо при компіляції бібліотеки SNMP було визначено опцію OPAQUE_SPECIAL_TYPES, то також можуть бути використані такі типи:
| U | unsigned int64 |
| I | signed int64 |
| F | float |
| D | double |
Більшість цих значень використовує очевидний тип ASN.1. 's', 'x', 'd' і 'b' — це різні способи вказівки значення OCTET STRING, а беззнаковий тип 'u' також вказують для обробки значень Gauge32.
Якщо MIB-файли були завантажені в MIB-дерево за допомогою "snmp_read_mib" або були вказані в конфігураційному файлі libsnmp, то для вказівки параметра type можна використовувати нотацію '=', оскільки тип всіх ідентифікаторів об'єктів буде автоматично зчитаний з MIB.
Зверніть увагу, що є два способи встановити змінну типу BITS, наприклад "SYNTAX BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https( 6)}":
- За допомогою типу "b" та списку бітових чисел. Не рекомендується використовувати цей метод, тому що GET-запит для того ж OID поверне, наприклад, 0xF8.
- За допомогою типу "x" та шістнадцяткового числа, але без (!) звичайного префікса "0x".
Докладніше дивіться у розділі з прикладами.
value
Нове значення.
timeout
Час очікування у мікросекундах.
retries
Кількість повторних спроб після закінчення часу очікування.
Значення, що повертаються
Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.
Якщо хост SNMP відхиляє тип даних, виводиться помилка рівня E_WARNING на кшталт "Warning: Error in packet. Reason: (badValue) The value given has wrong type or length.". Якщо вказано невідомий або неприпустимий OID, ймовірно, буде виведено попередження "Could not add variable".
Приклади
Приклад #1 Приклад використання snmp2_set()****
Приклад #2 Приклад використання snmp2_set()** для встановлення BITS ідентифікатору об'єкта SNMP**
Дивіться також
- snmp2_get() - Отримує об'єкт SNMP