// INFORM request message PDU.
// Copyright (C) 2008-2010 Malcolm Crowe, Lex Li, and other contributors.
//
// 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.
/*
* Created by SharpDevelop.
* User: lextm
* Date: 2008/8/3
* Time: 15:36
*
* To change this template use Tools | Options | Coding | Edit Standard Headers.
*/
using System;
using System.Collections.Generic;
using System.Globalization;
using System.IO;
namespace GSF.Net.Snmp
{
///
/// INFORM request PDU.
///
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1704:IdentifiersShouldBeSpelledCorrectly", MessageId = "Pdu")]
public sealed class InformRequestPdu : ISnmpPdu
{
private readonly uint[] _timeId = new uint[] { 1, 3, 6, 1, 2, 1, 1, 3, 0 };
private readonly uint[] _enterpriseId = new uint[] { 1, 3, 6, 1, 6, 3, 1, 1, 4, 1, 0 };
private readonly Sequence _varbindSection;
private readonly TimeTicks _time;
private readonly byte[] _length;
private byte[] _raw;
///
/// Creates a instance with all content.
///
/// The request id.
/// Enterprise
/// Time stamp
/// Variables
[CLSCompliant(false)]
public InformRequestPdu(int requestId, ObjectIdentifier enterprise, uint time, IList variables)
{
if (enterprise == null)
{
throw new ArgumentNullException(nameof(enterprise));
}
if (variables == null)
{
throw new ArgumentNullException(nameof(variables));
}
Enterprise = enterprise;
RequestId = new Integer32(requestId);
_time = new TimeTicks(time);
Variables = variables;
IList full = new List(variables);
full.Insert(0, new Variable(_timeId, _time));
full.Insert(1, new Variable(_enterpriseId, Enterprise));
_varbindSection = Variable.Transform(full);
}
///
/// Creates a instance for discovery.
///
/// The request id.
public InformRequestPdu(int requestId)
{
Enterprise = null;
RequestId = new Integer32(requestId);
_time = new TimeTicks(0);
Variables = new List();
_varbindSection = Variable.Transform(Variables);
}
///
/// Initializes a new instance of the class.
///
/// The length data.
/// The stream.
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Performance", "CA1804:RemoveUnusedLocals", MessageId = "temp1")]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Performance", "CA1804:RemoveUnusedLocals", MessageId = "temp2")]
public InformRequestPdu(Tuple length, Stream stream)
{
if (length == null)
{
throw new ArgumentNullException(nameof(length));
}
if (stream == null)
{
throw new ArgumentNullException(nameof(stream));
}
RequestId = (Integer32)DataFactory.CreateSnmpData(stream);
#pragma warning disable 168
Integer32 temp1 = (Integer32)DataFactory.CreateSnmpData(stream); // 0
Integer32 temp2 = (Integer32)DataFactory.CreateSnmpData(stream); // 0
#pragma warning restore 168
_varbindSection = (Sequence)DataFactory.CreateSnmpData(stream);
Variables = Variable.Transform(_varbindSection);
if (Variables.Count >= 2)
{
_time = (TimeTicks)Variables[0].Data;
Variables.RemoveAt(0);
Enterprise = (ObjectIdentifier)Variables[0].Data;
Variables.RemoveAt(0);
}
else if (Variables.Count == 0)
{
_time = new TimeTicks(0);
Enterprise = null;
}
else
{
throw new ArgumentException("Malformed inform message.", nameof(stream));
}
_length = length.Item2;
}
///
/// Gets the request ID.
///
/// The request ID.
public Integer32 RequestId { get; private set; }
///
/// Gets the error status.
///
/// The error status.
public Integer32 ErrorStatus
{
get { throw new NotSupportedException(); }
}
///
/// Gets the index of the error.
///
/// The index of the error.
public Integer32 ErrorIndex
{
get { throw new NotSupportedException(); }
}
///
/// Variables.
///
public IList Variables { get; private set; }
#region ISnmpData Members
///
/// Type code.
///
public SnmpType TypeCode
{
get { return SnmpType.InformRequestPdu; }
}
///
/// Gets the enterprise.
///
/// The enterprise.
public ObjectIdentifier Enterprise { get; private set; }
///
/// Gets the time stamp.
///
/// The time stamp.
[CLSCompliant(false)]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1702:CompoundWordsShouldBeCasedCorrectly", MessageId = "TimeStamp")]
public uint TimeStamp
{
get { return _time.ToUInt32(); }
}
///
/// Appends the bytes to .
///
/// The stream.
public void AppendBytesTo(Stream stream)
{
if (stream == null)
{
throw new ArgumentNullException(nameof(stream));
}
if (_raw == null)
{
_raw = ByteTool.ParseItems(RequestId, Integer32.Zero, Integer32.Zero, _varbindSection);
}
stream.AppendBytes(TypeCode, _length, _raw);
}
#endregion
///
/// Returns a that represents this .
///
///
public override string ToString()
{
return string.Format(
CultureInfo.InvariantCulture,
"INFORM request PDU: seq: {0}; enterprise: {1}; time stamp: {2}; variable count: {3}",
RequestId,
Enterprise,
_time,
Variables.Count.ToString(CultureInfo.InvariantCulture));
}
}
}