snmp3_set

(PHP 4, PHP 5, PHP 7)

snmp3_set — Set the value of an SNMP object

˵��

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 , string $value [, int $timeout = 1000000 [, int $retries = 5 ]] ) : bool

snmp3_set() is used to set the value of an SNMP object specified by the object_id.

Even if the security level does not use an auth or priv protocol/password valid values have to be specified.

����

host

The hostname of the SNMP agent (server).

sec_name

the security name, usually some kind of username

sec_level

the security level (noAuthNoPriv|authNoPriv|authPriv)

auth_protocol

the authentication protocol (MD5 or SHA)

auth_passphrase

the authentication pass phrase

priv_protocol

the privacy protocol (DES or AES)

priv_passphrase

the privacy pass phrase

object_id

The SNMP object id.

type

MIB �����˸������� id �����͡������������г��ĵ����ַ�֮һ��

����
=MIB����
iINTEGER
uINTEGER
sSTRING
xHEX STRING
dDECIMAL STRING
nNULLOBJ
oOBJID
tTIMETICKS
aIPADDRESS
bBITS

����ڱ��� SNMP ��ʱ������ OPAQUE_SPECIAL_TYPES����ô����ֵ�ǺϷ��ģ�

types
Uunsigned int64
Isigned int64
Ffloat
Ddouble

��Щֵ�󶼻�ʹ���� ASN.1 ��������͡�'s'��'x'��'d' �Լ� 'b' ����ָ��һ�����ֽ��ַ���ֵ�ķ�ʽ������ 'u' �޷�������Ҳ�����ڴ��� Gauge32 ֵ��

��� MIB �ļ����� "snmp_read_mib" ����ͨ���� libsnmp config ��ָ���������� MIB ��ʱ�� '=' ���Ա�����Ϊ���ж���� type ��������Ϊ type ���Ա��Զ��� MIB �ж�ȡ��

ע�������ַ�ʽ�����趨 BITS ���͵ı��������� "SYNTAX BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}":

  • ʹ�� "b" �����Լ�һ��λ�����б����Ƽ�ʹ�ô˷�������Ϊ GET ��ѯ��ͬһ�� OID ���᷵������ 0xF8��
  • ʹ�� "x" �����Լ�һ��ʮ�����������Dz���Ҫͨ���� "0x" ǰ׺��

����ϸ�ڼ��������֡�

value

The new value

timeout

The number of microseconds until the first timeout.

retries

The number of times to retry if timeouts occur.

����ֵ

�ɹ�ʱ���� TRUE�� ������ʧ��ʱ���� FALSE��

If the SNMP host rejects the data type, an E_WARNING message like "Warning: Error in packet. Reason: (badValue) The value given has the wrong type or length." is shown. If an unknown or invalid OID is specified the warning probably reads "Could not add variable".

����

Example #1 Using snmp3_set()

<?php
  snmp3_set('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifAlias.3', 's', "foo");
?>

Example #2 Using snmp3_set() for setting BITS SNMP object id

<?php
  snmp3_set('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'FOO-MIB::bar.42', 'b', '0 1 2 3 4');
// or
  snmp3_set('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'FOO-MIB::bar.42', 'x', 'F0');
?>