org.onosproject.net.flow.TrafficSelector Maven / Gradle / Ivy
/*
* Copyright 2014-2015 Open Networking Laboratory
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.onosproject.net.flow;
import java.util.Set;
import org.onlab.packet.Ip6Address;
import org.onlab.packet.IpPrefix;
import org.onlab.packet.MacAddress;
import org.onlab.packet.MplsLabel;
import org.onlab.packet.TpPort;
import org.onlab.packet.VlanId;
import org.onosproject.net.PortNumber;
import org.onosproject.net.flow.criteria.Criterion;
/**
* Abstraction of a slice of network traffic.
*/
public interface TrafficSelector {
/**
* Returns selection criteria as an ordered list.
*
* @return list of criteria
*/
Set criteria();
/**
* Returns the selection criterion for a particular type, if it exists in
* this traffic selector.
*
* @param type criterion type to look up
* @return the criterion of the specified type if one exists, otherwise null
*/
Criterion getCriterion(Criterion.Type type);
/**
* Builder of traffic selector entities.
*/
interface Builder {
/**
* Adds a traffic selection criterion. If a same type criterion has
* already been added, it will be replaced by this one.
*
* @param criterion new criterion
* @return self
*/
Builder add(Criterion criterion);
/**
* Matches an inport.
*
* @param port the inport
* @return a selection builder
*/
Builder matchInPort(PortNumber port);
/**
* Matches a physical inport.
*
* @param port the physical inport
* @return a selection builder
*/
Builder matchInPhyPort(PortNumber port);
/**
* Matches a metadata.
*
* @param metadata the metadata
* @return a selection builder
*/
Builder matchMetadata(long metadata);
/**
* Matches a l2 dst address.
*
* @param addr a l2 address
* @return a selection builder
*/
Builder matchEthDst(MacAddress addr);
/**
* Matches a l2 src address.
*
* @param addr a l2 address
* @return a selection builder
*/
Builder matchEthSrc(MacAddress addr);
/**
* Matches the ethernet type.
*
* @param ethType an ethernet type
* @return a selection builder
*/
Builder matchEthType(short ethType);
/**
* Matches the vlan id.
*
* @param vlanId a vlan id
* @return a selection builder
*/
Builder matchVlanId(VlanId vlanId);
/**
* Matches a vlan priority.
*
* @param vlanPcp a vlan priority
* @return a selection builder
*/
Builder matchVlanPcp(byte vlanPcp);
/**
* Matches an IP DSCP (6 bits in ToS field).
*
* @param ipDscp an IP DSCP value
* @return a selection builder
*/
Builder matchIPDscp(byte ipDscp);
/**
* Matches an IP ECN (2 bits in ToS field).
*
* @param ipEcn an IP ECN value
* @return a selection builder
*/
Builder matchIPEcn(byte ipEcn);
/**
* Matches the l3 protocol.
*
* @param proto a l3 protocol
* @return a selection builder
*/
Builder matchIPProtocol(byte proto);
/**
* Matches a l3 IPv4 address.
*
* @param ip a l3 address
* @return a selection builder
*/
Builder matchIPSrc(IpPrefix ip);
/**
* Matches a l3 IPv4 address.
*
* @param ip a l3 address
* @return a selection builder
*/
Builder matchIPDst(IpPrefix ip);
/**
* Matches a TCP source port number.
*
* @param tcpPort a TCP source port number
* @return a selection builder
* @deprecated in Drake release
*/
@Deprecated
Builder matchTcpSrc(short tcpPort);
/**
* Matches a TCP source port number.
*
* @param tcpPort a TCP source port number
* @return a selection builder
*/
Builder matchTcpSrc(TpPort tcpPort);
/**
* Matches a TCP destination port number.
*
* @param tcpPort a TCP destination port number
* @return a selection builder
* @deprecated in Drake release
*/
@Deprecated
Builder matchTcpDst(short tcpPort);
/**
* Matches a TCP destination port number.
*
* @param tcpPort a TCP destination port number
* @return a selection builder
*/
Builder matchTcpDst(TpPort tcpPort);
/**
* Matches an UDP source port number.
*
* @param udpPort an UDP source port number
* @return a selection builder
* @deprecated in Drake release
*/
@Deprecated
Builder matchUdpSrc(short udpPort);
/**
* Matches an UDP source port number.
*
* @param udpPort an UDP source port number
* @return a selection builder
*/
Builder matchUdpSrc(TpPort udpPort);
/**
* Matches an UDP destination port number.
*
* @param udpPort an UDP destination port number
* @return a selection builder
* @deprecated in Drake release
*/
@Deprecated
Builder matchUdpDst(short udpPort);
/**
* Matches an UDP destination port number.
*
* @param udpPort an UDP destination port number
* @return a selection builder
*/
Builder matchUdpDst(TpPort udpPort);
/**
* Matches a SCTP source port number.
*
* @param sctpPort a SCTP source port number
* @return a selection builder
* @deprecated in Drake release
*/
@Deprecated
Builder matchSctpSrc(short sctpPort);
/**
* Matches a SCTP source port number.
*
* @param sctpPort a SCTP source port number
* @return a selection builder
*/
Builder matchSctpSrc(TpPort sctpPort);
/**
* Matches a SCTP destination port number.
*
* @param sctpPort a SCTP destination port number
* @return a selection builder
* @deprecated in Drake release
*/
@Deprecated
Builder matchSctpDst(short sctpPort);
/**
* Matches a SCTP destination port number.
*
* @param sctpPort a SCTP destination port number
* @return a selection builder
*/
Builder matchSctpDst(TpPort sctpPort);
/**
* Matches an ICMP type.
*
* @param icmpType an ICMP type
* @return a selection builder
*/
Builder matchIcmpType(byte icmpType);
/**
* Matches an ICMP code.
*
* @param icmpCode an ICMP code
* @return a selection builder
*/
Builder matchIcmpCode(byte icmpCode);
/**
* Matches a l3 IPv6 address.
*
* @param ip a l3 IPv6 address
* @return a selection builder
*/
Builder matchIPv6Src(IpPrefix ip);
/**
* Matches a l3 IPv6 address.
*
* @param ip a l3 IPv6 address
* @return a selection builder
*/
Builder matchIPv6Dst(IpPrefix ip);
/**
* Matches an IPv6 flow label.
*
* @param flowLabel an IPv6 flow label
* @return a selection builder
*/
Builder matchIPv6FlowLabel(int flowLabel);
/**
* Matches an ICMPv6 type.
*
* @param icmpv6Type an ICMPv6 type
* @return a selection builder
*/
Builder matchIcmpv6Type(byte icmpv6Type);
/**
* Matches an ICMPv6 code.
*
* @param icmpv6Code an ICMPv6 code
* @return a selection builder
*/
Builder matchIcmpv6Code(byte icmpv6Code);
/**
* Matches an IPv6 Neighbor Discovery target address.
*
* @param targetAddress an IPv6 Neighbor Discovery target address
* @return a selection builder
*/
Builder matchIPv6NDTargetAddress(Ip6Address targetAddress);
/**
* Matches an IPv6 Neighbor Discovery source link-layer address.
*
* @param mac an IPv6 Neighbor Discovery source link-layer address
* @return a selection builder
*/
Builder matchIPv6NDSourceLinkLayerAddress(MacAddress mac);
/**
* Matches an IPv6 Neighbor Discovery target link-layer address.
*
* @param mac an IPv6 Neighbor Discovery target link-layer address
* @return a selection builder
*/
Builder matchIPv6NDTargetLinkLayerAddress(MacAddress mac);
/**
* Matches on a MPLS label.
*
* @param mplsLabel a MPLS label.
* @return a selection builder
*/
Builder matchMplsLabel(MplsLabel mplsLabel);
/**
* Matches on a MPLS Bottom-of-Stack indicator bit.
*
* @param mplsBos boolean value indicating BOS=1 (true) or BOS=0 (false).
* @return a selection builder
*/
Builder matchMplsBos(boolean mplsBos);
/**
* Matches a tunnel id.
*
* @param tunnelId a tunnel id
* @return a selection builder
*/
Builder matchTunnelId(long tunnelId);
/**
* Matches on IPv6 Extension Header pseudo-field flags.
*
* @param exthdrFlags the IPv6 Extension Header pseudo-field flags
* @return a selection builder
*/
Builder matchIPv6ExthdrFlags(short exthdrFlags);
/**
* Matches an optical signal ID or lambda.
*
* @param lambda lambda
* @return a selection builder
* @deprecated in Cardinal Release.
* Use {@link #add(Criterion)} with an instance created
* by {@link org.onosproject.net.flow.criteria.Criteria#matchLambda(org.onosproject.net.Lambda)}.
*/
@Deprecated
Builder matchLambda(short lambda);
/**
* Matches an optical Signal Type.
*
* @param signalType signalType
* @return a selection builder
* @deprecated in Cardinal Release.
* Use {@link #add(Criterion)}} with an instance created
* by {@link org.onosproject.net.flow.criteria.Criteria#matchOchSignalType(org.onosproject.net.OchSignalType)}.
*/
@Deprecated
Builder matchOpticalSignalType(short signalType);
/**
* Builds an immutable traffic selector.
*
* @return traffic selector
*/
TrafficSelector build();
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy