mirror of https://gitee.com/openkylin/qemu.git
qemu-help: Sort devices by logical functionality
Categorize devices that appear as output to "-device ?" command by logical functionality. Sort the devices by logical categories before showing them to user. The sort is done by functionality rather than alphabetical. Signed-off-by: Marcel Apfelbaum <marcel.a@redhat.com> Message-id: 1375107465-25767-3-git-send-email-marcel.a@redhat.com Signed-off-by: Anthony Liguori <aliguori@us.ibm.com>
This commit is contained in:
parent
949fc82314
commit
3d1237fb2a
|
@ -18,6 +18,34 @@ enum {
|
|||
#define DEVICE_CLASS(klass) OBJECT_CLASS_CHECK(DeviceClass, (klass), TYPE_DEVICE)
|
||||
#define DEVICE_GET_CLASS(obj) OBJECT_GET_CLASS(DeviceClass, (obj), TYPE_DEVICE)
|
||||
|
||||
typedef enum DeviceCategory {
|
||||
DEVICE_CATEGORY_BRIDGE,
|
||||
DEVICE_CATEGORY_USB,
|
||||
DEVICE_CATEGORY_STORAGE,
|
||||
DEVICE_CATEGORY_NETWORK,
|
||||
DEVICE_CATEGORY_INPUT,
|
||||
DEVICE_CATEGORY_DISPLAY,
|
||||
DEVICE_CATEGORY_SOUND,
|
||||
DEVICE_CATEGORY_MISC,
|
||||
DEVICE_CATEGORY_MAX
|
||||
} DeviceCategory;
|
||||
|
||||
static inline const char *qdev_category_get_name(DeviceCategory category)
|
||||
{
|
||||
static const char *category_names[DEVICE_CATEGORY_MAX] = {
|
||||
[DEVICE_CATEGORY_BRIDGE] = "Controller/Bridge/Hub",
|
||||
[DEVICE_CATEGORY_USB] = "USB",
|
||||
[DEVICE_CATEGORY_STORAGE] = "Storage",
|
||||
[DEVICE_CATEGORY_NETWORK] = "Network",
|
||||
[DEVICE_CATEGORY_INPUT] = "Input",
|
||||
[DEVICE_CATEGORY_DISPLAY] = "Display",
|
||||
[DEVICE_CATEGORY_SOUND] = "Sound",
|
||||
[DEVICE_CATEGORY_MISC] = "Misc",
|
||||
};
|
||||
|
||||
return category_names[category];
|
||||
};
|
||||
|
||||
typedef int (*qdev_initfn)(DeviceState *dev);
|
||||
typedef int (*qdev_event)(DeviceState *dev);
|
||||
typedef void (*qdev_resetfn)(DeviceState *dev);
|
||||
|
@ -81,6 +109,7 @@ typedef struct DeviceClass {
|
|||
ObjectClass parent_class;
|
||||
/*< public >*/
|
||||
|
||||
DECLARE_BITMAP(categories, DEVICE_CATEGORY_MAX);
|
||||
const char *fw_name;
|
||||
const char *desc;
|
||||
Property *props;
|
||||
|
|
|
@ -75,24 +75,27 @@ static bool qdev_class_has_alias(DeviceClass *dc)
|
|||
return (qdev_class_get_alias(dc) != NULL);
|
||||
}
|
||||
|
||||
static void qdev_print_devinfo(ObjectClass *klass, void *opaque)
|
||||
static void qdev_print_class_devinfo(DeviceClass *dc)
|
||||
{
|
||||
DeviceClass *dc;
|
||||
bool *show_no_user = opaque;
|
||||
DeviceCategory category;
|
||||
|
||||
dc = (DeviceClass *)object_class_dynamic_cast(klass, TYPE_DEVICE);
|
||||
|
||||
if (!dc || (show_no_user && !*show_no_user && dc->no_user)) {
|
||||
if (!dc) {
|
||||
return;
|
||||
}
|
||||
|
||||
error_printf("name \"%s\"", object_class_get_name(klass));
|
||||
error_printf("name \"%s\"", object_class_get_name(OBJECT_CLASS(dc)));
|
||||
if (dc->bus_type) {
|
||||
error_printf(", bus %s", dc->bus_type);
|
||||
}
|
||||
if (qdev_class_has_alias(dc)) {
|
||||
error_printf(", alias \"%s\"", qdev_class_get_alias(dc));
|
||||
}
|
||||
error_printf(", categories");
|
||||
for (category = 0; category < DEVICE_CATEGORY_MAX; ++category) {
|
||||
if (test_bit(category, dc->categories)) {
|
||||
error_printf(" \"%s\"", qdev_category_get_name(category));
|
||||
}
|
||||
}
|
||||
if (dc->desc) {
|
||||
error_printf(", desc \"%s\"", dc->desc);
|
||||
}
|
||||
|
@ -102,6 +105,15 @@ static void qdev_print_devinfo(ObjectClass *klass, void *opaque)
|
|||
error_printf("\n");
|
||||
}
|
||||
|
||||
static void qdev_print_devinfo(ObjectClass *klass, void *opaque)
|
||||
{
|
||||
DeviceClass *dc;
|
||||
|
||||
dc = (DeviceClass *)object_class_dynamic_cast(klass, TYPE_DEVICE);
|
||||
|
||||
qdev_print_class_devinfo(dc);
|
||||
}
|
||||
|
||||
static int set_property(const char *name, const char *value, void *opaque)
|
||||
{
|
||||
DeviceState *dev = opaque;
|
||||
|
@ -139,6 +151,21 @@ static const char *find_typename_by_alias(const char *alias)
|
|||
return NULL;
|
||||
}
|
||||
|
||||
static void qdev_print_category_devices(DeviceCategory category)
|
||||
{
|
||||
DeviceClass *dc;
|
||||
GSList *list, *curr;
|
||||
|
||||
list = object_class_get_list(TYPE_DEVICE, false);
|
||||
for (curr = list; curr; curr = g_slist_next(curr)) {
|
||||
dc = (DeviceClass *)object_class_dynamic_cast(curr->data, TYPE_DEVICE);
|
||||
if (!dc->no_user && test_bit(category, dc->categories)) {
|
||||
qdev_print_class_devinfo(dc);
|
||||
}
|
||||
}
|
||||
g_slist_free(list);
|
||||
}
|
||||
|
||||
int qdev_device_help(QemuOpts *opts)
|
||||
{
|
||||
const char *driver;
|
||||
|
@ -147,8 +174,11 @@ int qdev_device_help(QemuOpts *opts)
|
|||
|
||||
driver = qemu_opt_get(opts, "driver");
|
||||
if (driver && is_help_option(driver)) {
|
||||
bool show_no_user = false;
|
||||
object_class_foreach(qdev_print_devinfo, TYPE_DEVICE, false, &show_no_user);
|
||||
DeviceCategory category;
|
||||
for (category = 0; category < DEVICE_CATEGORY_MAX; ++category) {
|
||||
qdev_print_category_devices(category);
|
||||
}
|
||||
|
||||
return 1;
|
||||
}
|
||||
|
||||
|
|
Loading…
Reference in New Issue