Adding packaging script.
Added display of raw DPID and IPs or MACs for hosts.
diff --git a/core/api/src/main/java/org/onlab/onos/net/flow/FlowRuleService.java b/core/api/src/main/java/org/onlab/onos/net/flow/FlowRuleService.java
index 724051f..85d5680 100644
--- a/core/api/src/main/java/org/onlab/onos/net/flow/FlowRuleService.java
+++ b/core/api/src/main/java/org/onlab/onos/net/flow/FlowRuleService.java
@@ -4,12 +4,17 @@
/**
* Service for injecting flow rules into the environment and for obtaining
- * information about flow rules already in the environment.
+ * information about flow rules already in the environment. This implements
+ * semantics of a distributed authoritative flow table where the master copy
+ * of the flow rules lies with the controller and the devices hold only the
+ * 'cached' copy.
*/
public interface FlowRuleService {
/**
* Returns the collection of flow entries applied on the specified device.
+ * This will include flow rules which may not yet have been applied to
+ * the device.
*
* @param deviceId device identifier
* @return collection of flow rules
@@ -17,7 +22,9 @@
Iterable<FlowEntry> getFlowEntries(DeviceId deviceId);
/**
- * Applies the specified flow rules onto their respective devices.
+ * Applies the specified flow rules onto their respective devices. These
+ * flow rules will be retained by the system and re-applied anytime the
+ * device reconnects to the controller.
*
* @param flowRules one or more flow rules
* throws SomeKindOfException that indicates which ones were applied and
@@ -26,7 +33,9 @@
void applyFlowRules(FlowRule... flowRules);
/**
- * Removes the specified flow rules from their respective devices.
+ * Removes the specified flow rules from their respective devices. If the
+ * device is not presently connected to the controller, these flow will
+ * be removed once the device reconnects.
*
* @param flowRules one or more flow rules
* throws SomeKindOfException that indicates which ones were removed and
@@ -34,6 +43,10 @@
*/
void removeFlowRules(FlowRule... flowRules);
+
+ // void addInitialFlowContributor(InitialFlowContributor contributor);
+ // void removeInitialFlowContributor(InitialFlowContributor contributor);
+
/**
* Adds the specified flow rule listener.
*