From 6492f2ffbf3fadb112a5e819c1afb56cd258893c Mon Sep 17 00:00:00 2001 From: Ewan Mellor Date: Mon, 9 Apr 2007 17:09:21 +0100 Subject: Added documentation, C bindings, and a test for VM_metrics.{start_time, VCPUs_CPU,VCPUs_params}. Changed VM_metrics.start_time to be a DateTime, not an integer. Signed-off-by: Ewan Mellor --- tools/libxen/include/xen_int_int_map.h | 53 ++++++++++++++++++++++++++++ tools/libxen/include/xen_internal.h | 1 + tools/libxen/include/xen_vm_metrics.h | 26 ++++++++++++++ tools/libxen/src/xen_common.c | 19 ++++++++++ tools/libxen/src/xen_int_int_map.c | 39 +++++++++++++++++++++ tools/libxen/src/xen_vm_metrics.c | 63 ++++++++++++++++++++++++++++++++++ tools/libxen/test/test_bindings.c | 20 +++++++++++ 7 files changed, 221 insertions(+) create mode 100644 tools/libxen/include/xen_int_int_map.h create mode 100644 tools/libxen/src/xen_int_int_map.c (limited to 'tools/libxen') diff --git a/tools/libxen/include/xen_int_int_map.h b/tools/libxen/include/xen_int_int_map.h new file mode 100644 index 0000000000..5d11e146b0 --- /dev/null +++ b/tools/libxen/include/xen_int_int_map.h @@ -0,0 +1,53 @@ +/* + * Copyright (c) 2006-2007, XenSource Inc. + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2.1 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ + +#ifndef XEN_INT_INT_MAP_H +#define XEN_INT_INT_MAP_H + + +#include "xen_common.h" + + +typedef struct xen_int_int_map_contents +{ + int64_t key; + int64_t val; +} xen_int_int_map_contents; + + +typedef struct xen_int_int_map +{ + size_t size; + xen_int_int_map_contents contents[]; +} xen_int_int_map; + +/** + * Allocate a xen_int_int_map of the given size. + */ +extern xen_int_int_map * +xen_int_int_map_alloc(size_t size); + +/** + * Free the given xen_int_int_map, and all referenced values. The + * given map must have been allocated by this library. + */ +extern void +xen_int_int_map_free(xen_int_int_map *map); + + +#endif diff --git a/tools/libxen/include/xen_internal.h b/tools/libxen/include/xen_internal.h index ac50de20b2..aad061fe56 100644 --- a/tools/libxen/include/xen_internal.h +++ b/tools/libxen/include/xen_internal.h @@ -86,6 +86,7 @@ extern const abstract_type abstract_type_ref_set; extern const abstract_type abstract_type_string_string_map; extern const abstract_type abstract_type_int_float_map; +extern const abstract_type abstract_type_int_int_map; typedef struct abstract_value diff --git a/tools/libxen/include/xen_vm_metrics.h b/tools/libxen/include/xen_vm_metrics.h index d686a7c99f..4b64b5953e 100644 --- a/tools/libxen/include/xen_vm_metrics.h +++ b/tools/libxen/include/xen_vm_metrics.h @@ -21,6 +21,8 @@ #include "xen_common.h" #include "xen_int_float_map.h" +#include "xen_int_int_map.h" +#include "xen_string_string_map.h" #include "xen_vm_metrics_decl.h" @@ -66,6 +68,9 @@ typedef struct xen_vm_metrics_record int64_t memory_actual; int64_t vcpus_number; xen_int_float_map *vcpus_utilisation; + xen_int_int_map *vcpus_cpu; + xen_string_string_map *vcpus_params; + time_t start_time; time_t last_updated; } xen_vm_metrics_record; @@ -190,6 +195,27 @@ extern bool xen_vm_metrics_get_vcpus_utilisation(xen_session *session, xen_int_float_map **result, xen_vm_metrics vm_metrics); +/** + * Get the VCPUs/CPU field of the given VM_metrics. + */ +extern bool +xen_vm_metrics_get_vcpus_cpu(xen_session *session, xen_int_int_map **result, xen_vm_metrics vm_metrics); + + +/** + * Get the VCPUs/params field of the given VM_metrics. + */ +extern bool +xen_vm_metrics_get_vcpus_params(xen_session *session, xen_string_string_map **result, xen_vm_metrics vm_metrics); + + +/** + * Get the start_time field of the given VM_metrics. + */ +extern bool +xen_vm_metrics_get_start_time(xen_session *session, time_t *result, xen_vm_metrics vm_metrics); + + /** * Get the last_updated field of the given VM_metrics. */ diff --git a/tools/libxen/src/xen_common.c b/tools/libxen/src/xen_common.c index 70ecc1e4fc..6b52723d9d 100644 --- a/tools/libxen/src/xen_common.c +++ b/tools/libxen/src/xen_common.c @@ -35,6 +35,7 @@ #include "xen_host.h" #include "xen_internal.h" #include "xen_int_float_map.h" +#include "xen_int_int_map.h" #include "xen_string_string_map.h" @@ -1697,3 +1698,21 @@ const abstract_type abstract_type_int_float_map = .struct_size = sizeof(xen_int_float_map_contents), .members = int_float_members }; + +static struct struct_member int_int_members[] = +{ + { + .type = &abstract_type_int, + .offset = offsetof(xen_int_int_map_contents, key) + }, + { + .type = &abstract_type_int, + .offset = offsetof(xen_int_int_map_contents, val) + } +}; +const abstract_type abstract_type_int_int_map = + { + .typename = MAP, + .struct_size = sizeof(xen_int_int_map_contents), + .members = int_int_members + }; diff --git a/tools/libxen/src/xen_int_int_map.c b/tools/libxen/src/xen_int_int_map.c new file mode 100644 index 0000000000..b7eeba6e96 --- /dev/null +++ b/tools/libxen/src/xen_int_int_map.c @@ -0,0 +1,39 @@ +/* + * Copyright (c) 2006-2007, XenSource Inc. + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2.1 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ + + +#include "xen_common.h" +#include "xen_int_int_map.h" +#include "xen_internal.h" + + +xen_int_int_map * +xen_int_int_map_alloc(size_t size) +{ + xen_int_int_map *result = calloc(1, sizeof(xen_int_int_map) + + size * sizeof(struct xen_int_int_map_contents)); + result->size = size; + return result; +} + + +void +xen_int_int_map_free(xen_int_int_map *map) +{ + free(map); +} diff --git a/tools/libxen/src/xen_vm_metrics.c b/tools/libxen/src/xen_vm_metrics.c index 11e421282b..bd0509bfc4 100644 --- a/tools/libxen/src/xen_vm_metrics.c +++ b/tools/libxen/src/xen_vm_metrics.c @@ -22,7 +22,9 @@ #include "xen_common.h" #include "xen_int_float_map.h" +#include "xen_int_int_map.h" #include "xen_internal.h" +#include "xen_string_string_map.h" #include "xen_vm_metrics.h" @@ -49,6 +51,15 @@ static const struct_member xen_vm_metrics_record_struct_members[] = { .key = "VCPUs_utilisation", .type = &abstract_type_int_float_map, .offset = offsetof(xen_vm_metrics_record, vcpus_utilisation) }, + { .key = "VCPUs_CPU", + .type = &abstract_type_int_int_map, + .offset = offsetof(xen_vm_metrics_record, vcpus_cpu) }, + { .key = "VCPUs_params", + .type = &abstract_type_string_string_map, + .offset = offsetof(xen_vm_metrics_record, vcpus_params) }, + { .key = "start_time", + .type = &abstract_type_datetime, + .offset = offsetof(xen_vm_metrics_record, start_time) }, { .key = "last_updated", .type = &abstract_type_datetime, .offset = offsetof(xen_vm_metrics_record, last_updated) } @@ -74,6 +85,8 @@ xen_vm_metrics_record_free(xen_vm_metrics_record *record) free(record->handle); free(record->uuid); xen_int_float_map_free(record->vcpus_utilisation); + xen_int_int_map_free(record->vcpus_cpu); + xen_string_string_map_free(record->vcpus_params); free(record); } @@ -167,6 +180,56 @@ xen_vm_metrics_get_vcpus_utilisation(xen_session *session, xen_int_float_map **r } +bool +xen_vm_metrics_get_vcpus_cpu(xen_session *session, xen_int_int_map **result, xen_vm_metrics vm_metrics) +{ + abstract_value param_values[] = + { + { .type = &abstract_type_string, + .u.string_val = vm_metrics } + }; + + abstract_type result_type = abstract_type_int_int_map; + + *result = NULL; + XEN_CALL_("VM_metrics.get_VCPUs_CPU"); + return session->ok; +} + + +bool +xen_vm_metrics_get_vcpus_params(xen_session *session, xen_string_string_map **result, xen_vm_metrics vm_metrics) +{ + abstract_value param_values[] = + { + { .type = &abstract_type_string, + .u.string_val = vm_metrics } + }; + + abstract_type result_type = abstract_type_string_string_map; + + *result = NULL; + XEN_CALL_("VM_metrics.get_VCPUs_params"); + return session->ok; +} + + +bool +xen_vm_metrics_get_start_time(xen_session *session, time_t *result, xen_vm_metrics vm_metrics) +{ + abstract_value param_values[] = + { + { .type = &abstract_type_string, + .u.string_val = vm_metrics } + }; + + abstract_type result_type = abstract_type_datetime; + + XEN_CALL_("VM_metrics.get_start_time"); + return session->ok; +} + + bool xen_vm_metrics_get_last_updated(xen_session *session, time_t *result, xen_vm_metrics vm_metrics) { diff --git a/tools/libxen/test/test_bindings.c b/tools/libxen/test/test_bindings.c index df067aa438..9a1ad1f9c4 100644 --- a/tools/libxen/test/test_bindings.c +++ b/tools/libxen/test/test_bindings.c @@ -757,6 +757,10 @@ static void print_vm_metrics(xen_session *session, xen_vm vm) my_strftime(time, 256, "Metrics updated at %c, local time.\n", tm); printf(time); + tm = localtime(&vm_metrics_record->start_time); + my_strftime(time, 256, "VM running since %c, local time.\n", tm); + printf(time); + for (size_t i = 0; i < vm_metrics_record->vcpus_utilisation->size; i++) { printf("%"PRId64" -> %lf.\n", @@ -764,6 +768,22 @@ static void print_vm_metrics(xen_session *session, xen_vm vm) vm_metrics_record->vcpus_utilisation->contents[i].val); } + printf("VCPU -> PCPU mapping:\n"); + for (size_t i = 0; i < vm_metrics_record->vcpus_cpu->size; i++) + { + printf(" %"PRId64" -> %"PRId64".\n", + vm_metrics_record->vcpus_cpu->contents[i].key, + vm_metrics_record->vcpus_cpu->contents[i].val); + } + + printf("Live scheduling parameters:\n"); + for (size_t i = 0; i < vm_metrics_record->vcpus_params->size; i++) + { + printf(" %s -> %s.\n", + vm_metrics_record->vcpus_params->contents[i].key, + vm_metrics_record->vcpus_params->contents[i].val); + } + xen_vm_metrics_record_free(vm_metrics_record); xen_vm_metrics_free(vm_metrics); -- cgit v1.2.3