1 /* Copyright (c) 2009, 2010 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.
17 #define OVSDB_TYPES_H 1
31 /* An atomic type: one that OVSDB regards as a single unit of data. */
32 enum ovsdb_atomic_type {
33 OVSDB_TYPE_VOID, /* No value. */
34 OVSDB_TYPE_INTEGER, /* Signed 64-bit integer. */
35 OVSDB_TYPE_REAL, /* IEEE 754 double-precision floating point. */
36 OVSDB_TYPE_BOOLEAN, /* True or false. */
37 OVSDB_TYPE_STRING, /* UTF-8 string. */
38 OVSDB_TYPE_UUID, /* RFC 4122 UUID referencing a table row. */
42 static inline bool ovsdb_atomic_type_is_valid(enum ovsdb_atomic_type);
43 bool ovsdb_atomic_type_from_string(const char *, enum ovsdb_atomic_type *);
44 struct ovsdb_error *ovsdb_atomic_type_from_json(enum ovsdb_atomic_type *,
46 const char *ovsdb_atomic_type_to_string(enum ovsdb_atomic_type);
47 struct json *ovsdb_atomic_type_to_json(enum ovsdb_atomic_type);
49 /* An atomic type plus optional constraints. */
51 struct ovsdb_base_type {
52 enum ovsdb_atomic_type type;
54 struct ovsdb_integer_constraints {
55 int64_t min; /* minInteger or INT64_MIN. */
56 int64_t max; /* maxInteger or INT64_MAX. */
59 struct ovsdb_real_constraints {
60 double min; /* minReal or -DBL_MAX. */
61 double max; /* minReal or DBL_MAX. */
64 /* No constraints for Boolean types. */
66 struct ovsdb_string_constraints {
68 pcre *re; /* Compiled regular expression. */
70 char *reMatch; /* reMatch or NULL. */
71 char *reComment; /* reComment or NULL. */
72 unsigned int minLen; /* minLength or 0. */
73 unsigned int maxLen; /* maxLength or UINT_MAX. */
76 struct ovsdb_uuid_constraints {
77 char *refTableName; /* Name of referenced table, or NULL. */
78 struct ovsdb_table *refTable; /* Referenced table, if available. */
83 #define OVSDB_BASE_VOID_INIT { .type = OVSDB_TYPE_VOID }
84 #define OVSDB_BASE_INTEGER_INIT { .type = OVSDB_TYPE_INTEGER, \
85 .u.integer = { INT64_MIN, INT64_MAX } }
86 #define OVSDB_BASE_REAL_INIT { .type = OVSDB_TYPE_REAL, \
87 .u.real = { -DBL_MAX, DBL_MAX } }
88 #define OVSDB_BASE_BOOLEAN_INIT { .type = OVSDB_TYPE_BOOLEAN }
90 #define OVSDB_BASE_STRING_INIT { .type = OVSDB_TYPE_STRING, \
91 .u.string = { NULL, NULL, NULL, \
94 #define OVSDB_BASE_STRING_INIT { .type = OVSDB_TYPE_STRING, \
95 .u.string = { NULL, NULL, \
98 #define OVSDB_BASE_UUID_INIT { .type = OVSDB_TYPE_UUID, \
99 .u.uuid = { NULL, NULL } }
101 void ovsdb_base_type_init(struct ovsdb_base_type *, enum ovsdb_atomic_type);
102 void ovsdb_base_type_clone(struct ovsdb_base_type *,
103 const struct ovsdb_base_type *);
104 void ovsdb_base_type_destroy(struct ovsdb_base_type *);
106 bool ovsdb_base_type_is_valid(const struct ovsdb_base_type *);
107 bool ovsdb_base_type_has_constraints(const struct ovsdb_base_type *);
108 void ovsdb_base_type_clear_constraints(struct ovsdb_base_type *);
109 struct ovsdb_error *ovsdb_base_type_set_regex(struct ovsdb_base_type *,
111 const char *reComment)
114 struct ovsdb_error *ovsdb_base_type_from_json(struct ovsdb_base_type *,
117 struct json *ovsdb_base_type_to_json(const struct ovsdb_base_type *);
121 * Several rules constrain the valid types. See ovsdb_type_is_valid() (in
122 * ovsdb-types.c) for details.
124 * If 'value_type' is OVSDB_TYPE_VOID, 'n_min' is 1, and 'n_max' is 1, then the
125 * type is a single atomic 'key_type'.
127 * If 'value_type' is OVSDB_TYPE_VOID and 'n_min' or 'n_max' (or both) has a
128 * value other than 1, then the type is a set of 'key_type'. If 'n_min' is 0
129 * and 'n_max' is 1, then the type can also be considered an optional
132 * If 'value_type' is not OVSDB_TYPE_VOID, then the type is a map from
133 * 'key_type' to 'value_type'. If 'n_min' is 0 and 'n_max' is 1, then the type
134 * can also be considered an optional pair of 'key_type' and 'value_type'.
137 struct ovsdb_base_type key;
138 struct ovsdb_base_type value;
140 unsigned int n_max; /* UINT_MAX stands in for "unlimited". */
143 #define OVSDB_TYPE_SCALAR_INITIALIZER(KEY) { KEY, OVSDB_BASE_VOID_INIT, 1, 1 }
145 extern const struct ovsdb_type ovsdb_type_integer;
146 extern const struct ovsdb_type ovsdb_type_real;
147 extern const struct ovsdb_type ovsdb_type_boolean;
148 extern const struct ovsdb_type ovsdb_type_string;
149 extern const struct ovsdb_type ovsdb_type_uuid;
151 void ovsdb_type_clone(struct ovsdb_type *, const struct ovsdb_type *);
152 void ovsdb_type_destroy(struct ovsdb_type *);
154 bool ovsdb_type_is_valid(const struct ovsdb_type *);
156 static inline bool ovsdb_type_is_scalar(const struct ovsdb_type *);
157 static inline bool ovsdb_type_is_optional(const struct ovsdb_type *);
158 static inline bool ovsdb_type_is_composite(const struct ovsdb_type *);
159 static inline bool ovsdb_type_is_set(const struct ovsdb_type *);
160 static inline bool ovsdb_type_is_map(const struct ovsdb_type *);
162 char *ovsdb_type_to_english(const struct ovsdb_type *);
164 struct ovsdb_error *ovsdb_type_from_json(struct ovsdb_type *,
167 struct json *ovsdb_type_to_json(const struct ovsdb_type *);
169 /* Inline function implementations. */
172 ovsdb_atomic_type_is_valid(enum ovsdb_atomic_type atomic_type)
174 return atomic_type >= 0 && atomic_type < OVSDB_N_TYPES;
177 static inline bool ovsdb_type_is_scalar(const struct ovsdb_type *type)
179 return (type->value.type == OVSDB_TYPE_VOID
180 && type->n_min == 1 && type->n_max == 1);
183 static inline bool ovsdb_type_is_optional(const struct ovsdb_type *type)
185 return type->n_min == 0;
188 static inline bool ovsdb_type_is_composite(const struct ovsdb_type *type)
190 return type->n_max > 1;
193 static inline bool ovsdb_type_is_set(const struct ovsdb_type *type)
195 return (type->value.type == OVSDB_TYPE_VOID
196 && (type->n_min != 1 || type->n_max != 1));
199 static inline bool ovsdb_type_is_map(const struct ovsdb_type *type)
201 return type->value.type != OVSDB_TYPE_VOID;
204 #endif /* ovsdb-types.h */