Data Fields
xdg_shell_listener Struct Reference

xdg_shell - create desktop-style surfaces : check if the client is alive More...

Data Fields

void(* ping )(void *data, struct xdg_shell *xdg_shell, uint32_t serial)
 ping - check if the client is alive : pass this to the callback More...
 

Detailed Description

xdg_shell - create desktop-style surfaces : check if the client is alive

This interface is implemented by servers that provide desktop-style user interfaces.

It allows clients to associate a xdg_surface with a basic surface.

Field Documentation

void(* xdg_shell_listener::ping) (void *data, struct xdg_shell *xdg_shell, uint32_t serial)

ping - check if the client is alive : pass this to the callback

The ping event asks the client if it's still alive. Pass the serial specified in the event back to the compositor by sending a "pong" request back with the specified serial.

Compositors can use this to determine if the client is still alive. It's unspecified what will happen if the client doesn't respond to the ping request, or in what timeframe. Clients should try to respond in a reasonable amount of time.