Add the Linux VSOCK transport.

VSOCK transport allows communication between the Host
and guests.

It requires linux on the host and Guest.

Fixes #4491

Author: remijouannet

AUTHORS

@@ -102,6 +102,7 @@ Philip Kovacs
 Pieter Hintjens
 Piotr Trojanek
 Reza Ebrahimi
+Remi Jouannet
 Richard Newton
 Rik van der Heijden
 Robert G. Jakabosky

CMakeLists.txt

@@ -1160,6 +1160,9 @@ set(cxx-sources
     vmci_address.hpp
     vmci_connecter.hpp
     vmci_listener.hpp
+    vsock_address.hpp
+    vsock_connecter.hpp
+    vsock_listener.hpp
     windows.hpp
     wire.hpp
     xpub.hpp
@@ -1233,6 +1236,10 @@ message(STATUS "Building with VMCI")
   list(APPEND cxx-sources vmci_address.cpp vmci_connecter.cpp vmci_listener.cpp vmci.cpp)
 endif()
 
+if(ZMQ_HAVE_VSOCK)
+  list(APPEND cxx-sources vsock_address.cpp vsock_connecter.cpp vsock_listener.cpp)
+endif()
+
 if(ZMQ_HAVE_TIPC)
   list(APPEND cxx-sources tipc_address.cpp tipc_connecter.cpp tipc_listener.cpp)
 endif()

Makefile.am

@@ -255,6 +255,12 @@ src_libzmq_la_SOURCES = \
 	src/vmci_connecter.hpp \
 	src/vmci_listener.cpp \
 	src/vmci_listener.hpp \
+	src/vsock_address.cpp \
+	src/vsock_address.hpp \
+	src/vsock_connecter.cpp \
+	src/vsock_connecter.hpp \
+	src/vsock_listener.cpp \
+	src/vsock_listener.hpp \
 	src/windows.hpp \
 	src/wire.hpp \
 	src/xpub.cpp \
@@ -1047,6 +1053,19 @@ tests_test_reqrep_vmci_CXXFLAGS = @LIBZMQ_VMCI_CXXFLAGS@
 
 endif
 
+if BUILD_VSOCK
+test_apps += tests/test_pair_vsock tests/test_reqrep_vsock
+
+tests_test_pair_vsock_SOURCES = tests/test_pair_vsock.cpp
+tests_test_pair_vsock_LDADD = ${TESTUTIL_LIBS} src/libzmq.la
+tests_test_pair_vsock_CPPFLAGS = ${TESTUTIL_CPPFLAGS}
+
+tests_test_reqrep_vsock_SOURCES = tests/test_reqrep_vsock.cpp
+tests_test_reqrep_vsock_LDADD = ${TESTUTIL_LIBS} src/libzmq.la
+tests_test_reqrep_vsock_CPPFLAGS = ${TESTUTIL_CPPFLAGS}
+
+endif
+
 if ENABLE_DRAFTS
 test_apps += tests/test_poller \
 	tests/test_client_server \

builds/cmake/platform.hpp.in

@@ -71,6 +71,7 @@
 #cmakedefine ZMQ_HAVE_OPENPGM
 #cmakedefine ZMQ_HAVE_NORM
 #cmakedefine ZMQ_HAVE_VMCI
+#cmakedefine ZMQ_HAVE_VSOCK
 
 #cmakedefine ZMQ_MAKE_VALGRIND_HAPPY
 

configure.ac

@@ -128,6 +128,22 @@ AC_RUN_IFELSE(
 
 AC_MSG_RESULT([$libzmq_tipc_support])
 
+
+# check vsock support
+AC_MSG_CHECKING([if vsock is available ])
+
+AC_CHECK_HEADERS([linux/vm_sockets.h],
+   [libzmq_vsock_support=yes],
+   [libzmq_vsock_support=no],
+   [
+    #include <sys/socket.h>
+    #include <linux/vm_sockets.h>
+   ]
+)
+AC_MSG_RESULT([$libzmq_vsock_support])
+
+
+
 AC_ARG_ENABLE([pedantic],
     [AS_HELP_STRING([--disable-pedantic], [disable pedantic compiler checks [default=enabled]])],
     [libzmq_pedantic=$enableval], [libzmq_pedantic=yes])
@@ -235,6 +251,10 @@ case "${host_os}" in
         if test "x$libzmq_tipc_support" = "xyes"; then
             AC_DEFINE(ZMQ_HAVE_TIPC, 1, [Have TIPC support])
         fi
+
+        if test "x$libzmq_vsock_support" = "xyes"; then
+            AC_DEFINE(ZMQ_HAVE_VSOCK, 1, [Have vsock support])
+        fi
         case "${host_os}" in
             *android*)
                 AC_DEFINE(ZMQ_HAVE_ANDROID, 1, [Have Android OS])
@@ -774,6 +794,7 @@ fi
 
 AM_CONDITIONAL(HAVE_VMCI, test "x$have_vmci_ext" != "xno")
 
+
 # Set -Wall, -Werror and -pedantic
 AC_LANG_PUSH([C++])
 
@@ -789,6 +810,7 @@ if test "x$libzmq_pedantic" = "xyes"; then
 fi
 AC_LANG_POP([C++])
 
+AM_CONDITIONAL(BUILD_VSOCK, test "x$libzmq_vsock_support" = "xyes")
 AM_CONDITIONAL(BUILD_TIPC, test "x$libzmq_tipc_support" = "xyes")
 AM_CONDITIONAL(ON_MINGW, test "x$libzmq_on_mingw" = "xyes")
 AM_CONDITIONAL(ON_CYGWIN, test "x$libzmq_on_cygwin" = "xyes")

doc/Makefile.am

@@ -26,7 +26,7 @@ MAN3 = \
 MAN7 = \
     zmq.7 zmq_tcp.7 zmq_pgm.7 zmq_inproc.7 zmq_ipc.7 \
     zmq_null.7 zmq_plain.7 zmq_curve.7 zmq_tipc.7 zmq_vmci.7 zmq_udp.7 \
-    zmq_gssapi.7
+    zmq_gssapi.7 zmq_vsock.7
 
 # ASCIIDOC_DOC_WITHOUT_INDEX contains all the Asciidoc files checked into the git repo, except for index.adoc
 ASCIIDOC_DOC_WITHOUT_INDEX = $(MAN3:%.3=%.adoc) $(MAN7:%.7=%.adoc)

doc/zmq.adoc

@@ -165,12 +165,14 @@ Local inter-process communication transport::
 Local in-process (inter-thread) communication transport::
  * xref:zmq_inproc.adoc[zmq_inproc]
 
-Virtual Machine Communications Interface (VMC) transport::
+Virtual Machine Communications Interface (VMCI) transport::
  * xref:zmq_vmci.adoc[zmq_vmci]
 
 Unreliable unicast and multicast using UDP::
  * xref:zmq_udp.adoc[zmq_udp]
 
+Linux VSOCK (AF_VSCOK) transport::
+ * xref:zmq_vsock.adoc[zmq_vsock]
 
 Proxies
 ~~~~~~~

doc/zmq_bind.adoc

@@ -25,14 +25,15 @@ The 'endpoint' is a string consisting of a 'transport'`://` followed by an
 'pgm', 'epgm':: reliable multicast transport using PGM, see xref:zmq_pgm.adoc[zmq_pgm]
 'vmci':: virtual machine communications interface (VMCI), see xref:zmq_vmci.adoc[zmq_vmci]
 'udp':: unreliable unicast and multicast using UDP, see xref:zmq_udp.adoc[zmq_udp]
+'vsock':: Linux VSOCK, see xref:zmq_vsock.adoc[zmq_vsock]
 
 Every 0MQ socket type except 'ZMQ_PAIR' and 'ZMQ_CHANNEL' supports one-to-many and many-to-one
 semantics. The precise semantics depend on the socket type and are defined in
 xref:zmq_socket.adoc[zmq_socket]
 
-The 'ipc', 'tcp', 'vmci' and 'udp' transports accept wildcard addresses: see
-xref:zmq_ipc.adoc[zmq_ipc], xref:zmq_tcp.adoc[zmq_tcp], xref:zmq_vmci.adoc[zmq_vmci] and
-xref:zmq_udp.adoc[zmq_udp] for details.
+The 'ipc', 'tcp', 'vmci', 'udp' and 'vsock' transports accept wildcard addresses: see
+xref:zmq_ipc.adoc[zmq_ipc], xref:zmq_tcp.adoc[zmq_tcp], xref:zmq_vmci.adoc[zmq_vmci],
+xref:zmq_udp.adoc[zmq_udp] and xref:zmq_vsock.adoc[zmq_vsock] for details.
 
 NOTE: the address syntax may be different for _zmq_bind()_ and _zmq_connect()_
 especially for the 'tcp', 'pgm' and 'epgm' transports.

doc/zmq_connect.adoc

@@ -25,6 +25,7 @@ The 'endpoint' is a string consisting of a 'transport'`://` followed by an
 'pgm', 'epgm':: reliable multicast transport using PGM, see xref:zmq_pgm.adoc[zmq_pgm]
 'vmci':: virtual machine communications interface (VMCI), see xref:zmq_vmci.adoc[zmq_vmci]
 'udp':: unreliable unicast and multicast using UDP, see xref:zmq_udp.adoc[zmq_udp]
+'vsock':: Linux VSOCK, see xref:zmq_vsock.adoc[zmq_vsock]
 
 Every 0MQ socket type except 'ZMQ_PAIR' and 'ZMQ_CHANNEL' supports one-to-many and many-to-one
 semantics. The precise semantics depend on the socket type and are defined in

doc/zmq_inproc.adoc

@@ -73,6 +73,7 @@ assert (rc == 0);
 * xref:zmq_tcp.adoc[zmq_tcp]
 * xref:zmq_pgm.adoc[zmq_pgm]
 * xref:zmq_vmci.adoc[zmq_vmci]
+* xref:zmq_vsock.adoc[zmq_vsock]
 * xref:zmq.adoc[zmq]