xref: /qemu/qom/object_interfaces.c (revision abff1abf)
1 #include "qemu/osdep.h"
2 
3 #include "qemu/cutils.h"
4 #include "qapi/error.h"
5 #include "qapi/qmp/qdict.h"
6 #include "qapi/qmp/qerror.h"
7 #include "qapi/qmp/qjson.h"
8 #include "qapi/qmp/qstring.h"
9 #include "qapi/qobject-input-visitor.h"
10 #include "qom/object_interfaces.h"
11 #include "qemu/help_option.h"
12 #include "qemu/module.h"
13 #include "qemu/option.h"
14 #include "qapi/opts-visitor.h"
15 #include "qemu/config-file.h"
16 
17 bool user_creatable_complete(UserCreatable *uc, Error **errp)
18 {
19     UserCreatableClass *ucc = USER_CREATABLE_GET_CLASS(uc);
20     Error *err = NULL;
21 
22     if (ucc->complete) {
23         ucc->complete(uc, &err);
24         error_propagate(errp, err);
25     }
26     return !err;
27 }
28 
29 bool user_creatable_can_be_deleted(UserCreatable *uc)
30 {
31 
32     UserCreatableClass *ucc = USER_CREATABLE_GET_CLASS(uc);
33 
34     if (ucc->can_be_deleted) {
35         return ucc->can_be_deleted(uc);
36     } else {
37         return true;
38     }
39 }
40 
41 Object *user_creatable_add_type(const char *type, const char *id,
42                                 const QDict *qdict,
43                                 Visitor *v, Error **errp)
44 {
45     Object *obj;
46     ObjectClass *klass;
47     const QDictEntry *e;
48     Error *local_err = NULL;
49 
50     klass = object_class_by_name(type);
51     if (!klass) {
52         error_setg(errp, "invalid object type: %s", type);
53         return NULL;
54     }
55 
56     if (!object_class_dynamic_cast(klass, TYPE_USER_CREATABLE)) {
57         error_setg(errp, "object type '%s' isn't supported by object-add",
58                    type);
59         return NULL;
60     }
61 
62     if (object_class_is_abstract(klass)) {
63         error_setg(errp, "object type '%s' is abstract", type);
64         return NULL;
65     }
66 
67     assert(qdict);
68     obj = object_new(type);
69     if (!visit_start_struct(v, NULL, NULL, 0, &local_err)) {
70         goto out;
71     }
72     for (e = qdict_first(qdict); e; e = qdict_next(qdict, e)) {
73         if (!object_property_set(obj, e->key, v, &local_err)) {
74             break;
75         }
76     }
77     if (!local_err) {
78         visit_check_struct(v, &local_err);
79     }
80     visit_end_struct(v, NULL);
81     if (local_err) {
82         goto out;
83     }
84 
85     if (id != NULL) {
86         object_property_try_add_child(object_get_objects_root(),
87                                       id, obj, &local_err);
88         if (local_err) {
89             goto out;
90         }
91     }
92 
93     if (!user_creatable_complete(USER_CREATABLE(obj), &local_err)) {
94         if (id != NULL) {
95             object_property_del(object_get_objects_root(), id);
96         }
97         goto out;
98     }
99 out:
100     if (local_err) {
101         error_propagate(errp, local_err);
102         object_unref(obj);
103         return NULL;
104     }
105     return obj;
106 }
107 
108 bool user_creatable_add_dict(QDict *qdict, bool keyval, Error **errp)
109 {
110     Visitor *v;
111     Object *obj;
112     g_autofree char *type = NULL;
113     g_autofree char *id = NULL;
114 
115     type = g_strdup(qdict_get_try_str(qdict, "qom-type"));
116     if (!type) {
117         error_setg(errp, QERR_MISSING_PARAMETER, "qom-type");
118         return false;
119     }
120     qdict_del(qdict, "qom-type");
121 
122     id = g_strdup(qdict_get_try_str(qdict, "id"));
123     if (!id) {
124         error_setg(errp, QERR_MISSING_PARAMETER, "id");
125         return false;
126     }
127     qdict_del(qdict, "id");
128 
129     if (keyval) {
130         v = qobject_input_visitor_new_keyval(QOBJECT(qdict));
131     } else {
132         v = qobject_input_visitor_new(QOBJECT(qdict));
133     }
134     obj = user_creatable_add_type(type, id, qdict, v, errp);
135     visit_free(v);
136     object_unref(obj);
137     return !!obj;
138 }
139 
140 Object *user_creatable_add_opts(QemuOpts *opts, Error **errp)
141 {
142     Visitor *v;
143     QDict *pdict;
144     Object *obj;
145     const char *id = qemu_opts_id(opts);
146     char *type = qemu_opt_get_del(opts, "qom-type");
147 
148     if (!type) {
149         error_setg(errp, QERR_MISSING_PARAMETER, "qom-type");
150         return NULL;
151     }
152     if (!id) {
153         error_setg(errp, QERR_MISSING_PARAMETER, "id");
154         qemu_opt_set(opts, "qom-type", type, &error_abort);
155         g_free(type);
156         return NULL;
157     }
158 
159     qemu_opts_set_id(opts, NULL);
160     pdict = qemu_opts_to_qdict(opts, NULL);
161 
162     v = opts_visitor_new(opts);
163     obj = user_creatable_add_type(type, id, pdict, v, errp);
164     visit_free(v);
165 
166     qemu_opts_set_id(opts, (char *) id);
167     qemu_opt_set(opts, "qom-type", type, &error_abort);
168     g_free(type);
169     qobject_unref(pdict);
170     return obj;
171 }
172 
173 
174 int user_creatable_add_opts_foreach(void *opaque, QemuOpts *opts, Error **errp)
175 {
176     bool (*type_opt_predicate)(const char *, QemuOpts *) = opaque;
177     Object *obj = NULL;
178     const char *type;
179 
180     type = qemu_opt_get(opts, "qom-type");
181     if (type && type_opt_predicate &&
182         !type_opt_predicate(type, opts)) {
183         return 0;
184     }
185 
186     obj = user_creatable_add_opts(opts, errp);
187     if (!obj) {
188         return -1;
189     }
190     object_unref(obj);
191     return 0;
192 }
193 
194 char *object_property_help(const char *name, const char *type,
195                            QObject *defval, const char *description)
196 {
197     GString *str = g_string_new(NULL);
198 
199     g_string_append_printf(str, "  %s=<%s>", name, type);
200     if (description || defval) {
201         if (str->len < 24) {
202             g_string_append_printf(str, "%*s", 24 - (int)str->len, "");
203         }
204         g_string_append(str, " - ");
205     }
206     if (description) {
207         g_string_append(str, description);
208     }
209     if (defval) {
210         g_autofree char *def_json = qstring_free(qobject_to_json(defval), TRUE);
211         g_string_append_printf(str, " (default: %s)", def_json);
212     }
213 
214     return g_string_free(str, false);
215 }
216 
217 bool user_creatable_print_help(const char *type, QemuOpts *opts)
218 {
219     ObjectClass *klass;
220 
221     if (is_help_option(type)) {
222         GSList *l, *list;
223 
224         printf("List of user creatable objects:\n");
225         list = object_class_get_list_sorted(TYPE_USER_CREATABLE, false);
226         for (l = list; l != NULL; l = l->next) {
227             ObjectClass *oc = OBJECT_CLASS(l->data);
228             printf("  %s\n", object_class_get_name(oc));
229         }
230         g_slist_free(list);
231         return true;
232     }
233 
234     klass = object_class_by_name(type);
235     if (klass && qemu_opt_has_help_opt(opts)) {
236         ObjectPropertyIterator iter;
237         ObjectProperty *prop;
238         GPtrArray *array = g_ptr_array_new();
239         int i;
240 
241         object_class_property_iter_init(&iter, klass);
242         while ((prop = object_property_iter_next(&iter))) {
243             if (!prop->set) {
244                 continue;
245             }
246 
247             g_ptr_array_add(array,
248                             object_property_help(prop->name, prop->type,
249                                                  prop->defval, prop->description));
250         }
251         g_ptr_array_sort(array, (GCompareFunc)qemu_pstrcmp0);
252         if (array->len > 0) {
253             printf("%s options:\n", type);
254         } else {
255             printf("There are no options for %s.\n", type);
256         }
257         for (i = 0; i < array->len; i++) {
258             printf("%s\n", (char *)array->pdata[i]);
259         }
260         g_ptr_array_set_free_func(array, g_free);
261         g_ptr_array_free(array, true);
262         return true;
263     }
264 
265     return false;
266 }
267 
268 bool user_creatable_del(const char *id, Error **errp)
269 {
270     Object *container;
271     Object *obj;
272 
273     container = object_get_objects_root();
274     obj = object_resolve_path_component(container, id);
275     if (!obj) {
276         error_setg(errp, "object '%s' not found", id);
277         return false;
278     }
279 
280     if (!user_creatable_can_be_deleted(USER_CREATABLE(obj))) {
281         error_setg(errp, "object '%s' is in use, can not be deleted", id);
282         return false;
283     }
284 
285     /*
286      * if object was defined on the command-line, remove its corresponding
287      * option group entry
288      */
289     qemu_opts_del(qemu_opts_find(qemu_find_opts_err("object", &error_abort),
290                                  id));
291 
292     object_unparent(obj);
293     return true;
294 }
295 
296 void user_creatable_cleanup(void)
297 {
298     object_unparent(object_get_objects_root());
299 }
300 
301 static void register_types(void)
302 {
303     static const TypeInfo uc_interface_info = {
304         .name          = TYPE_USER_CREATABLE,
305         .parent        = TYPE_INTERFACE,
306         .class_size = sizeof(UserCreatableClass),
307     };
308 
309     type_register_static(&uc_interface_info);
310 }
311 
312 type_init(register_types)
313