aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorAlyssa Ross <hi@alyssa.is>2021-12-10 17:40:59 +0000
committerDaniel Eklöf <daniel@ekloef.se>2024-03-14 06:31:03 +0000
commit86894a1cd29f8fb3e5a8487b4ce2d2c1b4cf57a9 (patch)
tree35bb34fda0a86556662159439d47b3b599276d40 /doc
parentcsi: the CSI-t family of queries now report unscaled pixel values (diff)
Add support for opening an existing PTY
Virtual machine monitor programs (e.g. QEMU, Cloud Hypervisor) expose guest consoles as PTYs. With this patch, foot can access these guest consoles. Usually, the program used for accessing these PTYs is screen, but screen is barely developed, doesn't support resizing, and has a bunch of other unrelated stuff going on. It would be nice to have a terminal emulator that properly supported opening an existing PTY. The VMM controls the master end of the PTY, so to the other end (in this case foot), it just behaves like any application running in a directly-opened PTY, and all that's needed is to change foot's code to support opening an existing PTY rather than creating one. Co-authored-by: tanto <tanto@ccc.ac>
Diffstat (limited to 'doc')
-rw-r--r--doc/foot.1.scd7
1 files changed, 7 insertions, 0 deletions
diff --git a/doc/foot.1.scd b/doc/foot.1.scd
index 8e2e6a48..86975464 100644
--- a/doc/foot.1.scd
+++ b/doc/foot.1.scd
@@ -78,6 +78,13 @@ the foot command line
*-L*,*--login-shell*
Start a login shell, by prepending a '-' to argv[0].
+*--pty*
+ Display an existing pty instead of creating one. This is useful
+ for interacting with VM consoles.
+
+ This option is not currently supported in combination with
+ *-s*,*--server*.
+
*-D*,*--working-directory*=_DIR_
Initial working directory for the client application. Default:
_CWD of foot_.