snmp3_set
(PHP 4, PHP 5, PHP 7, PHP 8)
snmp3_set — Встановлює значення об'єкта SNMP
Опис
snmp3_set( 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
Ім'я хоста агента (сервера) SNMP.
security_name
Ім'я безпеки, зазвичай якесь ім'я користувача.
security_level
Рівень безпеки (noAuthNoPriv|authNoPriv|authPriv).
auth_protocol
Протокол аутентифікації (MD5 чи SHA).
auth_passphrase
Пароль для автентифікації.
privacy_protocol
Протокол конфіденційності (DES чи AES).
privacy_passphrase
Пароль конфіденційності.
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 Приклад використання snmp3_set()****
Приклад #2 Приклад використання snmp3_set()** для встановлення BITS ідентифікатору об'єкта SNMP**