summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSebastien Helleu <flashcode@flashtux.org>2014-03-17 14:59:00 +0100
committerSebastien Helleu <flashcode@flashtux.org>2014-03-17 14:59:00 +0100
commit30de830982f127c538602f05f4c9eb32d5f991cf (patch)
tree11efa828a77f50f5a405e9a5a8052a48f417dd43 /doc
parente84eaafe8e56c359f95db0d19a13c5ca6fad9468 (diff)
downloadweechat-30de830982f127c538602f05f4c9eb32d5f991cf.zip
exec: don't use shell by default when executing commands (for security reasons)
It is possible to force shell by default with this command: /set exec.command.default_options "-sh"
Diffstat (limited to 'doc')
-rw-r--r--doc/de/autogen/user/exec_commands.txt82
-rw-r--r--doc/en/autogen/user/exec_commands.txt4
-rw-r--r--doc/fr/autogen/user/exec_commands.txt4
-rw-r--r--doc/it/autogen/user/exec_commands.txt4
-rw-r--r--doc/ja/autogen/user/exec_commands.txt4
-rw-r--r--doc/pl/autogen/user/exec_commands.txt4
6 files changed, 51 insertions, 51 deletions
diff --git a/doc/de/autogen/user/exec_commands.txt b/doc/de/autogen/user/exec_commands.txt
index 1f07722f1..193404e28 100644
--- a/doc/de/autogen/user/exec_commands.txt
+++ b/doc/de/autogen/user/exec_commands.txt
@@ -12,49 +12,49 @@
-set <id> <property> <value>
-del <id>|-all [<id>...]
- -list: zeigt laufende Befehle an
- -sh: die shell wird verwendet um Befehle auszuführen (Standardverhalten)
- -nosh: die shell wird nicht verwendet um Befehle auszuführen (wird benötigt, falls der Befehl mit sensiblen Daten hantiert. Zum Beispiel der Inhalt einer Nachricht eines anderen Users)
- -bg: führt Prozess im Hintergrund aus: gibt weder eine Prozessausgabe noch einen Rückgabewert aus (nicht kompatibel mit Optionen -o/-n)
- -nobg: gibt Prozessausgabe und Rückgabewert aus (Standardverhalten)
- -stdin: erstellt eine PIPE um Daten zu dem Prozess zu senden (mittels /exec -in/-inclose)
--nostdin: es wird keine PIPE für stdin erstellt (Standardverhalten)
- -buffer: zeigt/sendet Ausgabe des Befehls an diesen Buffer (wird der angegebene Buffer nicht gefunden wird ein neuer Bufger mit dem Namen "exec.exec.xxx" erstellt)
- -l: gibt die Ausgabe des Befehls lokal im Buffer aus (Standardverhalten)
- -o: gibt die Ausgabe des Befehls im Buffer aus (nicht kompatibel mit Option -bg)
- -n: gibt die Ausgabe des Befehls in einem neuen Buffer aus (nicht kompatibel mit Option -bg)
- -sw: es wird zum Ausgabebuffer gewechselt (Standardverhalten)
- -nosw: es wird nicht zum Ausgabebuffer gewechselt
- -ln: legt eine Zeilennummerierung an (Standardverhalten, nur für neue Buffer)
- -noln: es wird keine Zeilennummerierung angezeigt
- -color: es wird eine der folgenden Aktionen bei ANSI Zeichenkodierungen in der Ausgabe durchgeführt:
- ansi: ANSI-Kodierung wird beibehalten
- auto: konvertiert ANSI-Farben nach WeeChat/IRC (Standardverhalten)
- irc: konvertiert ANSI-Farben nach IRC Farben
- weechat: konvertiert ANSI-Farben nach WeeChat-Farben
- strip: ANSI-Farben werden entfernt
- -rc: der Rückgabewert wird ausgegeben (Standardverhalten)
- -norc: der Rückgabewert wird unterdrückt
--timeout: gibt eine Zeitbeschränkung für den auszuführenden Befehl an (in Sekunden)
- -name: dem Befehl wird ein Name zugewiesen (um den Befehl später mittels /exec zu nutzen)
- -pipe: sendet die Ausgabe an einen Befehl von WeeChat/Erweiterung (Zeile für Zeile); sollen Leerzeichen im Befehl/Argument verwendet werden, müssen diese mit Anführungszeichen eingeschlossen werden; Variable $line wird durch die entsprechende Zeile ersetzt (standardmäßig wird die Zeile, getrennt durch ein Leerzeichen, dem Befehl nachgestellt (nicht kompatibel mit den Optionen -bg/-o/-n)
- -hsignal: sendet die Ausgabe als hsignal (um es z.B. mittels /trigger zu verwenden) (nicht kompatibel mit den Optionen -bg/-o/-n)
- command: Befehl der ausgeführt werden soll; beginnt der Befehl mit "url:", wird die shell deaktiviert und der Inhalt der URL wird heruntergeladen und im Buffer ausgegeben
- id: identifiziert eindeutig einen Befehl: entweder durch eine Nummer oder einen Namen (sofern ein Name mittels "-name xxx" zugewiesen wurde)
- -in: sendet Text an die Standardeingabe des Prozesses
--inclose: wie -in aber stdin wird danach geschlossen (und der Text ist optional: ohne Text wird stdin umgehend geschlossen
- -signal: schickt ein Signal an den Prozess; das Signal kann entweder ein Integerwert oder eines der folgenden Schlüsselworte sein: hup, int, quit, kill, term, usr1, usr2
- -kill: Alias für "-signal <id> kill"
--killall: beendet alle laufenden Prozesse
- -set: nutzt eine Hook-Fähigkeit (siehe Funktion hook_set in Anleitung für API Erweiterung)
-property: Hook-Fähigkeit
- value: neuer Wert für Hook-Fähigkeit
- -del: entfernt einen beendeten Befehl
- -all: entfernt alle beendeten Befehle
+ -list: list commands
+ -sh: use the shell to execute the command (WARNING: use this option ONLY if all arguments are safe date, see option -nosh)
+ -nosh: do not use the shell to execute the command (required if the command has some unsafe data, for example the content of a message from another user) (default)
+ -bg: run process in background: do not display process output neither return code (not compatible with options -o/-n)
+ -nobg: catch process output and display return code (default)
+ -stdin: create a pipe for sending data to the process (with /exec -in/-inclose)
+-nostdin: do not create a pipe for stdin (default)
+ -buffer: display/send output of command on this buffer (if the buffer is not found, a new buffer with name "exec.exec.xxx" is created)
+ -l: display locally output of command on buffer (default)
+ -o: send output of command to the buffer (not compatible with option -bg)
+ -n: display output of command in a new buffer (not compatible with option -bg)
+ -sw: switch to the output buffer (default)
+ -nosw: don't switch to the output buffer
+ -ln: display line numbers (default in new buffer only)
+ -noln: don't display line numbers
+ -color: action on ANSI colors in output:
+ ansi: keep ANSI codes as-is
+ auto: convert ANSI colors to WeeChat/IRC (default)
+ irc: convert ANSI colors to IRC colors
+ weechat: convert ANSI colors to WeeChat colors
+ strip: remove ANSI colors
+ -rc: display return code (default)
+ -norc: don't display return code
+-timeout: set a timeout for the command (in seconds)
+ -name: set a name for the command (to name it later with /exec)
+ -pipe: send the output to a WeeChat/plugin command (line by line); if there are spaces in command/arguments, enclose them with double quotes; variable $line is replaced by the line (by default the line is added after the command, separated by a space) (not compatible with options -bg/-o/-n)
+-hsignal: send the output as a hsignal (to be used for example in a trigger) (not compatible with options -bg/-o/-n)
+ command: the command to execute; if beginning with "url:", the shell is disabled and the content of URL is downloaded and sent as output
+ id: command identifier: either its number or name (if set with "-name xxx")
+ -in: send text on standard input of process
+-inclose: same as -in, but stdin is closed after (and text is optional: without text, the stdin is just closed)
+ -signal: send a signal to the process; the signal can be an integer or one of these names: hup, int, quit, kill, term, usr1, usr2
+ -kill: alias of "-signal <id> kill"
+-killall: kill all running processes
+ -set: set a hook property (see function hook_set in plugin API reference)
+property: hook property
+ value: new value for hook property
+ -del: delete a terminated command
+ -all: delete all terminated commands
-Standardoptionen können in der Option exec.command.default_options bestimmt werden.
+Default options can be set in the option exec.command.default_options.
-Beispiele:
+Examples:
/exec -n ls -l /tmp
/exec -n ps xu | grep weechat
/exec -n -norc url:http://pastebin.com/raw.php?i=xxxxxxxx
diff --git a/doc/en/autogen/user/exec_commands.txt b/doc/en/autogen/user/exec_commands.txt
index b8048d429..b803918e0 100644
--- a/doc/en/autogen/user/exec_commands.txt
+++ b/doc/en/autogen/user/exec_commands.txt
@@ -13,8 +13,8 @@
-del <id>|-all [<id>...]
-list: list commands
- -sh: use the shell to execute the command (default)
- -nosh: do not use the shell to execute the command (required if the command has some unsafe data, for example the content of a message from another user)
+ -sh: use the shell to execute the command (WARNING: use this option ONLY if all arguments are safe date, see option -nosh)
+ -nosh: do not use the shell to execute the command (required if the command has some unsafe data, for example the content of a message from another user) (default)
-bg: run process in background: do not display process output neither return code (not compatible with options -o/-n)
-nobg: catch process output and display return code (default)
-stdin: create a pipe for sending data to the process (with /exec -in/-inclose)
diff --git a/doc/fr/autogen/user/exec_commands.txt b/doc/fr/autogen/user/exec_commands.txt
index fe5a29288..e74ea8d6e 100644
--- a/doc/fr/autogen/user/exec_commands.txt
+++ b/doc/fr/autogen/user/exec_commands.txt
@@ -13,8 +13,8 @@
-del <id>|-all [<id>...]
-list: lister les commandes
- -sh: utiliser le shell pour exécuter la commande (par défaut)
- -nosh: ne pas utiliser le shell pour exécuter la commande (requis si la commande a des données non fiables, par exemple le contenu d'un message d'un autre utilisateur)
+ -sh: utiliser le shell pour exécuter la commande (ATTENTION : utilisez cette option SEULEMENT si tous les paramètres sont des données fiables, voir l'option -nosh)
+ -nosh: ne pas utiliser le shell pour exécuter la commande (requis si la commande a des données non fiables, par exemple le contenu d'un message d'un autre utilisateur) (par défaut)
-bg: lancer le processus en tâche de fond : ne pas afficher la sortie ni le code retour (non compatible avec les options -o/-n)
-nobg: capturer la sortie du processus et afficher le code retour (par défaut)
-stdin: créer un tuyau pour envoyer des données sur l'entrée standard du processus (avec /exec -in/-inclose)
diff --git a/doc/it/autogen/user/exec_commands.txt b/doc/it/autogen/user/exec_commands.txt
index b8048d429..b803918e0 100644
--- a/doc/it/autogen/user/exec_commands.txt
+++ b/doc/it/autogen/user/exec_commands.txt
@@ -13,8 +13,8 @@
-del <id>|-all [<id>...]
-list: list commands
- -sh: use the shell to execute the command (default)
- -nosh: do not use the shell to execute the command (required if the command has some unsafe data, for example the content of a message from another user)
+ -sh: use the shell to execute the command (WARNING: use this option ONLY if all arguments are safe date, see option -nosh)
+ -nosh: do not use the shell to execute the command (required if the command has some unsafe data, for example the content of a message from another user) (default)
-bg: run process in background: do not display process output neither return code (not compatible with options -o/-n)
-nobg: catch process output and display return code (default)
-stdin: create a pipe for sending data to the process (with /exec -in/-inclose)
diff --git a/doc/ja/autogen/user/exec_commands.txt b/doc/ja/autogen/user/exec_commands.txt
index b8048d429..b803918e0 100644
--- a/doc/ja/autogen/user/exec_commands.txt
+++ b/doc/ja/autogen/user/exec_commands.txt
@@ -13,8 +13,8 @@
-del <id>|-all [<id>...]
-list: list commands
- -sh: use the shell to execute the command (default)
- -nosh: do not use the shell to execute the command (required if the command has some unsafe data, for example the content of a message from another user)
+ -sh: use the shell to execute the command (WARNING: use this option ONLY if all arguments are safe date, see option -nosh)
+ -nosh: do not use the shell to execute the command (required if the command has some unsafe data, for example the content of a message from another user) (default)
-bg: run process in background: do not display process output neither return code (not compatible with options -o/-n)
-nobg: catch process output and display return code (default)
-stdin: create a pipe for sending data to the process (with /exec -in/-inclose)
diff --git a/doc/pl/autogen/user/exec_commands.txt b/doc/pl/autogen/user/exec_commands.txt
index b8048d429..b803918e0 100644
--- a/doc/pl/autogen/user/exec_commands.txt
+++ b/doc/pl/autogen/user/exec_commands.txt
@@ -13,8 +13,8 @@
-del <id>|-all [<id>...]
-list: list commands
- -sh: use the shell to execute the command (default)
- -nosh: do not use the shell to execute the command (required if the command has some unsafe data, for example the content of a message from another user)
+ -sh: use the shell to execute the command (WARNING: use this option ONLY if all arguments are safe date, see option -nosh)
+ -nosh: do not use the shell to execute the command (required if the command has some unsafe data, for example the content of a message from another user) (default)
-bg: run process in background: do not display process output neither return code (not compatible with options -o/-n)
-nobg: catch process output and display return code (default)
-stdin: create a pipe for sending data to the process (with /exec -in/-inclose)