From 4a0f9e713c6d9825e2a4ef2f43630d6a950ae250 Mon Sep 17 00:00:00 2001
From: Andrew Wood <andrew.wood@ivarch.com>
Date: Tue, 16 Sep 2025 23:05:41 +0100
Subject: [PATCH] Define struct pvwatchspec_s for future use in an array for
 --watchfd, and add a comment defining nullable_string_t.

---
 src/include/pv-internal.h | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/include/pv-internal.h b/src/include/pv-internal.h
index 84b4b64..2b3259b 100644
--- a/src/include/pv-internal.h
+++ b/src/include/pv-internal.h
@@ -131,6 +131,14 @@ typedef uint16_t pvdisplay_bytecount_t;
 typedef uint16_t pvdisplay_width_t;
 #define PVDISPLAY_WIDTH_MAX (65535)	/* UINT16_MAX */
 
+/* Process and (optional) file descriptor to watch with "--watchfd". */
+struct pvwatchspec_s {
+	pid_t pid;		 /* process to watch fds of */
+	int fd;			 /* fd to watch, or 0 for all */
+};
+typedef struct pvwatchspec_s *pvwatchspec_t;
+
+/* String pointer, that is the only pointer to this resource, that can be null. */
 typedef /*@only@*/ /*@null@*/ char * nullable_string_t;
 
 /*