/*
* Copyright (c) 2011,2013 Big Switch Networks, Inc.
*
* Licensed under the Eclipse Public License, Version 1.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.eclipse.org/legal/epl-v10.html
*
* 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.
*
* This file incorporates work covered by the following copyright and
* permission notice:
*
* Originally created by David Erickson, Stanford University
*
* 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.sdnplatform.routing;
import java.util.ArrayList;
import org.sdnplatform.core.module.IPlatformService;
import org.sdnplatform.routing.Route;
public interface IRoutingService extends IPlatformService {
/**
* Provides a route between src and dst that allows tunnels. The cookie is provisioned
* for callers of getRoute to provide additional information to influence the route
* to be returned, if the underlying routing implementation supports choice among
* multiple routes.
* @param src Source switch DPID.
* @param dst Destination switch DPID.
* @param cookie cookie (usage determined by implementation; ignored by topology instance now).
*/
public Route getRoute(long src, long dst, long cookie);
/**
* Provides a route between src and dst, with option to allow or
* not allow tunnels in the path.
* @param src Source switch DPID.
* @param dst Destination switch DPID.
* @param cookie cookie (usage determined by implementation; ignored by topology instance now).
* @param tunnelEnabled boolean option.
*/
public Route getRoute(long src, long dst, long cookie, boolean tunnelEnabled);
/**
* Provides a route between srcPort on src and dstPort on dst.
* @param src Source switch DPID.
* @param srcPort Source port on source switch.
* @param dst Destination switch DPID.
* @param dstPort dstPort on Destination switch.
* @param cookie cookie (usage determined by implementation; ignored by topology instance now).
*/
public Route getRoute(long srcId, short srcPort,
long dstId, short dstPort, long cookie);
/**
* Provides a route between srcPort on src and dstPort on dst.
* @param src Source switch DPID.
* @param srcPort Source port on source switch.
* @param dst Destination switch DPID.
* @param dstPort dstPort on Destination switch.
* @param cookie cookie (usage determined by implementation; ignored by topology instance now).
* @param tunnelEnabled boolean option.
*/
public Route getRoute(long srcId, short srcPort,
long dstId, short dstPort, long cookie,
boolean tunnelEnabled);
/** return all routes, if available */
public ArrayList<Route> getRoutes(long longSrcDpid, long longDstDpid, boolean tunnelEnabled);
/** Check if a route exists between src and dst, including tunnel links
* in the path.
*/
public boolean routeExists(long src, long dst);
/** Check if a route exists between src and dst, with option to have
* or not have tunnels as part of the path.
*/
public boolean routeExists(long src, long dst, boolean tunnelEnabled);
}