snmp3_set

snmp3_set

Set the value of an SNMP object

bool **snmp3_set** string $hostname string $security_name string $security_level string $auth_protocol string $auth_passphrase string $privacy_protocol string $privacy_passphrase  $object_id  $type  $value int $timeout int $retries

is used to set the value of an  object

specified by the . snmp3_set``object_id

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

hostnameThe hostname of the SNMP agent (server).

security_namethe security name, usually some kind of username

security_levelthe security level (noAuthNoPriv|authNoPriv|authPriv)

auth_protocolthe authentication protocol (MD5 or SHA)

auth_passphrasethe authentication pass phrase

privacy_protocolthe privacy protocol (DES or AES)

privacy_passphrasethe privacy pass phrase

object_idThe object id.

type``valueThe new value

timeoutThe number of microseconds until the first timeout.

retriesThe number of times to retry if timeouts occur.

return.success

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".

**Voorbeeld: Using **

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

Voorbeeld: Using for setting BITS 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');
?>