diff options
| author | Daniel Eklöf <daniel@ekloef.se> | 2024-12-21 05:52:00 +0000 |
|---|---|---|
| committer | Daniel Eklöf <daniel@ekloef.se> | 2024-12-22 06:16:12 +0000 |
| commit | e38ec79be15fe355bf50670bc9066210ae0ed211 (patch) | |
| tree | 9abd0d14ba98bfd2a910d852affa5130522e0287 /doc | |
| parent | selection: 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.scd | 27 |
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* |
