Re: [Qemu-devel] [PATCHv2] cutils: factor out pci_host_device_address_parse()

["Michael S. Tsirkin" <mst@redhat.com>]

On Thu, Feb 16, 2017 at 02:58:27PM +0400, Marc-André Lureau wrote:
> This will allow the function to be used outside of QOM properties.
> 
> Add tests and replace strtoul usage for qemu_strtoul while touching it.
> 
> Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>

Sorry, I don't want to start maintaining it. So pls do not move it
to hw/pci. Find out who wants to maintain this and add it there :)


> ---
> v2:
>  - fixed incompatible type warning/error
> 
> include/hw/pci/pci.h      | 12 ++++++++++
>  hw/core/qdev-properties.c | 61 +++--------------------------------------------
>  tests/test-cutils.c       | 46 +++++++++++++++++++++++++++++++++++
>  util/cutils.c             | 59 +++++++++++++++++++++++++++++++++++++++++++++
>  4 files changed, 120 insertions(+), 58 deletions(-)
> 
> diff --git a/include/hw/pci/pci.h b/include/hw/pci/pci.h
> index cbc1fdfb5b..61718080ea 100644
> --- a/include/hw/pci/pci.h
> +++ b/include/hw/pci/pci.h
> @@ -815,4 +815,16 @@ extern const VMStateDescription vmstate_pci_device;
>  
>  MSIMessage pci_get_msi_message(PCIDevice *dev, int vector);
>  
> +/**
> + * pci_host_device_address_parse:
> + * @str: string to parse
> + * @addr: destination structure or NULL
> + *
> + * Parse [<domain>:]<bus>:<slot>.<func>
> + *   if <domain> is not supplied, it's assumed to be 0.
> + *
> + * Returns: -1 on failure, 0 on success.
> + */
> +int pci_host_device_address_parse(const char *str, PCIHostDeviceAddress *addr);
> +
>  #endif

Used to be a static function, now it's an interface, I'm not sure it's a win.

