SNMP 関数

目次

  • snmp_get_quick_print — NET-SNMP ライブラリの quick_print の現在の設定値を取得する
  • snmp_get_valueretrieval — SNMP の値が返される方法を返す
  • snmp_read_mib — アクティブな MIB ツリーの中に MIB ファイルを読み込んでパースする
  • snmp_set_enum_print — すべての enum を、実際の整数値ではなく enum 値とともに返す
  • snmp_set_oid_numeric_print — snmp_set_oid_output_format のエイリアス
  • snmp_set_oid_output_format — OID の出力形式を設定する
  • snmp_set_quick_print — NET-SNMP ライブラリで enable の値を設定する
  • snmp_set_valueretrieval — SNMP の値が返される方法を設定する
  • snmp2_get — SNMP オブジェクトを取得する
  • snmp2_getnext — 指定したオブジェクト ID に続く SNMP オブジェクトを取得する
  • snmp2_real_walk — 指定したすべてのオブジェクトとそのオブジェクト ID を返す
  • snmp2_set — SNMP オブジェクトの値を設定する
  • snmp2_walk — すべての SNMP オブジェクトをエージェントから取得する
  • snmp3_get — SNMP オブジェクトを取得する
  • snmp3_getnext — 指定したオブジェクト ID に続く SNMP オブジェクトを取得する
  • snmp3_real_walk — 指定したすべてのオブジェクトとそのオブジェクト ID を返す
  • snmp3_set — SNMP オブジェクトの値を設定する
  • snmp3_walk — すべての SNMP オブジェクトをエージェントから取得する
  • snmpget — SNMP オブジェクトを取得する
  • snmpgetnext — 指定したオブジェクト ID に続く SNMP オブジェクトを取得する
  • snmprealwalk — 指定したオブジェクトに関するオブジェクト ID を含むすべてのオブジェクトを返す
  • snmpset — SNMP オブジェクトの値を設定する
  • snmpwalk — エージェントから全ての SNMP オブジェクトを取得する
  • snmpwalkoid — ネットワークエンティティに関する情報ツリーを検索する
add a note add a note

User Contributed Notes 2 notes

up
7
1413 at blargh dot com
19 years ago
For my purposes in PHP coding, I have the following SNMP options set, always.  These aren't documented very well in PHP's docs, but they make dealing with the SNMP results a LOT easier:

<?php
// Return back the numeric OIDs, instead of text strings.
snmp_set_oid_numeric_print(1);

// Get just the values.
snmp_set_quick_print(TRUE);

// For sequence types, return just the numbers, not the string and numbers.
snmp_set_enum_print(TRUE);

// Don't let the SNMP library get cute with value interpretation.  This makes
// MAC addresses return the 6 binary bytes, timeticks to return just the integer
// value, and some other things.
snmp_set_valueretrieval(SNMP_VALUE_PLAIN); 
?>
up
1
Chris
17 years ago
Here's a fresh list of API for SNMPv1, SNMPv2c, and SNMPv3 as of PHP 5.2.4:

SNMPv1
------
string snmpget(string host, string community, string object_id [, int timeout [, int retries]]);

string snmpgetnext(string host, string community, string object_id [, int timeout [, int retries]]);

array snmpwalk(string host, string community, string object_id [, int timeout [, int retries]]);

array snmprealwalk(string host, string community, string object_id [, int timeout [, int retries]]);

bool snmp_get_quick_print(void);

void snmp_set_quick_print(int quick_print);

void snmp_set_enum_print(int enum_print);

void snmp_set_oid_output_format(int oid_format);

int snmpset(string host, string community, string object_id, string type, mixed value [, int timeout [, int retries]]);

SNMPv2c
-------
string snmp2_get(string host, string community, string object_id [, int timeout [, int retries]]);

string snmp2_getnext(string host, string community, string object_id [, int timeout [, int retries]]);

array snmp2_walk(string host, string community, string object_id [, int timeout [, int retries]]);

array snmp2_real_walk(string host, string community, string object_id [, int timeout [, int retries]]);

int snmp2_set(string host, string community, string object_id, string type, mixed value [, int timeout [, int retries]]);

SNMPv3
------
int snmp3_get(string host, string sec_name, string sec_level, string auth_protocol, string auth_passphrase, string priv_protocol, string priv_passphrase, string object_id [, int timeout [, int retries]]);

int snmp3_getnext(string host, string sec_name, string sec_level, string auth_protocol, string auth_passphrase, string priv_protocol, string priv_passphrase, string object_id [, int timeout [, int retries]]);

int snmp3_walk(string host, string sec_name, string sec_level, string auth_protocol, string auth_passphrase, string priv_protocol, string priv_passphrase, string object_id [, int timeout [, int retries]]);

int snmp3_real_walk(string host, string sec_name, string sec_level, string auth_protocol, string auth_passphrase, string priv_protocol, string priv_passphrase, string object_id [, int timeout [, int retries]]);

int snmp3_set(string host, string sec_name, string sec_level, string auth_protocol, string auth_passphrase, string priv_protocol, string priv_passphrase, string object_id, string type, mixed value [, int timeout [, int retries]]);

General
-------
int snmp_set_valueretrieval(int method);

int snmp_get_valueretrieval();

int snmp_read_mib(string filename);

SNMPv3 options
--------------
SNMPv3 offers a different authentication/authorization scheme than previous versions of SNMP.  To aid in using the API listed above, here is a brief explanation of each of the unique parameters used in the snmp3_* functions.

$sec_name - the "username" used for authentication to the system

$sec_level - the authentication scheme ('noAuthNoPriv', 'authNoPriv', or 'authPriv')

$auth_protocol - the encryption protocol used for authentication ('MD5' [default] or 'SHA')

$auth_passphrase - the encrypted key to use as the authentication challenge

$priv_protocol - the encryption protocol used for protecting the protocol data unit ('DES' [default], 'AES128', 'AES192', or 'AES256')

$priv_passphrase - the key to use for encrypting the protocol data unit

There are good code snippets available on http://forums.cacti.net/about5403.html for more information.
To Top