/*
This file is part of PacketDotNet
PacketDotNet is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
PacketDotNet is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with PacketDotNet. If not, see .
*/
/*
* Copyright 2010 Evan Plaice
* Copyright 2010 Chris Morgan
*/
using System;
using System.Collections;
using System.Collections.Generic;
using System.Net;
using System.Net.NetworkInformation;
using System.Text;
using System.Text.RegularExpressions;
using MiscUtil.Conversion;
using PacketDotNet.Utils;
using PacketDotNet.LLDP;
namespace PacketDotNet
{
///
/// A LLDP packet.
/// As specified in IEEE Std 802.1AB
///
///
/// See http://en.wikipedia.org/wiki/Link_Layer_Discovery_Protocol for general info
/// See IETF 802.1AB for the full specification
///
public class LLDPPacket : InternetLinkLayerPacket, IEnumerable
{
// NOTE: No need to warn about lack of use, the compiler won't
// put any calls to 'log' here but we need 'log' to exist to compile
#pragma warning disable 0169, 0649
private static readonly ILogInactive log;
#pragma warning restore 0169, 0649
#region Constructors
///
/// Create an empty LLDPPacket
///
public LLDPPacket()
{
log.Debug("");
// all lldp packets end with an EndOfLLDPDU tlv so add one
// by default
TlvCollection.Add(new EndOfLLDPDU());
}
///
/// Constructor
///
///
/// A
///
public LLDPPacket(ByteArraySegment bas)
{
log.Debug("");
header = new ByteArraySegment(bas);
// Initiate the TLV list from the existing data
ParseByteArrayIntoTlvs(header.Bytes, header.Offset);
}
#endregion
#region Properties
///
/// The current length of the LLDPDU
///
public int Length
{
get { return _Length; }
set { _Length = value; }
}
///
/// LLDPPacket specific implementation of BytesHighPerformance
/// Necessary because each TLV in the collection may have a
/// byte[] that is not shared by other TLVs
///
/// NOTE: There is potential for the same performance improvement that
/// the Packet class uses where we check to see if each TLVs uses the
/// same byte[] and that there are no gaps.
///
public override ByteArraySegment BytesHighPerformance
{
get
{
var ms = new System.IO.MemoryStream();
foreach(var tlv in TlvCollection)
{
var tlvBytes = tlv.Bytes;
ms.Write(tlvBytes, 0, tlvBytes.Length);
}
var offset = 0;
var msArray = ms.ToArray();
return new ByteArraySegment(msArray, offset, msArray.Length);
}
}
///
/// Allows access of the TlvCollection by index
///
/// The index of the item being set/retrieved in the collection
/// The requested TLV
public TLV this[int index]
{
get { return TlvCollection[index]; }
set { TlvCollection[index] = value; }
}
///
/// Enables foreach functionality for this class
///
/// The next item in the list
public IEnumerator GetEnumerator()
{
return TlvCollection.GetEnumerator();
}
#endregion
#region Methods
///
/// Parse byte[] into TLVs
///
public void ParseByteArrayIntoTlvs(byte[] bytes, int offset)
{
log.DebugFormat("bytes.Length {0}, offset {1}", bytes.Length, offset);
int position = 0;
TlvCollection.Clear();
while(position < bytes.Length)
{
// The payload type
var byteArraySegment = new ByteArraySegment(bytes, offset + position, TLVTypeLength.TypeLengthLength);
var typeLength = new TLVTypeLength(byteArraySegment);
// create a TLV based on the type and
// add it to the collection
TLV currentTlv = TLVFactory(bytes, offset + position, typeLength.Type);
if (currentTlv == null)
{
log.Debug("currentTlv == null");
break;
}
log.DebugFormat("Adding tlv {0}, Type {1}",
currentTlv.GetType(), currentTlv.Type);
TlvCollection.Add(currentTlv);
// stop at the first end tlv we run into
if(currentTlv is EndOfLLDPDU)
{
break;
}
// Increment the position to seek the next TLV
position += (currentTlv.TotalLength);
}
log.DebugFormat("Done, position {0}", position);
}
///
///
///
///
/// A
///
///
/// A
///
///
/// A
///
///
/// A
///
private static TLV TLVFactory(byte[] Bytes, int offset, TLVTypes type)
{
switch(type)
{
case TLVTypes.ChassisID:
return new ChassisID(Bytes, offset);
case TLVTypes.PortID:
return new PortID(Bytes, offset);
case TLVTypes.TimeToLive:
return new TimeToLive(Bytes, offset);
case TLVTypes.PortDescription:
return new PortDescription(Bytes, offset);
case TLVTypes.SystemName:
return new SystemName(Bytes, offset);
case TLVTypes.SystemDescription:
return new SystemDescription(Bytes, offset);
case TLVTypes.SystemCapabilities:
return new SystemCapabilities(Bytes, offset);
case TLVTypes.ManagementAddress:
return new ManagementAddress(Bytes, offset);
case TLVTypes.OrganizationSpecific:
return new OrganizationSpecific(Bytes, offset);
case TLVTypes.EndOfLLDPU:
return new EndOfLLDPDU(Bytes, offset);
default:
throw new ArgumentOutOfRangeException();
}
}
///
/// Returns the LLDP inside of the Packet p or null if
/// there is no encapsulated packet
///
///
/// A
///
///
/// A
///
[Obsolete("Use Packet.Extract() instead")]
public static LLDPPacket GetEncapsulated(Packet p)
{
log.Debug("");
if(p is InternetLinkLayerPacket)
{
var payload = InternetLinkLayerPacket.GetInnerPayload((InternetLinkLayerPacket)p);
if(payload is LLDPPacket)
{
return (LLDPPacket)payload;
}
}
return null;
}
///
/// Create a randomized LLDP packet with some basic TLVs
///
///
/// A
///
public static LLDPPacket RandomPacket()
{
var rnd = new Random();
var lldpPacket = new LLDPPacket();
byte[] physicalAddressBytes = new byte[EthernetFields.MacAddressLength];
rnd.NextBytes(physicalAddressBytes);
var physicalAddress = new PhysicalAddress(physicalAddressBytes);
lldpPacket.TlvCollection.Add(new ChassisID(physicalAddress));
byte[] networkAddress = new byte[IPv4Fields.AddressLength];
rnd.NextBytes(networkAddress);
lldpPacket.TlvCollection.Add(new PortID(new NetworkAddress(new IPAddress(networkAddress))));
ushort seconds = (ushort)rnd.Next(0,120);
lldpPacket.TlvCollection.Add(new TimeToLive(seconds));
lldpPacket.TlvCollection.Add(new EndOfLLDPDU());
return lldpPacket;
}
///
public override string ToString(StringOutputType outputFormat)
{
var buffer = new StringBuilder();
string color = "";
string colorEscape = "";
if(outputFormat == StringOutputType.Colored || outputFormat == StringOutputType.VerboseColored)
{
color = Color;
colorEscape = AnsiEscapeSequences.Reset;
}
if(outputFormat == StringOutputType.Normal || outputFormat == StringOutputType.Colored)
{
// build the string of tlvs
string tlvs = "{";
var r = new Regex(@"[^(\.)]([^\.]*)$");
foreach(TLV tlv in TlvCollection)
{
// regex trim the parent namespaces from the class type
// (ex. "PacketDotNet.LLDP.TimeToLive" becomes "TimeToLive")
var m = r.Match(tlv.GetType().ToString());
tlvs += m.Groups[0].Value + "|";
}
tlvs = tlvs.TrimEnd('|');
tlvs += "}";
// build the output string
buffer.AppendFormat("{0}[LLDPPacket: TLVs={2}]{1}",
color,
colorEscape,
tlvs);
}
if(outputFormat == StringOutputType.Verbose || outputFormat == StringOutputType.VerboseColored)
{
// build the output string
buffer.AppendLine("LLDP: ******* LLDP - \"Link Layer Discovery Protocol\" - offset=? length=" + TotalPacketLength);
buffer.AppendLine("LLDP:");
foreach(var tlv in TlvCollection)
{
buffer.AppendLine("LLDP:" + tlv.ToString());
}
buffer.AppendLine("LLDP:");
}
// append the base string output
buffer.Append(base.ToString(outputFormat));
return buffer.ToString();
}
#endregion
#region Members
///
/// Contains the TLV's in the LLDPDU
///
public TLVCollection TlvCollection = new TLVCollection();
int _Length;
#endregion
}
}