Feature or enhancement

Currentlysocket.connect() accepts a wide range of values when connecting to a socket with the code insocketmodule.c transforming it based on the family the socket was created with. Unfortunately there is a check that fails the connection if the family is unrecognized

My proposal is to allow a caller to bypass this check if passing in a raw byte value to be used as the addr info on the native call.

Pitch

The reason why I am hoping for this feature is to support clients connecting to a Hyper-V socket. This uses theAF_HYPERV family which isn't known to Python so any attempts to connect to it won't work.

Currently I am using the following to work around this restriction by using ctypes to call the C API directly and using the fileno:

importctypesimportsocketimportuuidHV_GUID_VM_SESSION_SERVICE_ID=uuid.UUID("999e53d4-3d5c-4c3e-8779-bed06ec056e1")HV_GUID_VM_SESSION_SERVICE_ID_2=uuid.UUID("a5201c21-2770-4c11-a68e-f182edb29220")AF_HYPERV=34HV_PROTOCOL_RAW=1# This is the GUID of the Win VM to connect tovm_id=uuid.UUID("...")win32sock=ctypes.WinDLL("Ws2_32.dll")raw_sock=win32sock.socket(AF_HYPERV,socket.SOCK_STREAM,HV_PROTOCOL_RAW)ifraw_sock==-1:err=win32sock.WSAGetLastError()raisectypes.WinError(code=err)try:sock_addr=b"\x22\x00\x00\x00"+vm_id.bytes_le+HV_GUID_VM_SESSION_SERVICE_ID.bytes_leres=win32sock.connect(raw_sock,sock_addr,len(sock_addr))ifres:err=win32sock.WSAGetLastError()raisectypes.WinError(code=err)sock=socket.socket(fileno=raw_sock)except:win32sock.closesocket(raw_sock)raise...sock.close()

It would be good to be able to do this instead

importsocketsock=socket.socket(AF_HYPERV,socket.SOCK_STREAM,HV_PROTOCOL_RAW)sock_addr=b"\x22\x00\x00\x00"+vm_id.bytes_le+HV_GUID_VM_SESSION_SERVICE_ID.bytes_lesock.connect(sock_addr)...sock.close()

Currently that fails due to the hardcoded check against unknown families

Traceback (mostrecentcalllast):File"<stdin>",line1,in<module>OSError:connect():badfamily

Another option is to add support forAF_HYPERV on Windows and support a tuple of (vm_id, service_id) and have Python create the struct. This could be done as a separate feature request potentially.

Linked PRs

• gh-92658: Fix typo in docs and tests forHV_GUID_PARENT #105267
• [3.12] gh-92658: Fix typo in docs and tests forHV_GUID_PARENT (GH-105267) #105398