at.jku.fim.rubanetra.protocol.handler

Class KrakenEthernetProtocolHandler

java.lang.Object

at.jku.fim.rubanetra.protocol.KrakenBaseProtocol

at.jku.fim.rubanetra.protocol.handler.KrakenEthernetProtocolHandler

All Implemented Interfaces:

BaseProtocol

public class KrakenEthernetProtocolHandler
extends KrakenBaseProtocol

The Kraken network layer 2 decoder EthernetDecoder is used by this handler in order to create and deliver EthernetActivity instances. Furthermore, several bindings have been implemented, i.e.:

• -> KrakenIpv4Handler
• -> KrakenIpv6Handler
• -> KrakenArpHandler

Field Summary

Fields

Modifier and Type	Field and Description
static ProtocolId	krakenEthernetProtocolId
static String	PROPERTY_NEW_ETHERNET_ACTIVITY

Fields inherited from class at.jku.fim.rubanetra.protocol.KrakenBaseProtocol

BINDING_METHOD_NAME, propertyChangeSupport, protocolSetting

Constructor Summary

Constructors

Constructor and Description
KrakenEthernetProtocolHandler()

Method Summary

Modifier and Type	Method and Description
void	bind(KrakenArpHandler arpHandler) Bind the internal EthernetDecoder to an ARP decoder, i.e.
void	bind(KrakenIpv4Handler ipv4Protocol) Bind the internal EthernetDecoder to an IPv4 decoder, i.e.
void	bind(KrakenIpv6Handler ipv6Handler) Bind the internal EthernetDecoder to an IPv6 decoder, i.e.
void	decodePcapPacket(PcapActivity pcapActivity) Takes a Pcap entry and tries to decode the payload as an Ethernet frame using a EthernetDecoder and a suitable Pcap wrapper PcapPacketToKrakenPcapPacketAdapter.
org.krakenapps.pcap.decoder.ethernet.EthernetDecoder	getKrakenEthernetDecoder()
ProtocolId	getProtocolId() An arbitrary identifier for the protocol(s) this decoder should be able to parse and decode.
void	initialize(KrakenProtocolConfiguration setting) Initializes this protocol decoder with the information provided by the user.

Methods inherited from class at.jku.fim.rubanetra.protocol.KrakenBaseProtocol

addPropertyChangeListener, addPropertyChangeListener, bind, findProtocolBindingMethod, getCurrentPcapActivity, getPcapHandler, getProtocolConfiguration, removePropertyChangeListener, removePropertyChangeListener

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

krakenEthernetProtocolId

public static final ProtocolId krakenEthernetProtocolId

PROPERTY_NEW_ETHERNET_ACTIVITY

public static final String PROPERTY_NEW_ETHERNET_ACTIVITY

See Also:

Constant Field Values

Constructor Detail

KrakenEthernetProtocolHandler

public KrakenEthernetProtocolHandler()

Method Detail

getProtocolId

public ProtocolId getProtocolId()

Description copied from interface: BaseProtocol

An arbitrary identifier for the protocol(s) this decoder should be able to parse and decode. This identifier must be unique and may not be reused multiple times inside this framework for multiple decoders, even if the same protocol can be decoded by multiple implementations.

Returns:

a unique identifier used to represent the decoding capabilities of this decoder

initialize

public void initialize(KrakenProtocolConfiguration setting)

Description copied from class: KrakenBaseProtocol

Initializes this protocol decoder with the information provided by the user. This method will be called once by KrakenProtocolConfigurationBuilderImpl before the bindings are processed. This method should be called exactly once, multiple calls will result in an exception being thrown.

Overrides:

initialize in class KrakenBaseProtocol

Parameters:

setting - the protocol configuration provided by the user

bind

public void bind(KrakenIpv4Handler ipv4Protocol)

Bind the internal EthernetDecoder to an IPv4 decoder, i.e. a decoder that shall receive all decoded Ethernet frames.

Parameters:

ipv4Protocol - the IPv4 decoder to bind to

Throws:

IllegalArgumentException - if the parameter is a null pointer

bind

public void bind(KrakenIpv6Handler ipv6Handler)

Bind the internal EthernetDecoder to an IPv6 decoder, i.e. a decoder that shall receive all decoded Ethernet frames.

Parameters:

ipv6Handler - the IPv6 decoder to bind to

Throws:

IllegalArgumentException - if the parameter is a null pointer

bind

public void bind(KrakenArpHandler arpHandler)

Bind the internal EthernetDecoder to an ARP decoder, i.e. a decoder that shall receive all decoded Ethernet frames.

Parameters:

arpHandler - the ARP decoder to bind to

Throws:

IllegalArgumentException - if the parameter is a null pointer

decodePcapPacket

public void decodePcapPacket(PcapActivity pcapActivity)

Takes a Pcap entry and tries to decode the payload as an Ethernet frame using a EthernetDecoder and a suitable Pcap wrapper PcapPacketToKrakenPcapPacketAdapter.

Parameters:

pcapActivity - the Pcap entry whose payload is to be decoded as an Ethernet frame

Throws:

NullPointerException - if pcapActivity is a null pointer

getKrakenEthernetDecoder

public org.krakenapps.pcap.decoder.ethernet.EthernetDecoder getKrakenEthernetDecoder()

Returns:

the Ethernet decoder used internally