mirror of
https://github.com/node-red/node-red.git
synced 2023-10-10 13:36:53 +02:00
84 lines
5.6 KiB
HTML
Executable File
84 lines
5.6 KiB
HTML
Executable File
<!--
|
|
Copyright JS Foundation and other contributors, http://js.foundation
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
-->
|
|
|
|
<script type="text/x-red" data-help-name="exec">
|
|
<p> Führt einen Systembefehl aus und gibt seine Ausgabe zurück. </p>
|
|
<p> Der Node kann so konfiguriert werden, dass er entweder wartet, bis der Befehl abgeschlossen ist,
|
|
oder die Ausgabe so sendet wie der Befehl sie generiert. </p>
|
|
<p> Der Befehl, der ausgeführt wird, kann im Node konfiguriert oder von der empfangenen Nachricht übergeben werden. </p>
|
|
|
|
<h3> Eingaben </h3>
|
|
<dl class="message-properties">
|
|
<dt class="optional">payload<span class="property-type"> Zeichenfolge </span> </dt>
|
|
<dd> wird an den ausgeführten Befehl angehängt </dd>
|
|
<dt class="optional"> kill <span class="property-type"> Zeichenfolge </span> </dt>
|
|
<dd> Der Typ des Kill-Signals, das einen vorhandenen exec-Node-Prozess gesendet wird. </dd>
|
|
<dt class="optional"> pid <span class="property-type"> Zahl|Zeichenfolge </span> </dt>
|
|
<dd> Die Prozess-ID eines vorhandenen exec-Node-Prozesses, der beendet werden soll. </dd>
|
|
</dl>
|
|
|
|
<h3> Ausgaben </h3>
|
|
<ol class="node-ports">
|
|
<li> Standardausgabe
|
|
<dl class="message-properties">
|
|
<dt> payload <span class="property-type"> Zeichenfolge </span> </dt>
|
|
<dd> die Standardausgabe des Befehls. </dd>
|
|
</dl>
|
|
<dl class="message-properties">
|
|
<dt> rc <span class="property-type"> Objekt </span> </dt>
|
|
<dd> Eine Kopie des Rückkehrcodeobjekts (auch an Port 3 verfügbar) - nur im Ausführungsmodus verfügbar </dd>
|
|
</dl>
|
|
</li>
|
|
<li> Standardfehler
|
|
<dl class="message-properties">
|
|
<dt> payload <span class="property-type"> Zeichenfolge </span> </dt>
|
|
<dd> Standardfehlerausgabe des Befehls. </dd>
|
|
</dl>
|
|
<dl class="message-properties">
|
|
<dt> rc <span class="property-type"> Objekt </span> </dt>
|
|
<dd> Eine Kopie des Rückkehrcodeobjekts (auch an Port 3 verfügbar) - nur im Ausführungsmodus verfügbar </dd>
|
|
</dl>
|
|
</li>
|
|
<li> Rückkehrcode
|
|
<dl class="message-properties">
|
|
<dt> payload <span class="property-type"> Objekt </span> </dt>
|
|
<dd> ein Objekt, das den Rückkehrcode und gegebenfals <code>Nachricht</code>, <code>Signal</code> Eigenschaften enthält. </dd>
|
|
</dl>
|
|
</li>
|
|
</ol>
|
|
<h3> Details </h3>
|
|
<p> Standardmäßig verwendet der Systemaufruf <code>exec</code> , der den Befehl aufruft, darauf wartet, dass er ausgeführt wird und anschließend
|
|
gibt dessen Ausgabe zurück. Ein erfolgreicher Befehl sollte z. B. den Rückkehrcode <code>{ code: 0 }</code> haben. </p>
|
|
<p> Optional kann stattdessen <code>spawn</code> verwendet werden, wodurch die Ausgaben von Standardausgabe und Standardfehler zurückgegeben werden während
|
|
der Befehl ausgeführt wird, in der Regel Zeile für Zeile. Nach Abschluss des Befehles gibt sie ein Objekt
|
|
am 3. Port zurück. Ein erfolgreicher Befehl sollte z. B. <code>{ code: 0 }</code> zurückgeben. </p>
|
|
<p> Fehler können zusätzliche Informationen über den dritten Port als <code>msg.payload</code> zurückgeben,
|
|
z. B. eine <code>message</code> Zeichenfolge oder <code>Signal</code> zeichenfolge. </p>
|
|
<p> Der Befehl, der ausgeführt wird, ist innerhalb des Nodes definiert, mit einer Option zum Anhängen von <code> msg.payload </code>
|
|
und einer weiteren Gruppe von Parametern. </p>
|
|
<p> Befehle oder Parameter mit Leerzeichen müssen in Anführungszeichen eingeschlossen werden: <code> "Dies ist ein einzelner Parameter" </code> </p>
|
|
<p> Die zurückgegebenen <code>Nutzdaten</code> sind in der Regel ein <i>string</i>, es sei denn, es werden nicht UTF8-Zeichen erkannt, in denen
|
|
falls es sich um einen <i>Buffer</i> handelt. </p>
|
|
<p> Das Statussymbol und die PID des Nodes werden angezeigt, während der Node aktiv ist. Änderungen an dieser Funktion können vom Node <code> Status </code> gelesen werden. </p>
|
|
<h4> Prozesse beenden </h4>
|
|
<p> Wird <code>msg.kill</code> gesendet, wird ein einzelner aktiver Prozess beendet. <code>msg.kill</code> sollte eine Zeichenfolge sein, die
|
|
Der Typ des Signals, der gesendet werden soll, z. B. <code>SIGINT</code>, <code>SIGQUIT</code> oder <code>SIGHUP</code>.
|
|
Der Standardwert ist <code>SIGTERM</code> , wenn er auf eine leere Zeichenfolge gesetzt ist. </p>
|
|
<p> Wenn der Node mehr als einen Prozess ausführt, muss <code>msg.pid</code> ebenfalls mit dem Wert der zu ermordenen PID festgelegt werden. </p>
|
|
<p> Wenn ein Wert im Feld <code>Zeitlimit</code> angegeben wird, wird der Prozess automatisch beendet, wenn der Prozess nicht abgeschlossen ist, wenn die angegebene Anzahl von Sekunden abgelaufen ist. </p>
|
|
<p> Tipp: Wenn Sie eine Python-App ausführen, müssen Sie möglicherweise den Parameter <code>-u</code> verwenden, um die Ausgabe zu stoppen, die gepuffert wird. </p>
|
|
</script>
|