speech-dispatcher: Address specification

 
 3.2 Address specification
 =========================
 
 Speech Dispatcher provides several methods of communication and can be
 used both locally and over network.  ⇒Communication mechanisms.
 Client applications and interface libraries need to recognize an
 address, which specifies how and where to contact the appropriate
 server.
 
    Address specification consists from the method and one or more of its
 parameters, each item separated by a colon:
 
      method:parameter1:parameter2
 
    The method is either 'unix_socket' or 'inet_socket'.  Parameters are
 optional.  If not used in the address line, their default value will be
 used.
 
    Two forms are currently recognized:
 
      unix_socket:full/path/to/socket
      inet_socket:host_ip:port
 
    Examples of valid address lines are:
      unix_socket
      unix_socket:/tmp/test.sock
      inet_socket
      inet_socket:192.168.0.34
      inet_socket:192.168.0.34:6563
 
    Clients implement different mechanisms how the user can set the
 address.  Clients should respect the SPEECHD_ADDRESS environment
 variable ⇒Setting Communication Method, unless the user overrides
 its value by settings in the client application itself.  Clients should
 fallback to the default address, if neither the environment variable or
 their specific configuration is set.
 
    The default communication address currently is:
 
      unix_socket:/$XDG_RUNTIME_DIR/speech-dispatcher/speechd.sock
 
    where '~' stands for the path to the users home directory.