> diff --git a/hw/core/qdev-properties.c b/hw/core/qdev-properties.c
> index 6ab4265eb4..5dd0774e88 100644
> --- a/hw/core/qdev-properties.c
> +++ b/hw/core/qdev-properties.c
> @@ -722,10 +722,6 @@ static void get_pci_host_devaddr(Object *obj, Visitor *v, const char *name,
>      visit_type_str(v, name, &p, errp);
>  }
>  
> -/*
> - * Parse [<domain>:]<bus>:<slot>.<func>
> - *   if <domain> is not supplied, it's assumed to be 0.
> - */
>  static void set_pci_host_devaddr(Object *obj, Visitor *v, const char *name,
>                                   void *opaque, Error **errp)
>  {
> @@ -733,11 +729,7 @@ static void set_pci_host_devaddr(Object *obj, Visitor *v, const char *name,
>      Property *prop = opaque;
>      PCIHostDeviceAddress *addr = qdev_get_prop_ptr(dev, prop);
>      Error *local_err = NULL;
> -    char *str, *p;
> -    char *e;
> -    unsigned long val;
> -    unsigned long dom = 0, bus = 0;
> -    unsigned int slot = 0, func = 0;
> +    char *str;
>  
>      if (dev->realized) {
>          qdev_prop_set_after_realize(dev, name, errp);
> @@ -750,58 +742,11 @@ static void set_pci_host_devaddr(Object *obj, Visitor *v, const char *name,
>          return;
>      }
>  
> -    p = str;
> -    val = strtoul(p, &e, 16);
> -    if (e == p || *e != ':') {
> -        goto inval;
> -    }
> -    bus = val;
> -
> -    p = e + 1;
> -    val = strtoul(p, &e, 16);
> -    if (e == p) {
> -        goto inval;
> -    }
> -    if (*e == ':') {
> -        dom = bus;
> -        bus = val;
> -        p = e + 1;
> -        val = strtoul(p, &e, 16);
> -        if (e == p) {
> -            goto inval;
> -        }
> -    }
> -    slot = val;
> -
> -    if (*e != '.') {
> -        goto inval;
> +    if (!pci_host_device_address_parse(str, addr)) {
> +        error_set_from_qdev_prop_error(errp, EINVAL, dev, prop, str);
>      }
> -    p = e + 1;
> -    val = strtoul(p, &e, 10);
> -    if (e == p) {
> -        goto inval;
> -    }
> -    func = val;
> -
> -    if (dom > 0xffff || bus > 0xff || slot > 0x1f || func > 7) {
> -        goto inval;
> -    }
> -
> -    if (*e) {
> -        goto inval;
> -    }
> -
> -    addr->domain = dom;
> -    addr->bus = bus;
> -    addr->slot = slot;
> -    addr->function = func;
>  
>      g_free(str);
> -    return;
> -
> -inval:
> -    error_set_from_qdev_prop_error(errp, EINVAL, dev, prop, str);
> -    g_free(str);
>  }
>  
>  PropertyInfo qdev_prop_pci_host_devaddr = {
> diff --git a/tests/test-cutils.c b/tests/test-cutils.c
> index 20b0f59ba2..81c4f072f3 100644
> --- a/tests/test-cutils.c
> +++ b/tests/test-cutils.c
> @@ -28,6 +28,7 @@
>  #include "qemu/osdep.h"
>  
>  #include "qemu/cutils.h"
> +#include "hw/pci/pci.h"
>  
>  static void test_parse_uint_null(void)
>  {
> @@ -1437,6 +1438,46 @@ static void test_qemu_strtosz_suffix_unit(void)
>      g_assert_cmpint(res, ==, 12345000);
>  }
>  
> +static void test_pci_parse_valid(void)
> +{
> +    PCIHostDeviceAddress addr = { 0xff, 0xff, 0xff, 0xff };
> +    int i, res;
> +    const struct {
> +        const char *str;
> +        PCIHostDeviceAddress addr;
> +    } tests[] = {
> +        { "1:2.3", { 0, 1, 2, 3 } },
> +        { "4:1:2.3", { 4, 1, 2, 3 } },
> +        { "a:a:a.7", { 10, 10, 10, 7 } },
> +    };
> +
> +    for (i = 0; i < ARRAY_SIZE(tests); i++) {
> +        res = pci_host_device_address_parse(tests[i].str, &addr);
> +        g_assert_cmpint(res, ==, 0);
> +
> +        g_assert_cmpint(addr.domain, ==, tests[i].addr.domain);
> +        g_assert_cmpint(addr.bus, ==, tests[i].addr.bus);
> +        g_assert_cmpint(addr.slot, ==, tests[i].addr.slot);
> +        g_assert_cmpint(addr.function, ==, tests[i].addr.function);
> +    }
> +}
> +
> +static void test_pci_parse_invalid(void)
> +{
> +    int i, res;
> +    const char *tests[] =  {
> +        "", "foo", "1:2.3 foo",
> +        "a:a:a.a",
> +        "1", "1:", "1:2", "1:2:", "1:2:3", ":1:2:3.",
> +        "-1:1:2.3", "-1:2.3", "1:-1.3", "1:2.-3",
> +        "0x10000:1:1.1", "0x100:1.1", "1:0x20.1", "1:1.8" };
> +
> +    for (i = 0; i < ARRAY_SIZE(tests); i++) {
> +        res = pci_host_device_address_parse(tests[i], NULL);
> +        g_assert_cmpint(res, ==, -1);
> +    }
> +}
> +
>  int main(int argc, char **argv)
>  {
>      g_test_init(&argc, &argv, NULL);


Pls find a way to test is through a property.

> @@ -1598,5 +1639,10 @@ int main(int argc, char **argv)
>      g_test_add_func("/cutils/strtosz/suffix-unit",
>                      test_qemu_strtosz_suffix_unit);
>  
> +    g_test_add_func("/cutils/pci-parse/valid",
> +                    test_pci_parse_valid);
> +    g_test_add_func("/cutils/pci-parse/invalid",
> +                    test_pci_parse_invalid);
> +
>      return g_test_run();
>  }
> diff --git a/util/cutils.c b/util/cutils.c
> index 4fefcf3be3..fc71c85816 100644
> --- a/util/cutils.c
> +++ b/util/cutils.c
> @@ -29,6 +29,7 @@
>  #include "qemu/sockets.h"
>  #include "qemu/iov.h"
>  #include "net/net.h"
> +#include "hw/pci/pci.h"
>  #include "qemu/cutils.h"
>  
>  void strpadcpy(char *buf, int buf_size, const char *str, char pad)
> @@ -594,3 +595,61 @@ const char *qemu_ether_ntoa(const MACAddr *mac)
>  
>      return ret;
>  }
> +
> +int pci_host_device_address_parse(const char *str, PCIHostDeviceAddress *addr)
> +{
> +    const char *p = str;
> +    const char *e;
> +    unsigned long val;
> +    unsigned int dom = 0, bus = 0;
> +    unsigned int slot = 0, func = 0;
> +
> +    if (qemu_strtoul(p, &e, 16, &val) < 0
> +        || e == p || *e != ':') {
> +        return -1;
> +    }
> +    bus = val;
> +
> +    p = e + 1;
> +    if (qemu_strtoul(p, &e, 16, &val) < 0
> +        || e == p) {
> +        return -1;
> +    }
> +    if (*e == ':') {
> +        dom = bus;
> +        bus = val;
> +        p = e + 1;
> +        if (qemu_strtoul(p, &e, 16, &val) < 0
> +            || e == p) {
> +            return -1;
> +        }
> +    }
> +    slot = val;
> +
> +    if (*e != '.') {
> +        return -1;
> +    }
> +    p = e + 1;
> +    if (qemu_strtoul(p, &e, 10, &val) < 0
> +        || e == p) {
> +        return -1;
> +    }
> +    func = val;
> +
> +    if (dom > 0xffff || bus > 0xff || slot > 0x1f || func > 7) {
> +        return -1;
> +    }
> +
> +    if (*e) {
> +        return -1;
> +    }
> +
> +    if (addr) {
> +        addr->domain = dom;
> +        addr->bus = bus;
> +        addr->slot = slot;
> +        addr->function = func;
> +    }
> +
> +    return 0;
> +}
> -- 
> 2.11.0.295.gd7dffce1c.dirty