// 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)); } } }