snmpset

(PHP 4、PHP 5、PHP 7、PHP 8)

snmpset — 设置 SNMP 对象的值

描述

snmpset(
    字符串 $hostname,
    字符串 $community,
    数组|字符串 $object_id,
    数组|字符串 $type,
    数组|字符串 $value,
    整数 $timeout = -1,
    整数 $retries = -1
): 布尔值

snmpset() 用于设置由 object_id 指定的 SNMP 对象的值。

参数

hostname

SNMP 代理（服务器）的主机名。

community

写入社区。

object_id

SNMP 对象 ID。

type

MIB 定义每个对象 ID 的类型。它必须以以下列表中的单个字符指定。

**types**
=	类型取自 MIB
i	INTEGER
u	INTEGER
s	STRING
x	HEX STRING
d	DECIMAL STRING
n	NULLOBJ
o	OBJID
t	TIMETICKS
a	IPADDRESS
b	BITS

如果在编译 SNMP 库时定义了OPAQUE_SPECIAL_TYPES，则以下内容也有效

**types**
U	无符号 int64
I	有符号 int64
F	浮点型
D	双精度浮点型

大多数这些将使用明显的对应 ASN.1 类型。's'、'x'、'd' 和 'b' 都是指定 OCTET STRING 值的不同方式，并且 'u' 无符号类型也用于处理 Gauge32 值。

如果 MIB 文件通过“snmp_read_mib”加载到 MIB 树中，或者在 libsnmp 配置中指定，则“=”可以用作 type 参数，因为类型可以自动从 MIB 中读取。

请注意，有两种方法可以设置 BITS 类型变量，例如“SYNTAX BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}”

使用类型“b”和位号列表。此方法不建议使用，因为对相同 OID 的 GET 查询将返回例如 0xF8。
使用类型“x”和十六进制数，但不带(!)通常的“0x”前缀。

有关更多详细信息，请参阅示例部分。

value

新值。

timeout

第一次超时之前的微秒数。

retries

如果发生超时，重试的次数。

返回值

成功时返回true，失败时返回false。

如果 SNMP 主机拒绝数据类型，则会显示类似“警告：数据包中出错。原因：（badValue）给定的值类型或长度错误。”的 E_WARNING 消息。如果指定了未知或无效的 OID，则警告可能显示“无法添加变量”。

示例

示例 #1 使用 snmpset()

<?php
 snmpset("localhost", "public", "IF-MIB::ifAlias.3", "s", "foo");
?>

示例 #2 使用 snmpset() 设置 BITS SNMP 对象 ID

<?php
 snmpset("localhost", "public", 'FOO-MIB::bar.42', 'b', '0 1 2 3 4');
// 或
 snmpset("localhost", "public", 'FOO-MIB::bar.42', 'x', 'F0');
?>

参见

snmpget() - 获取 SNMP 对象

发现问题？

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加注释

用户贡献的注释 3 个注释

上

下

ch at lathspell dot de ¶

14 年前

请注意，有两种方法可以设置 BITS 类型变量，例如
SYNTAX BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}

1. 使用类型“b”和位号列表，例如
snmpset('FOO-MIB::bar.42', 'b', '0 1 2 3 4');
缺点是成功不容易验证，因为对相同 OID 的 snmpget() 将返回例如 0xF8。

2. 使用类型“x”和十六进制数，但不带(!)通常的“0x”前缀
snmpset('FOO-MIB::bar.42', 'x', 'F0');

上

下

deivis dot jakstas at gmail dot com ¶

17 年前

如果您设置十六进制值，正确的格式是
snmpset($source_ip,$community,"$oid","x","10 10 10 10");

上

下

slawrance at technologist dot com ¶

25 年前

"type" 参数必须是以下之一，具体取决于要在 SNMP 主机上设置的变量类型


i INTEGER
u 无符号 INTEGER
t TIMETICKS
a IPADDRESS
o OBJID
s STRING
x HEX STRING
d DECIMAL STRING
n NULLOBJ
b BITS


如果在编译 SNMP 库时定义了 OPAQUE_SPECIAL_TYPES，则
以下内容也有效


U 无符号 int64
I 有符号 int64
F 浮点型
D 双精度浮点型


例如，使用“i”将设置整数，而“s”将设置字符串。如果 SNMP 主机拒绝数据类型，您可能会收到以下消息：“警告：数据包中出错。原因：（badValue）给定的值类型或长度错误。”


如果您指定了未知或无效的 OID，您可能会收到“无法添加变量”消息。在指定完全是数字的绝对 OID（已解析的 OID）时，请在其前面加上一个句点。例如，一个可以在 Asante 集线器上启用/禁用以太网端口的 OID 可能是“1.3.6.1.2.1.22.1.3.1.1.3.6.4.0”，但您需要在 OID 参数中使用“.1.3.6.1.2.1.22.1.3.1.1.3.6.4.0”，以便 SNMP 库不会尝试解析已解析的 OID。友好的、未解析的 OID 不需要在前面加上句点，例如“system.SysContact.0”

＋添加注释