root/ext/snmp/snmp.c

/* [<][>][^][v][top][bottom][index][help] */

DEFINITIONS

This source file includes following definitions.
  1. ZEND_BEGIN_ARG_INFO_EX
  2. ZEND_GET_MODULE
  3. netsnmp_session_free
  4. php_snmp_session_destructor
  5. php_snmp_object_free_storage
  6. php_snmp_object_new
  7. php_snmp_error
  8. php_snmp_getvalue
  9. php_snmp_internal
  10. php_snmp_parse_oid
  11. netsnmp_session_init
  12. netsnmp_session_set_sec_level
  13. netsnmp_session_set_auth_protocol
  14. netsnmp_session_set_sec_protocol
  15. netsnmp_session_gen_auth_key
  16. netsnmp_session_gen_sec_key
  17. netsnmp_session_set_contextEngineID
  18. netsnmp_session_set_security
  19. php_snmp
  20. PHP_FUNCTION
  21. PHP_FUNCTION
  22. PHP_FUNCTION
  23. PHP_FUNCTION
  24. PHP_FUNCTION
  25. PHP_FUNCTION
  26. PHP_FUNCTION
  27. PHP_FUNCTION
  28. PHP_FUNCTION
  29. PHP_FUNCTION
  30. PHP_FUNCTION
  31. PHP_FUNCTION
  32. PHP_FUNCTION
  33. PHP_FUNCTION
  34. PHP_FUNCTION
  35. PHP_FUNCTION
  36. PHP_FUNCTION
  37. PHP_FUNCTION
  38. PHP_FUNCTION
  39. PHP_FUNCTION
  40. PHP_FUNCTION
  41. PHP_FUNCTION
  42. PHP_METHOD
  43. PHP_METHOD
  44. PHP_METHOD
  45. PHP_METHOD
  46. PHP_METHOD
  47. PHP_METHOD
  48. PHP_METHOD
  49. PHP_METHOD
  50. PHP_METHOD
  51. php_snmp_add_property
  52. php_snmp_read_property
  53. php_snmp_write_property
  54. php_snmp_has_property
  55. php_snmp_get_properties
  56. php_snmp_read_info
  57. php_snmp_read_max_oids
  58. PHP_SNMP_LONG_PROPERTY_READER_FUNCTION
  59. php_snmp_write_max_oids
  60. php_snmp_write_valueretrieval
  61. PHP_SNMP_BOOL_PROPERTY_WRITER_FUNCTION
  62. php_snmp_write_exceptions_enabled
  63. PHP_MINIT_FUNCTION
  64. PHP_MSHUTDOWN_FUNCTION
  65. PHP_MINFO_FUNCTION

   1 /*
   2    +----------------------------------------------------------------------+
   3    | PHP Version 5                                                        |
   4    +----------------------------------------------------------------------+
   5    | Copyright (c) 1997-2016 The PHP Group                                |
   6    +----------------------------------------------------------------------+
   7    | This source file is subject to version 3.01 of the PHP license,      |
   8    | that is bundled with this package in the file LICENSE, and is        |
   9    | available through the world-wide-web at the following url:           |
  10    | http://www.php.net/license/3_01.txt                                  |
  11    | If you did not receive a copy of the PHP license and are unable to   |
  12    | obtain it through the world-wide-web, please send a note to          |
  13    | license@php.net so we can mail you a copy immediately.               |
  14    +----------------------------------------------------------------------+
  15    | Authors: Rasmus Lerdorf <rasmus@php.net>                             |
  16    |          Mike Jackson <mhjack@tscnet.com>                            |
  17    |          Steven Lawrance <slawrance@technologist.com>                |
  18    |          Harrie Hazewinkel <harrie@lisanza.net>                      |
  19    |          Johann Hanne <jonny@nurfuerspam.de>                         |
  20    |          Boris Lytockin <lytboris@gmail.com>                         |
  21    +----------------------------------------------------------------------+
  22  */
  23 
  24 /* $Id$ */
  25 
  26 #ifdef HAVE_CONFIG_H
  27 #include "config.h"
  28 #endif
  29 
  30 #include "php.h"
  31 #include "main/php_network.h"
  32 #include "ext/standard/info.h"
  33 #include "php_snmp.h"
  34 
  35 #include "zend_exceptions.h"
  36 
  37 #if HAVE_SPL
  38 #include "ext/spl/spl_exceptions.h"
  39 #endif
  40 
  41 #if HAVE_SNMP
  42 
  43 #include <sys/types.h>
  44 #ifdef PHP_WIN32
  45 #include <winsock2.h>
  46 #include <errno.h>
  47 #include <process.h>
  48 #include "win32/time.h"
  49 #elif defined(NETWARE)
  50 #ifdef USE_WINSOCK
  51 #include <novsock2.h>
  52 #else
  53 #include <sys/socket.h>
  54 #endif
  55 #include <errno.h>
  56 #include <sys/timeval.h>
  57 #else
  58 #include <sys/socket.h>
  59 #include <netinet/in.h>
  60 #include <arpa/inet.h>
  61 #ifndef _OSD_POSIX
  62 #include <sys/errno.h>
  63 #else
  64 #include <errno.h>  /* BS2000/OSD uses <errno.h>, not <sys/errno.h> */
  65 #endif
  66 #include <netdb.h>
  67 #endif
  68 #ifdef HAVE_UNISTD_H
  69 #include <unistd.h>
  70 #endif
  71 
  72 #ifndef __P
  73 #ifdef __GNUC__
  74 #define __P(args) args
  75 #else
  76 #define __P(args) ()
  77 #endif
  78 #endif
  79 
  80 #include <net-snmp/net-snmp-config.h>
  81 #include <net-snmp/net-snmp-includes.h>
  82 
  83 /* For net-snmp prior to 5.4 */
  84 #ifndef HAVE_SHUTDOWN_SNMP_LOGGING
  85 extern netsnmp_log_handler *logh_head;
  86 #define shutdown_snmp_logging() \
  87         { \
  88                 snmp_disable_log(); \
  89                 while(NULL != logh_head) \
  90                         netsnmp_remove_loghandler( logh_head ); \
  91         }
  92 #endif
  93 
  94 #define SNMP_VALUE_LIBRARY      (0 << 0)
  95 #define SNMP_VALUE_PLAIN        (1 << 0)
  96 #define SNMP_VALUE_OBJECT       (1 << 1)
  97 
  98 typedef struct snmp_session php_snmp_session;
  99 #define PHP_SNMP_SESSION_RES_NAME "SNMP session"
 100 
 101 #define PHP_SNMP_ADD_PROPERTIES(a, b) \
 102 { \
 103         int i = 0; \
 104         while (b[i].name != NULL) { \
 105                 php_snmp_add_property((a), (b)[i].name, (b)[i].name_length, \
 106                                                         (php_snmp_read_t)(b)[i].read_func, (php_snmp_write_t)(b)[i].write_func TSRMLS_CC); \
 107                 i++; \
 108         } \
 109 }
 110 
 111 #define PHP_SNMP_ERRNO_NOERROR                  0
 112 #define PHP_SNMP_ERRNO_GENERIC                  (1 << 1)
 113 #define PHP_SNMP_ERRNO_TIMEOUT                  (1 << 2)
 114 #define PHP_SNMP_ERRNO_ERROR_IN_REPLY           (1 << 3)
 115 #define PHP_SNMP_ERRNO_OID_NOT_INCREASING       (1 << 4)
 116 #define PHP_SNMP_ERRNO_OID_PARSING_ERROR        (1 << 5)
 117 #define PHP_SNMP_ERRNO_MULTIPLE_SET_QUERIES     (1 << 6)
 118 #define PHP_SNMP_ERRNO_ANY      ( \
 119                 PHP_SNMP_ERRNO_GENERIC | \
 120                 PHP_SNMP_ERRNO_TIMEOUT | \
 121                 PHP_SNMP_ERRNO_ERROR_IN_REPLY | \
 122                 PHP_SNMP_ERRNO_OID_NOT_INCREASING | \
 123                 PHP_SNMP_ERRNO_OID_PARSING_ERROR | \
 124                 PHP_SNMP_ERRNO_MULTIPLE_SET_QUERIES | \
 125                 PHP_SNMP_ERRNO_NOERROR \
 126         )
 127 
 128 ZEND_DECLARE_MODULE_GLOBALS(snmp)
 129 static PHP_GINIT_FUNCTION(snmp);
 130 
 131 /* constant - can be shared among threads */
 132 static oid objid_mib[] = {1, 3, 6, 1, 2, 1};
 133 
 134 static int le_snmp_session;
 135 
 136 /* Handlers */
 137 static zend_object_handlers php_snmp_object_handlers;
 138 
 139 /* Class entries */
 140 zend_class_entry *php_snmp_ce;
 141 zend_class_entry *php_snmp_exception_ce;
 142 
 143 /* Class object properties */
 144 static HashTable php_snmp_properties;
 145 
 146 /* {{{ arginfo */
 147 
 148 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmpget, 0, 0, 3)
 149         ZEND_ARG_INFO(0, host)
 150         ZEND_ARG_INFO(0, community)
 151         ZEND_ARG_INFO(0, object_id)
 152         ZEND_ARG_INFO(0, timeout)
 153         ZEND_ARG_INFO(0, retries)
 154 ZEND_END_ARG_INFO()
 155 
 156 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmpgetnext, 0, 0, 3)
 157         ZEND_ARG_INFO(0, host)
 158         ZEND_ARG_INFO(0, community)
 159         ZEND_ARG_INFO(0, object_id)
 160         ZEND_ARG_INFO(0, timeout)
 161         ZEND_ARG_INFO(0, retries)
 162 ZEND_END_ARG_INFO()
 163 
 164 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmpwalk, 0, 0, 3)
 165         ZEND_ARG_INFO(0, host)
 166         ZEND_ARG_INFO(0, community)
 167         ZEND_ARG_INFO(0, object_id)
 168         ZEND_ARG_INFO(0, timeout)
 169         ZEND_ARG_INFO(0, retries)
 170 ZEND_END_ARG_INFO()
 171 
 172 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmprealwalk, 0, 0, 3)
 173         ZEND_ARG_INFO(0, host)
 174         ZEND_ARG_INFO(0, community)
 175         ZEND_ARG_INFO(0, object_id)
 176         ZEND_ARG_INFO(0, timeout)
 177         ZEND_ARG_INFO(0, retries)
 178 ZEND_END_ARG_INFO()
 179 
 180 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmpset, 0, 0, 5)
 181         ZEND_ARG_INFO(0, host)
 182         ZEND_ARG_INFO(0, community)
 183         ZEND_ARG_INFO(0, object_id)
 184         ZEND_ARG_INFO(0, type)
 185         ZEND_ARG_INFO(0, value)
 186         ZEND_ARG_INFO(0, timeout)
 187         ZEND_ARG_INFO(0, retries)
 188 ZEND_END_ARG_INFO()
 189 
 190 
 191 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp_get_quick_print, 0, 0, 1)
 192         ZEND_ARG_INFO(0, d)
 193 ZEND_END_ARG_INFO()
 194 
 195 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp_set_quick_print, 0, 0, 1)
 196         ZEND_ARG_INFO(0, quick_print)
 197 ZEND_END_ARG_INFO()
 198 
 199 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp_set_enum_print, 0, 0, 1)
 200         ZEND_ARG_INFO(0, enum_print)
 201 ZEND_END_ARG_INFO()
 202 
 203 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp_set_oid_output_format, 0, 0, 1)
 204         ZEND_ARG_INFO(0, oid_format)
 205 ZEND_END_ARG_INFO()
 206 
 207 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp2_get, 0, 0, 3)
 208         ZEND_ARG_INFO(0, host)
 209         ZEND_ARG_INFO(0, community)
 210         ZEND_ARG_INFO(0, object_id)
 211         ZEND_ARG_INFO(0, timeout)
 212         ZEND_ARG_INFO(0, retries)
 213 ZEND_END_ARG_INFO()
 214 
 215 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp2_getnext, 0, 0, 3)
 216         ZEND_ARG_INFO(0, host)
 217         ZEND_ARG_INFO(0, community)
 218         ZEND_ARG_INFO(0, object_id)
 219         ZEND_ARG_INFO(0, timeout)
 220         ZEND_ARG_INFO(0, retries)
 221 ZEND_END_ARG_INFO()
 222 
 223 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp2_walk, 0, 0, 3)
 224         ZEND_ARG_INFO(0, host)
 225         ZEND_ARG_INFO(0, community)
 226         ZEND_ARG_INFO(0, object_id)
 227         ZEND_ARG_INFO(0, timeout)
 228         ZEND_ARG_INFO(0, retries)
 229 ZEND_END_ARG_INFO()
 230 
 231 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp2_real_walk, 0, 0, 3)
 232         ZEND_ARG_INFO(0, host)
 233         ZEND_ARG_INFO(0, community)
 234         ZEND_ARG_INFO(0, object_id)
 235         ZEND_ARG_INFO(0, timeout)
 236         ZEND_ARG_INFO(0, retries)
 237 ZEND_END_ARG_INFO()
 238 
 239 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp2_set, 0, 0, 5)
 240         ZEND_ARG_INFO(0, host)
 241         ZEND_ARG_INFO(0, community)
 242         ZEND_ARG_INFO(0, object_id)
 243         ZEND_ARG_INFO(0, type)
 244         ZEND_ARG_INFO(0, value)
 245         ZEND_ARG_INFO(0, timeout)
 246         ZEND_ARG_INFO(0, retries)
 247 ZEND_END_ARG_INFO()
 248 
 249 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp3_get, 0, 0, 8)
 250         ZEND_ARG_INFO(0, host)
 251         ZEND_ARG_INFO(0, sec_name)
 252         ZEND_ARG_INFO(0, sec_level)
 253         ZEND_ARG_INFO(0, auth_protocol)
 254         ZEND_ARG_INFO(0, auth_passphrase)
 255         ZEND_ARG_INFO(0, priv_protocol)
 256         ZEND_ARG_INFO(0, priv_passphrase)
 257         ZEND_ARG_INFO(0, object_id)
 258         ZEND_ARG_INFO(0, timeout)
 259         ZEND_ARG_INFO(0, retries)
 260 ZEND_END_ARG_INFO()
 261 
 262 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp3_getnext, 0, 0, 8)
 263         ZEND_ARG_INFO(0, host)
 264         ZEND_ARG_INFO(0, sec_name)
 265         ZEND_ARG_INFO(0, sec_level)
 266         ZEND_ARG_INFO(0, auth_protocol)
 267         ZEND_ARG_INFO(0, auth_passphrase)
 268         ZEND_ARG_INFO(0, priv_protocol)
 269         ZEND_ARG_INFO(0, priv_passphrase)
 270         ZEND_ARG_INFO(0, object_id)
 271         ZEND_ARG_INFO(0, timeout)
 272         ZEND_ARG_INFO(0, retries)
 273 ZEND_END_ARG_INFO()
 274 
 275 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp3_walk, 0, 0, 8)
 276         ZEND_ARG_INFO(0, host)
 277         ZEND_ARG_INFO(0, sec_name)
 278         ZEND_ARG_INFO(0, sec_level)
 279         ZEND_ARG_INFO(0, auth_protocol)
 280         ZEND_ARG_INFO(0, auth_passphrase)
 281         ZEND_ARG_INFO(0, priv_protocol)
 282         ZEND_ARG_INFO(0, priv_passphrase)
 283         ZEND_ARG_INFO(0, object_id)
 284         ZEND_ARG_INFO(0, timeout)
 285         ZEND_ARG_INFO(0, retries)
 286 ZEND_END_ARG_INFO()
 287 
 288 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp3_real_walk, 0, 0, 8)
 289         ZEND_ARG_INFO(0, host)
 290         ZEND_ARG_INFO(0, sec_name)
 291         ZEND_ARG_INFO(0, sec_level)
 292         ZEND_ARG_INFO(0, auth_protocol)
 293         ZEND_ARG_INFO(0, auth_passphrase)
 294         ZEND_ARG_INFO(0, priv_protocol)
 295         ZEND_ARG_INFO(0, priv_passphrase)
 296         ZEND_ARG_INFO(0, object_id)
 297         ZEND_ARG_INFO(0, timeout)
 298         ZEND_ARG_INFO(0, retries)
 299 ZEND_END_ARG_INFO()
 300 
 301 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp3_set, 0, 0, 10)
 302         ZEND_ARG_INFO(0, host)
 303         ZEND_ARG_INFO(0, sec_name)
 304         ZEND_ARG_INFO(0, sec_level)
 305         ZEND_ARG_INFO(0, auth_protocol)
 306         ZEND_ARG_INFO(0, auth_passphrase)
 307         ZEND_ARG_INFO(0, priv_protocol)
 308         ZEND_ARG_INFO(0, priv_passphrase)
 309         ZEND_ARG_INFO(0, object_id)
 310         ZEND_ARG_INFO(0, type)
 311         ZEND_ARG_INFO(0, value)
 312         ZEND_ARG_INFO(0, timeout)
 313         ZEND_ARG_INFO(0, retries)
 314 ZEND_END_ARG_INFO()
 315 
 316 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp_set_valueretrieval, 0, 0, 1)
 317         ZEND_ARG_INFO(0, method)
 318 ZEND_END_ARG_INFO()
 319 
 320 ZEND_BEGIN_ARG_INFO(arginfo_snmp_get_valueretrieval, 0)
 321 ZEND_END_ARG_INFO()
 322 
 323 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp_read_mib, 0, 0, 1)
 324         ZEND_ARG_INFO(0, filename)
 325 ZEND_END_ARG_INFO()
 326 
 327 /* OO arginfo */
 328 
 329 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp_create, 0, 0, 3)
 330         ZEND_ARG_INFO(0, version)
 331         ZEND_ARG_INFO(0, host)
 332         ZEND_ARG_INFO(0, community)
 333         ZEND_ARG_INFO(0, timeout)
 334         ZEND_ARG_INFO(0, retries)
 335 ZEND_END_ARG_INFO()
 336 
 337 ZEND_BEGIN_ARG_INFO(arginfo_snmp_void, 0)
 338 ZEND_END_ARG_INFO()
 339 
 340 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp_setSecurity, 0, 0, 8)
 341         ZEND_ARG_INFO(0, sec_level)
 342         ZEND_ARG_INFO(0, auth_protocol)
 343         ZEND_ARG_INFO(0, auth_passphrase)
 344         ZEND_ARG_INFO(0, priv_protocol)
 345         ZEND_ARG_INFO(0, priv_passphrase)
 346         ZEND_ARG_INFO(0, contextName)
 347         ZEND_ARG_INFO(0, contextEngineID)
 348 ZEND_END_ARG_INFO()
 349 
 350 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp_get, 0, 0, 1)
 351         ZEND_ARG_INFO(0, object_id)
 352         ZEND_ARG_INFO(0, use_orignames)
 353 ZEND_END_ARG_INFO()
 354 
 355 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp_walk, 0, 0, 4)
 356         ZEND_ARG_INFO(0, object_id)
 357         ZEND_ARG_INFO(0, suffix_keys)
 358         ZEND_ARG_INFO(0, max_repetitions)
 359         ZEND_ARG_INFO(0, non_repeaters)
 360 ZEND_END_ARG_INFO()
 361 
 362 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp_set, 0, 0, 3)
 363         ZEND_ARG_INFO(0, object_id)
 364         ZEND_ARG_INFO(0, type)
 365         ZEND_ARG_INFO(0, value)
 366 ZEND_END_ARG_INFO()
 367 
 368 ZEND_BEGIN_ARG_INFO_EX(arginfo_snmp_class_set_quick_print, 0, 0, 1)
 369         ZEND_ARG_INFO(0, quick_print)
 370 ZEND_END_ARG_INFO()
 371 /* }}} */
 372 
 373 struct objid_query {
 374         int count;
 375         int offset;
 376         int step;
 377         long non_repeaters;
 378         long max_repetitions;
 379         int valueretrieval;
 380         int array_output;
 381         int oid_increasing_check;
 382         snmpobjarg *vars;
 383 };
 384 
 385 /* {{{ snmp_functions[]
 386  */
 387 const zend_function_entry snmp_functions[] = {
 388         PHP_FE(snmpget,                                 arginfo_snmpget)
 389         PHP_FE(snmpgetnext,                             arginfo_snmpgetnext)
 390         PHP_FE(snmpwalk,                                arginfo_snmpwalk)
 391         PHP_FE(snmprealwalk,                            arginfo_snmprealwalk)
 392         PHP_FALIAS(snmpwalkoid, snmprealwalk,           arginfo_snmprealwalk)
 393         PHP_FE(snmpset,                                 arginfo_snmpset)
 394         PHP_FE(snmp_get_quick_print,                    arginfo_snmp_get_quick_print)
 395         PHP_FE(snmp_set_quick_print,                    arginfo_snmp_set_quick_print)
 396         PHP_FE(snmp_set_enum_print,                     arginfo_snmp_set_enum_print)
 397         PHP_FE(snmp_set_oid_output_format,              arginfo_snmp_set_oid_output_format)
 398         PHP_FALIAS(snmp_set_oid_numeric_print, snmp_set_oid_output_format, arginfo_snmp_set_oid_output_format)
 399 
 400         PHP_FE(snmp2_get,                               arginfo_snmp2_get)
 401         PHP_FE(snmp2_getnext,                           arginfo_snmp2_getnext)
 402         PHP_FE(snmp2_walk,                              arginfo_snmp2_walk)
 403         PHP_FE(snmp2_real_walk,                         arginfo_snmp2_real_walk)
 404         PHP_FE(snmp2_set,                               arginfo_snmp2_set)
 405 
 406         PHP_FE(snmp3_get,                               arginfo_snmp3_get)
 407         PHP_FE(snmp3_getnext,                           arginfo_snmp3_getnext)
 408         PHP_FE(snmp3_walk,                              arginfo_snmp3_walk)
 409         PHP_FE(snmp3_real_walk,                         arginfo_snmp3_real_walk)
 410         PHP_FE(snmp3_set,                               arginfo_snmp3_set)
 411         PHP_FE(snmp_set_valueretrieval,                 arginfo_snmp_set_valueretrieval)
 412         PHP_FE(snmp_get_valueretrieval,                 arginfo_snmp_get_valueretrieval)
 413 
 414         PHP_FE(snmp_read_mib,                           arginfo_snmp_read_mib)
 415         PHP_FE_END
 416 };
 417 /* }}} */
 418 
 419 /* query an agent with GET method */
 420 #define SNMP_CMD_GET            (1<<0)
 421 /* query an agent with GETNEXT method */
 422 #define SNMP_CMD_GETNEXT        (1<<1)
 423 /* query an agent with SET method */
 424 #define SNMP_CMD_SET            (1<<2)
 425 /* walk the mib */
 426 #define SNMP_CMD_WALK           (1<<3)
 427 /* force values-only output */
 428 #define SNMP_NUMERIC_KEYS       (1<<7)
 429 /* use user-supplied OID names for keys in array output mode in GET method */
 430 #define SNMP_ORIGINAL_NAMES_AS_KEYS     (1<<8)
 431 /* use OID suffix (`index') for keys in array output mode in WALK  method */
 432 #define SNMP_USE_SUFFIX_AS_KEYS (1<<9)
 433 
 434 #ifdef COMPILE_DL_SNMP
 435 ZEND_GET_MODULE(snmp)
 436 #endif
 437 
 438 /* THREAD_LS snmp_module php_snmp_module; - may need one of these at some point */
 439 
 440 /* {{{ PHP_GINIT_FUNCTION
 441  */
 442 static PHP_GINIT_FUNCTION(snmp)
 443 {
 444         snmp_globals->valueretrieval = SNMP_VALUE_LIBRARY;
 445 }
 446 /* }}} */
 447 
 448 #define PHP_SNMP_SESSION_FREE(a) { \
 449         if ((*session)->a) { \
 450                 efree((*session)->a); \
 451                 (*session)->a = NULL; \
 452         } \
 453 }
 454 
 455 static void netsnmp_session_free(php_snmp_session **session)
 456 {
 457         if (*session) {
 458                 PHP_SNMP_SESSION_FREE(peername);
 459                 PHP_SNMP_SESSION_FREE(community);
 460                 PHP_SNMP_SESSION_FREE(securityName);
 461                 PHP_SNMP_SESSION_FREE(contextEngineID);
 462                 efree(*session);
 463                 *session = NULL;
 464         }
 465 }
 466 
 467 static void php_snmp_session_destructor(zend_rsrc_list_entry *rsrc TSRMLS_DC)
 468 {
 469         php_snmp_session *session = (php_snmp_session *)rsrc->ptr;
 470         netsnmp_session_free(&session);
 471 }
 472 
 473 static void php_snmp_object_free_storage(void *object TSRMLS_DC)
 474 {
 475         php_snmp_object *intern = (php_snmp_object *)object;
 476         
 477         if (!intern) {
 478                 return;
 479         }
 480 
 481         netsnmp_session_free(&(intern->session));
 482 
 483         zend_object_std_dtor(&intern->zo TSRMLS_CC);
 484         
 485         efree(intern);
 486 }
 487 
 488 static zend_object_value php_snmp_object_new(zend_class_entry *class_type TSRMLS_DC) /* {{{ */
 489 {
 490         zend_object_value retval;
 491         php_snmp_object *intern;
 492 
 493         /* Allocate memory for it */
 494         intern = emalloc(sizeof(php_snmp_object));
 495         memset(&intern->zo, 0, sizeof(php_snmp_object));
 496 
 497         zend_object_std_init(&intern->zo, class_type TSRMLS_CC);
 498         object_properties_init(&intern->zo, class_type);
 499 
 500         retval.handle = zend_objects_store_put(intern, (zend_objects_store_dtor_t)zend_objects_destroy_object, (zend_objects_free_object_storage_t) php_snmp_object_free_storage, NULL TSRMLS_CC);
 501         retval.handlers = (zend_object_handlers *) &php_snmp_object_handlers;
 502 
 503         return retval;
 504         
 505 }
 506 
 507 /* {{{ php_snmp_error
 508  *
 509  * Record last SNMP-related error in object
 510  *
 511  */
 512 static void php_snmp_error(zval *object, const char *docref TSRMLS_DC, int type, const char *format, ...)
 513 {
 514         va_list args;
 515         php_snmp_object *snmp_object = NULL;
 516 
 517         if (object) {
 518                 snmp_object = (php_snmp_object *)zend_object_store_get_object(object TSRMLS_CC);
 519                 if (type == PHP_SNMP_ERRNO_NOERROR) {
 520                         memset(snmp_object->snmp_errstr, 0, sizeof(snmp_object->snmp_errstr));
 521                 } else {
 522                         va_start(args, format);
 523                         vsnprintf(snmp_object->snmp_errstr, sizeof(snmp_object->snmp_errstr) - 1, format, args);
 524                         va_end(args);
 525                 }
 526                 snmp_object->snmp_errno = type;
 527         }
 528 
 529         if (type == PHP_SNMP_ERRNO_NOERROR) {
 530                 return;
 531         }
 532 
 533         if (object && (snmp_object->exceptions_enabled & type)) {
 534                 zend_throw_exception_ex(php_snmp_exception_ce, type TSRMLS_CC, "%s", snmp_object->snmp_errstr);
 535         } else {
 536                 va_start(args, format);
 537                 php_verror(docref, "", E_WARNING, format, args TSRMLS_CC);
 538                 va_end(args);
 539         }
 540 }
 541 
 542 /* }}} */
 543 
 544 /* {{{ php_snmp_getvalue
 545 *
 546 * SNMP value to zval converter
 547 *
 548 */
 549 static void php_snmp_getvalue(struct variable_list *vars, zval *snmpval TSRMLS_DC, int valueretrieval)
 550 {
 551         zval *val;
 552         char sbuf[512];
 553         char *buf = &(sbuf[0]);
 554         char *dbuf = (char *)NULL;
 555         int buflen = sizeof(sbuf) - 1;
 556         int val_len = vars->val_len;
 557         
 558         /* use emalloc() for large values, use static array otherwize */
 559 
 560         /* There is no way to know the size of buffer snprint_value() needs in order to print a value there.
 561          * So we are forced to probe it
 562          */
 563         while ((valueretrieval & SNMP_VALUE_PLAIN) == 0) {
 564                 *buf = '\0';
 565                 if (snprint_value(buf, buflen, vars->name, vars->name_length, vars) == -1) {
 566                         if (val_len > 512*1024) {
 567                                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "snprint_value() asks for a buffer more than 512k, Net-SNMP bug?");
 568                                 break;
 569                         }
 570                          /* buffer is not long enough to hold full output, double it */
 571                         val_len *= 2;
 572                 } else {
 573                         break;
 574                 }
 575 
 576                 if (buf == dbuf) {
 577                         dbuf = (char *)erealloc(dbuf, val_len + 1);
 578                 } else {
 579                         dbuf = (char *)emalloc(val_len + 1);
 580                 }
 581 
 582                 if (!dbuf) {
 583                         php_error_docref(NULL TSRMLS_CC, E_WARNING, "emalloc() failed: %s, fallback to static buffer", strerror(errno));
 584                         buf = &(sbuf[0]);
 585                         buflen = sizeof(sbuf) - 1;
 586                         break;
 587                 }
 588 
 589                 buf = dbuf;
 590                 buflen = val_len;
 591         }
 592 
 593         if((valueretrieval & SNMP_VALUE_PLAIN) && val_len > buflen){
 594                 if ((dbuf = (char *)emalloc(val_len + 1))) {
 595                         buf = dbuf;
 596                         buflen = val_len;
 597                 } else {
 598                         php_error_docref(NULL TSRMLS_CC, E_WARNING, "emalloc() failed: %s, fallback to static buffer", strerror(errno));
 599                 }
 600         }
 601 
 602         MAKE_STD_ZVAL(val);
 603 
 604         if (valueretrieval & SNMP_VALUE_PLAIN) {
 605                 *buf = 0;
 606                 switch (vars->type) {
 607                 case ASN_BIT_STR:               /* 0x03, asn1.h */
 608                         ZVAL_STRINGL(val, (char *)vars->val.bitstring, vars->val_len, 1);
 609                         break;
 610 
 611                 case ASN_OCTET_STR:             /* 0x04, asn1.h */
 612                 case ASN_OPAQUE:                /* 0x44, snmp_impl.h */
 613                         ZVAL_STRINGL(val, (char *)vars->val.string, vars->val_len, 1);
 614                         break;
 615 
 616                 case ASN_NULL:                  /* 0x05, asn1.h */
 617                         ZVAL_NULL(val);
 618                         break;
 619 
 620                 case ASN_OBJECT_ID:             /* 0x06, asn1.h */
 621                         snprint_objid(buf, buflen, vars->val.objid, vars->val_len / sizeof(oid));
 622                         ZVAL_STRING(val, buf, 1);
 623                         break;
 624 
 625                 case ASN_IPADDRESS:             /* 0x40, snmp_impl.h */
 626                         snprintf(buf, buflen, "%d.%d.%d.%d",
 627                                  (vars->val.string)[0], (vars->val.string)[1],
 628                                  (vars->val.string)[2], (vars->val.string)[3]);
 629                         buf[buflen]=0;
 630                         ZVAL_STRING(val, buf, 1);
 631                         break;
 632 
 633                 case ASN_COUNTER:               /* 0x41, snmp_impl.h */
 634                 case ASN_GAUGE:                 /* 0x42, snmp_impl.h */
 635                 /* ASN_UNSIGNED is the same as ASN_GAUGE */
 636                 case ASN_TIMETICKS:             /* 0x43, snmp_impl.h */
 637                 case ASN_UINTEGER:              /* 0x47, snmp_impl.h */
 638                         snprintf(buf, buflen, "%lu", *vars->val.integer);
 639                         buf[buflen]=0;
 640                         ZVAL_STRING(val, buf, 1);
 641                         break;
 642 
 643                 case ASN_INTEGER:               /* 0x02, asn1.h */
 644                         snprintf(buf, buflen, "%ld", *vars->val.integer);
 645                         buf[buflen]=0;
 646                         ZVAL_STRING(val, buf, 1);
 647                         break;
 648 
 649 #if defined(NETSNMP_WITH_OPAQUE_SPECIAL_TYPES) || defined(OPAQUE_SPECIAL_TYPES)
 650                 case ASN_OPAQUE_FLOAT:          /* 0x78, asn1.h */
 651                         snprintf(buf, buflen, "%f", *vars->val.floatVal);
 652                         ZVAL_STRING(val, buf, 1);
 653                         break;
 654 
 655                 case ASN_OPAQUE_DOUBLE:         /* 0x79, asn1.h */
 656                         snprintf(buf, buflen, "%Lf", *vars->val.doubleVal);
 657                         ZVAL_STRING(val, buf, 1);
 658                         break;
 659 
 660                 case ASN_OPAQUE_I64:            /* 0x80, asn1.h */
 661                         printI64(buf, vars->val.counter64);
 662                         ZVAL_STRING(val, buf, 1);
 663                         break;
 664 
 665                 case ASN_OPAQUE_U64:            /* 0x81, asn1.h */
 666 #endif
 667                 case ASN_COUNTER64:             /* 0x46, snmp_impl.h */
 668                         printU64(buf, vars->val.counter64);
 669                         ZVAL_STRING(val, buf, 1);
 670                         break;
 671 
 672                 default:
 673                         ZVAL_STRING(val, "Unknown value type", 1);
 674                         php_error_docref(NULL TSRMLS_CC, E_WARNING, "Unknown value type: %u", vars->type);
 675                         break;
 676                 }
 677         } else /* use Net-SNMP value translation */ {
 678                 /* we have desired string in buffer, just use it */
 679                 ZVAL_STRING(val, buf, 1);
 680         }
 681 
 682         if (valueretrieval & SNMP_VALUE_OBJECT) {
 683                 object_init(snmpval);
 684                 add_property_long(snmpval, "type", vars->type);
 685                 add_property_zval(snmpval, "value", val);
 686         } else  {
 687                 *snmpval = *val;
 688                 zval_copy_ctor(snmpval);
 689         }
 690         zval_ptr_dtor(&val);
 691 
 692         if(dbuf){ /* malloc was used to store value */
 693                 efree(dbuf);
 694         }
 695 }
 696 /* }}} */
 697 
 698 /* {{{ php_snmp_internal
 699 *
 700 * SNMP object fetcher/setter for all SNMP versions
 701 *
 702 */
 703 static void php_snmp_internal(INTERNAL_FUNCTION_PARAMETERS, int st, 
 704                                                         struct snmp_session *session,
 705                                                         struct objid_query *objid_query)
 706 {
 707         struct snmp_session *ss;
 708         struct snmp_pdu *pdu=NULL, *response;
 709         struct variable_list *vars;
 710         oid root[MAX_NAME_LEN];
 711         size_t rootlen = 0;
 712         int status, count, found;
 713         char buf[2048];
 714         char buf2[2048];
 715         int keepwalking=1;
 716         char *err;
 717         zval *snmpval = NULL;
 718         int snmp_errno;
 719 
 720         /* we start with retval=FALSE. If any actual data is acquired, retval will be set to appropriate type */
 721         RETVAL_FALSE;
 722         
 723         /* reset errno and errstr */
 724         php_snmp_error(getThis(), NULL TSRMLS_CC, PHP_SNMP_ERRNO_NOERROR, "");
 725 
 726         if (st & SNMP_CMD_WALK) { /* remember root OID */
 727                 memmove((char *)root, (char *)(objid_query->vars[0].name), (objid_query->vars[0].name_length) * sizeof(oid));
 728                 rootlen = objid_query->vars[0].name_length;
 729                 objid_query->offset = objid_query->count;
 730         }
 731 
 732         if ((ss = snmp_open(session)) == NULL) {
 733                 snmp_error(session, NULL, NULL, &err);
 734                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "Could not open snmp connection: %s", err);
 735                 free(err);
 736                 RETVAL_FALSE;
 737                 return;
 738         }
 739 
 740         if ((st & SNMP_CMD_SET) && objid_query->count > objid_query->step) {
 741                 php_snmp_error(getThis(), NULL TSRMLS_CC, PHP_SNMP_ERRNO_MULTIPLE_SET_QUERIES, "Can not fit all OIDs for SET query into one packet, using multiple queries");
 742         }
 743 
 744         while (keepwalking) {
 745                 keepwalking = 0;
 746                 if (st & SNMP_CMD_WALK) {
 747                         if (session->version == SNMP_VERSION_1) {
 748                                 pdu = snmp_pdu_create(SNMP_MSG_GETNEXT);
 749                         } else {
 750                                 pdu = snmp_pdu_create(SNMP_MSG_GETBULK);
 751                                 pdu->non_repeaters = objid_query->non_repeaters;
 752                                 pdu->max_repetitions = objid_query->max_repetitions;
 753                         }
 754                         snmp_add_null_var(pdu, objid_query->vars[0].name, objid_query->vars[0].name_length);
 755                 } else {
 756                         if (st & SNMP_CMD_GET) {
 757                                 pdu = snmp_pdu_create(SNMP_MSG_GET);
 758                         } else if (st & SNMP_CMD_GETNEXT) {
 759                                 pdu = snmp_pdu_create(SNMP_MSG_GETNEXT);
 760                         } else if (st & SNMP_CMD_SET) {
 761                                 pdu = snmp_pdu_create(SNMP_MSG_SET);
 762                         } else {
 763                                 snmp_close(ss);
 764                                 php_error_docref(NULL TSRMLS_CC, E_ERROR, "Unknown SNMP command (internals)");
 765                                 RETVAL_FALSE;
 766                                 return;
 767                         }
 768                         for (count = 0; objid_query->offset < objid_query->count && count < objid_query->step; objid_query->offset++, count++){
 769                                 if (st & SNMP_CMD_SET) {
 770                                         if ((snmp_errno = snmp_add_var(pdu, objid_query->vars[objid_query->offset].name, objid_query->vars[objid_query->offset].name_length, objid_query->vars[objid_query->offset].type, objid_query->vars[objid_query->offset].value))) {
 771                                                 snprint_objid(buf, sizeof(buf), objid_query->vars[objid_query->offset].name, objid_query->vars[objid_query->offset].name_length);
 772                                                 php_snmp_error(getThis(), NULL TSRMLS_CC, PHP_SNMP_ERRNO_OID_PARSING_ERROR, "Could not add variable: OID='%s' type='%c' value='%s': %s", buf, objid_query->vars[objid_query->offset].type, objid_query->vars[objid_query->offset].value, snmp_api_errstring(snmp_errno));
 773                                                 snmp_free_pdu(pdu);
 774                                                 snmp_close(ss);
 775                                                 RETVAL_FALSE;
 776                                                 return;
 777                                         }
 778                                 } else {
 779                                         snmp_add_null_var(pdu, objid_query->vars[objid_query->offset].name, objid_query->vars[objid_query->offset].name_length);
 780                                 }
 781                         }
 782                         if(pdu->variables == NULL){
 783                                 snmp_free_pdu(pdu);
 784                                 snmp_close(ss);
 785                                 RETVAL_FALSE;
 786                                 return;
 787                         }
 788                 }
 789 
 790 retry:
 791                 status = snmp_synch_response(ss, pdu, &response);
 792                 if (status == STAT_SUCCESS) {
 793                         if (response->errstat == SNMP_ERR_NOERROR) {
 794                                 if (st & SNMP_CMD_SET) {
 795                                         if (objid_query->offset < objid_query->count) { /* we have unprocessed OIDs */
 796                                                 keepwalking = 1;
 797                                                 continue;
 798                                         }
 799                                         snmp_free_pdu(response);
 800                                         snmp_close(ss);
 801                                         RETVAL_TRUE;
 802                                         return;
 803                                 }
 804                                 for (vars = response->variables; vars; vars = vars->next_variable) {
 805                                         /* do not output errors as values */
 806                                         if (    vars->type == SNMP_ENDOFMIBVIEW || 
 807                                                 vars->type == SNMP_NOSUCHOBJECT || 
 808                                                 vars->type == SNMP_NOSUCHINSTANCE ) {
 809                                                 if ((st & SNMP_CMD_WALK) && Z_TYPE_P(return_value) == IS_ARRAY) {
 810                                                         break;
 811                                                 }
 812                                                 snprint_objid(buf, sizeof(buf), vars->name, vars->name_length);
 813                                                 snprint_value(buf2, sizeof(buf2), vars->name, vars->name_length, vars);
 814                                                 php_snmp_error(getThis(), NULL TSRMLS_CC, PHP_SNMP_ERRNO_ERROR_IN_REPLY, "Error in packet at '%s': %s", buf, buf2);
 815                                                 continue;
 816                                         }
 817                                         
 818                                         if ((st & SNMP_CMD_WALK) && 
 819                                                 (vars->name_length < rootlen || memcmp(root, vars->name, rootlen * sizeof(oid)))) { /* not part of this subtree */
 820                                                 if (Z_TYPE_P(return_value) == IS_ARRAY) { /* some records are fetched already, shut down further lookup */
 821                                                         keepwalking = 0;
 822                                                 } else {
 823                                                         /* first fetched OID is out of subtree, fallback to GET query */
 824                                                         st |= SNMP_CMD_GET;
 825                                                         st ^= SNMP_CMD_WALK;
 826                                                         objid_query->offset = 0;
 827                                                         keepwalking = 1;
 828                                                 }
 829                                                 break;
 830                                         }
 831 
 832                                         MAKE_STD_ZVAL(snmpval);
 833                                         php_snmp_getvalue(vars, snmpval TSRMLS_CC, objid_query->valueretrieval);
 834 
 835                                         if (objid_query->array_output) {
 836                                                 if (Z_TYPE_P(return_value) == IS_BOOL) {
 837                                                         array_init(return_value);
 838                                                 }
 839                                                 if (st & SNMP_NUMERIC_KEYS) {
 840                                                         add_next_index_zval(return_value, snmpval);
 841                                                 } else if (st & SNMP_ORIGINAL_NAMES_AS_KEYS && st & SNMP_CMD_GET) {
 842                                                         found = 0;
 843                                                         for (count = 0; count < objid_query->count; count++) {
 844                                                                 if (objid_query->vars[count].name_length == vars->name_length && snmp_oid_compare(objid_query->vars[count].name, objid_query->vars[count].name_length, vars->name, vars->name_length) == 0) {
 845                                                                         found = 1;
 846                                                                         objid_query->vars[count].name_length = 0; /* mark this name as used */
 847                                                                         break;
 848                                                                 }
 849                                                         }
 850                                                         if (found) {
 851                                                                 add_assoc_zval(return_value, objid_query->vars[count].oid, snmpval);
 852                                                         } else {
 853                                                                 snprint_objid(buf2, sizeof(buf2), vars->name, vars->name_length);
 854                                                                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "Could not find original OID name for '%s'", buf2);
 855                                                         }
 856                                                 } else if (st & SNMP_USE_SUFFIX_AS_KEYS && st & SNMP_CMD_WALK) {
 857                                                         snprint_objid(buf2, sizeof(buf2), vars->name, vars->name_length);
 858                                                         if (rootlen <= vars->name_length && snmp_oid_compare(root, rootlen, vars->name, rootlen) == 0) {
 859                                                                 buf2[0] = '\0';
 860                                                                 count = rootlen;
 861                                                                 while(count < vars->name_length){
 862                                                                         sprintf(buf, "%lu.", vars->name[count]);
 863                                                                         strcat(buf2, buf);
 864                                                                         count++;
 865                                                                 }
 866                                                                 buf2[strlen(buf2) - 1] = '\0'; /* remove trailing '.' */
 867                                                         }
 868                                                         add_assoc_zval(return_value, buf2, snmpval);
 869                                                 } else {
 870                                                         snprint_objid(buf2, sizeof(buf2), vars->name, vars->name_length);
 871                                                         add_assoc_zval(return_value, buf2, snmpval);
 872                                                 }
 873                                         } else {
 874                                                 *return_value = *snmpval;
 875                                                 zval_copy_ctor(return_value);
 876                                                 zval_ptr_dtor(&snmpval);
 877                                                 break;
 878                                         }
 879 
 880                                         /* OID increase check */
 881                                         if (st & SNMP_CMD_WALK) {
 882                                                 if (objid_query->oid_increasing_check == TRUE && snmp_oid_compare(objid_query->vars[0].name, objid_query->vars[0].name_length, vars->name, vars->name_length) >= 0) {
 883                                                         snprint_objid(buf2, sizeof(buf2), vars->name, vars->name_length);
 884                                                         php_snmp_error(getThis(), NULL TSRMLS_CC, PHP_SNMP_ERRNO_OID_NOT_INCREASING, "Error: OID not increasing: %s", buf2);
 885                                                         keepwalking = 0;
 886                                                 } else {
 887                                                         memmove((char *)(objid_query->vars[0].name), (char *)vars->name, vars->name_length * sizeof(oid));
 888                                                         objid_query->vars[0].name_length = vars->name_length;
 889                                                         keepwalking = 1;
 890                                                 }
 891                                         }
 892                                 }
 893                                 if (objid_query->offset < objid_query->count) { /* we have unprocessed OIDs */
 894                                         keepwalking = 1;
 895                                 }
 896                         } else {
 897                                 if (st & SNMP_CMD_WALK && response->errstat == SNMP_ERR_TOOBIG && objid_query->max_repetitions > 1) { /* Answer will not fit into single packet */
 898                                         objid_query->max_repetitions /= 2;
 899                                         snmp_free_pdu(response);
 900                                         keepwalking = 1;
 901                                         continue;
 902                                 }
 903                                 if (!(st & SNMP_CMD_WALK) || response->errstat != SNMP_ERR_NOSUCHNAME || Z_TYPE_P(return_value) == IS_BOOL) {
 904                                         for (   count=1, vars = response->variables;
 905                                                 vars && count != response->errindex;
 906                                                 vars = vars->next_variable, count++);
 907 
 908                                         if (st & (SNMP_CMD_GET | SNMP_CMD_GETNEXT) && response->errstat == SNMP_ERR_TOOBIG && objid_query->step > 1) { /* Answer will not fit into single packet */
 909                                                 objid_query->offset = ((objid_query->offset > objid_query->step) ? (objid_query->offset - objid_query->step) : 0 );
 910                                                 objid_query->step /= 2;
 911                                                 snmp_free_pdu(response);
 912                                                 keepwalking = 1;
 913                                                 continue;
 914                                         }
 915                                         if (vars) {
 916                                                 snprint_objid(buf, sizeof(buf), vars->name, vars->name_length);
 917                                                 php_snmp_error(getThis(), NULL TSRMLS_CC, PHP_SNMP_ERRNO_ERROR_IN_REPLY, "Error in packet at '%s': %s", buf, snmp_errstring(response->errstat));
 918                                         } else {
 919                                                 php_snmp_error(getThis(), NULL TSRMLS_CC, PHP_SNMP_ERRNO_ERROR_IN_REPLY, "Error in packet at %u object_id: %s", response->errindex, snmp_errstring(response->errstat));
 920                                         }
 921                                         if (st & (SNMP_CMD_GET | SNMP_CMD_GETNEXT)) { /* cut out bogus OID and retry */
 922                                                 if ((pdu = snmp_fix_pdu(response, ((st & SNMP_CMD_GET) ? SNMP_MSG_GET : SNMP_MSG_GETNEXT) )) != NULL) {
 923                                                         snmp_free_pdu(response);
 924                                                         goto retry;
 925                                                 }
 926                                         }
 927                                         snmp_free_pdu(response);
 928                                         snmp_close(ss);
 929                                         if (objid_query->array_output) {
 930                                                 zval_dtor(return_value);
 931                                         }
 932                                         RETVAL_FALSE;
 933                                         return;
 934                                 }
 935                         }
 936                 } else if (status == STAT_TIMEOUT) {
 937                         php_snmp_error(getThis(), NULL TSRMLS_CC, PHP_SNMP_ERRNO_TIMEOUT, "No response from %s", session->peername);
 938                         if (objid_query->array_output) {
 939                                 zval_dtor(return_value);
 940                         }
 941                         snmp_close(ss);
 942                         RETVAL_FALSE;
 943                         return;
 944                 } else {    /* status == STAT_ERROR */
 945                         snmp_error(ss, NULL, NULL, &err);
 946                         php_snmp_error(getThis(), NULL TSRMLS_CC, PHP_SNMP_ERRNO_GENERIC, "Fatal error: %s", err);
 947                         free(err);
 948                         if (objid_query->array_output) {
 949                                 zval_dtor(return_value);
 950                         }
 951                         snmp_close(ss);
 952                         RETVAL_FALSE;
 953                         return;
 954                 }
 955                 if (response) {
 956                         snmp_free_pdu(response);
 957                 }
 958         } /* keepwalking */
 959         snmp_close(ss);
 960 }
 961 /* }}} */
 962 
 963 /* {{{ php_snmp_parse_oid
 964 *
 965 * OID parser (and type, value for SNMP_SET command)
 966 */
 967 
 968 static int php_snmp_parse_oid(zval *object, int st, struct objid_query *objid_query, zval **oid, zval **type, zval **value TSRMLS_DC)
 969 {
 970         char *pptr;
 971         HashPosition pos_oid, pos_type, pos_value;
 972         zval **tmp_oid, **tmp_type, **tmp_value;
 973 
 974         if (Z_TYPE_PP(oid) != IS_ARRAY) {
 975                 if (Z_ISREF_PP(oid)) {
 976                         SEPARATE_ZVAL(oid);
 977                 }
 978                 convert_to_string_ex(oid);
 979         } else if (Z_TYPE_PP(oid) == IS_ARRAY) {
 980                 zend_hash_internal_pointer_reset_ex(Z_ARRVAL_PP(oid), &pos_oid);
 981         }
 982 
 983         if (st & SNMP_CMD_SET) {
 984                 if (Z_TYPE_PP(type) != IS_ARRAY) {
 985                         if (Z_ISREF_PP(type)) {
 986                                 SEPARATE_ZVAL(type);
 987                         }
 988                         convert_to_string_ex(type);
 989                 } else if (Z_TYPE_PP(type) == IS_ARRAY) {
 990                         zend_hash_internal_pointer_reset_ex(Z_ARRVAL_PP(type), &pos_type);
 991                 }
 992 
 993                 if (Z_TYPE_PP(value) != IS_ARRAY) {
 994                         if (Z_ISREF_PP(value)) {
 995                                 SEPARATE_ZVAL(value);
 996                         }
 997                         convert_to_string_ex(value);
 998                 } else if (Z_TYPE_PP(value) == IS_ARRAY) {
 999                         zend_hash_internal_pointer_reset_ex(Z_ARRVAL_PP(value), &pos_value);
1000                 }
1001         }
1002 
1003         objid_query->count = 0;
1004         objid_query->array_output = ((st & SNMP_CMD_WALK) ? TRUE : FALSE);
1005         if (Z_TYPE_PP(oid) == IS_STRING) {
1006                 objid_query->vars = (snmpobjarg *)emalloc(sizeof(snmpobjarg));
1007                 if (objid_query->vars == NULL) {
1008                         php_error_docref(NULL TSRMLS_CC, E_WARNING, "emalloc() failed while parsing oid: %s", strerror(errno));
1009                         efree(objid_query->vars);
1010                         return FALSE;
1011                 }
1012                 objid_query->vars[objid_query->count].oid = Z_STRVAL_PP(oid);
1013                 if (st & SNMP_CMD_SET) {
1014                         if (Z_TYPE_PP(type) == IS_STRING && Z_TYPE_PP(value) == IS_STRING) {
1015                                 if (Z_STRLEN_PP(type) != 1) {
1016                                         php_error_docref(NULL TSRMLS_CC, E_WARNING, "Bogus type '%s', should be single char, got %u", Z_STRVAL_PP(type), Z_STRLEN_PP(type));
1017                                         efree(objid_query->vars);
1018                                         return FALSE;
1019                                 }
1020                                 pptr = Z_STRVAL_PP(type);
1021                                 objid_query->vars[objid_query->count].type = *pptr;
1022                                 objid_query->vars[objid_query->count].value = Z_STRVAL_PP(value);
1023                         } else {
1024                                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "Single objid and multiple type or values are not supported");
1025                                 efree(objid_query->vars);
1026                                 return FALSE;
1027                         }
1028                 }
1029                 objid_query->count++;
1030         } else if (Z_TYPE_PP(oid) == IS_ARRAY) { /* we got objid array */
1031                 if (zend_hash_num_elements(Z_ARRVAL_PP(oid)) == 0) {
1032                         php_error_docref(NULL TSRMLS_CC, E_WARNING, "Got empty OID array");
1033                         return FALSE;
1034                 }
1035                 objid_query->vars = (snmpobjarg *)emalloc(sizeof(snmpobjarg) * zend_hash_num_elements(Z_ARRVAL_PP(oid)));
1036                 if (objid_query->vars == NULL) {
1037                         php_error_docref(NULL TSRMLS_CC, E_WARNING, "emalloc() failed while parsing oid array: %s", strerror(errno));
1038                         efree(objid_query->vars);
1039                         return FALSE;
1040                 }
1041                 objid_query->array_output = ( (st & SNMP_CMD_SET) ? FALSE : TRUE );
1042                 for (   zend_hash_internal_pointer_reset_ex(Z_ARRVAL_PP(oid), &pos_oid);
1043                         zend_hash_get_current_data_ex(Z_ARRVAL_PP(oid), (void **) &tmp_oid, &pos_oid) == SUCCESS;
1044                         zend_hash_move_forward_ex(Z_ARRVAL_PP(oid), &pos_oid) ) {
1045 
1046                         convert_to_string_ex(tmp_oid);
1047                         objid_query->vars[objid_query->count].oid = Z_STRVAL_PP(tmp_oid);
1048                         if (st & SNMP_CMD_SET) {
1049                                 if (Z_TYPE_PP(type) == IS_STRING) {
1050                                         pptr = Z_STRVAL_PP(type);
1051                                         objid_query->vars[objid_query->count].type = *pptr;
1052                                 } else if (Z_TYPE_PP(type) == IS_ARRAY) {
1053                                         if (SUCCESS == zend_hash_get_current_data_ex(Z_ARRVAL_PP(type), (void **) &tmp_type, &pos_type)) {
1054                                                 convert_to_string_ex(tmp_type);
1055                                                 if (Z_STRLEN_PP(tmp_type) != 1) {
1056                                                         php_error_docref(NULL TSRMLS_CC, E_WARNING, "'%s': bogus type '%s', should be single char, got %u", Z_STRVAL_PP(tmp_oid), Z_STRVAL_PP(tmp_type), Z_STRLEN_PP(tmp_type));
1057                                                         efree(objid_query->vars);
1058                                                         return FALSE;
1059                                                 }
1060                                                 pptr = Z_STRVAL_PP(tmp_type);
1061                                                 objid_query->vars[objid_query->count].type = *pptr;
1062                                                 zend_hash_move_forward_ex(Z_ARRVAL_PP(type), &pos_type);
1063                                         } else {
1064                                                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "'%s': no type set", Z_STRVAL_PP(tmp_oid));
1065                                                 efree(objid_query->vars);
1066                                                 return FALSE;
1067                                         }
1068                                 }
1069 
1070                                 if (Z_TYPE_PP(value) == IS_STRING) {
1071                                         objid_query->vars[objid_query->count].value = Z_STRVAL_PP(value);
1072                                 } else if (Z_TYPE_PP(value) == IS_ARRAY) {
1073                                         if (SUCCESS == zend_hash_get_current_data_ex(Z_ARRVAL_PP(value), (void **) &tmp_value, &pos_value)) {
1074                                                 convert_to_string_ex(tmp_value);
1075                                                 objid_query->vars[objid_query->count].value = Z_STRVAL_PP(tmp_value);
1076                                                 zend_hash_move_forward_ex(Z_ARRVAL_PP(value), &pos_value);
1077                                         } else {
1078                                                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "'%s': no value set", Z_STRVAL_PP(tmp_oid));
1079                                                 efree(objid_query->vars);
1080                                                 return FALSE;
1081                                         }
1082                                 }
1083                         }
1084                         objid_query->count++;
1085                 }
1086         }
1087 
1088         /* now parse all OIDs */
1089         if (st & SNMP_CMD_WALK) {
1090                 if (objid_query->count > 1) {
1091                         php_snmp_error(object, NULL TSRMLS_CC, PHP_SNMP_ERRNO_OID_PARSING_ERROR, "Multi OID walks are not supported!");
1092                         efree(objid_query->vars);
1093                         return FALSE;
1094                 }
1095                 objid_query->vars[0].name_length = MAX_NAME_LEN;
1096                 if (strlen(objid_query->vars[0].oid)) { /* on a walk, an empty string means top of tree - no error */
1097                         if (!snmp_parse_oid(objid_query->vars[0].oid, objid_query->vars[0].name, &(objid_query->vars[0].name_length))) {
1098                                 php_snmp_error(object, NULL TSRMLS_CC, PHP_SNMP_ERRNO_OID_PARSING_ERROR, "Invalid object identifier: %s", objid_query->vars[0].oid);
1099                                 efree(objid_query->vars);
1100                                 return FALSE;
1101                         }
1102                 } else { 
1103                         memmove((char *)objid_query->vars[0].name, (char *)objid_mib, sizeof(objid_mib));
1104                         objid_query->vars[0].name_length = sizeof(objid_mib) / sizeof(oid);
1105                 }
1106         } else {
1107                 for (objid_query->offset = 0; objid_query->offset < objid_query->count; objid_query->offset++) {
1108                         objid_query->vars[objid_query->offset].name_length = MAX_OID_LEN;
1109                         if (!snmp_parse_oid(objid_query->vars[objid_query->offset].oid, objid_query->vars[objid_query->offset].name, &(objid_query->vars[objid_query->offset].name_length))) {
1110                                 php_snmp_error(object, NULL TSRMLS_CC, PHP_SNMP_ERRNO_OID_PARSING_ERROR, "Invalid object identifier: %s", objid_query->vars[objid_query->offset].oid);
1111                                 efree(objid_query->vars);
1112                                 return FALSE;
1113                         }
1114                 }
1115         }
1116         objid_query->offset = 0;
1117         objid_query->step = objid_query->count;
1118         return (objid_query->count > 0);
1119 }
1120 /* }}} */
1121 
1122 /* {{{ netsnmp_session_init
1123         allocates memory for session and session->peername, caller should free it manually using netsnmp_session_free() and efree()
1124 */
1125 static int netsnmp_session_init(php_snmp_session **session_p, int version, char *hostname, char *community, int timeout, int retries TSRMLS_DC)
1126 {
1127         php_snmp_session *session;
1128         char *pptr, *host_ptr;
1129         int force_ipv6 = FALSE;
1130         int n;
1131         struct sockaddr **psal;
1132         struct sockaddr **res;
1133 
1134         *session_p = (php_snmp_session *)emalloc(sizeof(php_snmp_session));
1135         session = *session_p;
1136         if (session == NULL) {
1137                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "emalloc() failed allocating session");
1138                 return (-1);
1139         }
1140         memset(session, 0, sizeof(php_snmp_session));
1141 
1142         snmp_sess_init(session);
1143 
1144         session->version = version;
1145         session->remote_port = SNMP_PORT;
1146 
1147         session->peername = emalloc(MAX_NAME_LEN);
1148         if (session->peername == NULL) {
1149                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "emalloc() failed while copying hostname");
1150                 return (-1);
1151         }
1152         /* we copy original hostname for further processing */
1153         strlcpy(session->peername, hostname, MAX_NAME_LEN);
1154         host_ptr = session->peername;
1155 
1156         /* Reading the hostname and its optional non-default port number */
1157         if (*host_ptr == '[') { /* IPv6 address */
1158                 force_ipv6 = TRUE;
1159                 host_ptr++;
1160                 if ((pptr = strchr(host_ptr, ']'))) {
1161                         if (pptr[1] == ':') {
1162                                 session->remote_port = atoi(pptr + 2);
1163                         }
1164                         *pptr = '\0';
1165                 } else {
1166                         php_error_docref(NULL TSRMLS_CC, E_WARNING, "malformed IPv6 address, closing square bracket missing");
1167                         return (-1);
1168                 }
1169         } else { /* IPv4 address */
1170                 if ((pptr = strchr(host_ptr, ':'))) {
1171                         session->remote_port = atoi(pptr + 1);
1172                         *pptr = '\0';
1173                 }
1174         }
1175 
1176         /* since Net-SNMP library requires 'udp6:' prefix for all IPv6 addresses (in FQDN form too) we need to
1177            perform possible name resolution before running any SNMP queries */
1178         if ((n = php_network_getaddresses(host_ptr, SOCK_DGRAM, &psal, NULL TSRMLS_CC)) == 0) { /* some resolver error */
1179                 /* warnings sent, bailing out */
1180                 return (-1);
1181         }
1182 
1183         /* we have everything we need in psal, flush peername and fill it properly */
1184         *(session->peername) = '\0';
1185         res = psal;
1186         while (n-- > 0) {
1187                 pptr = session->peername;
1188 #if HAVE_GETADDRINFO && HAVE_IPV6 && HAVE_INET_NTOP
1189                 if (force_ipv6 && (*res)->sa_family != AF_INET6) {
1190                         res++;
1191                         continue;
1192                 }
1193                 if ((*res)->sa_family == AF_INET6) {
1194                         strcpy(session->peername, "udp6:[");
1195                         pptr = session->peername + strlen(session->peername);
1196                         inet_ntop((*res)->sa_family, &(((struct sockaddr_in6*)(*res))->sin6_addr), pptr, MAX_NAME_LEN);
1197                         strcat(pptr, "]");
1198                 } else if ((*res)->sa_family == AF_INET) {
1199                         inet_ntop((*res)->sa_family, &(((struct sockaddr_in*)(*res))->sin_addr), pptr, MAX_NAME_LEN);
1200                 } else {
1201                         res++;
1202                         continue;
1203                 }
1204 #else
1205                 if ((*res)->sa_family != AF_INET) {
1206                         res++;
1207                         continue;
1208                 }
1209                 strcat(pptr, inet_ntoa(((struct sockaddr_in*)(*res))->sin_addr));
1210 #endif
1211                 break;
1212         }
1213 
1214         if (strlen(session->peername) == 0) {
1215                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "Unknown failure while resolving '%s'", hostname);
1216                 return (-1);
1217         }
1218         /* XXX FIXME
1219                 There should be check for non-empty session->peername!
1220         */
1221 
1222         /* put back non-standard SNMP port */
1223         if (session->remote_port != SNMP_PORT) {
1224                 pptr = session->peername + strlen(session->peername);
1225                 sprintf(pptr, ":%d", session->remote_port);
1226         }
1227 
1228         php_network_freeaddresses(psal);
1229 
1230         if (version == SNMP_VERSION_3) {
1231                 /* Setting the security name. */
1232                 session->securityName = estrdup(community);
1233                 session->securityNameLen = strlen(session->securityName);
1234         } else {
1235                 session->authenticator = NULL;
1236                 session->community = (u_char *)estrdup(community);
1237                 session->community_len = strlen(community);
1238         }
1239 
1240         session->retries = retries;
1241         session->timeout = timeout;
1242         return (0);
1243 }
1244 /* }}} */
1245 
1246 /* {{{ int netsnmp_session_set_sec_level(struct snmp_session *s, char *level)
1247    Set the security level in the snmpv3 session */
1248 static int netsnmp_session_set_sec_level(struct snmp_session *s, char *level)
1249 {
1250         if (!strcasecmp(level, "noAuthNoPriv") || !strcasecmp(level, "nanp")) {
1251                 s->securityLevel = SNMP_SEC_LEVEL_NOAUTH;
1252         } else if (!strcasecmp(level, "authNoPriv") || !strcasecmp(level, "anp")) {
1253                 s->securityLevel = SNMP_SEC_LEVEL_AUTHNOPRIV;
1254         } else if (!strcasecmp(level, "authPriv") || !strcasecmp(level, "ap")) {
1255                 s->securityLevel = SNMP_SEC_LEVEL_AUTHPRIV;
1256         } else {
1257                 return (-1);
1258         }
1259         return (0);
1260 }
1261 /* }}} */
1262 
1263 /* {{{ int netsnmp_session_set_auth_protocol(struct snmp_session *s, char *prot)
1264    Set the authentication protocol in the snmpv3 session */
1265 static int netsnmp_session_set_auth_protocol(struct snmp_session *s, char *prot TSRMLS_DC)
1266 {
1267         if (!strcasecmp(prot, "MD5")) {
1268                 s->securityAuthProto = usmHMACMD5AuthProtocol;
1269                 s->securityAuthProtoLen = USM_AUTH_PROTO_MD5_LEN;
1270         } else if (!strcasecmp(prot, "SHA")) {
1271                 s->securityAuthProto = usmHMACSHA1AuthProtocol;
1272                 s->securityAuthProtoLen = USM_AUTH_PROTO_SHA_LEN;
1273         } else {
1274                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "Unknown authentication protocol '%s'", prot);
1275                 return (-1);
1276         }
1277         return (0);
1278 }
1279 /* }}} */
1280 
1281 /* {{{ int netsnmp_session_set_sec_protocol(struct snmp_session *s, char *prot)
1282    Set the security protocol in the snmpv3 session */
1283 static int netsnmp_session_set_sec_protocol(struct snmp_session *s, char *prot TSRMLS_DC)
1284 {
1285         if (!strcasecmp(prot, "DES")) {
1286                 s->securityPrivProto = usmDESPrivProtocol;
1287                 s->securityPrivProtoLen = USM_PRIV_PROTO_DES_LEN;
1288 #ifdef HAVE_AES
1289         } else if (!strcasecmp(prot, "AES128") || !strcasecmp(prot, "AES")) {
1290                 s->securityPrivProto = usmAESPrivProtocol;
1291                 s->securityPrivProtoLen = USM_PRIV_PROTO_AES_LEN;
1292 #endif
1293         } else {
1294                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "Unknown security protocol '%s'", prot);
1295                 return (-1);
1296         }
1297         return (0);
1298 }
1299 /* }}} */
1300 
1301 /* {{{ int netsnmp_session_gen_auth_key(struct snmp_session *s, char *pass)
1302    Make key from pass phrase in the snmpv3 session */
1303 static int netsnmp_session_gen_auth_key(struct snmp_session *s, char *pass TSRMLS_DC)
1304 {
1305         int snmp_errno;
1306         s->securityAuthKeyLen = USM_AUTH_KU_LEN;
1307         if ((snmp_errno = generate_Ku(s->securityAuthProto, s->securityAuthProtoLen,
1308                         (u_char *) pass, strlen(pass),
1309                         s->securityAuthKey, &(s->securityAuthKeyLen)))) {
1310                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "Error generating a key for authentication pass phrase '%s': %s", pass, snmp_api_errstring(snmp_errno));
1311                 return (-1);
1312         }
1313         return (0);
1314 }
1315 /* }}} */
1316 
1317 /* {{{ int netsnmp_session_gen_sec_key(struct snmp_session *s, u_char *pass)
1318    Make key from pass phrase in the snmpv3 session */
1319 static int netsnmp_session_gen_sec_key(struct snmp_session *s, char *pass TSRMLS_DC)
1320 {
1321         int snmp_errno;
1322 
1323         s->securityPrivKeyLen = USM_PRIV_KU_LEN;
1324         if ((snmp_errno = generate_Ku(s->securityAuthProto, s->securityAuthProtoLen,
1325                         (u_char *)pass, strlen(pass),
1326                         s->securityPrivKey, &(s->securityPrivKeyLen)))) {
1327                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "Error generating a key for privacy pass phrase '%s': %s", pass, snmp_api_errstring(snmp_errno));
1328                 return (-2);
1329         }
1330         return (0);
1331 }
1332 /* }}} */
1333 
1334 /* {{{ in netsnmp_session_set_contextEngineID(struct snmp_session *s, u_char * contextEngineID)
1335    Set context Engine Id in the snmpv3 session */
1336 static int netsnmp_session_set_contextEngineID(struct snmp_session *s, char * contextEngineID TSRMLS_DC)
1337 {
1338         size_t  ebuf_len = 32, eout_len = 0;
1339         u_char  *ebuf = (u_char *) emalloc(ebuf_len);
1340 
1341         if (ebuf == NULL) {
1342                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "malloc failure setting contextEngineID");
1343                 return (-1);
1344         }
1345         if (!snmp_hex_to_binary(&ebuf, &ebuf_len, &eout_len, 1, contextEngineID)) {
1346                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "Bad engine ID value '%s'", contextEngineID);
1347                 efree(ebuf);
1348                 return (-1);
1349         }
1350 
1351         if (s->contextEngineID) {
1352                 efree(s->contextEngineID);
1353         }
1354 
1355         s->contextEngineID = ebuf;
1356         s->contextEngineIDLen = eout_len;
1357         return (0);
1358 }
1359 /* }}} */
1360 
1361 /* {{{ php_set_security(struct snmp_session *session, char *sec_level, char *auth_protocol, char *auth_passphrase, char *priv_protocol, char *priv_passphrase, char *contextName, char *contextEngineID)
1362    Set all snmpv3-related security options */
1363 static int netsnmp_session_set_security(struct snmp_session *session, char *sec_level, char *auth_protocol, char *auth_passphrase, char *priv_protocol, char *priv_passphrase, char *contextName, char *contextEngineID TSRMLS_DC)
1364 {
1365 
1366         /* Setting the security level. */
1367         if (netsnmp_session_set_sec_level(session, sec_level)) {
1368                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "Invalid security level '%s'", sec_level);
1369                 return (-1);
1370         }
1371 
1372         if (session->securityLevel == SNMP_SEC_LEVEL_AUTHNOPRIV || session->securityLevel == SNMP_SEC_LEVEL_AUTHPRIV) {
1373 
1374                 /* Setting the authentication protocol. */
1375                 if (netsnmp_session_set_auth_protocol(session, auth_protocol TSRMLS_CC)) {
1376                         /* Warning message sent already, just bail out */
1377                         return (-1);
1378                 }
1379 
1380                 /* Setting the authentication passphrase. */
1381                 if (netsnmp_session_gen_auth_key(session, auth_passphrase TSRMLS_CC)) {
1382                         /* Warning message sent already, just bail out */
1383                         return (-1);
1384                 }
1385 
1386                 if (session->securityLevel == SNMP_SEC_LEVEL_AUTHPRIV) {
1387                         /* Setting the security protocol. */
1388                         if (netsnmp_session_set_sec_protocol(session, priv_protocol TSRMLS_CC)) {
1389                                 /* Warning message sent already, just bail out */
1390                                 return (-1);
1391                         }
1392 
1393                         /* Setting the security protocol passphrase. */
1394                         if (netsnmp_session_gen_sec_key(session, priv_passphrase TSRMLS_CC)) {
1395                                 /* Warning message sent already, just bail out */
1396                                 return (-1);
1397                         }
1398                 }
1399         }
1400 
1401         /* Setting contextName if specified */
1402         if (contextName) {
1403                 session->contextName = contextName;
1404                 session->contextNameLen = strlen(contextName);
1405         }
1406 
1407         /* Setting contextEngineIS if specified */
1408         if (contextEngineID && strlen(contextEngineID) && netsnmp_session_set_contextEngineID(session, contextEngineID TSRMLS_CC)) {
1409                 /* Warning message sent already, just bail out */
1410                 return (-1);
1411         }
1412 
1413         return (0);
1414 }
1415 /* }}} */
1416 
1417 /* {{{ php_snmp
1418 *
1419 * Generic SNMP handler for all versions.
1420 * This function makes use of the internal SNMP object fetcher.
1421 * Used both in old (non-OO) and OO API
1422 *
1423 */
1424 static void php_snmp(INTERNAL_FUNCTION_PARAMETERS, int st, int version)
1425 {
1426         zval **oid, **value, **type;
1427         char *a1, *a2, *a3, *a4, *a5, *a6, *a7;
1428         int a1_len, a2_len, a3_len, a4_len, a5_len, a6_len, a7_len;
1429         zend_bool use_orignames = 0, suffix_keys = 0;
1430         long timeout = SNMP_DEFAULT_TIMEOUT;
1431         long retries = SNMP_DEFAULT_RETRIES;
1432         int argc = ZEND_NUM_ARGS();
1433         struct objid_query objid_query;
1434         php_snmp_session *session;
1435         int session_less_mode = (getThis() == NULL);
1436         php_snmp_object *snmp_object;
1437         php_snmp_object glob_snmp_object;
1438         
1439         objid_query.max_repetitions = -1;
1440         objid_query.non_repeaters = 0;
1441         objid_query.valueretrieval = SNMP_G(valueretrieval);
1442         objid_query.oid_increasing_check = TRUE;
1443 
1444         if (session_less_mode) {
1445                 if (version == SNMP_VERSION_3) {
1446                         if (st & SNMP_CMD_SET) {
1447                                 if (zend_parse_parameters(argc TSRMLS_CC, "sssssssZZZ|ll", &a1, &a1_len, &a2, &a2_len, &a3, &a3_len,
1448                                         &a4, &a4_len, &a5, &a5_len, &a6, &a6_len, &a7, &a7_len, &oid, &type, &value, &timeout, &retries) == FAILURE) {
1449                                         RETURN_FALSE;
1450                                 }
1451                         } else {
1452                                 /* SNMP_CMD_GET
1453                                  * SNMP_CMD_GETNEXT
1454                                  * SNMP_CMD_WALK
1455                                  */
1456                                 if (zend_parse_parameters(argc TSRMLS_CC, "sssssssZ|ll", &a1, &a1_len, &a2, &a2_len, &a3, &a3_len,
1457                                         &a4, &a4_len, &a5, &a5_len, &a6, &a6_len, &a7, &a7_len, &oid, &timeout, &retries) == FAILURE) {
1458                                         RETURN_FALSE;
1459                                 }
1460                         }
1461                 } else {
1462                         if (st & SNMP_CMD_SET) {
1463                                 if (zend_parse_parameters(argc TSRMLS_CC, "ssZZZ|ll", &a1, &a1_len, &a2, &a2_len, &oid, &type, &value, &timeout, &retries) == FAILURE) {
1464                                         RETURN_FALSE;
1465                                 }
1466                         } else {
1467                                 /* SNMP_CMD_GET
1468                                  * SNMP_CMD_GETNEXT
1469                                  * SNMP_CMD_WALK
1470                                  */
1471                                 if (zend_parse_parameters(argc TSRMLS_CC, "ssZ|ll", &a1, &a1_len, &a2, &a2_len, &oid, &timeout, &retries) == FAILURE) {
1472                                         RETURN_FALSE;
1473                                 }
1474                         }
1475                 }
1476         } else {
1477                 if (st & SNMP_CMD_SET) {
1478                         if (zend_parse_parameters(argc TSRMLS_CC, "ZZZ", &oid, &type, &value) == FAILURE) {
1479                                 RETURN_FALSE;
1480                         }
1481                 } else if (st & SNMP_CMD_WALK) {
1482                         if (zend_parse_parameters(argc TSRMLS_CC, "Z|bll", &oid, &suffix_keys, &(objid_query.max_repetitions), &(objid_query.non_repeaters)) == FAILURE) {
1483                                 RETURN_FALSE;
1484                         }
1485                         if (suffix_keys) {
1486                                 st |= SNMP_USE_SUFFIX_AS_KEYS;
1487                         }
1488                 } else if (st & SNMP_CMD_GET) {
1489                         if (zend_parse_parameters(argc TSRMLS_CC, "Z|b", &oid, &use_orignames) == FAILURE) {
1490                                 RETURN_FALSE;
1491                         }
1492                         if (use_orignames) {
1493                                 st |= SNMP_ORIGINAL_NAMES_AS_KEYS;
1494                         }
1495                 } else {
1496                         /* SNMP_CMD_GETNEXT
1497                          */
1498                         if (zend_parse_parameters(argc TSRMLS_CC, "Z", &oid) == FAILURE) {
1499                                 RETURN_FALSE;
1500                         }
1501                 }
1502         }
1503 
1504         if (!php_snmp_parse_oid(getThis(), st, &objid_query, oid, type, value TSRMLS_CC)) {
1505                 RETURN_FALSE;
1506         }
1507 
1508         if (session_less_mode) {
1509                 if (netsnmp_session_init(&session, version, a1, a2, timeout, retries TSRMLS_CC)) {
1510                         efree(objid_query.vars);
1511                         netsnmp_session_free(&session);
1512                         RETURN_FALSE;
1513                 }
1514                 if (version == SNMP_VERSION_3 && netsnmp_session_set_security(session, a3, a4, a5, a6, a7, NULL, NULL TSRMLS_CC)) {
1515                         efree(objid_query.vars);
1516                         netsnmp_session_free(&session);
1517                         /* Warning message sent already, just bail out */
1518                         RETURN_FALSE;
1519                 }
1520         } else {
1521                 zval *object = getThis();
1522                 snmp_object = (php_snmp_object *)zend_object_store_get_object(object TSRMLS_CC);
1523                 session = snmp_object->session;
1524                 if (!session) {
1525                         php_error_docref(NULL TSRMLS_CC, E_WARNING, "Invalid or uninitialized SNMP object");
1526                         efree(objid_query.vars);
1527                         RETURN_FALSE;
1528                 }
1529 
1530                 if (snmp_object->max_oids > 0) {
1531                         objid_query.step = snmp_object->max_oids;
1532                         if (objid_query.max_repetitions < 0) { /* unspecified in function call, use session-wise */
1533                                 objid_query.max_repetitions = snmp_object->max_oids;
1534                         }
1535                 }
1536                 objid_query.oid_increasing_check = snmp_object->oid_increasing_check;
1537                 objid_query.valueretrieval = snmp_object->valueretrieval;
1538                 glob_snmp_object.enum_print = netsnmp_ds_get_boolean(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_PRINT_NUMERIC_ENUM);
1539                 netsnmp_ds_set_boolean(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_PRINT_NUMERIC_ENUM, snmp_object->enum_print);
1540                 glob_snmp_object.quick_print = netsnmp_ds_get_boolean(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_QUICK_PRINT);
1541                 netsnmp_ds_set_boolean(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_QUICK_PRINT, snmp_object->quick_print);
1542                 glob_snmp_object.oid_output_format = netsnmp_ds_get_int(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_OID_OUTPUT_FORMAT);
1543                 netsnmp_ds_set_int(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_OID_OUTPUT_FORMAT, snmp_object->oid_output_format);
1544         }
1545 
1546         if (objid_query.max_repetitions < 0) {
1547                 objid_query.max_repetitions = 20; /* provide correct default value */
1548         }
1549 
1550         php_snmp_internal(INTERNAL_FUNCTION_PARAM_PASSTHRU, st, session, &objid_query);
1551         
1552         efree(objid_query.vars);
1553 
1554         if (session_less_mode) {
1555                 netsnmp_session_free(&session);
1556         } else {
1557                 netsnmp_ds_set_boolean(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_PRINT_NUMERIC_ENUM, glob_snmp_object.enum_print);
1558                 netsnmp_ds_set_boolean(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_QUICK_PRINT, glob_snmp_object.quick_print);
1559                 netsnmp_ds_set_int(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_OID_OUTPUT_FORMAT, glob_snmp_object.oid_output_format);
1560         }
1561 }
1562 /* }}} */
1563 
1564 /* {{{ proto mixed snmpget(string host, string community, mixed object_id [, int timeout [, int retries]]) 
1565    Fetch a SNMP object */
1566 PHP_FUNCTION(snmpget)
1567 {
1568         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, SNMP_CMD_GET, SNMP_VERSION_1);
1569 }
1570 /* }}} */
1571 
1572 /* {{{ proto mixed snmpgetnext(string host, string community, mixed object_id [, int timeout [, int retries]]) 
1573    Fetch a SNMP object */
1574 PHP_FUNCTION(snmpgetnext)
1575 {
1576         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, SNMP_CMD_GETNEXT, SNMP_VERSION_1);
1577 }
1578 /* }}} */
1579 
1580 /* {{{ proto mixed snmpwalk(string host, string community, mixed object_id [, int timeout [, int retries]]) 
1581    Return all objects under the specified object id */
1582 PHP_FUNCTION(snmpwalk)
1583 {
1584         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, (SNMP_CMD_WALK | SNMP_NUMERIC_KEYS), SNMP_VERSION_1);
1585 }
1586 /* }}} */
1587 
1588 /* {{{ proto mixed snmprealwalk(string host, string community, mixed object_id [, int timeout [, int retries]])
1589    Return all objects including their respective object id within the specified one */
1590 PHP_FUNCTION(snmprealwalk)
1591 {
1592         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, SNMP_CMD_WALK, SNMP_VERSION_1);
1593 }
1594 /* }}} */
1595 
1596 /* {{{ proto bool snmpset(string host, string community, mixed object_id, mixed type, mixed value [, int timeout [, int retries]]) 
1597    Set the value of a SNMP object */
1598 PHP_FUNCTION(snmpset)
1599 {
1600         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, SNMP_CMD_SET, SNMP_VERSION_1);
1601 }
1602 /* }}} */
1603 
1604 /* {{{ proto bool snmp_get_quick_print(void)
1605    Return the current status of quick_print */
1606 PHP_FUNCTION(snmp_get_quick_print)
1607 {
1608         if (zend_parse_parameters_none() == FAILURE) {
1609                 return;
1610         }
1611 
1612         RETURN_BOOL(netsnmp_ds_get_boolean(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_QUICK_PRINT));
1613 }
1614 /* }}} */
1615 
1616 /* {{{ proto bool snmp_set_quick_print(int quick_print)
1617    Return all objects including their respective object id within the specified one */
1618 PHP_FUNCTION(snmp_set_quick_print)
1619 {
1620         long a1;
1621 
1622         if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &a1) == FAILURE) {
1623                 RETURN_FALSE;
1624         }
1625 
1626         netsnmp_ds_set_boolean(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_QUICK_PRINT, (int)a1);
1627         RETURN_TRUE;
1628 }
1629 /* }}} */
1630 
1631 /* {{{ proto bool snmp_set_enum_print(int enum_print)
1632    Return all values that are enums with their enum value instead of the raw integer */
1633 PHP_FUNCTION(snmp_set_enum_print)
1634 {
1635         long a1;
1636 
1637         if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &a1) == FAILURE) {
1638                 RETURN_FALSE;
1639         }
1640 
1641         netsnmp_ds_set_boolean(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_PRINT_NUMERIC_ENUM, (int) a1);
1642         RETURN_TRUE;
1643 } 
1644 /* }}} */
1645 
1646 /* {{{ proto bool snmp_set_oid_output_format(int oid_format)
1647    Set the OID output format. */
1648 PHP_FUNCTION(snmp_set_oid_output_format)
1649 {
1650         long a1;
1651 
1652         if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &a1) == FAILURE) {
1653                 RETURN_FALSE;
1654         }
1655 
1656         switch((int) a1) {
1657                 case NETSNMP_OID_OUTPUT_SUFFIX:
1658                 case NETSNMP_OID_OUTPUT_MODULE:
1659                 case NETSNMP_OID_OUTPUT_FULL:
1660                 case NETSNMP_OID_OUTPUT_NUMERIC:
1661                 case NETSNMP_OID_OUTPUT_UCD:
1662                 case NETSNMP_OID_OUTPUT_NONE:
1663                         netsnmp_ds_set_int(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_OID_OUTPUT_FORMAT, a1);
1664                         RETURN_TRUE;
1665                         break;
1666                 default:
1667                         php_error_docref(NULL TSRMLS_CC, E_WARNING, "Unknown SNMP output print format '%d'", (int) a1);
1668                         RETURN_FALSE;
1669                         break;
1670         }
1671 } 
1672 /* }}} */
1673 
1674 /* {{{ proto mixed snmp2_get(string host, string community, mixed object_id [, int timeout [, int retries]]) 
1675    Fetch a SNMP object */
1676 PHP_FUNCTION(snmp2_get)
1677 {
1678         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, SNMP_CMD_GET, SNMP_VERSION_2c);
1679 }
1680 /* }}} */
1681 
1682 /* {{{ proto mixed snmp2_getnext(string host, string community, mixed object_id [, int timeout [, int retries]]) 
1683    Fetch a SNMP object */
1684 PHP_FUNCTION(snmp2_getnext)
1685 {
1686         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, SNMP_CMD_GETNEXT, SNMP_VERSION_2c);
1687 }
1688 /* }}} */
1689 
1690 /* {{{ proto mixed snmp2_walk(string host, string community, mixed object_id [, int timeout [, int retries]]) 
1691    Return all objects under the specified object id */
1692 PHP_FUNCTION(snmp2_walk)
1693 {
1694         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, (SNMP_CMD_WALK | SNMP_NUMERIC_KEYS), SNMP_VERSION_2c);
1695 }
1696 /* }}} */
1697 
1698 /* {{{ proto mixed snmp2_real_walk(string host, string community, mixed object_id [, int timeout [, int retries]])
1699    Return all objects including their respective object id within the specified one */
1700 PHP_FUNCTION(snmp2_real_walk)
1701 {
1702         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, SNMP_CMD_WALK, SNMP_VERSION_2c);
1703 }
1704 /* }}} */
1705 
1706 /* {{{ proto bool snmp2_set(string host, string community, mixed object_id, mixed type, mixed value [, int timeout [, int retries]]) 
1707    Set the value of a SNMP object */
1708 PHP_FUNCTION(snmp2_set)
1709 {
1710         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, SNMP_CMD_SET, SNMP_VERSION_2c);
1711 }
1712 /* }}} */
1713 
1714 /* {{{ proto mixed snmp3_get(string host, string sec_name, string sec_level, string auth_protocol, string auth_passphrase, string priv_protocol, string priv_passphrase, mixed object_id [, int timeout [, int retries]])
1715    Fetch the value of a SNMP object */
1716 PHP_FUNCTION(snmp3_get)
1717 {
1718         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, SNMP_CMD_GET, SNMP_VERSION_3);
1719 }
1720 /* }}} */
1721 
1722 /* {{{ proto mixed snmp3_getnext(string host, string sec_name, string sec_level, string auth_protocol, string auth_passphrase, string priv_protocol, string priv_passphrase, mixed object_id [, int timeout [, int retries]])
1723    Fetch the value of a SNMP object */
1724 PHP_FUNCTION(snmp3_getnext)
1725 {
1726         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, SNMP_CMD_GETNEXT, SNMP_VERSION_3);
1727 }
1728 /* }}} */
1729 
1730 /* {{{ proto mixed snmp3_walk(string host, string sec_name, string sec_level, string auth_protocol, string auth_passphrase, string priv_protocol, string priv_passphrase, mixed object_id [, int timeout [, int retries]])
1731    Fetch the value of a SNMP object */
1732 PHP_FUNCTION(snmp3_walk)
1733 {
1734         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, (SNMP_CMD_WALK | SNMP_NUMERIC_KEYS), SNMP_VERSION_3);
1735 }
1736 /* }}} */
1737 
1738 /* {{{ proto mixed snmp3_real_walk(string host, string sec_name, string sec_level, string auth_protocol, string auth_passphrase, string priv_protocol, string priv_passphrase, mixed object_id [, int timeout [, int retries]])
1739    Fetch the value of a SNMP object */
1740 PHP_FUNCTION(snmp3_real_walk)
1741 {
1742         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, SNMP_CMD_WALK, SNMP_VERSION_3);
1743 }
1744 /* }}} */
1745 
1746 /* {{{ proto bool snmp3_set(string host, string sec_name, string sec_level, string auth_protocol, string auth_passphrase, string priv_protocol, string priv_passphrase, mixed object_id, mixed type, mixed value [, int timeout [, int retries]])
1747    Fetch the value of a SNMP object */
1748 PHP_FUNCTION(snmp3_set)
1749 {
1750         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, SNMP_CMD_SET, SNMP_VERSION_3);
1751 }
1752 /* }}} */
1753 
1754 /* {{{ proto bool snmp_set_valueretrieval(int method)
1755    Specify the method how the SNMP values will be returned */
1756 PHP_FUNCTION(snmp_set_valueretrieval)
1757 {
1758         long method;
1759 
1760         if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &method) == FAILURE) {
1761                 RETURN_FALSE;
1762         }
1763 
1764         if (method >= 0 && method <= (SNMP_VALUE_LIBRARY|SNMP_VALUE_PLAIN|SNMP_VALUE_OBJECT)) {
1765                         SNMP_G(valueretrieval) = method;
1766                         RETURN_TRUE;
1767         } else {
1768                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "Unknown SNMP value retrieval method '%ld'", method);
1769                 RETURN_FALSE;
1770         }
1771 }
1772 /* }}} */
1773 
1774 /* {{{ proto int snmp_get_valueretrieval()
1775    Return the method how the SNMP values will be returned */
1776 PHP_FUNCTION(snmp_get_valueretrieval)
1777 {
1778         if (zend_parse_parameters_none() == FAILURE) {
1779                 RETURN_FALSE;
1780         }
1781 
1782         RETURN_LONG(SNMP_G(valueretrieval));
1783 }
1784 /* }}} */
1785 
1786 /* {{{ proto bool snmp_read_mib(string filename)
1787    Reads and parses a MIB file into the active MIB tree. */
1788 PHP_FUNCTION(snmp_read_mib)
1789 {
1790         char *filename;
1791         int filename_len;
1792 
1793         if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "p", &filename, &filename_len) == FAILURE) {
1794                 RETURN_FALSE;
1795         }
1796 
1797         if (!read_mib(filename)) {
1798                 char *error = strerror(errno);
1799                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "Error while reading MIB file '%s': %s", filename, error);
1800                 RETURN_FALSE;
1801         }
1802         RETURN_TRUE;
1803 }
1804 /* }}} */
1805 
1806 /* {{{ proto SNMP SNMP::__construct(int version, string hostname, string community|securityName [, long timeout [, long retries]])
1807         Creates a new SNMP session to specified host. */
1808 PHP_METHOD(snmp, __construct)
1809 {
1810         php_snmp_object *snmp_object;
1811         zval *object = getThis();
1812         char *a1, *a2;
1813         int a1_len, a2_len;
1814         long timeout = SNMP_DEFAULT_TIMEOUT;
1815         long retries = SNMP_DEFAULT_RETRIES;
1816         long version = SNMP_DEFAULT_VERSION;
1817         int argc = ZEND_NUM_ARGS();
1818         zend_error_handling error_handling;
1819 
1820         snmp_object = (php_snmp_object *)zend_object_store_get_object(object TSRMLS_CC);
1821         zend_replace_error_handling(EH_THROW, NULL, &error_handling TSRMLS_CC);
1822         
1823         if (zend_parse_parameters(argc TSRMLS_CC, "lss|ll", &version, &a1, &a1_len, &a2, &a2_len, &timeout, &retries) == FAILURE) {
1824                 zend_restore_error_handling(&error_handling TSRMLS_CC);
1825                 return;
1826         }
1827 
1828         zend_restore_error_handling(&error_handling TSRMLS_CC);
1829 
1830         switch(version) {
1831                 case SNMP_VERSION_1:
1832                 case SNMP_VERSION_2c:
1833                 case SNMP_VERSION_3:
1834                         break;
1835                 default:
1836                         zend_throw_exception(zend_exception_get_default(TSRMLS_C), "Unknown SNMP protocol version", 0 TSRMLS_CC);
1837                         return;
1838         }
1839 
1840         /* handle re-open of snmp session */
1841         if (snmp_object->session) {
1842                 netsnmp_session_free(&(snmp_object->session));
1843         }
1844         
1845         if (netsnmp_session_init(&(snmp_object->session), version, a1, a2, timeout, retries TSRMLS_CC)) {
1846                 return;
1847         }
1848         snmp_object->max_oids = 0;
1849         snmp_object->valueretrieval = SNMP_G(valueretrieval);
1850         snmp_object->enum_print = netsnmp_ds_get_boolean(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_PRINT_NUMERIC_ENUM);
1851         snmp_object->oid_output_format = netsnmp_ds_get_int(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_OID_OUTPUT_FORMAT);
1852         snmp_object->quick_print = netsnmp_ds_get_boolean(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_QUICK_PRINT);
1853         snmp_object->oid_increasing_check = TRUE;
1854         snmp_object->exceptions_enabled = 0;
1855 }
1856 /* }}} */
1857 
1858 /* {{{ proto bool SNMP::close() 
1859         Close SNMP session */
1860 PHP_METHOD(snmp, close)
1861 {
1862         php_snmp_object *snmp_object;
1863         zval *object = getThis();
1864 
1865         snmp_object = (php_snmp_object *)zend_object_store_get_object(object TSRMLS_CC);
1866 
1867         if (zend_parse_parameters_none() == FAILURE) {
1868                 RETURN_FALSE;
1869         }
1870 
1871         netsnmp_session_free(&(snmp_object->session));
1872 
1873         RETURN_TRUE;
1874 }
1875 /* }}} */
1876 
1877 /* {{{ proto mixed SNMP::get(mixed object_id [, bool preserve_keys])
1878    Fetch a SNMP object returning scalar for single OID and array of oid->value pairs for multi OID request */
1879 PHP_METHOD(snmp, get)
1880 {
1881         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, SNMP_CMD_GET, (-1));
1882 }
1883 /* }}} */
1884 
1885 /* {{{ proto mixed SNMP::getnext(mixed object_id)
1886    Fetch a SNMP object returning scalar for single OID and array of oid->value pairs for multi OID request */
1887 PHP_METHOD(snmp, getnext)
1888 {
1889         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, SNMP_CMD_GETNEXT, (-1));
1890 }
1891 /* }}} */
1892 
1893 /* {{{ proto mixed SNMP::walk(mixed object_id [, bool $suffix_as_key = FALSE [, int $max_repetitions [, int $non_repeaters]])
1894    Return all objects including their respective object id within the specified one as array of oid->value pairs */
1895 PHP_METHOD(snmp, walk)
1896 {
1897         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, SNMP_CMD_WALK, (-1));
1898 }
1899 /* }}} */
1900 
1901 /* {{{ proto bool SNMP::set(mixed object_id, mixed type, mixed value) 
1902    Set the value of a SNMP object */
1903 PHP_METHOD(snmp, set)
1904 {
1905         php_snmp(INTERNAL_FUNCTION_PARAM_PASSTHRU, SNMP_CMD_SET, (-1));
1906 }
1907 
1908 /* {{{ proto bool SNMP::setSecurity(string sec_level, [ string auth_protocol, string auth_passphrase [, string priv_protocol, string priv_passphrase [, string contextName [, string contextEngineID]]]])
1909         Set SNMPv3 security-related session parameters */
1910 PHP_METHOD(snmp, setSecurity)
1911 {
1912         php_snmp_object *snmp_object;
1913         zval *object = getThis();
1914         char *a1 = "", *a2 = "", *a3 = "", *a4 = "", *a5 = "", *a6 = "", *a7 = "";
1915         int a1_len = 0, a2_len = 0, a3_len = 0, a4_len = 0, a5_len = 0, a6_len = 0, a7_len = 0;
1916         int argc = ZEND_NUM_ARGS();
1917 
1918         snmp_object = (php_snmp_object *)zend_object_store_get_object(object TSRMLS_CC);
1919         
1920         if (zend_parse_parameters(argc TSRMLS_CC, "s|ssssss", &a1, &a1_len, &a2, &a2_len, &a3, &a3_len,
1921                 &a4, &a4_len, &a5, &a5_len, &a6, &a6_len, &a7, &a7_len) == FAILURE) {
1922                 RETURN_FALSE;
1923         }
1924 
1925         if (netsnmp_session_set_security(snmp_object->session, a1, a2, a3, a4, a5, a6, a7 TSRMLS_CC)) {
1926                 /* Warning message sent already, just bail out */
1927                 RETURN_FALSE;
1928         }
1929         RETURN_TRUE;
1930 }
1931 /* }}} */
1932 
1933 /* {{{ proto long SNMP::getErrno() 
1934         Get last error code number */
1935 PHP_METHOD(snmp, getErrno)
1936 {
1937         php_snmp_object *snmp_object;
1938         zval *object = getThis();
1939 
1940         snmp_object = (php_snmp_object *)zend_object_store_get_object(object TSRMLS_CC);
1941 
1942         RETVAL_LONG(snmp_object->snmp_errno);
1943         return;
1944 }
1945 /* }}} */
1946 
1947 /* {{{ proto long SNMP::getError() 
1948         Get last error message */
1949 PHP_METHOD(snmp, getError)
1950 {
1951         php_snmp_object *snmp_object;
1952         zval *object = getThis();
1953 
1954         snmp_object = (php_snmp_object *)zend_object_store_get_object(object TSRMLS_CC);
1955 
1956         RETVAL_STRING(snmp_object->snmp_errstr, 1);
1957         return;
1958 }
1959 /* }}} */
1960 
1961 /* {{{ */
1962 void php_snmp_add_property(HashTable *h, const char *name, size_t name_length, php_snmp_read_t read_func, php_snmp_write_t write_func TSRMLS_DC)
1963 {
1964         php_snmp_prop_handler p;
1965 
1966         p.name = (char*) name;
1967         p.name_length = name_length;
1968         p.read_func = (read_func) ? read_func : NULL;
1969         p.write_func = (write_func) ? write_func : NULL;
1970         zend_hash_add(h, (char *)name, name_length + 1, &p, sizeof(php_snmp_prop_handler), NULL);
1971 }
1972 /* }}} */
1973 
1974 /* {{{ php_snmp_read_property(zval *object, zval *member, int type[, const zend_literal *key])
1975    Generic object property reader */
1976 zval *php_snmp_read_property(zval *object, zval *member, int type, const zend_literal *key TSRMLS_DC)
1977 {
1978         zval tmp_member;
1979         zval *retval;
1980         php_snmp_object *obj;
1981         php_snmp_prop_handler *hnd;
1982         int ret;
1983 
1984         ret = FAILURE;
1985         obj = (php_snmp_object *)zend_objects_get_address(object TSRMLS_CC);
1986 
1987         if (Z_TYPE_P(member) != IS_STRING) {
1988                 tmp_member = *member;
1989                 zval_copy_ctor(&tmp_member);
1990                 convert_to_string(&tmp_member);
1991                 member = &tmp_member;
1992         }
1993 
1994         ret = zend_hash_find(&php_snmp_properties, Z_STRVAL_P(member), Z_STRLEN_P(member)+1, (void **) &hnd);
1995 
1996         if (ret == SUCCESS && hnd->read_func) {
1997                 ret = hnd->read_func(obj, &retval TSRMLS_CC);
1998                 if (ret == SUCCESS) {
1999                         /* ensure we're creating a temporary variable */
2000                         Z_SET_REFCOUNT_P(retval, 0);
2001                 } else {
2002                         retval = EG(uninitialized_zval_ptr);
2003                 }
2004         } else {
2005                 zend_object_handlers * std_hnd = zend_get_std_object_handlers();
2006                 retval = std_hnd->read_property(object, member, type, key TSRMLS_CC);
2007         }
2008 
2009         if (member == &tmp_member) {
2010                 zval_dtor(member);
2011         }
2012         return(retval);
2013 }
2014 /* }}} */
2015 
2016 /* {{{ php_snmp_write_property(zval *object, zval *member, zval *value[, const zend_literal *key])
2017    Generic object property writer */
2018 void php_snmp_write_property(zval *object, zval *member, zval *value, const zend_literal *key TSRMLS_DC)
2019 {
2020         zval tmp_member;
2021         php_snmp_object *obj;
2022         php_snmp_prop_handler *hnd;
2023         int ret;
2024 
2025         if (Z_TYPE_P(member) != IS_STRING) {
2026                 tmp_member = *member;
2027                 zval_copy_ctor(&tmp_member);
2028                 convert_to_string(&tmp_member);
2029                 member = &tmp_member;
2030         }
2031 
2032         ret = FAILURE;
2033         obj = (php_snmp_object *)zend_objects_get_address(object TSRMLS_CC);
2034 
2035         ret = zend_hash_find(&php_snmp_properties, Z_STRVAL_P(member), Z_STRLEN_P(member) + 1, (void **) &hnd);
2036 
2037         if (ret == SUCCESS && hnd->write_func) {
2038                 hnd->write_func(obj, value TSRMLS_CC);
2039                 if (! PZVAL_IS_REF(value) && Z_REFCOUNT_P(value) == 0) {
2040                         Z_ADDREF_P(value);
2041                         zval_ptr_dtor(&value);
2042                 }
2043         } else {
2044                 zend_object_handlers * std_hnd = zend_get_std_object_handlers();
2045                 std_hnd->write_property(object, member, value, key TSRMLS_CC);
2046         }
2047 
2048         if (member == &tmp_member) {
2049                 zval_dtor(member);
2050         }
2051 }
2052 /* }}} */
2053 
2054 /* {{{ php_snmp_has_property(zval *object, zval *member, int has_set_exists[, const zend_literal *key])
2055    Generic object property checker */
2056 static int php_snmp_has_property(zval *object, zval *member, int has_set_exists, const zend_literal *key TSRMLS_DC)
2057 {
2058         php_snmp_prop_handler *hnd;
2059         int ret = 0;
2060 
2061         if (zend_hash_find(&php_snmp_properties, Z_STRVAL_P(member), Z_STRLEN_P(member) + 1, (void **)&hnd) == SUCCESS) {
2062                 switch (has_set_exists) {
2063                         case 2:
2064                                 ret = 1;
2065                                 break;
2066                         case 0: {
2067                                 zval *value = php_snmp_read_property(object, member, BP_VAR_IS, key TSRMLS_CC);
2068                                 if (value != EG(uninitialized_zval_ptr)) {
2069                                         ret = Z_TYPE_P(value) != IS_NULL? 1:0;
2070                                         /* refcount is 0 */
2071                                         Z_ADDREF_P(value);
2072                                         zval_ptr_dtor(&value);
2073                                 }
2074                                 break;
2075                         }
2076                         default: {
2077                                 zval *value = php_snmp_read_property(object, member, BP_VAR_IS, key TSRMLS_CC);
2078                                 if (value != EG(uninitialized_zval_ptr)) {
2079                                         convert_to_boolean(value);
2080                                         ret = Z_BVAL_P(value)? 1:0;
2081                                         /* refcount is 0 */
2082                                         Z_ADDREF_P(value);
2083                                         zval_ptr_dtor(&value);
2084                                 }
2085                                 break;
2086                         }
2087                 }
2088         } else {
2089                 zend_object_handlers * std_hnd = zend_get_std_object_handlers();
2090                 ret = std_hnd->has_property(object, member, has_set_exists, key TSRMLS_CC);
2091         }
2092         return ret;
2093 }
2094 /* }}} */
2095 
2096 /* {{{ php_snmp_get_properties(zval *object)
2097    Returns all object properties. Injects SNMP properties into object on first call */
2098 static HashTable *php_snmp_get_properties(zval *object TSRMLS_DC)
2099 {
2100         php_snmp_object *obj;
2101         php_snmp_prop_handler *hnd;
2102         HashTable *props;
2103         zval *val;
2104         char *key;
2105         uint key_len;
2106         HashPosition pos;
2107         ulong num_key;
2108 
2109         obj = (php_snmp_object *)zend_objects_get_address(object TSRMLS_CC);
2110         props = zend_std_get_properties(object TSRMLS_CC);
2111 
2112         zend_hash_internal_pointer_reset_ex(&php_snmp_properties, &pos);
2113 
2114         while (zend_hash_get_current_data_ex(&php_snmp_properties, (void**)&hnd, &pos) == SUCCESS) {
2115                 zend_hash_get_current_key_ex(&php_snmp_properties, &key, &key_len, &num_key, 0, &pos);
2116                 if (!hnd->read_func || hnd->read_func(obj, &val TSRMLS_CC) != SUCCESS) {
2117                         val = EG(uninitialized_zval_ptr);
2118                         Z_ADDREF_P(val);
2119                 }
2120                 zend_hash_update(props, key, key_len, (void *)&val, sizeof(zval *), NULL);
2121                 zend_hash_move_forward_ex(&php_snmp_properties, &pos);
2122         }
2123         return obj->zo.properties;
2124 }
2125 /* }}} */
2126 
2127 /* {{{ */
2128 static int php_snmp_read_info(php_snmp_object *snmp_object, zval **retval TSRMLS_DC)
2129 {
2130         zval *val;
2131 
2132         MAKE_STD_ZVAL(*retval);
2133         array_init(*retval);
2134 
2135         if (snmp_object->session == NULL) {
2136                 return SUCCESS;
2137         }
2138                 
2139         MAKE_STD_ZVAL(val);
2140         ZVAL_STRINGL(val, snmp_object->session->peername, strlen(snmp_object->session->peername), 1);
2141         add_assoc_zval(*retval, "hostname", val);
2142         
2143         MAKE_STD_ZVAL(val);
2144         ZVAL_LONG(val, snmp_object->session->remote_port);
2145         add_assoc_zval(*retval, "port", val);
2146         
2147         MAKE_STD_ZVAL(val);
2148         ZVAL_LONG(val, snmp_object->session->timeout);
2149         add_assoc_zval(*retval, "timeout", val);
2150         
2151         MAKE_STD_ZVAL(val);
2152         ZVAL_LONG(val, snmp_object->session->retries);
2153         add_assoc_zval(*retval, "retries", val);
2154         
2155         return SUCCESS;
2156 }
2157 /* }}} */
2158 
2159 /* {{{ */
2160 static int php_snmp_read_max_oids(php_snmp_object *snmp_object, zval **retval TSRMLS_DC)
2161 {
2162         MAKE_STD_ZVAL(*retval);
2163         if (snmp_object->max_oids > 0) {
2164                 ZVAL_LONG(*retval, snmp_object->max_oids);
2165         } else {
2166                 ZVAL_NULL(*retval);
2167         }
2168         return SUCCESS;
2169 }
2170 /* }}} */
2171 
2172 #define PHP_SNMP_BOOL_PROPERTY_READER_FUNCTION(name) \
2173         static int php_snmp_read_##name(php_snmp_object *snmp_object, zval **retval TSRMLS_DC) \
2174         { \
2175                 MAKE_STD_ZVAL(*retval); \
2176                 ZVAL_BOOL(*retval, snmp_object->name); \
2177                 return SUCCESS; \
2178         }
2179 
2180 PHP_SNMP_BOOL_PROPERTY_READER_FUNCTION(oid_increasing_check)
2181 PHP_SNMP_BOOL_PROPERTY_READER_FUNCTION(quick_print)
2182 PHP_SNMP_BOOL_PROPERTY_READER_FUNCTION(enum_print)
2183 
2184 #define PHP_SNMP_LONG_PROPERTY_READER_FUNCTION(name) \
2185         static int php_snmp_read_##name(php_snmp_object *snmp_object, zval **retval TSRMLS_DC) \
2186         { \
2187                 MAKE_STD_ZVAL(*retval); \
2188                 ZVAL_LONG(*retval, snmp_object->name); \
2189                 return SUCCESS; \
2190         }
2191 
2192 PHP_SNMP_LONG_PROPERTY_READER_FUNCTION(valueretrieval)
2193 PHP_SNMP_LONG_PROPERTY_READER_FUNCTION(oid_output_format)
2194 PHP_SNMP_LONG_PROPERTY_READER_FUNCTION(exceptions_enabled)
2195 
2196 /* {{{ */
2197 static int php_snmp_write_info(php_snmp_object *snmp_object, zval *newval TSRMLS_DC)
2198 {
2199         php_error_docref(NULL TSRMLS_CC, E_WARNING, "info property is read-only");
2200         return FAILURE;
2201 }
2202 /* }}} */
2203 
2204 /* {{{ */
2205 static int php_snmp_write_max_oids(php_snmp_object *snmp_object, zval *newval TSRMLS_DC)
2206 {
2207         zval ztmp;
2208         int ret = SUCCESS;
2209 
2210         if (Z_TYPE_P(newval) == IS_NULL) {
2211                 snmp_object->max_oids = 0;
2212                 return ret;
2213         }
2214 
2215         if (Z_TYPE_P(newval) != IS_LONG) {
2216                 ztmp = *newval;
2217                 zval_copy_ctor(&ztmp);
2218                 convert_to_long(&ztmp);
2219                 newval = &ztmp;
2220         }
2221 
2222         if (Z_LVAL_P(newval) > 0) {
2223                 snmp_object->max_oids = Z_LVAL_P(newval);
2224         } else {
2225                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "max_oids should be positive integer or NULL, got %ld", Z_LVAL_P(newval));
2226         }
2227         
2228         if (newval == &ztmp) {
2229                 zval_dtor(newval);
2230         }
2231 
2232         return ret;
2233 }
2234 /* }}} */
2235 
2236 /* {{{ */
2237 static int php_snmp_write_valueretrieval(php_snmp_object *snmp_object, zval *newval TSRMLS_DC)
2238 {
2239         zval ztmp;
2240         int ret = SUCCESS;
2241 
2242         if (Z_TYPE_P(newval) != IS_LONG) {
2243                 ztmp = *newval;
2244                 zval_copy_ctor(&ztmp);
2245                 convert_to_long(&ztmp);
2246                 newval = &ztmp;
2247         }
2248 
2249         if (Z_LVAL_P(newval) >= 0 && Z_LVAL_P(newval) <= (SNMP_VALUE_LIBRARY|SNMP_VALUE_PLAIN|SNMP_VALUE_OBJECT)) {
2250                 snmp_object->valueretrieval = Z_LVAL_P(newval);
2251         } else {
2252                 php_error_docref(NULL TSRMLS_CC, E_WARNING, "Unknown SNMP value retrieval method '%ld'", Z_LVAL_P(newval));
2253                 ret = FAILURE;
2254         }
2255         
2256         if (newval == &ztmp) {
2257                 zval_dtor(newval);
2258         }
2259 
2260         return ret;
2261 }
2262 /* }}} */
2263 
2264 #define PHP_SNMP_BOOL_PROPERTY_WRITER_FUNCTION(name) \
2265 static int php_snmp_write_##name(php_snmp_object *snmp_object, zval *newval TSRMLS_DC) \
2266 { \
2267         zval ztmp; \
2268         if (Z_TYPE_P(newval) != IS_BOOL) { \
2269                 ztmp = *newval; \
2270                 zval_copy_ctor(&ztmp); \
2271                 convert_to_boolean(&ztmp); \
2272                 newval = &ztmp; \
2273         } \
2274 \
2275         snmp_object->name = Z_LVAL_P(newval); \
2276 \
2277         if (newval == &ztmp) { \
2278                 zval_dtor(newval); \
2279         } \
2280         return SUCCESS; \
2281 }
2282 
2283 PHP_SNMP_BOOL_PROPERTY_WRITER_FUNCTION(quick_print)
2284 PHP_SNMP_BOOL_PROPERTY_WRITER_FUNCTION(enum_print)
2285 PHP_SNMP_BOOL_PROPERTY_WRITER_FUNCTION(oid_increasing_check)
2286 
2287 /* {{{ */
2288 static int php_snmp_write_oid_output_format(php_snmp_object *snmp_object, zval *newval TSRMLS_DC)
2289 {
2290         zval ztmp;
2291         int ret = SUCCESS;
2292         if (Z_TYPE_P(newval) != IS_LONG) {
2293                 ztmp = *newval;
2294                 zval_copy_ctor(&ztmp);
2295                 convert_to_long(&ztmp);
2296                 newval = &ztmp;
2297         }
2298         
2299         switch(Z_LVAL_P(newval)) {
2300                 case NETSNMP_OID_OUTPUT_SUFFIX:
2301                 case NETSNMP_OID_OUTPUT_MODULE:
2302                 case NETSNMP_OID_OUTPUT_FULL:
2303                 case NETSNMP_OID_OUTPUT_NUMERIC:
2304                 case NETSNMP_OID_OUTPUT_UCD:
2305                 case NETSNMP_OID_OUTPUT_NONE:
2306                         snmp_object->oid_output_format = Z_LVAL_P(newval);
2307                         break;
2308                 default:
2309                         php_error_docref(NULL TSRMLS_CC, E_WARNING, "Unknown SNMP output print format '%ld'", Z_LVAL_P(newval));
2310                         ret = FAILURE;
2311                         break;
2312         }
2313 
2314         if (newval == &ztmp) {
2315                 zval_dtor(newval);
2316         }
2317         return ret;
2318 }
2319 /* }}} */
2320 
2321 /* {{{ */
2322 static int php_snmp_write_exceptions_enabled(php_snmp_object *snmp_object, zval *newval TSRMLS_DC)
2323 {
2324         zval ztmp;
2325         int ret = SUCCESS;
2326         if (Z_TYPE_P(newval) != IS_LONG) {
2327                 ztmp = *newval;
2328                 zval_copy_ctor(&ztmp);
2329                 convert_to_long(&ztmp);
2330                 newval = &ztmp;
2331         }
2332 
2333         snmp_object->exceptions_enabled = Z_LVAL_P(newval);     
2334 
2335         if (newval == &ztmp) {
2336                 zval_dtor(newval);
2337         }
2338         return ret;
2339 }
2340 /* }}} */
2341 
2342 /* {{{ php_snmp_class_methods[] */
2343 static zend_function_entry php_snmp_class_methods[] = {
2344         PHP_ME(snmp,     __construct,           arginfo_snmp_create,            ZEND_ACC_PUBLIC)
2345         PHP_ME(snmp,     close,                         arginfo_snmp_void,                      ZEND_ACC_PUBLIC)
2346         PHP_ME(snmp,     setSecurity,           arginfo_snmp_setSecurity,       ZEND_ACC_PUBLIC)
2347 
2348         PHP_ME(snmp,     get,                           arginfo_snmp_get,                       ZEND_ACC_PUBLIC)
2349         PHP_ME(snmp,     getnext,                       arginfo_snmp_get,                       ZEND_ACC_PUBLIC)
2350         PHP_ME(snmp,     walk,                          arginfo_snmp_walk,                      ZEND_ACC_PUBLIC)
2351         PHP_ME(snmp,     set,                           arginfo_snmp_set,                       ZEND_ACC_PUBLIC)
2352         PHP_ME(snmp,     getErrno,                      arginfo_snmp_void,                      ZEND_ACC_PUBLIC)
2353         PHP_ME(snmp,     getError,                      arginfo_snmp_void,                      ZEND_ACC_PUBLIC)
2354 
2355         PHP_FE_END
2356 };
2357 
2358 #define PHP_SNMP_PROPERTY_ENTRY_RECORD(name) \
2359         { "" #name "",          sizeof("" #name "") - 1,        php_snmp_read_##name,   php_snmp_write_##name }
2360 
2361 const php_snmp_prop_handler php_snmp_property_entries[] = {
2362         PHP_SNMP_PROPERTY_ENTRY_RECORD(info),
2363         PHP_SNMP_PROPERTY_ENTRY_RECORD(max_oids),
2364         PHP_SNMP_PROPERTY_ENTRY_RECORD(valueretrieval),
2365         PHP_SNMP_PROPERTY_ENTRY_RECORD(quick_print),
2366         PHP_SNMP_PROPERTY_ENTRY_RECORD(enum_print),
2367         PHP_SNMP_PROPERTY_ENTRY_RECORD(oid_output_format),
2368         PHP_SNMP_PROPERTY_ENTRY_RECORD(oid_increasing_check),
2369         PHP_SNMP_PROPERTY_ENTRY_RECORD(exceptions_enabled),
2370         { NULL, 0, NULL, NULL}
2371 };
2372 /* }}} */
2373 
2374 /* {{{ PHP_MINIT_FUNCTION
2375  */
2376 PHP_MINIT_FUNCTION(snmp)
2377 {
2378         netsnmp_log_handler *logh;
2379         zend_class_entry ce, cex;
2380 
2381         le_snmp_session = zend_register_list_destructors_ex(php_snmp_session_destructor, NULL, PHP_SNMP_SESSION_RES_NAME, module_number);
2382 
2383         init_snmp("snmpapp");
2384 
2385 #ifdef NETSNMP_DS_LIB_DONT_PERSIST_STATE
2386         /* Prevent update of the snmpapp.conf file */
2387         netsnmp_ds_set_boolean(NETSNMP_DS_LIBRARY_ID, NETSNMP_DS_LIB_DONT_PERSIST_STATE, 1);
2388 #endif
2389 
2390         /* Disable logging, use exit status'es and related variabled to detect errors */
2391         shutdown_snmp_logging();
2392         logh = netsnmp_register_loghandler(NETSNMP_LOGHANDLER_NONE, LOG_ERR);
2393         if (logh) {
2394                 logh->pri_max = LOG_ERR;
2395         }
2396 
2397         memcpy(&php_snmp_object_handlers, zend_get_std_object_handlers(), sizeof(zend_object_handlers));
2398         php_snmp_object_handlers.read_property = php_snmp_read_property;
2399         php_snmp_object_handlers.write_property = php_snmp_write_property;
2400         php_snmp_object_handlers.has_property = php_snmp_has_property;
2401         php_snmp_object_handlers.get_properties = php_snmp_get_properties;
2402 
2403         /* Register SNMP Class */
2404         INIT_CLASS_ENTRY(ce, "SNMP", php_snmp_class_methods);
2405         ce.create_object = php_snmp_object_new;
2406         php_snmp_object_handlers.clone_obj = NULL;
2407         php_snmp_ce = zend_register_internal_class(&ce TSRMLS_CC);
2408 
2409         /* Register SNMP Class properties */
2410         zend_hash_init(&php_snmp_properties, 0, NULL, NULL, 1);
2411         PHP_SNMP_ADD_PROPERTIES(&php_snmp_properties, php_snmp_property_entries);
2412 
2413         REGISTER_LONG_CONSTANT("SNMP_OID_OUTPUT_SUFFIX",        NETSNMP_OID_OUTPUT_SUFFIX,      CONST_CS | CONST_PERSISTENT);
2414         REGISTER_LONG_CONSTANT("SNMP_OID_OUTPUT_MODULE",        NETSNMP_OID_OUTPUT_MODULE,      CONST_CS | CONST_PERSISTENT);
2415         REGISTER_LONG_CONSTANT("SNMP_OID_OUTPUT_FULL",          NETSNMP_OID_OUTPUT_FULL,        CONST_CS | CONST_PERSISTENT);
2416         REGISTER_LONG_CONSTANT("SNMP_OID_OUTPUT_NUMERIC",       NETSNMP_OID_OUTPUT_NUMERIC,     CONST_CS | CONST_PERSISTENT);
2417         REGISTER_LONG_CONSTANT("SNMP_OID_OUTPUT_UCD",           NETSNMP_OID_OUTPUT_UCD,         CONST_CS | CONST_PERSISTENT);
2418         REGISTER_LONG_CONSTANT("SNMP_OID_OUTPUT_NONE",          NETSNMP_OID_OUTPUT_NONE,        CONST_CS | CONST_PERSISTENT);
2419 
2420         REGISTER_LONG_CONSTANT("SNMP_VALUE_LIBRARY",    SNMP_VALUE_LIBRARY,     CONST_CS | CONST_PERSISTENT);
2421         REGISTER_LONG_CONSTANT("SNMP_VALUE_PLAIN",      SNMP_VALUE_PLAIN,       CONST_CS | CONST_PERSISTENT);
2422         REGISTER_LONG_CONSTANT("SNMP_VALUE_OBJECT",     SNMP_VALUE_OBJECT,      CONST_CS | CONST_PERSISTENT);
2423 
2424         REGISTER_LONG_CONSTANT("SNMP_BIT_STR",          ASN_BIT_STR,    CONST_CS | CONST_PERSISTENT);
2425         REGISTER_LONG_CONSTANT("SNMP_OCTET_STR",        ASN_OCTET_STR,  CONST_CS | CONST_PERSISTENT);
2426         REGISTER_LONG_CONSTANT("SNMP_OPAQUE",           ASN_OPAQUE,     CONST_CS | CONST_PERSISTENT);
2427         REGISTER_LONG_CONSTANT("SNMP_NULL",             ASN_NULL,       CONST_CS | CONST_PERSISTENT);
2428         REGISTER_LONG_CONSTANT("SNMP_OBJECT_ID",        ASN_OBJECT_ID,  CONST_CS | CONST_PERSISTENT);
2429         REGISTER_LONG_CONSTANT("SNMP_IPADDRESS",        ASN_IPADDRESS,  CONST_CS | CONST_PERSISTENT);
2430         REGISTER_LONG_CONSTANT("SNMP_COUNTER",          ASN_GAUGE,      CONST_CS | CONST_PERSISTENT);
2431         REGISTER_LONG_CONSTANT("SNMP_UNSIGNED",         ASN_UNSIGNED,   CONST_CS | CONST_PERSISTENT);
2432         REGISTER_LONG_CONSTANT("SNMP_TIMETICKS",        ASN_TIMETICKS,  CONST_CS | CONST_PERSISTENT);
2433         REGISTER_LONG_CONSTANT("SNMP_UINTEGER",         ASN_UINTEGER,   CONST_CS | CONST_PERSISTENT);
2434         REGISTER_LONG_CONSTANT("SNMP_INTEGER",          ASN_INTEGER,    CONST_CS | CONST_PERSISTENT);
2435         REGISTER_LONG_CONSTANT("SNMP_COUNTER64",        ASN_COUNTER64,  CONST_CS | CONST_PERSISTENT);
2436 
2437         REGISTER_SNMP_CLASS_CONST_LONG("VERSION_1",                     SNMP_VERSION_1);
2438         REGISTER_SNMP_CLASS_CONST_LONG("VERSION_2c",                    SNMP_VERSION_2c);
2439         REGISTER_SNMP_CLASS_CONST_LONG("VERSION_2C",                    SNMP_VERSION_2c);
2440         REGISTER_SNMP_CLASS_CONST_LONG("VERSION_3",                     SNMP_VERSION_3);
2441 
2442         REGISTER_SNMP_CLASS_CONST_LONG("ERRNO_NOERROR",                 PHP_SNMP_ERRNO_NOERROR);
2443         REGISTER_SNMP_CLASS_CONST_LONG("ERRNO_ANY",                     PHP_SNMP_ERRNO_ANY);
2444         REGISTER_SNMP_CLASS_CONST_LONG("ERRNO_GENERIC",                 PHP_SNMP_ERRNO_GENERIC);
2445         REGISTER_SNMP_CLASS_CONST_LONG("ERRNO_TIMEOUT",                 PHP_SNMP_ERRNO_TIMEOUT);
2446         REGISTER_SNMP_CLASS_CONST_LONG("ERRNO_ERROR_IN_REPLY",          PHP_SNMP_ERRNO_ERROR_IN_REPLY);
2447         REGISTER_SNMP_CLASS_CONST_LONG("ERRNO_OID_NOT_INCREASING",      PHP_SNMP_ERRNO_OID_NOT_INCREASING);
2448         REGISTER_SNMP_CLASS_CONST_LONG("ERRNO_OID_PARSING_ERROR",       PHP_SNMP_ERRNO_OID_PARSING_ERROR);
2449         REGISTER_SNMP_CLASS_CONST_LONG("ERRNO_MULTIPLE_SET_QUERIES",    PHP_SNMP_ERRNO_MULTIPLE_SET_QUERIES);
2450 
2451         /* Register SNMPException class */
2452         INIT_CLASS_ENTRY(cex, "SNMPException", NULL);
2453 #ifdef HAVE_SPL
2454         php_snmp_exception_ce = zend_register_internal_class_ex(&cex, spl_ce_RuntimeException, NULL TSRMLS_CC);
2455 #else
2456         php_snmp_exception_ce = zend_register_internal_class_ex(&cex, zend_exception_get_default(TSRMLS_C), NULL TSRMLS_CC);
2457 #endif
2458 
2459         return SUCCESS;
2460 }
2461 /* }}} */
2462 
2463 /* {{{ PHP_MSHUTDOWN_FUNCTION
2464  */
2465 PHP_MSHUTDOWN_FUNCTION(snmp)
2466 {
2467         snmp_shutdown("snmpapp");
2468         
2469         zend_hash_destroy(&php_snmp_properties);
2470 
2471         return SUCCESS;
2472 }
2473 /* }}} */
2474 
2475 /* {{{ PHP_MINFO_FUNCTION
2476  */
2477 PHP_MINFO_FUNCTION(snmp)
2478 {
2479         php_info_print_table_start();
2480         php_info_print_table_row(2, "NET-SNMP Support", "enabled");
2481         php_info_print_table_row(2, "NET-SNMP Version", netsnmp_get_version());
2482         php_info_print_table_row(2, "PHP SNMP Version", PHP_SNMP_VERSION);
2483         php_info_print_table_end();
2484 }
2485 /* }}} */
2486 
2487 /* {{{ snmp_module_deps[]
2488  */
2489 #if ZEND_MODULE_API_NO >= 20050922
2490 static const zend_module_dep snmp_module_deps[] = {
2491 #ifdef HAVE_SPL
2492         ZEND_MOD_REQUIRED("spl")
2493 #endif
2494         ZEND_MOD_END
2495 };
2496 #endif
2497 /* }}} */
2498 
2499 /* {{{ snmp_module_entry
2500  */
2501 zend_module_entry snmp_module_entry = {
2502 #if ZEND_MODULE_API_NO >= 20050922
2503         STANDARD_MODULE_HEADER_EX,
2504         NULL,
2505         snmp_module_deps,
2506 #else
2507         STANDARD_MODULE_HEADER,
2508 #endif
2509         "snmp",
2510         snmp_functions,
2511         PHP_MINIT(snmp),
2512         PHP_MSHUTDOWN(snmp),
2513         NULL,
2514         NULL,
2515         PHP_MINFO(snmp),
2516         PHP_SNMP_VERSION,
2517         PHP_MODULE_GLOBALS(snmp),
2518         PHP_GINIT(snmp),
2519         NULL,
2520         NULL,
2521         STANDARD_MODULE_PROPERTIES_EX
2522 };
2523 /* }}} */
2524 
2525 #endif
2526 
2527 /*
2528  * Local variables:
2529  * tab-width: 4
2530  * c-basic-offset: 4
2531  * End:
2532  * vim600: sw=4 ts=4 fdm=marker
2533  * vim<600: sw=4 ts=4
2534  */

/* [<][>][^][v][top][bottom][index][help] */