mirror of
				https://github.com/openvswitch/ovs
				synced 2025-10-29 15:28:56 +00:00 
			
		
		
		
	The conditional replication code had hardly any comments. This adds some. This commit also fixes a number of style problems, factors out some code into a helper function, and moves some struct declarations from a public header, that were not used by client code, into more private locations. Signed-off-by: Ben Pfaff <blp@ovn.org>
		
			
				
	
	
		
			105 lines
		
	
	
		
			3.8 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			105 lines
		
	
	
		
			3.8 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /* Copyright (c) 2009, 2010, 2011, 2012, 2016 Nicira, Inc.
 | |
|  *
 | |
|  * Licensed under the Apache License, Version 2.0 (the "License");
 | |
|  * you may not use this file except in compliance with the License.
 | |
|  * You may obtain a copy of the License at:
 | |
|  *
 | |
|  *     http://www.apache.org/licenses/LICENSE-2.0
 | |
|  *
 | |
|  * Unless required by applicable law or agreed to in writing, software
 | |
|  * distributed under the License is distributed on an "AS IS" BASIS,
 | |
|  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 | |
|  * See the License for the specific language governing permissions and
 | |
|  * limitations under the License.
 | |
|  */
 | |
| 
 | |
| #ifndef OVSDB_IDL_PROVIDER_H
 | |
| #define OVSDB_IDL_PROVIDER_H 1
 | |
| 
 | |
| #include "openvswitch/hmap.h"
 | |
| #include "openvswitch/list.h"
 | |
| #include "ovsdb-idl.h"
 | |
| #include "ovsdb-map-op.h"
 | |
| #include "ovsdb-set-op.h"
 | |
| #include "ovsdb-types.h"
 | |
| #include "openvswitch/shash.h"
 | |
| #include "uuid.h"
 | |
| 
 | |
| struct ovsdb_idl_row {
 | |
|     struct hmap_node hmap_node; /* In struct ovsdb_idl_table's 'rows'. */
 | |
|     struct uuid uuid;           /* Row "_uuid" field. */
 | |
|     struct ovs_list src_arcs;   /* Forward arcs (ovsdb_idl_arc.src_node). */
 | |
|     struct ovs_list dst_arcs;   /* Backward arcs (ovsdb_idl_arc.dst_node). */
 | |
|     struct ovsdb_idl_table *table; /* Containing table. */
 | |
|     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. */
 | |
|     unsigned long int *map_op_written; /* Bitmap of columns pending map ops. */
 | |
|     struct map_op_list **map_op_lists; /* Per-column map operations. */
 | |
|     unsigned long int *set_op_written; /* Bitmap of columns pending set ops. */
 | |
|     struct set_op_list **set_op_lists; /* Per-column set operations. */
 | |
| 
 | |
|     /* Tracking data */
 | |
|     unsigned int change_seqno[OVSDB_IDL_CHANGE_MAX];
 | |
|     struct ovs_list track_node; /* Rows modified/added/deleted by IDL */
 | |
|     unsigned long int *updated; /* Bitmap of columns updated by IDL */
 | |
| };
 | |
| 
 | |
| struct ovsdb_idl_column {
 | |
|     char *name;
 | |
|     struct ovsdb_type type;
 | |
|     bool mutable;
 | |
|     void (*parse)(struct ovsdb_idl_row *, const struct ovsdb_datum *);
 | |
|     void (*unparse)(struct ovsdb_idl_row *);
 | |
| };
 | |
| 
 | |
| struct ovsdb_idl_table_class {
 | |
|     char *name;
 | |
|     bool is_root;
 | |
|     const struct ovsdb_idl_column *columns;
 | |
|     size_t n_columns;
 | |
|     size_t allocation_size;
 | |
|     void (*row_init)(struct ovsdb_idl_row *);
 | |
| };
 | |
| 
 | |
| struct ovsdb_idl_condition {
 | |
|     const struct ovsdb_idl_table_class *tc;
 | |
|     struct ovs_list clauses;
 | |
| };
 | |
| 
 | |
| struct ovsdb_idl_table {
 | |
|     const struct ovsdb_idl_table_class *class;
 | |
|     unsigned char *modes;    /* OVSDB_IDL_* bitmasks, indexed by column. */
 | |
|     bool need_table;         /* Monitor table even if no columns are selected
 | |
|                               * for replication. */
 | |
|     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. */
 | |
|     unsigned int change_seqno[OVSDB_IDL_CHANGE_MAX];
 | |
|     struct ovs_list track_list; /* Tracked rows (ovsdb_idl_row.track_node). */
 | |
|     struct ovsdb_idl_condition condition;
 | |
|     bool cond_changed;
 | |
| };
 | |
| 
 | |
| struct ovsdb_idl_class {
 | |
|     const char *database;       /* <db-name> for this database. */
 | |
|     const struct ovsdb_idl_table_class *tables;
 | |
|     size_t n_tables;
 | |
| };
 | |
| 
 | |
| struct ovsdb_idl_row *ovsdb_idl_get_row_arc(
 | |
|     struct ovsdb_idl_row *src,
 | |
|     struct ovsdb_idl_table_class *dst_table,
 | |
|     const struct uuid *dst_uuid);
 | |
| 
 | |
| void ovsdb_idl_txn_verify(const struct ovsdb_idl_row *,
 | |
|                           const struct ovsdb_idl_column *);
 | |
| 
 | |
| struct ovsdb_idl_txn *ovsdb_idl_txn_get(const struct ovsdb_idl_row *);
 | |
| 
 | |
| #endif /* ovsdb-idl-provider.h */
 |