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() - Возвращает все объекты, включая их идентификатор в указанном объекте
    To Top