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 указывает тип идентификатора каждого объекта. Он должен быть указан в виде одного символа из
следующего списка.
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
unsigned int64
I
signed int64
F
float
D
double
Большинство этих значений используют очевидный тип ASN.1.
's', 'x', 'd' и 'b' - это
все разные способы указания значения OCTET STRING, а
беззнаковый тип 'u' также используется для обработки
значений Gauge32.
Если MIB-файлы были загружены в MIB-дерево с помощью "snmp_read_mib"
или были указаны в конфигурационном файле libsnmp, то для указания
параметра type можно использовать нотацию
'=', т.к. тип всех идентификаторов объектов будет автоматически
считан из MIB.
Обратите внимание, что есть два способа установить переменную
типа BITS, например,
"SYNTAX BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}":
С помощью типа "b" и списка битовых чисел. Не рекомендуется использовать этот метод,
т.к. GET-запрос для того же OID вернет, к примеру, 0xF8.
С помощью типа "x" и шестнадцатеричного числа, но без(!) обычного префикса "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".