Turn internal device link into a public object

To enable arbitrary parameters to be set on the association
between the device & hypervisor/os objects, turn the internal
device link struct into a formal managed OsinfoEntity called
OsinfoDeviceLink.

* data/libosinfo-dummy-data.xml: Make 'driver' into a entity
  parameter instead of link text content
* docs/reference/Libosinfo-docs.xml,
  docs/reference/Libosinfo-sections.txt: Add OsinfoDeviceLink
  and OsinfoDeviceLinkList objects
* docs/reference/Libosinfo-sections.txt, osinfo/libosinfo.syms,
  osinfo/osinfo.h, osinfo/osinfo_devicelink.c,
  osinfo/osinfo_devicelink.h, osinfo/osinfo_devicelinklist.c,
  osinfo/osinfo_devicelinklist.h: Add OsinfoDeviceLink and
  OsinfoDeviceLinkList objects.
* osinfo/osinfo_hypervisor.c, osinfo/osinfo_hypervisor.h,
  osinfo/osinfo_os.c, osinfo/osinfo_os.c: Convert internal
  device links to use OsinfoDeviceLink object
* osinfo/osinfo_loader.c: Allow setting of 'driver' attribute
  on device links
* test/test-hypervisor.c, test/test-os.c: Update for API
  change

2 files changed, 45 insertions, 0 deletions

diff --git a/docs/reference/Libosinfo-docs.xml b/docs/reference/Libosinfo-docs.xml
index 44b5506..1b6c92b 100644
--- a/docs/reference/Libosinfo-docs.xml
+++ b/docs/reference/Libosinfo-docs.xml
@@ -18,6 +18,8 @@
     <xi:include href="xml/osinfo_db.xml"/>
     <xi:include href="xml/osinfo_device.xml"/>
     <xi:include href="xml/osinfo_devicelist.xml"/>
+    <xi:include href="xml/osinfo_devicelink.xml"/>
+    <xi:include href="xml/osinfo_devicelinklist.xml"/>
     <xi:include href="xml/osinfo_entity.xml"/>
     <xi:include href="xml/osinfo_filter.xml"/>
     <xi:include href="xml/osinfo_hypervisor.xml"/>
diff --git a/docs/reference/Libosinfo-sections.txt b/docs/reference/Libosinfo-sections.txt
index baa086f..216ad18 100644
--- a/docs/reference/Libosinfo-sections.txt
+++ b/docs/reference/Libosinfo-sections.txt
@@ -83,8 +83,10 @@ OsinfoOsPrivate
 OsinfoOsRelationship
 osinfo_os_new
 osinfo_os_get_preferred_device
+osinfo_os_get_preferred_device_link
 osinfo_os_get_related
 osinfo_os_get_devices
+osinfo_os_get_device_links
 osinfo_os_add_device
 osinfo_os_add_related_os
 <SUBSECTION Standard>
@@ -105,6 +107,7 @@ OsinfoHypervisorClass
 OsinfoHypervisorPrivate
 osinfo_hypervisor_new
 osinfo_hypervisor_get_devices
+osinfo_hypervisor_get_device_links
 osinfo_hypervisor_add_device
 <SUBSECTION Standard>
 OSINFO_HYPERVISOR
@@ -183,6 +186,28 @@ OSINFO_DEVICELIST_GET_CLASS
 </SECTION>
 
 <SECTION>
+<FILE>osinfo_devicelinklist</FILE>
+<TITLE>OsinfoDeviceLinkList</TITLE>
+OsinfoDeviceLinkList
+OsinfoDeviceLinkListClass
+OsinfoDeviceLinkListPrivate
+osinfo_devicelinklist_new
+osinfo_devicelinklist_new_copy
+osinfo_devicelinklist_new_filtered
+osinfo_devicelinklist_new_intersection
+osinfo_devicelinklist_new_union
+osinfo_devicelinklist_get_devices
+<SUBSECTION Standard>
+OSINFO_DEVICELINKLIST
+OSINFO_IS_DEVICELINKLIST
+OSINFO_TYPE_DEVICELINKLIST
+osinfo_devicelinklist_get_type
+OSINFO_DEVICELINKLIST_CLASS
+OSINFO_IS_DEVICELINKLIST_CLASS
+OSINFO_DEVICELINKLIST_GET_CLASS
+</SECTION>
+
+<SECTION>
 <FILE>osinfo_osfilter</FILE>
 <TITLE>OsinfoOsfilter</TITLE>
 OsinfoOsfilter
@@ -262,3 +287,21 @@ OSINFO_IS_DEVICE_CLASS
 OSINFO_DEVICE_GET_CLASS
 </SECTION>
 
+<SECTION>
+<FILE>osinfo_devicelink</FILE>
+<TITLE>OsinfoDeviceLink</TITLE>
+OsinfoDeviceLink
+OsinfoDeviceLinkClass
+OsinfoDeviceLinkPrivate
+osinfo_devicelink_new
+osinfo_devicelink_get_target
+<SUBSECTION Standard>
+OSINFO_DEVICELINK
+OSINFO_IS_DEVICELINK
+OSINFO_TYPE_DEVICELINK
+osinfo_devicelink_get_type
+OSINFO_DEVICELINK_CLASS
+OSINFO_IS_DEVICELINK_CLASS
+OSINFO_DEVICELINK_GET_CLASS
+</SECTION>
+