1 /* Copyright (c) 2009 Nicira Networks
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:
7 * http://www.apache.org/licenses/LICENSE-2.0
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.
18 #include "transaction.h"
22 #include "dynamic-string.h"
26 #include "ovsdb-error.h"
34 struct hmap txn_tables; /* Contains "struct ovsdb_txn_table"s. */
38 /* A table modified by a transaction. */
39 struct ovsdb_txn_table {
40 struct hmap_node hmap_node; /* Element in ovsdb_txn's txn_tables hmap. */
41 struct ovsdb_table *table;
42 struct hmap txn_rows; /* Contains "struct ovsdb_txn_row"s. */
45 /* A row modified by the transaction:
47 * - A row added by a transaction will have null 'old' and non-null 'new'.
49 * - A row deleted by a transaction will have non-null 'old' and null
52 * - A row modified by a transaction will have non-null 'old' and 'new'.
54 * - 'old' and 'new' both null is invalid. It would indicate that a row
55 * was added then deleted within a single transaction, but we instead
56 * handle that case by deleting the txn_row entirely.
58 struct ovsdb_txn_row {
59 struct hmap_node hmap_node; /* In ovsdb_txn_table's txn_rows hmap. */
60 struct ovsdb_row *old; /* The old row. */
61 struct ovsdb_row *new; /* The new row. */
65 ovsdb_txn_create(struct ovsdb *db)
67 struct ovsdb_txn *txn = xmalloc(sizeof *txn);
69 hmap_init(&txn->txn_tables);
70 ds_init(&txn->comment);
75 ovsdb_txn_destroy(struct ovsdb_txn *txn, void (*cb)(struct ovsdb_txn_row *))
77 struct ovsdb_txn_table *txn_table, *next_txn_table;
79 HMAP_FOR_EACH_SAFE (txn_table, next_txn_table,
80 struct ovsdb_txn_table, hmap_node, &txn->txn_tables)
82 struct ovsdb_txn_row *txn_row, *next_txn_row;
84 HMAP_FOR_EACH_SAFE (txn_row, next_txn_row,
85 struct ovsdb_txn_row, hmap_node,
89 txn_row->old->txn_row = NULL;
92 txn_row->new->txn_row = NULL;
98 hmap_destroy(&txn_table->txn_rows);
101 hmap_destroy(&txn->txn_tables);
102 ds_destroy(&txn->comment);
107 ovsdb_txn_row_abort(struct ovsdb_txn_row *txn_row)
109 struct ovsdb_row *old = txn_row->old;
110 struct ovsdb_row *new = txn_row->new;
113 hmap_remove(&new->table->rows, &new->hmap_node);
115 hmap_insert(&old->table->rows, &old->hmap_node, ovsdb_row_hash(old));
117 hmap_replace(&new->table->rows, &new->hmap_node, &old->hmap_node);
119 ovsdb_row_destroy(new);
123 ovsdb_txn_abort(struct ovsdb_txn *txn)
125 ovsdb_txn_destroy(txn, ovsdb_txn_row_abort);
129 ovsdb_txn_row_commit(struct ovsdb_txn_row *txn_row)
131 ovsdb_row_destroy(txn_row->old);
135 ovsdb_txn_commit(struct ovsdb_txn *txn, bool durable)
137 struct ovsdb_replica *replica;
138 struct ovsdb_error *error;
140 LIST_FOR_EACH (replica, struct ovsdb_replica, node, &txn->db->replicas) {
141 error = (replica->class->commit)(replica, txn, durable);
143 /* We don't support two-phase commit so only the first replica is
144 * allowed to report an error. */
145 assert(&replica->node == txn->db->replicas.next);
147 ovsdb_txn_abort(txn);
152 txn->db->run_triggers = true;
153 ovsdb_txn_destroy(txn, ovsdb_txn_row_commit);
158 ovsdb_txn_for_each_change(const struct ovsdb_txn *txn,
159 ovsdb_txn_row_cb_func *cb, void *aux)
161 struct ovsdb_txn_table *t;
162 struct ovsdb_txn_row *r;
164 HMAP_FOR_EACH (t, struct ovsdb_txn_table, hmap_node, &txn->txn_tables) {
165 HMAP_FOR_EACH (r, struct ovsdb_txn_row, hmap_node, &t->txn_rows) {
166 if (!cb(r->old, r->new, aux)) {
173 static struct ovsdb_txn_table *
174 ovsdb_txn_get_txn_table__(struct ovsdb_txn *txn,
175 const struct ovsdb_table *table,
178 struct ovsdb_txn_table *txn_table;
180 HMAP_FOR_EACH_IN_BUCKET (txn_table, struct ovsdb_txn_table, hmap_node,
181 hash, &txn->txn_tables) {
182 if (txn_table->table == table) {
190 static struct ovsdb_txn_table *
191 ovsdb_txn_get_txn_table(struct ovsdb_txn *txn, const struct ovsdb_table *table)
193 return ovsdb_txn_get_txn_table__(txn, table, hash_pointer(table, 0));
196 static struct ovsdb_txn_table *
197 ovsdb_txn_create_txn_table(struct ovsdb_txn *txn,
198 struct ovsdb_table *table)
200 uint32_t hash = hash_pointer(table, 0);
201 struct ovsdb_txn_table *txn_table;
203 txn_table = ovsdb_txn_get_txn_table__(txn, table, hash);
205 txn_table = xmalloc(sizeof *txn_table);
206 txn_table->table = table;
207 hmap_init(&txn_table->txn_rows);
208 hmap_insert(&txn->txn_tables, &txn_table->hmap_node, hash);
213 static struct ovsdb_txn_row *
214 ovsdb_txn_row_create(struct ovsdb_txn_table *txn_table,
215 const struct ovsdb_row *old, struct ovsdb_row *new)
217 uint32_t hash = ovsdb_row_hash(old ? old : new);
218 struct ovsdb_txn_row *txn_row;
220 txn_row = xmalloc(sizeof *txn_row);
221 txn_row->old = (struct ovsdb_row *) old;
223 hmap_insert(&txn_table->txn_rows, &txn_row->hmap_node, hash);
229 ovsdb_txn_row_modify(struct ovsdb_txn *txn, const struct ovsdb_row *ro_row_)
231 struct ovsdb_row *ro_row = (struct ovsdb_row *) ro_row_;
233 if (ro_row->txn_row) {
234 assert(ro_row == ro_row->txn_row->new);
237 struct ovsdb_table *table = ro_row->table;
238 struct ovsdb_txn_table *txn_table;
239 struct ovsdb_row *rw_row;
241 txn_table = ovsdb_txn_create_txn_table(txn, table);
242 rw_row = ovsdb_row_clone(ro_row);
243 uuid_generate(ovsdb_row_get_version_rw(rw_row));
244 rw_row->txn_row = ovsdb_txn_row_create(txn_table, ro_row, rw_row);
245 hmap_replace(&table->rows, &ro_row->hmap_node, &rw_row->hmap_node);
252 ovsdb_txn_row_insert(struct ovsdb_txn *txn, struct ovsdb_row *row)
254 uint32_t hash = ovsdb_row_hash(row);
255 struct ovsdb_table *table = row->table;
256 struct ovsdb_txn_table *txn_table;
258 uuid_generate(ovsdb_row_get_version_rw(row));
260 txn_table = ovsdb_txn_create_txn_table(txn, table);
261 row->txn_row = ovsdb_txn_row_create(txn_table, NULL, row);
262 hmap_insert(&table->rows, &row->hmap_node, hash);
265 /* 'row' must be assumed destroyed upon return; the caller must not reference
268 ovsdb_txn_row_delete(struct ovsdb_txn *txn, const struct ovsdb_row *row_)
270 struct ovsdb_row *row = (struct ovsdb_row *) row_;
271 struct ovsdb_table *table = row->table;
272 struct ovsdb_txn_row *txn_row = row->txn_row;
273 struct ovsdb_txn_table *txn_table;
275 hmap_remove(&table->rows, &row->hmap_node);
278 txn_table = ovsdb_txn_create_txn_table(txn, table);
279 row->txn_row = ovsdb_txn_row_create(txn_table, row, NULL);
281 assert(txn_row->new == row);
285 txn_table = ovsdb_txn_get_txn_table(txn, table);
286 hmap_remove(&txn_table->txn_rows, &txn_row->hmap_node);
288 ovsdb_row_destroy(row);
293 ovsdb_txn_add_comment(struct ovsdb_txn *txn, const char *s)
295 if (txn->comment.length) {
296 ds_put_char(&txn->comment, '\n');
298 ds_put_cstr(&txn->comment, s);
302 ovsdb_txn_get_comment(const struct ovsdb_txn *txn)
304 return txn->comment.length ? ds_cstr_ro(&txn->comment) : NULL;