snmp3_walk

(PHP 4, PHP 5, PHP 7, PHP 8)

snmp3_walk — Получает все объекты SNMP из агента

Описание

snmp3_walk(
    string $hostname,
    string $security_name,
    string $security_level,
    string $auth_protocol,
    string $auth_passphrase,
    string $privacy_protocol,
    string $privacy_passphrase,
    array|string $object_id,
    int $timeout = -1,
    int $retries = -1
): array|false

Функция snmp3_walk() используется для чтения всех значений из агента SNMP, указанного в hostname.

Даже если уровень безопасности не использует протокол авторизации или пароль, необходимо указать корректные значения.

Список параметров

hostname

Имя хоста агента (сервера) SNMP.

security_name

Имя безопасности, обычно какое-то имя пользователя.

security_level

Уровень безопасности (noAuthNoPriv|authNoPriv|authPriv).

auth_protocol

Протокол аутентификации ("MD5", "SHA", "SHA256" или "SHA512").

auth_passphrase

Пароль для аутентификации.

privacy_protocol

Протокол конфиденциальности (DES или AES).

privacy_passphrase

Пароль конфиденциальности.

object_id

Если null, object_id берётся в качестве корня дерева объектов SNMP и все объекты этого дерева возвращаются в виде массива.

Если указан object_id, возвращаются все объекты SNMP ниже этого object_id.

timeout

Время ожидания в микросекундах.

retries

Количество повторных попыток при истечении времени ожидания.

Возвращаемые значения

Возвращает массив значений объекта SNMP, начиная с object_id в качестве корня или false в случае возникновения ошибки.

Список изменений

Версия	Описание
8.1.0	Параметр `auth_protocol` теперь принимает `"SHA256"` и `"SHA512"`, если поддерживается libnetsnmp.

Примеры

Пример #1 Пример использования snmp3_walk()

<?php
$ret = snmp3_walk('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName');
var_export($ret);
?>

Вызов функции вернёт все объекты SNMP из агента SNMP, запущенного на localhost:

array (
  0 => 'STRING: lo',
  1 => 'STRING: eth0',
  2 => 'STRING: eth2',
  3 => 'STRING: sit0',
  4 => 'STRING: sixxs',
)

Смотрите также

snmp3_real_walk() - Возвращает все объекты, включая их идентификатор в указанном объекте

add a note

User Contributed Notes

There are no user contributed notes for this page.