1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
/* This is the header file to the 'interface.c' file. Will include things like
* function definitions, enums, etc.
*/
/******************************************************************************
*
* Defines for the 'interface.c' file are listed below
*
******************************************************************************/
#define APPNAME "python"
/*
* In snmpv1 when using retry_nosuch we need to track the
* index of each bad OID in the responses using a bitarray;
* DEFAULT_NUM_BAD_OIDS is a tradeoff to avoid allocating
* heavily on the heap; if we need to track more, we can
* just malloc on the heap.
*/
#define DEFAULT_NUM_BAD_OIDS (sizeof(bitarray) * 8 * 3)
#define STRLEN(x) ((x) ? strlen((x)) : 0)
#define SUCCESS (1)
#define FAILURE (0)
#define VARBIND_TAG_F (0)
#define VARBIND_IID_F (1)
#define VARBIND_VAL_F (2)
#define VARBIND_TYPE_F (3)
#define TYPE_UNKNOWN (0)
#define MAX_TYPE_NAME_LEN (32)
#define STR_BUF_SIZE ((MAX_TYPE_NAME_LEN) * (MAX_OID_LEN))
#define MAX_VALUE_SIZE (65536)
#define MAX_INVALID_OIDS (MAX_VALUE_SIZE / MIN_OID_LEN)
#define ENG_ID_BUF_SIZE (32)
#define NO_RETRY_NOSUCH (0)
#define USE_NUMERIC_OIDS (0x08)
#define NON_LEAF_NAME (0x04)
#define USE_LONG_NAMES (0x02)
#define FAIL_ON_NULL_IID (0x01)
#define NO_FLAGS (0x00)
#define SAFE_FREE(x) \
do \
{ \
if (x != NULL) \
{ \
free(x); \
} \
} while (0)
/******************************************************************************
*
* Data structures used in the 'interface.c' file are listed below
*
******************************************************************************/
typedef netsnmp_session SnmpSession;
/*
* This structure is attached to the easysnmp.Session
* object as a Python Capsule (or CObject).
*
* This allows a one time allocation of large buffers
* without resorting to (unnecessary) allocation on the
* stack, but also remains thread safe; as long as only
* one Session object is restricted to each thread.
*
* This is allocated in create_session_capsule()
* and later (automatically via garbage collection) destroyed
* delete_session_capsule().
*/
struct session_capsule_ctx
{
/*
* Technically this should be a (void *), but this probably
* won't ever change in Net-SNMP.
*/
netsnmp_session *handle;
/* buf is reusable and stores OID values and names */
u_char buf[MAX_VALUE_SIZE];
/* err_str is used to fetch the error message from net-snmp libs */
char err_str[STR_BUF_SIZE];
/* used by netsnmp_{get,getnext,set}. */
oid oid_arr[MAX_OID_LEN];
/*
* invalid_oids is a bitarray for maintaining invalid OIDS when performing
* SNMPv1 requests.
*
* Note: prior to use, the number of bits required should be cleared.
*/
unsigned char invalid_oids_buf[MAX_INVALID_OIDS / CHAR_BIT];
bitarray *invalid_oids;
};
enum
{
INFO,
WARNING,
ERROR,
DEBUG,
EXCEPTION
};
/******************************************************************************
*
* Function definitions for the 'interface.c' file are listed below
*
******************************************************************************/
static PyObject *create_session_capsule(SnmpSession *ss);
static void *get_session_handle_from_capsule(PyObject *session_capsule);
#ifdef USE_DEPRECATED_COBJECT_API
static void delete_session_capsule(void *session_ptr);
#else
static void delete_session_capsule(PyObject *session_capsule);
#endif
static int __is_numeric_oid(char *oidstr);
static int __is_leaf(struct tree *tp);
static int __translate_appl_type(char *typestr);
static int __translate_asn_type(int type);
static int __snprint_value(char *buf, size_t buf_len,
netsnmp_variable_list *var,
struct tree *tp, int type, int flag);
static int __sprint_num_objid(char *buf, oid *objid, int len);
static int __scan_num_objid(char *buf, oid *objid, size_t *len);
static int __get_type_str(int type, char *str, int log_error);
static int __get_label_iid(char *name, char **last_label, char **iid,
int flag);
static struct tree *__tag2oid(char *tag, char *iid, oid *oid_arr,
int *oid_arr_len, int *type, int best_guess);
static int __concat_oid_str(oid *doid_arr, int *doid_arr_len, char *soid_str);
static int __add_var_val_str(netsnmp_pdu *pdu, oid *name, int name_length,
char *val, int len, int type);
static void py_log_msg(int log_level, char *printf_fmt, ...);
static int __match_algo(int is_auth, char *algo, oid **output, size_t *len);
static void __remove_user_from_cache(struct session_list *ss);
|
