mirror of
https://github.com/openvswitch/ovs
synced 2025-10-25 15:07:05 +00:00
ee89ea7b47
To easily allow both in- and out-of-tree building of the Python
wrapper for the OVS JSON parser (e.g. w/ pip), move json.h to
include/openvswitch. This also requires moving lib/{hmap,shash}.h.
Both hmap.h and shash.h were #include-ing "util.h" even though the
headers themselves did not use anything from there, but rather from
include/openvswitch/util.h. Fixing that required including util.h
in several C files mostly due to OVS_NOT_REACHED and things like
xmalloc.
Signed-off-by: Terry Wilson <twilson@redhat.com>
Signed-off-by: Ben Pfaff <blp@ovn.org>
96 lines
3.6 KiB
C
96 lines
3.6 KiB
C
/* Copyright (c) 2011, 2012 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 SERVER_H
|
|
#define SERVER_H 1
|
|
|
|
#include "openvswitch/hmap.h"
|
|
#include "openvswitch/list.h"
|
|
#include "openvswitch/shash.h"
|
|
|
|
struct ovsdb;
|
|
struct ovsdb_server;
|
|
|
|
/* Abstract representation of an OVSDB client connection, not tied to any
|
|
* particular network protocol. Protocol implementations
|
|
* (e.g. jsonrpc-server.c) embed this in a larger data structure. */
|
|
struct ovsdb_session {
|
|
struct ovsdb_server *server;
|
|
struct ovs_list completions;/* Completed triggers. */
|
|
struct hmap waiters; /* "ovsdb_lock_waiter *"s by lock name. */
|
|
};
|
|
|
|
void ovsdb_session_init(struct ovsdb_session *, struct ovsdb_server *);
|
|
void ovsdb_session_destroy(struct ovsdb_session *);
|
|
|
|
struct ovsdb_lock_waiter *ovsdb_session_get_lock_waiter(
|
|
const struct ovsdb_session *, const char *lock_name);
|
|
|
|
/* A database lock.
|
|
*
|
|
* A lock always has one or more "lock waiters" kept on a list. The waiter at
|
|
* the head of the list owns the lock. */
|
|
struct ovsdb_lock {
|
|
struct hmap_node hmap_node; /* In ovsdb_server's "locks" hmap. */
|
|
struct ovsdb_server *server; /* The containing server. */
|
|
char *name; /* Unique name. */
|
|
struct ovs_list waiters; /* Contains "struct ovsdb_lock_waiter"s. */
|
|
};
|
|
|
|
struct ovsdb_lock_waiter *ovsdb_lock_get_owner(const struct ovsdb_lock *);
|
|
|
|
/* How to obtain a lock. */
|
|
enum ovsdb_lock_mode {
|
|
OVSDB_LOCK_WAIT, /* By waiting for it to become available. */
|
|
OVSDB_LOCK_STEAL /* By stealing it from the owner. */
|
|
};
|
|
|
|
/* A session's request for a database lock. */
|
|
struct ovsdb_lock_waiter {
|
|
struct hmap_node session_node; /* In ->session->locks's hmap. */
|
|
struct ovsdb_lock *lock; /* The lock being waited for. */
|
|
|
|
enum ovsdb_lock_mode mode;
|
|
char *lock_name;
|
|
|
|
struct ovsdb_session *session;
|
|
struct ovs_list lock_node; /* In ->lock->waiters's list. */
|
|
};
|
|
|
|
struct ovsdb_session *ovsdb_lock_waiter_remove(struct ovsdb_lock_waiter *);
|
|
void ovsdb_lock_waiter_destroy(struct ovsdb_lock_waiter *);
|
|
bool ovsdb_lock_waiter_is_owner(const struct ovsdb_lock_waiter *);
|
|
|
|
/* Abstract representation of an OVSDB server not tied to any particular
|
|
* network protocol. Protocol implementations (e.g. jsonrpc-server.c) embed
|
|
* this in a larger data structure. */
|
|
struct ovsdb_server {
|
|
struct shash dbs; /* Maps from a db name to a "struct ovsdb *". */
|
|
struct hmap locks; /* Contains "struct ovsdb_lock"s indexed by name. */
|
|
};
|
|
|
|
void ovsdb_server_init(struct ovsdb_server *);
|
|
bool ovsdb_server_add_db(struct ovsdb_server *, struct ovsdb *);
|
|
bool ovsdb_server_remove_db(struct ovsdb_server *, struct ovsdb *);
|
|
void ovsdb_server_destroy(struct ovsdb_server *);
|
|
|
|
struct ovsdb_lock_waiter *ovsdb_server_lock(struct ovsdb_server *,
|
|
struct ovsdb_session *,
|
|
const char *lock_name,
|
|
enum ovsdb_lock_mode,
|
|
struct ovsdb_session **victimp);
|
|
|
|
#endif /* ovsdb/server.h */
|