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
135
136
137
138
139
140
141
142
143
144
145
|
/*
* "$Id$"
*
* Private SNMP definitions for CUPS.
*
* Copyright 2007-2010 by Apple Inc.
* Copyright 2006-2007 by Easy Software Products, all rights reserved.
*
* These coded instructions, statements, and computer programs are the
* property of Apple Inc. and are protected by Federal copyright
* law. Distribution and use rights are outlined in the file "LICENSE.txt"
* "LICENSE" which should have been included with this file. If this
* file is missing or damaged, see the license at "http://www.cups.org/".
*
* This file is subject to the Apple OS-Developed Software exception.
*/
#ifndef _CUPS_SNMP_PRIVATE_H_
# define _CUPS_SNMP_PRIVATE_H_
/*
* Include necessary headers.
*/
#include <cups/http.h>
/*
* Constants...
*/
#define CUPS_SNMP_PORT 161 /* SNMP well-known port */
#define CUPS_SNMP_MAX_OID 128 /* Maximum number of OID numbers */
#define CUPS_SNMP_MAX_PACKET 1472 /* Maximum size of SNMP packet */
#define CUPS_SNMP_MAX_STRING 512 /* Maximum size of string */
#define CUPS_SNMP_VERSION_1 0 /* SNMPv1 */
/*
* Types...
*/
enum cups_asn1_e /**** ASN1 request/object types ****/
{
CUPS_ASN1_END_OF_CONTENTS = 0x00, /* End-of-contents */
CUPS_ASN1_BOOLEAN = 0x01, /* BOOLEAN */
CUPS_ASN1_INTEGER = 0x02, /* INTEGER or ENUMERATION */
CUPS_ASN1_BIT_STRING = 0x03, /* BIT STRING */
CUPS_ASN1_OCTET_STRING = 0x04, /* OCTET STRING */
CUPS_ASN1_NULL_VALUE = 0x05, /* NULL VALUE */
CUPS_ASN1_OID = 0x06, /* OBJECT IDENTIFIER */
CUPS_ASN1_SEQUENCE = 0x30, /* SEQUENCE */
CUPS_ASN1_HEX_STRING = 0x40, /* Binary string aka Hex-STRING */
CUPS_ASN1_COUNTER = 0x41, /* 32-bit unsigned aka Counter32 */
CUPS_ASN1_GAUGE = 0x42, /* 32-bit unsigned aka Gauge32 */
CUPS_ASN1_TIMETICKS = 0x43, /* 32-bit unsigned aka Timeticks32 */
CUPS_ASN1_GET_REQUEST = 0xa0, /* GetRequest-PDU */
CUPS_ASN1_GET_NEXT_REQUEST = 0xa1, /* GetNextRequest-PDU */
CUPS_ASN1_GET_RESPONSE = 0xa2 /* GetResponse-PDU */
};
typedef enum cups_asn1_e cups_asn1_t; /**** ASN1 request/object types ****/
typedef struct cups_snmp_string_s /**** String value ****/
{
unsigned char bytes[CUPS_SNMP_MAX_STRING];
/* Bytes in string */
int num_bytes; /* Number of bytes */
} cups_snmp_string_t;
union cups_snmp_value_u /**** Object value ****/
{
int boolean; /* Boolean value */
int integer; /* Integer value */
unsigned counter; /* Counter value */
unsigned gauge; /* Gauge value */
unsigned timeticks; /* Timeticks value */
int oid[CUPS_SNMP_MAX_OID]; /* OID value */
cups_snmp_string_t string; /* String value */
};
typedef struct cups_snmp_s /**** SNMP data packet ****/
{
const char *error; /* Encode/decode error */
http_addr_t address; /* Source address */
int version; /* Version number */
char community[CUPS_SNMP_MAX_STRING];
/* Community name */
cups_asn1_t request_type; /* Request type */
int request_id; /* request-id value */
int error_status; /* error-status value */
int error_index; /* error-index value */
int object_name[CUPS_SNMP_MAX_OID];
/* object-name value */
cups_asn1_t object_type; /* object-value type */
union cups_snmp_value_u
object_value; /* object-value value */
} cups_snmp_t;
typedef void (*cups_snmp_cb_t)(cups_snmp_t *packet, void *data);
/*
* Prototypes...
*/
# ifdef __cplusplus
extern "C" {
# endif /* __cplusplus */
extern void _cupsSNMPClose(int fd) _CUPS_API_1_4;
extern int *_cupsSNMPCopyOID(int *dst, const int *src, int dstsize)
_CUPS_API_1_4;
extern const char *_cupsSNMPDefaultCommunity(void) _CUPS_API_1_4;
extern int _cupsSNMPIsOID(cups_snmp_t *packet, const int *oid)
_CUPS_API_1_4;
extern int _cupsSNMPIsOIDPrefixed(cups_snmp_t *packet,
const int *prefix) _CUPS_API_1_4;
extern char *_cupsSNMPOIDToString(const int *src, char *dst,
size_t dstsize) _CUPS_API_1_4;
extern int _cupsSNMPOpen(int family) _CUPS_API_1_4;
extern cups_snmp_t *_cupsSNMPRead(int fd, cups_snmp_t *packet,
double timeout) _CUPS_API_1_4;
extern void _cupsSNMPSetDebug(int level) _CUPS_API_1_4;
extern int *_cupsSNMPStringToOID(const char *src,
int *dst, int dstsize)
_CUPS_API_1_4;
extern int _cupsSNMPWalk(int fd, http_addr_t *address, int version,
const char *community, const int *prefix,
double timeout, cups_snmp_cb_t cb,
void *data) _CUPS_API_1_4;
extern int _cupsSNMPWrite(int fd, http_addr_t *address, int version,
const char *community,
cups_asn1_t request_type,
const unsigned request_id,
const int *oid) _CUPS_API_1_4;
# ifdef __cplusplus
}
# endif /* __cplusplus */
#endif /* !_CUPS_SNMP_PRIVATE_H_ */
/*
* End of "$Id$".
*/
|
