aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDaniel Eklöf <daniel@ekloef.se>2024-12-21 05:52:00 +0000
committerDaniel Eklöf <daniel@ekloef.se>2024-12-22 06:16:12 +0000
commite38ec79be15fe355bf50670bc9066210ae0ed211 (patch)
tree9abd0d14ba98bfd2a910d852affa5130522e0287 /doc
parentselection: fix crash when tripple clicking in a region containing NUL characters (diff)
osc: add option to disable OSC-52, partially or fully
Closes #1867
Diffstat (limited to 'doc')
-rw-r--r--doc/foot.ini.5.scd27
1 files changed, 27 insertions, 0 deletions
diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd
index 2d69f13e..ba59050e 100644
--- a/doc/foot.ini.5.scd
+++ b/doc/foot.ini.5.scd
@@ -416,6 +416,33 @@ The format is simply:
Note: do not set *TERM* here; use the *term* option in the main
(default) section instead.
+# SECTION: security
+
+*osc52*
+
+ Whether OSC-52 (clipboard access) is enabled or disabled. One of
+ *disabled*, *copy-enabled*, *paste-enabled* or *enabled*.
+
+ OSC-52 gives terminal application access to the host clipboard
+ (i.e. the Wayland clipboard). This is normally not a security
+ issue, since all applications can access the clipboard directly
+ over the Wayland socket.
+
+ However, when SSH:ing into a remote system, or accessing a
+ container etc, the terminal applications may be untrusted, and you
+ might consider disabling the host clipboard access.
+
+ - *disabled*: disables all clipboard access
+ - *copy-enabled*: applications can write to the clipboard, but not
+ read from it.
+ - *paste-enabled*: applications can read from the clipboard, but
+ not write to it.
+ - *enabled*: all applications have full access to the host
+ clipboard. This is the default.
+
+ Default: _enabled_
+
+
# SECTION: bell
*urgent*