Soup.Server.listen

### Method

# Soup Serverlisten

#### Declaration [src]

    gboolean
    soup_server_listen (
      SoupServer* server,
      GSocketAddress* address,
      SoupServerListenOptions options,
      GError** error
    )

#### Description [src]

Attempts to set up `server` to listen for connections on `address`.

If `options` includes `SOUP_SERVER_LISTEN_HTTPS`, and `server` has been configured for TLS, then `server` will listen for https connections on this port. Otherwise it will listen for plain http.

You may call this method (along with the other “listen” methods) any number of times on a server, if you want to listen on multiple ports, or set up both http and https service.

After calling this method, `server` will begin accepting and processing connections as soon as the appropriate `GMainContext` is run.

Note that this API does not make use of dual IPv4/IPv6 sockets; if `address` is an IPv6 address, it will only accept IPv6 connections. You must configure IPv4 listening separately.

#### Parameters

`address` | `GSocketAddress`
| The address of the interface to listen on.
| The data is owned by the caller of the function.
`options` | `SoupServerListenOptions`
| Listening options for this server.
`error` | `GError **`
| The return location for a `GError*`, or `NULL`.

#### Return value

Returns: | `gboolean`
| `TRUE` on success, `FALSE` if `address` could not be bound or any other error occurred (in which case `error` will be set).