snmp3_getnext

(PHP 5, PHP 7, PHP 8)

snmp3_getnext — 指定したオブジェクト ID に続く SNMP オブジェクトを取得する

説明

function snmp3_getnext(
    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
): mixed

snmp3_getnext() 関数は、 object_id で指定したオブジェクトに続く SNMP オブジェクトの値を取得します。

パラメータ

hostname

SNMP エージェント (サーバー) のホスト名。

security_name

セキュリティ名。通常はユーザー名のようなものです。

security_level

セキュリティレベル。"noAuthNoPriv"、 "authNoPriv"、"authPriv" のいずれかです。

auth_protocol

認証プロトコル。"MD5"、"SHA"、 "SHA256"、"SHA512" のいずれかです。

auth_passphrase

認証パスフレーズ。

privacy_protocol

プライバシープロトコル。"DES"、 あるいは "AES"("AES128" としても受け付けられます)です。 "AES192"、"AES192C"、"AES256"、"AES256C" は、 Net-SNMP ライブラリがサポートしている場合に受け付けられます。

privacy_passphrase

プライバシーパスフレーズ。

object_id

SNMP オブジェクト ID。

timeout

最初のタイムアウトまでのマイクロ秒数。

retries

タイムアウト発生時の再試行回数。

戻り値

成功した場合に SNMP オブジェクトの値、エラー時に false を返します。 エラー時には E_WARNING が発生します。

変更履歴

バージョン 説明
8.6.0 Net-SNMP ライブラリがサポートしている場合に、プライバシープロトコルが "AES192"、"AES192C"、 "AES256"、"AES256C" を受け付けるようになりました。
8.1.0 Net-SNMP ライブラリがサポートしている場合に、認証プロトコルが "SHA256" と "SHA512" を受け付けるようになりました。

例

例1 snmp3_getnext() の使用法

<?php
$nameOfSecondInterface = snmp3_getnext('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName.1');
?>

参考

  • snmp3_get() - SNMP オブジェクトを取得する
  • snmp3_walk() - すべての SNMP オブジェクトをエージェントから取得する
+add a note

User Contributed Notes

There are no user contributed notes for this page.