snmp3_get

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

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

説明

function snmp3_get(
    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_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() - SNMP オブジェクトの値を設定する

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug
＋add a note

User Contributed Notes

There are no user contributed notes for this page.