summaryrefslogtreecommitdiff
path: root/lib/db-ctl-base.h
diff options
context:
space:
mode:
Diffstat (limited to 'lib/db-ctl-base.h')
-rw-r--r--lib/db-ctl-base.h11
1 files changed, 10 insertions, 1 deletions
diff --git a/lib/db-ctl-base.h b/lib/db-ctl-base.h
index 6e34ded2c..e89140982 100644
--- a/lib/db-ctl-base.h
+++ b/lib/db-ctl-base.h
@@ -237,8 +237,17 @@ void ctl_context_init(struct ctl_context *, struct ctl_command *,
void ctl_context_done_command(struct ctl_context *, struct ctl_command *);
void ctl_context_done(struct ctl_context *, struct ctl_command *);
+/* A way to identify a particular row in the database based on a user-provided
+ * string. If all fields are NULL, the struct is ignored. Otherwise,
+ * 'name_column' designates a column whose table is searched for rows that
+ * match with the user string. If a matching row is found, then:
+ *
+ * - If 'uuid_column' is NULL, the matching row is the final row.
+ *
+ * - Otherwise 'uuid_column' must designate a UUID-typed column whose value
+ * refers to exactly one row, which is the final row.
+ */
struct ctl_row_id {
- const struct ovsdb_idl_table_class *table;
const struct ovsdb_idl_column *name_column;
const struct ovsdb_idl_column *uuid_column;
};