wl_display_connect

wayland-client
September 2012
Developer David Herrmann dh.herrmann@googlemail.com
wl_display_connect 3
wl_display_connect wl_display_connect_to_fd Connect to a Wayland socket

    #include <wayland-client.h>

struct wl_display *`wl_display_connect` const char *name struct wl_display *`wl_display_connect_to_fd` int fd

## Description

`wl_display_connect` connects to a Wayland socket that was previously opened by a Wayland server. The server socket must be placed in `XDG_RUNTIME_DIR` for this function to find it. The `name` argument specifies the name of the socket or `NULL` to use the default (which is `"wayland-0"`). The environment variable `WAYLAND_DISPLAY` replaces the default value. If `WAYLAND_SOCKET` is set, this function behaves like `wl_display_connect_to_fd` with the file-descriptor number taken from the environment variable.

`wl_display_connect_to_fd` connects to a Wayland socket with an explicit file-descriptor. The file-descriptor is passed as argument `fd`.

## Return Value

`wl_display_connect` and `wl_display_connect_to_fd` return a new display context object or NULL on failure. `errno` is set correspondingly.

## See Also

wayland-client 7, wl_display_disconnect 3, wl_display_iterate 3