summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorcaavery <cavery@redhat.com>2017-09-06 22:18:10 (GMT)
committerChristian Heimes <christian@python.org>2017-09-06 22:18:10 (GMT)
commiteffc12f8e9e20d0951d2ba5883587666bd8218e3 (patch)
tree7c017ddd36f528c98a36c2b08293eb843194deb9 /Doc
parent5d578442ed5ba5025e465b384341cb8646ffd819 (diff)
downloadcpython-effc12f8e9e20d0951d2ba5883587666bd8218e3.zip
cpython-effc12f8e9e20d0951d2ba5883587666bd8218e3.tar.gz
cpython-effc12f8e9e20d0951d2ba5883587666bd8218e3.tar.bz2
bpo-27584: New addition of vSockets to the python socket module (#2489)
* bpo-27584: New addition of vSockets to the python socket module Support for AF_VSOCK on Linux only * bpo-27584: Fixes for V2 Fixed syntax and naming problems. Fixed #ifdef AF_VSOCK checking Restored original aclocal.m4 * bpo-27584: Fixes for V3 Added checking for fcntl and thread modules. * bpo-27584: Fixes for V4 Fixed white space error * bpo-27584: Fixes for V5 Added back comma in (CID, port). * bpo-27584: Fixes for V6 Added news file. socket.rst now reflects first Linux introduction of AF_VSOCK. Fixed get_cid in test_socket.py. Replaced PyLong_FromLong with PyLong_FromUnsignedLong in socketmodule.c Got rid of extra AF_VSOCK #define. Added sockaddr_vm to sock_addr. * bpo-27584: Fixes for V7 Minor cleanup. * bpo-27584: Fixes for V8 Put back #undef AF_VSOCK as it is necessary when vm_sockets.h is not installed.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/socket.rst20
1 files changed, 20 insertions, 0 deletions
diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst
index c5064e9..42fd7ea 100644
--- a/Doc/library/socket.rst
+++ b/Doc/library/socket.rst
@@ -153,6 +153,14 @@ created. Socket addresses are represented as follows:
.. versionadded:: 3.6
+- :const:`AF_VSOCK` allows communication between virtual machines and
+ their hosts. The sockets are represented as a ``(CID, port)`` tuple
+ where the context ID or CID and port are integers.
+
+ Availability: Linux >= 4.8 QEMU >= 2.8 ESX >= 4.0 ESX Workstation >= 6.5
+
+ .. versionadded:: 3.7
+
- Certain other address families (:const:`AF_PACKET`, :const:`AF_CAN`)
support specific representations.
@@ -395,6 +403,18 @@ Constants
.. versionadded:: 3.6
+
+.. data:: AF_VSOCK
+ IOCTL_VM_SOCKETS_GET_LOCAL_CID
+ VMADDR*
+ SO_VM*
+
+ Constants for Linux host/guest communication.
+
+ Availability: Linux >= 4.8.
+
+ .. versionadded:: 3.7
+
.. data:: AF_LINK
Availability: BSD, OSX.