snmp3_get

SNMP オブジェクトを取得する

説明

mixed snmp3_get(
    string $hostname,
    string $security_name,
    string $security_level,
    string $auth_protocol,
    string $auth_passphrase,
    string $privacy_protocol,
    string $privacy_passphrase,
    arraystring $object_id,
    int $timeout = -1,
    int $retries = -1
)

snmp3_get 関数は、 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 を返します。

変更履歴

バージョン 説明
8.6.0 Net-SNMP ライブラリがサポートしている場合に、プライバシープロトコルが "AES192"、"AES192C"、 "AES256"、"AES256C" を受け付けるようになりました。
8.5.0 hostname の長さが 128 バイト以上の場合、port が負の数または 65535 より大きい場合、 または timeout や retries の値が -1 より小さいか大きすぎる場合に、 ValueError をスローするようになりました。
8.1.0 Net-SNMP ライブラリがサポートしている場合に、認証プロトコルが "SHA256" と "SHA512" を受け付けるようになりました。

例

例1 snmp3_get の使用法

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

参考

  • snmp3_set