ovsdb-idl: Fix atomicity of writes that don't change a column's value.
[sliver-openvswitch.git] / lib / ovsdb-idl-provider.h
1 /* Copyright (c) 2009, 2010, 2011 Nicira Networks.
2  *
3  * Licensed under the Apache License, Version 2.0 (the "License");
4  * you may not use this file except in compliance with the License.
5  * You may obtain a copy of the License at:
6  *
7  *     http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software
10  * distributed under the License is distributed on an "AS IS" BASIS,
11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12  * See the License for the specific language governing permissions and
13  * limitations under the License.
14  */
15
16 #ifndef OVSDB_IDL_PROVIDER_H
17 #define OVSDB_IDL_PROVIDER_H 1
18
19 #include "hmap.h"
20 #include "list.h"
21 #include "ovsdb-idl.h"
22 #include "ovsdb-types.h"
23 #include "shash.h"
24 #include "uuid.h"
25
26 struct ovsdb_idl_row {
27     struct hmap_node hmap_node; /* In struct ovsdb_idl_table's 'rows'. */
28     struct uuid uuid;           /* Row "_uuid" field. */
29     struct list src_arcs;       /* Forward arcs (ovsdb_idl_arc.src_node). */
30     struct list dst_arcs;       /* Backward arcs (ovsdb_idl_arc.dst_node). */
31     struct ovsdb_idl_table *table; /* Containing table. */
32     struct ovsdb_datum *old;    /* Committed data (null if orphaned). */
33
34     /* Transactional data. */
35     struct ovsdb_datum *new;    /* Modified data (null to delete row). */
36     unsigned long int *prereqs; /* Bitmap of columns to verify in "old". */
37     unsigned long int *written; /* Bitmap of columns from "new" to write. */
38     struct hmap_node txn_node;  /* Node in ovsdb_idl_txn's list. */
39 };
40
41 struct ovsdb_idl_column {
42     char *name;
43     struct ovsdb_type type;
44     void (*parse)(struct ovsdb_idl_row *, const struct ovsdb_datum *);
45     void (*unparse)(struct ovsdb_idl_row *);
46 };
47
48 struct ovsdb_idl_table_class {
49     char *name;
50     bool is_root;
51     const struct ovsdb_idl_column *columns;
52     size_t n_columns;
53     size_t allocation_size;
54 };
55
56 struct ovsdb_idl_table {
57     const struct ovsdb_idl_table_class *class;
58     unsigned char *modes;    /* OVSDB_IDL_* bitmasks, indexed by column. */
59     bool need_table;         /* Monitor table even if no columns? */
60     struct shash columns;    /* Contains "const struct ovsdb_idl_column *"s. */
61     struct hmap rows;        /* Contains "struct ovsdb_idl_row"s. */
62     struct ovsdb_idl *idl;   /* Containing idl. */
63 };
64
65 struct ovsdb_idl_class {
66     const char *database;       /* <db-name> for this database. */
67     const struct ovsdb_idl_table_class *tables;
68     size_t n_tables;
69 };
70
71 struct ovsdb_idl_row *ovsdb_idl_get_row_arc(
72     struct ovsdb_idl_row *src,
73     struct ovsdb_idl_table_class *dst_table,
74     const struct uuid *dst_uuid);
75
76 void ovsdb_idl_txn_verify(const struct ovsdb_idl_row *,
77                           const struct ovsdb_idl_column *);
78
79 struct ovsdb_idl_txn *ovsdb_idl_txn_get(const struct ovsdb_idl_row *);
80
81 #endif /* ovsdb-idl-provider.h */