From da8b1c1d1baafb9cf4a0cc9a88362f161f8d1319 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Mon, 20 Apr 2020 18:58:00 +0200 Subject: First commit MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- LIBAXL_REQUEST_GET_SELECTION_OWNER.3 | 62 ++++++++++++++++++++++++++++++++++++ 1 file changed, 62 insertions(+) create mode 100644 LIBAXL_REQUEST_GET_SELECTION_OWNER.3 (limited to 'LIBAXL_REQUEST_GET_SELECTION_OWNER.3') diff --git a/LIBAXL_REQUEST_GET_SELECTION_OWNER.3 b/LIBAXL_REQUEST_GET_SELECTION_OWNER.3 new file mode 100644 index 0000000..40c7bb5 --- /dev/null +++ b/LIBAXL_REQUEST_GET_SELECTION_OWNER.3 @@ -0,0 +1,62 @@ +.TH LIBAXL_REQUEST_GET_SELECTION_OWNER 3 libaxl +.SH NAME +LIBAXL_REQUEST_GET_SELECTION_OWNER - Get the owner of a selection +.SH SYNOPSIS +.nf +#include + +#define LIBAXL_REQUEST_GET_SELECTION_OWNER 23 +struct libaxl_request_get_selection_owner { + uint8_t \fIopcode\fP; + uint8_t \fI__pad\fP; + uint16_t \fI_request_length\fP; + libaxl_atom_t \fIselection\fP; +}; +.fi +.SH DESCRIPTION +The display server shall return the ID of +the window that owns the selection whose +atom ID is specified in the +.I selection +field. +.PP +The value of the +.I opcode +field shall be +.I LIBAXL_REQUEST_GET_SELECTION_OWNER +to signify that the request is of the +request described in this document. +.PP +Other fields are filled in automatically by the +.BR libaxl_send_request (3) +function. +.SH ERRORS +.TP +.BR LIBAXL_ERROR_ATOM (3) +The specified atom ID does not exist. +.SH REPLIES +.nf +struct libaxl_reply_get_selection_owner { + uint8_t \fI__one\fP; + uint8_t \fI__pad\fP; + uint16_t \fIsequence_number\fP; + uint32_t \fI_reply_length\fP; + libaxl_window_t \fIowner\fP; + uint8_t \fI__unused\fP[20]; +}; +.fi +.PP +The display server shall, unless it returns an +error, return one +.B "struct libaxl_reply_get_selection_owner" +with the +.I owner +field set to the ID of the window that owns +the specified selection, or +.I LIBAXL_NONE +if the selection does not have an owner. +.SH SEE ALSO +.BR libaxl_send_request (3), +.BR libaxl_receive (3), +.BR LIBAXL_REQUEST_SET_SELECTION_OWNER (3), +.BR LIBAXL_REQUEST_CONVERT_SELECTION (3) -- cgit v1.2.3-70-g09d2