Documents the following TIOCL_SETSEL sub-operations: * TIOCL_SELPOINTER * TIOCL_SELCLEAR * TIOCL_SELMOUSEREPORT These previously undocumented selection modes for the Linux console are implemented in drivers/tty/vt/selection.c. The name "selection mode" is slightly misleading as not all of them actually manipulate the kernel's mouse selection buffer. Cc: Jared Finder <jared@xxxxxxxxxx> Cc: Hanno Böck <hanno@xxxxxxxxx> Cc: Jann Horn <jannh@xxxxxxxxxx> Cc: Jiri Slaby <jirislaby@xxxxxxxxxx> Cc: jwilk@xxxxxxxxx Signed-off-by: Günther Noack <gnoack3000@xxxxxxxxx> --- man/man2const/TIOCLINUX.2const | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/man/man2const/TIOCLINUX.2const b/man/man2const/TIOCLINUX.2const index 5db3f6ea6..3aa1c7eb2 100644 --- a/man/man2const/TIOCLINUX.2const +++ b/man/man2const/TIOCLINUX.2const @@ -82,6 +82,35 @@ and saved in a kernel buffer. Select line-by-line. The indicated screen characters are highlighted and saved in a kernel buffer. +.TP +.B TIOCL_SELPOINTER +Show the pointer at position +.RI ( xe ,\~ ye ). +.TP +.B TIOCL_SELCLEAR +Remove the current selection highlight, if any, +from the console holding the selection. +.TP +.B TIOCL_SELMOUSEREPORT +Make the terminal report +.RI ( xs ,\~ ys ) +as the current mouse location +using the +.BR xterm (1) +mouse tracking protocol +(see +.BR console_codes (4)). +The lower 4 bits of +.I sel_mode +.RB ( TIOCL_SELBUTTONMASK ) +indicate the desired button press and +modifier key information for the mouse event. +.\" <https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h3-Normal-tracking-mode> +.IP +If mouse reporting is not enabled for the terminal, +this operation yields an +.B EINVAL +error. .RE .IP Since Linux 6.7, using this subcode requires the -- 2.48.1
