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

[Marc-André Lureau]

Hi

----- Original Message -----
> 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 <address@hidden>
> 
> 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 :)


Well, if you are PCI maintainer, I guess it falls into you anyway ;)

> 
> > ---
> > 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.

It's an internal interface, with a single user and a test. Not a big deal.

> 
> > 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.

Probably doable, though it's less of a unit test then. I'll look into doing it.

> 
> > @@ -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
>