| /* |
| * 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 org.onlab.packet.IpAddress; |
| import org.onlab.packet.MacAddress; |
| import org.onlab.packet.MplsLabel; |
| import org.onlab.packet.VlanId; |
| import org.onosproject.core.GroupId; |
| import org.onosproject.net.PortNumber; |
| import org.onosproject.net.flow.instructions.Instruction; |
| import org.onosproject.net.flow.instructions.Instructions; |
| |
| import java.util.List; |
| |
| /** |
| * Abstraction of network traffic treatment. |
| */ |
| public interface TrafficTreatment { |
| |
| /** |
| * Returns the list of treatment instructions that will be applied |
| * further down the pipeline. |
| * @return list of treatment instructions |
| */ |
| List<Instruction> deferred(); |
| |
| /** |
| * Returns the list of treatment instructions that will be applied |
| * immediately. |
| * @return list of treatment instructions |
| */ |
| List<Instruction> immediate(); |
| |
| /** |
| * Returns the list of all instructions in the treatment, both immediate and |
| * deferred. |
| * |
| * @return list of treatment instructions |
| */ |
| List<Instruction> allInstructions(); |
| |
| /** |
| * Returns the next table in the pipeline. |
| * @return a table transition; may be null. |
| */ |
| Instructions.TableTypeTransition tableTransition(); |
| |
| /** |
| * Whether the deferred treatment instructions will be cleared |
| * by the device. |
| * @return a boolean |
| */ |
| boolean clearedDeferred(); |
| |
| /** |
| * Builder of traffic treatment entities. |
| */ |
| interface Builder { |
| |
| /** |
| * Adds an instruction to the builder. |
| * |
| * @param instruction an instruction |
| * @return a treatment builder |
| */ |
| Builder add(Instruction instruction); |
| |
| /** |
| * Adds a drop instruction. |
| * |
| * @return a treatment builder |
| */ |
| Builder drop(); |
| |
| /** |
| * Adds a punt-to-controller instruction. |
| * |
| * @return a treatment builder |
| */ |
| Builder punt(); |
| |
| /** |
| * Set the output port. |
| * |
| * @param number the out port |
| * @return a treatment builder |
| */ |
| Builder setOutput(PortNumber number); |
| |
| /** |
| * Sets the src l2 address. |
| * |
| * @param addr a macaddress |
| * @return a treatment builder |
| */ |
| Builder setEthSrc(MacAddress addr); |
| |
| /** |
| * Sets the dst l2 address. |
| * |
| * @param addr a macaddress |
| * @return a treatment builder |
| */ |
| Builder setEthDst(MacAddress addr); |
| |
| /** |
| * Sets the vlan id. |
| * |
| * @param id a vlanid |
| * @return a treatment builder |
| */ |
| Builder setVlanId(VlanId id); |
| |
| /** |
| * Sets the vlan priority. |
| * |
| * @param pcp a vlan priority |
| * @return a treatment builder |
| */ |
| Builder setVlanPcp(Byte pcp); |
| |
| /** |
| * Sets the src l3 address. |
| * |
| * @param addr an ip |
| * @return a treatment builder |
| */ |
| Builder setIpSrc(IpAddress addr); |
| |
| /** |
| * Sets the dst l3 address. |
| * |
| * @param addr an ip |
| * @return a treatment builder |
| */ |
| Builder setIpDst(IpAddress addr); |
| |
| /** |
| * Decrement the TTL in IP header by one. |
| * |
| * @return a treatment builder |
| */ |
| Builder decNwTtl(); |
| |
| /** |
| * Copy the TTL to outer protocol layer. |
| * |
| * @return a treatment builder |
| */ |
| Builder copyTtlOut(); |
| |
| /** |
| * Copy the TTL to inner protocol layer. |
| * |
| * @return a treatment builder |
| */ |
| Builder copyTtlIn(); |
| |
| /** |
| * Push MPLS ether type. |
| * |
| * @return a treatment builder. |
| */ |
| Builder pushMpls(); |
| |
| /** |
| * Pops MPLS ether type. |
| * |
| * @return a treatment builder. |
| */ |
| Builder popMpls(); |
| |
| /** |
| * Pops MPLS ether type and set the new ethertype. |
| * |
| * @param etherType an ether type |
| * @return a treatment builder. |
| */ |
| Builder popMpls(int etherType); |
| |
| /** |
| * Sets the mpls label. |
| * |
| * @param mplsLabel MPLS label. |
| * @return a treatment builder. |
| */ |
| Builder setMpls(MplsLabel mplsLabel); |
| |
| /** |
| * Decrement MPLS TTL. |
| * |
| * @return a treatment builder |
| */ |
| Builder decMplsTtl(); |
| |
| /** |
| * Sets the optical channel ID or lambda. |
| * |
| * @param lambda optical channel ID |
| * @return a treatment builder |
| */ |
| Builder setLambda(short lambda); |
| |
| /** |
| * Sets the group ID. |
| * |
| * @param groupId group ID |
| * @return a treatment builder |
| */ |
| Builder group(GroupId groupId); |
| |
| |
| /** |
| * Sets the next table type to transition to. |
| * |
| * @param type the table type |
| * @return a treatement builder |
| */ |
| @Deprecated |
| Builder transition(FlowRule.Type type); |
| |
| /** |
| * Sets the next table id to transition to. |
| * |
| * @param tableId the table table |
| * @return a treatement builder |
| */ |
| Builder transition(Integer tableId); |
| |
| |
| /** |
| * Pops outermost VLAN tag. |
| * |
| * @return a treatment builder. |
| */ |
| Builder popVlan(); |
| |
| /** |
| * Pushes a new VLAN tag. |
| * |
| * @return a treatment builder. |
| */ |
| Builder pushVlan(); |
| |
| /** |
| * Any instructions preceded by this method call will be deferred. |
| * @return a treatment builder |
| */ |
| Builder deferred(); |
| |
| /** |
| * Any instructions preceded by this method call will be immediate. |
| * @return a treatment builder |
| */ |
| Builder immediate(); |
| |
| |
| /** |
| * Instructs the device to clear the deferred instructions set. |
| * @return a treatment builder |
| */ |
| Builder wipeDeferred(); |
| |
| /** |
| * Builds an immutable traffic treatment descriptor. |
| * <p> |
| * If the treatment is empty when build() is called, it will add a default |
| * drop rule automatically. For a treatment that is actually empty, use |
| * {@link org.onosproject.net.flow.DefaultTrafficTreatment#emptyTreatment}. |
| * </p> |
| * |
| * @return traffic treatment |
| */ |
| TrafficTreatment build(); |
| } |
| } |