From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <gentoo-commits+bounces-1526737-garchives=archives.gentoo.org@lists.gentoo.org>
Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (2048 bits))
(No client certificate requested)
by finch.gentoo.org (Postfix) with ESMTPS id 331EC15810F
for <garchives@archives.gentoo.org>; Fri, 9 Jun 2023 11:02:29 +0000 (UTC)
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
by pigeon.gentoo.org (Postfix) with SMTP id 73065E07E6;
Fri, 9 Jun 2023 11:02:28 +0000 (UTC)
Received: from smtp.gentoo.org (dev.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256)
(No client certificate requested)
by pigeon.gentoo.org (Postfix) with ESMTPS id 5AC12E07E6
for <gentoo-commits@lists.gentoo.org>; Fri, 9 Jun 2023 11:02:28 +0000 (UTC)
Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (4096 bits))
(No client certificate requested)
by smtp.gentoo.org (Postfix) with ESMTPS id 6E880340D1D
for <gentoo-commits@lists.gentoo.org>; Fri, 9 Jun 2023 11:02:27 +0000 (UTC)
Received: from localhost.localdomain (localhost [IPv6:::1])
by oystercatcher.gentoo.org (Postfix) with ESMTP id 0CEFCA82
for <gentoo-commits@lists.gentoo.org>; Fri, 9 Jun 2023 11:02:26 +0000 (UTC)
From: "Sam James" <sam@gentoo.org>
To: gentoo-commits@lists.gentoo.org
Content-Transfer-Encoding: 8bit
Content-type: text/plain; charset=UTF-8
Reply-To: gentoo-dev@lists.gentoo.org, "Sam James" <sam@gentoo.org>
Message-ID: <1686136464.e08b541e2c875d7718d4452bbd8bb1228bd1a53b.sam@gentoo>
Subject: [gentoo-commits] proj/gentoo-functions:master commit in: /
X-VCS-Repository: proj/gentoo-functions
X-VCS-Files: ecma48-cpr.c
X-VCS-Directories: /
X-VCS-Committer: sam
X-VCS-Committer-Name: Sam James
X-VCS-Revision: e08b541e2c875d7718d4452bbd8bb1228bd1a53b
X-VCS-Branch: master
Date: Fri, 9 Jun 2023 11:02:26 +0000 (UTC)
Precedence: bulk
List-Post: <mailto:gentoo-commits@lists.gentoo.org>
List-Help: <mailto:gentoo-commits+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-commits+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-commits+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-commits.gentoo.org>
X-BeenThere: gentoo-commits@lists.gentoo.org
X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply
X-Archives-Salt: f5026796-7de3-423f-8185-a983c287666c
X-Archives-Hash: 02782a1dca1ae4afe6d654208109a00b
commit: e08b541e2c875d7718d4452bbd8bb1228bd1a53b
Author: Kerin Millar <kfm <AT> plushkava <DOT> net>
AuthorDate: Tue Jun 6 03:54:50 2023 +0000
Commit: Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Wed Jun 7 11:14:24 2023 +0000
URL: https://gitweb.gentoo.org/proj/gentoo-functions.git/commit/?id=e08b541e
Introduce a utility to obtain the cursor coordinates via ECMA-48 CPR
The ECMA-48 specification defines the CPR (Cursor Position Report)
sequence which, as its name implies, instructs the terminal to divulge
the present coordinates of the cursor. Though it is theoretically
possible to make use of this sequence by using the shell and standard
utilities, it would be tremendously costly and somewhat unreliable to
do so. This commit introduces a utility - written in C - that does the
job.
Its behaviour is quite simple. If STDIN is found to be a terminal, an
attempt will be made to initiate - and read - a Cursor Position Report.
Upon success, the present row and column of the cursor shall be printed
as two space-separated decimal integers. Otherwise, a diagnostic
message shall be printed to STDERR, and the utility shall exit with
a non-zero status.
This utility will be used by the impending overhaul of the _eprint()
and _eend() functions.
Signed-off-by: Kerin Millar <kfm <AT> plushkava.net>
Signed-off-by: Sam James <sam <AT> gentoo.org>
ecma48-cpr.c | 230 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 230 insertions(+)
diff --git a/ecma48-cpr.c b/ecma48-cpr.c
new file mode 100644
index 0000000..9aef182
--- /dev/null
+++ b/ecma48-cpr.c
@@ -0,0 +1,230 @@
+/*
+ * ecma48-cpr.c
+ * Treat STDIN as a tty and report the cursor position using the CPR sequence.
+ *
+ * Originally distributed as wsize.c by Stephen J. Friedl <steve@unixwiz.net>.
+ * Repurposed for gentoo-functions by Kerin F. Millar <kfm@plushkava.net>.
+ * This software is in the public domain.
+ */
+
+#define _POSIX_C_SOURCE 200809L
+
+#define PROGRAM "ecma48-cpr"
+#define READ_TIMEOUT_NS 250000000
+#define BUFSIZE 100
+#define MAX_LOOPS 20
+
+#include <signal.h>
+#include <stdbool.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <termios.h>
+#include <time.h>
+#include <unistd.h>
+
+static struct termios save_tty;
+static bool is_timed_out = false;
+static bool is_tty_saved = false;
+
+static void cleanup(void);
+static void die(char const * const errmsg);
+static void on_signal(int const signo);
+
+#ifndef __APPLE__
+static timer_t init_timer(void);
+#endif
+
+int
+main(void) {
+ /*
+ * Establish that STDIN is a terminal.
+ */
+ if (! isatty(STDIN_FILENO)) {
+ die("cannot determine the cursor position because stdin is not a tty");
+ }
+
+ /*
+ * Duplicate STDIN to a new file descriptor before reopening it as a
+ * writeable stream.
+ */
+ int fd = dup(STDIN_FILENO);
+ FILE *tty;
+ if (fd < 0) {
+ die("failed to dup stdin");
+ } else {
+ tty = fdopen(fd, "w");
+ if (tty == NULL) {
+ die("failed to re-open the tty for writing");
+ }
+ }
+
+ /*
+ * Save the current terminal settings.
+ */
+ if (tcgetattr(STDIN_FILENO, &save_tty) != 0) {
+ die("failed to obtain the current terminal settings");
+ } else {
+ is_tty_saved = true;
+ }
+
+ /*
+ * Duplicate the current terminal settings for modification.
+ */
+ struct termios new_tty = save_tty;
+ new_tty = save_tty;
+
+ /*
+ * Turn off ECHO, so that the response from the terminal isn't printed.
+ * Also, the terminal must be operating in its noncanonical mode,
+ * thereby ensuring that its input is always immediately available,
+ * with no processing having been performed.
+ */
+ new_tty.c_lflag &= ~(ECHO|ECHOE|ECHOK|ECHONL);
+ new_tty.c_lflag &= ~(ICANON);
+
+ /*
+ * Set an interbyte timeout of 1 decisecond. The timer is started only
+ * after the first byte is read, so read(2) will block until then.
+ */
+ new_tty.c_cc[VMIN] = 1;
+ new_tty.c_cc[VTIME] = 1;
+
+ /*
+ * Try to apply the new terminal settings.
+ */
+ if (tcsetattr(STDIN_FILENO, TCSANOW, &new_tty) != 0) {
+ die("failed to modify the terminal settings");
+ } else if (fprintf(tty, "\033[6n") != 4) {
+ die("failed to write the CPR sequence to the terminal");
+ } else if (fclose(tty) != 0) {
+ die("failed to flush the stream after writing the CPR sequence");
+ }
+
+ /*
+ * Prepare to catch our signals. We treat both an interrupt and a
+ * depleted timer as essentially the same thing: fatal errors.
+ */
+ struct sigaction act;
+ act.sa_handler = on_signal;
+ sigemptyset(&act.sa_mask);
+ act.sa_flags = 0;
+ sigaction(SIGALRM, &act, NULL);
+
+ /*
+ * A timeout is required, just in case read(2) proves unable to read an
+ * initial byte, otherwise causing the program to hang.
+ */
+#ifdef __APPLE__
+ alarm(1);
+#else
+ timer_t timerid = init_timer();
+#endif
+
+ /*
+ * Read up to (sizeof ibuf - 1) bytes of input in total. Upon each
+ * successful read, scan the input buffer for a valid ECMA4-8 CPR
+ * response. Abort if no such response is found within MAX_LOOPS
+ * iterations.
+ */
+ char ibuf[BUFSIZE];
+ char const * const imax = ibuf + sizeof ibuf - 1;
+ char *iptr = ibuf;
+ int maxloops = MAX_LOOPS;
+ int row = -1;
+ int col = -1;
+ ssize_t nr;
+ while (--maxloops > 0 && (nr = read(STDIN_FILENO, iptr, imax - iptr)) > 0) {
+ iptr += nr;
+ *iptr = '\0'; /* NUL-terminate for strchr(3) and sscanf(3) */
+ char const *p;
+ if ((p = strchr(ibuf, '\033')) != 0) {
+ if (sscanf(p, "\033[%d;%dR", &row, &col) == 2) {
+ break;
+ } else {
+ col = -1;
+ row = -1;
+ }
+ }
+ }
+
+ /*
+ * Deactivate the timer.
+ */
+#ifdef __APPLE__
+ alarm(0);
+#else
+ timer_delete(timerid);
+#endif
+
+ /*
+ * Die in the case that the timer fired.
+ */
+ if (is_timed_out) {
+ die("timed out waiting for the terminal to respond to CPR");
+ }
+
+ /*
+ * Restore the original terminal settings.
+ */
+ cleanup();
+
+ /*
+ * Print the cursor position, provided both col and row are above zero.
+ */
+ if (col < 1 || row < 1) {
+ die("failed to read the cursor position");
+ } else if (printf("%d %d\n", row, col) == -1 || fflush(stdout) == EOF) {
+ return EXIT_FAILURE;
+ } else {
+ return EXIT_SUCCESS;
+ }
+}
+
+#ifndef __APPLE__
+static timer_t
+init_timer(void) {
+ struct itimerspec timer;
+ struct sigevent event;
+ timer_t timerid;
+ event.sigev_notify = SIGEV_SIGNAL;
+ event.sigev_signo = SIGALRM;
+ event.sigev_value.sival_ptr = &timerid;
+ if (timer_create(CLOCK_REALTIME, &event, &timerid) == -1) {
+ die("failed to create a per-process timer");
+ } else {
+ timer.it_value.tv_sec = 0;
+ timer.it_value.tv_nsec = READ_TIMEOUT_NS;
+ timer.it_interval.tv_sec = 0;
+ timer.it_interval.tv_nsec = 0;
+ if (timer_settime(timerid, 0, &timer, NULL) == -1) {
+ die("failed to configure the per-process timer");
+ }
+ }
+ return timerid;
+}
+#endif
+
+/*
+ * Tries to restore the terminal settings. Only one attempt will ever be made.
+ */
+static void
+cleanup(void) {
+ bool const is_saved = is_tty_saved;
+ if (is_saved) {
+ tcsetattr(STDIN_FILENO, TCSANOW, &save_tty);
+ is_tty_saved = false;
+ }
+}
+
+static void
+die(char const * const errmsg) {
+ cleanup();
+ fprintf(stderr, "%s: %s\n", PROGRAM, errmsg);
+ exit(EXIT_FAILURE);
+}
+
+static void
+on_signal(int const signo) {
+ is_timed_out = true;
+}