diff options
author | Christian Brabandt <cb@256bit.org> | 2023-09-06 20:41:25 +0200 |
---|---|---|
committer | Christian Brabandt <cb@256bit.org> | 2023-09-06 20:41:25 +0200 |
commit | f7ac0ef5098856bedca26e7073594a407c05636f (patch) | |
tree | 236332bc827a84d5b5f70eedc96a00a30e0b9813 /runtime/doc/filetype.txt | |
parent | 1689e847ff3b43723c247be36d84f03fce2a66d6 (diff) |
runtime: don't execute external commands when loading ftplugins
This is a followup to 816fbcc262687b81fc46f82f7bbeb1453addfe0c (patch
9.0.1833: [security] runtime file fixes)
It basically disables that external commands are run on loading of the
filetype plugin, **unless** the user has set the `g:plugin_exec = 1`
global variable in their configuration or for a specific filetype the
variable g:<filetype>_exec=1.
There are a few more plugins, that may execute system commands like
debchangelog, gitcommit, sh, racket, zsh, ps1 but those do at least
do not run those commands by default during loading of the filetype plugin
(there the command is mostly run as convenience for auto-completion or
to provide documentation lookup).
closes: #13034
Signed-off-by: Christian Brabandt <cb@256bit.org>
Co-authored-by: Tim Pope <vim@tpope.org>
Diffstat (limited to 'runtime/doc/filetype.txt')
-rw-r--r-- | runtime/doc/filetype.txt | 17 |
1 files changed, 15 insertions, 2 deletions
diff --git a/runtime/doc/filetype.txt b/runtime/doc/filetype.txt index 05047224f9..9c092673f6 100644 --- a/runtime/doc/filetype.txt +++ b/runtime/doc/filetype.txt @@ -1,4 +1,4 @@ -*filetype.txt* For Vim version 9.0. Last change: 2023 Apr 29 +*filetype.txt* For Vim version 9.0. Last change: 2023 Sep 06 VIM REFERENCE MANUAL by Bram Moolenaar @@ -419,11 +419,24 @@ ways to change this: 3. Docs for the default filetype plugins. *ftplugin-docs* + *plugin_exec* *g:plugin_exec* +Enable executing of external commands. This was done historically for e.g. +the perl filetype plugin (and a few others) to set the search path. +Disabled by default for security reasons: > + :let g:plugin_exec = 1 +It is also possible to enable this only for certain filetypes: > + :let g:<filetype>_exec = 1 +So to enable this only for ruby, set the following variable: > + :let g:ruby_exec = 1 + +If both, the global `plugin_exec` and the `<filetype>_exec` specific variable +are set, the filetpe specific variable should have precedent. + AWK *ft-awk-plugin* Support for features specific to GNU Awk, like @include, can be enabled by setting: > - let g:awk_is_gawk = 1 + :let g:awk_is_gawk = 1 CHANGELOG *ft-changelog-plugin* |