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
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
|
/******************************************************************************
* The MIT License
* Copyright (c) 2003 Novell Inc. www.novell.com
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the Software), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
*******************************************************************************/
//
// Novell.Directory.Ldap.Asn1.Asn1Decoder.cs
//
// Author:
// Sunil Kumar (Sunilk@novell.com)
//
// (C) 2003 Novell, Inc (http://www.novell.com)
//
using System;
namespace Novell.Directory.Ldap.Asn1
{
/// <summary> This interface defines the methods for decoding each of the ASN.1 types.
///
/// Decoders which implement this interface may be used to decode any of the
/// Asn1Object data types.
///
/// This package also provides the BERDecoder class that can be used to
/// BER decode ASN.1 classes. However an application might chose to use
/// its own decoder class.
///
/// This interface thus allows an application to use this package to
/// decode ASN.1 objects using other decoding rules if needed.
///
/// Note that Ldap packets are required to be BER encoded. Since this package
/// includes a BER decoder no application provided decoder is needed for
/// building Ldap packets.
/// </summary>
[CLSCompliantAttribute(false)]
public interface Asn1Decoder : System.Runtime.Serialization.ISerializable
{
/// <summary> Decode an encoded value into an Asn1Object from a byte array.
///
/// </summary>
/// <param name="value">A byte array that points to the encoded Asn1 data
/// </param>
Asn1Object decode(sbyte[] value_Renamed);
/// <summary> Decode an encoded value into an Asn1Object from an InputStream.
///
/// </summary>
/// <param name="in">An input stream containig the encoded ASN.1 data.
/// </param>
Asn1Object decode(System.IO.Stream in_Renamed);
/// <summary> Decode an encoded value into an Asn1Object from an InputStream.
///
/// </summary>
/// <param name="length">The decoded components encoded length. This value is
/// handy when decoding structured types. It allows you to accumulate
/// the number of bytes decoded, so you know when the structured
/// type has decoded all of its components.
///
/// </param>
/// <param name="in">An input stream containig the encoded ASN.1 data.
/// </param>
Asn1Object decode(System.IO.Stream in_Renamed, int[] length);
/* Decoders for ASN.1 simple types
*/
/// <summary> Decode a BOOLEAN directly from a stream. Call this method when you
/// know that the next ASN.1 encoded element is a BOOLEAN
///
/// </summary>
/// <param name="in">An input stream containig the encoded ASN.1 data.
///
/// </param>
/// <param name="len">Length in bytes
/// </param>
System.Object decodeBoolean(System.IO.Stream in_Renamed, int len);
/// <summary> Decode a Numeric value directly from a stream. Call this method when you
/// know that the next ASN.1 encoded element is a Numeric
///
/// Can be used to decodes INTEGER and ENUMERATED types.
///
/// </summary>
/// <param name="in">An input stream containig the encoded ASN.1 data.
///
/// </param>
/// <param name="len">Length in bytes
/// </param>
System.Object decodeNumeric(System.IO.Stream in_Renamed, int len);
/* Asn1 TYPE NOT YET SUPPORTED
* Decode a REAL directly from a stream.
* public Object decodeReal(InputStream in, int len)
* throws IOException;
*/
/* Asn1 TYPE NOT YET SUPPORTED
* Decode a BIT_STRING directly from a stream.
* public Object decodeBitString(InputStream in, int len)
* throws IOException;
*/
/// <summary> Decode an OCTET_STRING directly from a stream. Call this method when you
/// know that the next ASN.1 encoded element is a OCTET_STRING.
///
/// </summary>
/// <param name="in">An input stream containig the encoded ASN.1 data.
///
/// </param>
/// <param name="len">Length in bytes
/// </param>
System.Object decodeOctetString(System.IO.Stream in_Renamed, int len);
/* Asn1 TYPE NOT YET SUPPORTED
* Decode an OBJECT_IDENTIFIER directly from a stream.
* public Object decodeObjectIdentifier(InputStream in, int len)
* throws IOException;
*/
/// <summary> Decode a CharacterString directly from a stream.
///
/// Decodes any of the specialized character strings.
///
/// </summary>
/// <param name="in">An input stream containig the encoded ASN.1 data.
///
/// </param>
/// <param name="len">Length in bytes
/// </param>
System.Object decodeCharacterString(System.IO.Stream in_Renamed, int len);
/* No Decoders for ASN.1 structured types. A structured type's value is a
* collection of other types.
*/
/* Decoders for ASN.1 useful types
*/
/* Asn1 TYPE NOT YET SUPPORTED
* Decode a GENERALIZED_TIME directly from a stream.
* public Object decodeGeneralizedTime(InputStream in, int len)
* throws IOException;
*/
/* Asn1 TYPE NOT YET SUPPORTED
* Decode a UNIVERSAL_TIME directly from a stream.
* public Object decodeUniversalTime(InputStream in, int len)
* throws IOException;
*/
/* Asn1 TYPE NOT YET SUPPORTED
* Decode an EXTERNAL directly from a stream.
* public Object decodeExternal(InputStream in, int len)
* throws IOException;
*/
/* Asn1 TYPE NOT YET SUPPORTED
* Decode an OBJECT_DESCRIPTOR directly from a stream.
* public Object decodeObjectDescriptor(InputStream in, int len)
* throws IOException;
*/
}
}
|
