Updated files.

[tinyos-2.x.git] / tos / lib / net / UnicastNameFreeRouting.nc

diff --git a/tos/lib/net/UnicastNameFreeRouting.nc b/tos/lib/net/UnicastNameFreeRouting.nc
new file mode 100644 (file)
index 0000000..db21a29
--- /dev/null
+++ b/tos/lib/net/UnicastNameFreeRouting.nc
@@ -0,0 +1,54 @@
+/* $Id$ */
+/*
+ * "Copyright (c) 2006 The Regents of the University  of California.  
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * - Redistributions of source code must retain the above copyright.
+ *   notice, this list of conditions and the following disclaimer.
+ * - Redistributions in binary form must reproduce the above copyright
+ *   notice, this list of conditions and the following disclaimer in the
+ *   documentation and/or other materials provided with the
+ *   distribution.
+ * - Neither the name of the University of California nor
+ *   the names of its contributors may be used to endorse or promote
+ *   products derived from this software without specific prior written
+ *   permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
+ * REGENTS OF THE UNVERSITY OF CALIFORNIA OR ITS CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
+ * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+ * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+ * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
+ * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
+ * DAMAGE.
+ */
+
+/**
+ *  Provides a single next hop on a name-free protocol.
+ *
+ *  @author Philip Levis
+ *  @date   $Date$
+ */
+interface UnicastNameFreeRouting {
+
+  /**
+   * Get the address of the best next hop set to the destination.
+   * If there is not best next hop, the address is the local address.
+   * @return : The next best hop, or the local address if there is no route.
+   */
+  command am_addr_t nextHop();
+  command bool hasRoute();
+  
+  event void routeFound();
+  event void noRoute();
+}
+