Type of message transport

recv tr receives one message from the given transport

send tr msg sends msg over the transport tr.

Returns the capabilities of the transport

shutdown tr frees resources allocated by the given transport

make ?switch ~recv ~send ~support_unxi_fd ~shutdown () creates a new transport from the given functions.

• parameter capabilities

  defaults to [].

Notes:

• message reading/writing are serialized by obus, so there is no need to handle concurrent access to transport

Loopback transport, each message sent is received on the same transport

socket ?switch ?capabilities socket creates a socket transport.

• parameter capabilities

  defaults to []. For unix sockets, the `Unix_fd capability is accepted.

of_addresses ?switch ?capabilities ?mechanisms addresses tries to:

• connect to the server using one of the given given addresses,
• authenticate itself to the server using mechanisms, which defaults to OBus_auth.Client.default_mechanisms,
• negotiates capabilities, which defaults to OBus_auth.capabilities

If all succeeded, it returns the server address guid and the newly created transport, which is ready to send and receive messages.

Note about errors:

• if one of the addresses is not valid, or addresses = [], it raises Invalid_argument,
• if all connections failed, it raises the exception raised by the try on first address, which is either a Failure or a Unix.Unix_error
• if the authentication failed, a OBus_auth.Auth_error is raised