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
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
|
#ifndef OID_CLS_
#define OID_CLS_
//=============================================================================
/**
* @file oid.h
*
* $Id$
*
* This class is fully contained and does not rely on or any other
* SNMP libraries. This class is portable across any platform
* which supports C++. Ported to ACE by Mike MacFaden mrm@cisco.com
* and modified for MT. Some API cleanup: collapse constructors,
* add suboid() method remove unnecessary overload, and update a few
* names and types to improve clarity.
*
*
* @author Peter E Mellquist
*/
//=============================================================================
/*===================================================================
Copyright (c) 1996
Hewlett-Packard Company
ATTENTION: USE OF THIS SOFTWARE IS SUBJECT TO THE FOLLOWING TERMS.
Permission to use, copy, modify, distribute and/or sell this software
and/or its documentation is hereby granted without fee. User agrees
to display the above copyright notice and this license notice in all
copies of the software and any documentation of the software. User
agrees to assume all liability for the use of the software; Hewlett-Packard
makes no representations about the suitability of this software for any
purpose. It is provided "AS-IS without warranty of any kind,either express
or implied. User hereby grants a royalty-free license to any and all
derivatives based upon this software code base.
=====================================================================*/
//----------[ extern C libraries Needed ]---------------------------------
#include "ace/config-all.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
#include "asnmp/smival.h" // derived class for all values
/**
* @class Oid
*
* @brief Implement RFC 1155 Object Identifier (OID) datatype
*/
class ASNMP_Export Oid : public SnmpSyntax
{
public:
/// constructor using a dotted string
Oid( const char * dotted_oid_string = "", size_t size = unsigned(-1) );
/// constructor using another oid object
Oid ( const Oid &oid);
/// constructor from raw form
Oid(const unsigned long *raw_oid, size_t oid_len);
/// destructor
~Oid();
/// syntax type
SmiUINT32 get_syntax();
/// assignment to another oid object overloaded
Oid& operator=( const Oid &oid);
/// equal operator overloaded
friend ASNMP_Export bool operator==( const Oid &lhs,const Oid &rhs);
/// not equal operator overloaded
friend ASNMP_Export bool operator!=( const Oid &lhs,const Oid &rhs);
/// less than < overloaded
friend ASNMP_Export bool operator<( const Oid &lhs,const Oid &rhs);
/// less than <= overloaded
friend ASNMP_Export bool operator<=( const Oid &lhs,const Oid &rhs);
/// greater than > overloaded
friend ASNMP_Export bool operator>( const Oid &lhs,const Oid &rhs);
/// greater than >= overloaded
friend ASNMP_Export bool operator>=( const Oid &lhs,const Oid &rhs);
/// append operator, appends a string
Oid& operator+=( const char *a);
/// appends an int
Oid& operator+=( const unsigned long i);
/// appends an Oid
Oid& operator+=( const Oid &o);
/// allows element access
unsigned long & operator[]( size_t position);
/// return the WinSnmp oid part
SmiLPOID oidval();
/// reset the data from raw 1 byte format
void set_data( const char *dotted_oid_string);
/// reset the data from raw 4byte integer format
void set_data( const unsigned long *raw_oid, const size_t oid_len);
/// return the len of the oid
size_t length() const;
/// trim off the n rightmost values of an oid
void trim( const size_t how_many = 1);
/// the equivalent of a substr(new_str, 0, 1)
int suboid(Oid& oid, size_t start = 0, size_t how_many = size_t (-1));
/**
* compare the n leftmost bytes (left-to-right)
* returns 0, equal
* returns -1, <
* returns 1 , >
*/
int left_comparison( const unsigned long n, const Oid &o) const;
/**
* compare the n rightmost bytes (right-to-left)
* returns 0, equal
* returns -1, <
* returns 1 , >
*/
int right_comparison( const unsigned long n, const Oid &o) const;
/// is the Oid object valid
int valid() const;
/// return dotted string value from the right
/// where the user specifies how many positions to print
const char *to_string();
/// create a new instance of this Value
SnmpSyntax *clone() const;
/// copy an instance of this Value
SnmpSyntax& operator=( SnmpSyntax &val);
protected:
/// used for returning oid string
char *iv_str;
/// convert a string to an smi oid
int StrToOid( const char *string, SmiLPOID dstOid, size_t& how_many_bytes);
/// clone an smi oid
int OidCopy( SmiLPOID srcOid, SmiLPOID dstOid, size_t& how_many_bytes);
/// convert an smi oid to its string representation
int OidToStr(SmiLPOID srcOid, SmiUINT32 size, char *string, size_t& how_many_bytes);
private:
/// release memory, re-init data members
void set_invalid();
/// initialize object data members
void set_null();
void init_value( const SmiLPOID srcOid, size_t len);
void init_value(const unsigned long *raw_oid, size_t oid_len);
};
#endif //OID_CLS_
|
