[libvirt] [PATCH v2 08/12] Introduce virConnectIsAlive API

[Jiri Denemark]

This API can be used to check if the socket associated with
virConnectPtr is still open or it was closed (probably because keepalive
protocol timed out). If there the connection is local (i.e., no socket
is associated with the connection, it is trivially always alive.
---
 include/libvirt/libvirt.h.in |    1 +
 src/driver.h                 |    3 +++
 src/libvirt.c                |   36 ++++++++++++++++++++++++++++++++++++
 src/libvirt_public.syms      |    1 +
 4 files changed, 41 insertions(+), 0 deletions(-)

diff --git a/include/libvirt/libvirt.h.in b/include/libvirt/libvirt.h.in
index 6f61cc0..3767582 100644
--- a/include/libvirt/libvirt.h.in
+++ b/include/libvirt/libvirt.h.in
@@ -2546,6 +2546,7 @@ int virInterfaceIsActive(virInterfacePtr iface);
 
 int virConnectIsEncrypted(virConnectPtr conn);
 int virConnectIsSecure(virConnectPtr conn);
+int virConnectIsAlive(virConnectPtr conn);
 
 /*
  * CPU specification API
diff --git a/src/driver.h b/src/driver.h
index cd17d83..8c01690 100644
--- a/src/driver.h
+++ b/src/driver.h
@@ -506,6 +506,8 @@ typedef int
 typedef int
     (*virDrvConnectIsSecure)(virConnectPtr conn);
 typedef int
+    (*virDrvConnectIsAlive)(virConnectPtr conn);
+typedef int
     (*virDrvDomainIsActive)(virDomainPtr dom);
 typedef int
     (*virDrvDomainIsPersistent)(virDomainPtr dom);
@@ -881,6 +883,7 @@ struct _virDriver {
     virDrvDomainBlockPull domainBlockPull;
     virDrvAllowKeepAlive allowKeepAlive;
     virDrvStartKeepAlive startKeepAlive;
+    virDrvConnectIsAlive isAlive;
 };
 
 typedef int
diff --git a/src/libvirt.c b/src/libvirt.c
index 138f367..19ac4b5 100644
--- a/src/libvirt.c
+++ b/src/libvirt.c
@@ -16697,3 +16697,39 @@ error:
     virDispatchError(conn);
     return -1;
 }
+
+/**
+ * virConnectIsAlive:
+ * @conn: pointer to the connection object
+ *
+ * Determine if the connection to the hypervisor is still alive
+ *
+ * A connection will be classed as alive if it is either local, or running
+ * over a channel (TCP or UNIX socket) which is not closed.
+ *
+ * Returns 1 if alive, 0 if dead, -1 on error
+ */
+int virConnectIsAlive(virConnectPtr conn)
+{
+    VIR_DEBUG("conn=%p", conn);
+
+    virResetLastError();
+
+    if (!VIR_IS_CONNECT(conn)) {
+        virLibConnError(VIR_ERR_INVALID_CONN, __FUNCTION__);
+        virDispatchError(NULL);
+        return -1;
+    }
+    if (conn->driver->isAlive) {
+        int ret;
+        ret = conn->driver->isAlive(conn);
+        if (ret < 0)
+            goto error;
+        return ret;
+    }
+
+    virLibConnError(VIR_ERR_NO_SUPPORT, __FUNCTION__);
+error:
+    virDispatchError(conn);
+    return -1;
+}
diff --git a/src/libvirt_public.syms b/src/libvirt_public.syms
index f7441d7..e60f66d 100644
--- a/src/libvirt_public.syms
+++ b/src/libvirt_public.syms
@@ -492,6 +492,7 @@ LIBVIRT_0.9.5 {
 LIBVIRT_0.9.7 {
     global:
         virConnectAllowKeepAlive;
+        virConnectIsAlive;
         virConnectStartKeepAlive;
 } LIBVIRT_0.9.5;
 
-- 
1.7.6.1