Module org.newsclub.net.unix.vsock

Package org.newsclub.net.unix.vsock

Class AFVSOCKProxyServerSocketConnector

java.lang.Object

org.newsclub.net.unix.vsock.AFVSOCKProxyServerSocketConnector

All Implemented Interfaces:

AFServerSocketConnector<AFVSOCKSocketAddress,AFSocketAddress>

public final class AFVSOCKProxyServerSocketConnector
extends Object
implements AFServerSocketConnector<AFVSOCKSocketAddress,AFSocketAddress>

Provides access to AF_VSOCK connections that aren't directly accessible but exposed via a proxying/multiplexing Unix domain socket.

Author:

Christian Kohlschütter

See Also:

• openFirecrackerStyleConnector(File, int)
• openDirectConnector()

Method Summary

Modifier and Type	Method	Description
AFServerSocket<?>	bind(AFVSOCKSocketAddress addr)	Creates an AFServerSocket bound to the given address.
static AFServerSocketConnector<AFVSOCKSocketAddress,AFSocketAddress>	openDirectConnector()	Returns an instance that is configured to connect directly to the given address.
static AFServerSocketConnector<AFVSOCKSocketAddress,AFSocketAddress>	openFirecrackerStyleConnector(File listenAddressPrefix, int allowedCID)	Returns an instance that is configured to support [Firecracker-style](https://github.com/firecracker-microvm/firecracker/blob/main/docs/vsock.md) Unix domain sockets.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

openFirecrackerStyleConnector

public static AFServerSocketConnector<AFVSOCKSocketAddress,AFSocketAddress> openFirecrackerStyleConnector(File listenAddressPrefix,
 int allowedCID)

Returns an instance that is configured to support [Firecracker-style](https://github.com/firecracker-microvm/firecracker/blob/main/docs/vsock.md) Unix domain sockets.

Parameters:

listenAddressPrefix - The prefix of any listening socket. The actual socket will have _vsockPort appended to it (with vsockPort being replaced by the corresponding port number).

allowedCID - The permitted CID, or AFVSOCKSocketAddress.VMADDR_CID_ANY for "any".

Returns:

The instance.

openDirectConnector

public static AFServerSocketConnector<AFVSOCKSocketAddress,AFSocketAddress> openDirectConnector()

Returns an instance that is configured to connect directly to the given address.

Returns:

The direct instance.

bind

public AFServerSocket<?> bind(AFVSOCKSocketAddress addr)
                       throws IOException

Description copied from interface: AFServerSocketConnector

Creates an AFServerSocket bound to the given address.

Specified by:

bind in interface AFServerSocketConnector<AFVSOCKSocketAddress,AFSocketAddress>

Parameters:

addr - The address to bind to.

Returns:

The bound socket.

Throws:

IOException - on error.