Type of a server

addresses server returns all the addresses the server is listenning on. These addresses must be passed to clients so they can connect to server.

shutdown server shutdowns the given server. It terminates when all listeners (a server may listen on several addresses) have exited. If the server has already been shut down, it does nothing.

make ?switch ?capabilities ?mechanisms ?addresses ?allow_anonymous f Creates a server which will listen on all of the given addresses.

• parameter capabilites

  is the set of the server's capabilities,

• parameter mechanisms

  is the list of authentication mechanisms supported by the server,

• parameter addresses

  default to { name = "unix"; args = [("tmpdir", "/tmp")],

• parameter allow_anonymous

  tell whether clients using anonymous authentication will be accepted. It defaults to false,

• parameter capabilities

  is the list of supported capabilities, it defaults to OBus_auth.capabilities

• parameter f

  is the callback which receive new clients. It takes as arguments the server and the connection for the client.

About errors:

• if no addresses are provided, it raises Invalid_argument,
• if an address is invalid, it raises Invalid_argument
• if listening fails for one of the addresses, it fails with the exception reported for that address

It succeeds if it can listen on at least one address.

When a new client connects, the server handles authentication of this client, then it creates a transport and the connection on top of this transport.

Note that connections passed to f are initially down. It is up to the user to set them up with OBus_connection.set_up.

make_lowlevel is the same as make except that f receives only the transport, and no connection is created for this transport.