snmp3_set

Set the value of an SNMP object

&reftitle.description; `bool` `snmp3_set` `string` `hostname` `string` `security_name` `string` `security_level` `string` `auth_protocol` `string` `auth_passphrase` `string` `privacy_protocol` `string` `privacy_passphrase` ``array``string```object_id` ``array``string```type` ``array``string```value` `int` `timeout`-1 `int` `retries`-1

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

&reftitle.parameters;

`hostname`

- The hostname of the SNMP agent (server).

`security_name`

- the security name, usually some kind of username

`security_level`

- the security level (noAuthNoPriv|authNoPriv|authPriv)

`auth_protocol`

- the authentication protocol (MD5 or SHA)

`auth_passphrase`

- the authentication pass phrase

`privacy_protocol`

- the privacy protocol (DES or AES)

`privacy_passphrase`

- the privacy pass phrase

`object_id`

- The SNMP object id.

`type`

- &snmp.set.type.values; &snmp.set.type.values.asn.mapping; &snmp.set.type.values.equal.note; &snmp.set.type.values.bitset.note;

`value`

- The new value

`timeout`

- The number of microseconds until the first timeout.

`retries`

- The number of times to retry if timeouts occur.

&reftitle.returnvalues;

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

&reftitle.examples;

### Using `snmp3_set`

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

### 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');
    ?>