Catalli's threaded switch

[sliver-openvswitch.git] / lib / ovsdb-idl-provider.h

diff --git a/lib/ovsdb-idl-provider.h b/lib/ovsdb-idl-provider.h
index 76197e8..040a699 100644 (file)
--- a/lib/ovsdb-idl-provider.h
+++ b/lib/ovsdb-idl-provider.h
@@ -1,4 +1,4 @@
-/* Copyright (c) 2009 Nicira Networks.
+/* Copyright (c) 2009, 2010 Nicira Networks.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -29,12 +29,20 @@ struct ovsdb_idl_row {
     struct list src_arcs;       /* Forward arcs (ovsdb_idl_arc.src_node). */
     struct list dst_arcs;       /* Backward arcs (ovsdb_idl_arc.dst_node). */
     struct ovsdb_idl_table *table; /* Containing table. */
-    struct ovsdb_datum *fields;    /* Row data, or null if orphaned. */
+    struct ovsdb_datum *old;    /* Committed data (null if orphaned). */
+
+    /* Transactional data. */
+    struct ovsdb_datum *new;    /* Modified data (null to delete row). */
+    unsigned long int *prereqs; /* Bitmap of columns to verify in "old". */
+    unsigned long int *written; /* Bitmap of columns from "new" to write. */
+    struct hmap_node txn_node;  /* Node in ovsdb_idl_txn's list. */
 };
 
 struct ovsdb_idl_column {
     char *name;
     struct ovsdb_type type;
+    void (*parse)(struct ovsdb_idl_row *, const struct ovsdb_datum *);
+    void (*unparse)(struct ovsdb_idl_row *);
 };
 
 struct ovsdb_idl_table_class {
@@ -42,18 +50,40 @@ struct ovsdb_idl_table_class {
     const struct ovsdb_idl_column *columns;
     size_t n_columns;
     size_t allocation_size;
-    void (*parse)(struct ovsdb_idl_row *);
-    void (*unparse)(struct ovsdb_idl_row *);
+};
+
+enum ovsdb_idl_mode {
+    /* Client reads and may write this column and wants to be alerted upon
+     * updates to it.
+     *
+     * This is the default. */
+    OVSDB_IDL_MODE_RW,
+
+    /* Client may read and write this column, but doesn't care to be alerted
+     * when it is updated.
+     *
+     * This is useful for columns that a client treats as "write-only", that
+     * is, it updates them but doesn't want to get alerted about its own
+     * updates.  It also won't be alerted about other clients' updates, so this
+     * is suitable only for use by a client that "owns" a particular column. */
+    OVSDB_IDL_MODE_WO,
+
+    /* Client won't read or write this column at all.  The IDL code can't
+     * prevent reading the column, but writing will cause assertion
+     * failures. */
+    OVSDB_IDL_MODE_NONE
 };
 
 struct ovsdb_idl_table {
     const struct ovsdb_idl_table_class *class;
+    unsigned char *modes;    /* One of OVSDB_MODE_*, indexed by column. */
     struct shash columns;    /* Contains "const struct ovsdb_idl_column *"s. */
     struct hmap rows;        /* Contains "struct ovsdb_idl_row"s. */
     struct ovsdb_idl *idl;   /* Containing idl. */
 };
 
 struct ovsdb_idl_class {
+    const char *database;       /* <db-name> for this database. */
     const struct ovsdb_idl_table_class *tables;
     size_t n_tables;
 };
@@ -63,9 +93,9 @@ struct ovsdb_idl_row *ovsdb_idl_get_row_arc(
     struct ovsdb_idl_table_class *dst_table,
     const struct uuid *dst_uuid);
 
-struct ovsdb_idl_row *ovsdb_idl_first_row(
-    const struct ovsdb_idl *, const struct ovsdb_idl_table_class *);
+void ovsdb_idl_txn_verify(const struct ovsdb_idl_row *,
+                          const struct ovsdb_idl_column *);
 
-struct ovsdb_idl_row *ovsdb_idl_next_row(const struct ovsdb_idl_row *);
+struct ovsdb_idl_txn *ovsdb_idl_txn_get(const struct ovsdb_idl_row *);
 
 #endif /* ovsdb-idl-provider.h */