snmp3_get(3) [php man page]

SNMP3_GET(3)								 1							      SNMP3_GET(3)

snmp3_get - Fetch anSNMPobject

SYNOPSIS

       string  snmp3_get  (string   $host,  string   $sec_name,  string   $sec_level,  string	$auth_protocol,  string   $auth_passphrase, string
       $priv_protocol, string  $priv_passphrase, string  $object_id, [string  $timeout = 1000000], [string  $retries = 5])

DESCRIPTION

	The snmp3_get(3) function is used to read the value of an SNMP object specified by the $object_id.

PARAMETERS

	      o $host
		- The hostname of the SNMP agent (server).

	      o $sec_name
		- the security name, usually some kind of username

	      o $sec_level
		- the security level (noAuthNoPriv|authNoPriv|authPriv)

	      o $auth_protocol
		- the authentication protocol (MD5 or SHA)

	      o $auth_passphrase
		- the authentication pass phrase

	      o $priv_protocol
		- the privacy protocol (DES or AES)

	      o $priv_passphrase
		- the privacy pass phrase

	      o $object_id
		- The SNMP object id.

	      o $timeout
		- The number of microseconds until the first timeout.

	      o $retries
		- The number of times to retry if timeouts occur.

RETURN VALUES

	Returns SNMP object value on success or FALSE on error.

EXAMPLES

       Example #1

	      Using snmp3_get(3)

	      <?php
	      $nameOfSecondInterface = snmp3_get('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName.2');
	      ?>

SEE ALSO

       snmp3_set(3).

PHP Documentation Group 													      SNMP3_GET(3)

SNMP3_WALK(3)								 1							     SNMP3_WALK(3)

snmp3_walk - Fetch all theSNMPobjects from an agent

SYNOPSIS

       array  snmp3_walk  (string   $host,  string   $sec_name,  string   $sec_level,  string	$auth_protocol,  string   $auth_passphrase, string
       $priv_protocol, string  $priv_passphrase, string  $object_id, [string  $timeout = 1000000], [string  $retries = 5])

DESCRIPTION

       snmp3_walk(3) function is used to read all the values from an SNMP agent specified by the $hostname.

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

PARAMETERS

	      o $host
		- The hostname of the SNMP agent (server).

	      o $sec_name
		- the security name, usually some kind of username

	      o $sec_level
		- the security level (noAuthNoPriv|authNoPriv|authPriv)

	      o $auth_protocol
		- the authentication protocol (MD5 or SHA)

	      o $auth_passphrase
		- the authentication pass phrase

	      o $priv_protocol
		- the privacy protocol (DES or AES)

	      o $priv_passphrase
		- the privacy pass phrase

	      o $object_id
		- If NULL, $object_id is taken as the root of the SNMP objects tree and all objects under that tree are returned as an array.	If
		$object_id is specified, all the SNMP objects below that $object_id are returned.

	      o $timeout
		- The number of microseconds until the first timeout.

	      o $retries
		- The number of times to retry if timeouts occur.

RETURN VALUES

	Returns an array of SNMP object values starting from the $object_id as root or FALSE on error.

EXAMPLES

       Example #1

	      snmp3_walk(3) Example

	      <?php
	      $ret = snmp3_walk('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName');
	      var_export($ret);
	      ?>

	Above function call would return all the SNMP objects from the SNMP agent running on localhost:

       array (
	 0 => 'STRING: lo',
	 1 => 'STRING: eth0',
	 2 => 'STRING: eth2',
	 3 => 'STRING: sit0',
	 4 => 'STRING: sixxs',
       )

SEE ALSO

       snmp3_real_walk(3).

PHP Documentation Group 													     SNMP3_WALK(3)