mirror of
https://github.com/bitburner-official/bitburner-src.git
synced 2024-12-27 08:27:32 +01:00
59 lines
1.8 KiB
ReStructuredText
59 lines
1.8 KiB
ReStructuredText
kill() Netscript Function
|
|
=========================
|
|
|
|
.. js:function:: kill(script, hostname, [args...])
|
|
|
|
:RAM cost: 0.5 GB
|
|
:param string script: Filename of the script to kill.
|
|
:param string hostname: Hostname of the server on which to kill the script.
|
|
:param args...: Arguments to identify which script to kill.
|
|
:returns: ``true`` is that script was killed.
|
|
|
|
Kills the script on the target server specified by the script's name and
|
|
arguments. Remember that scripts are uniquely identified by both their name
|
|
and arguments. For example, if ``foo.script`` is run with the argument 1,
|
|
then this is not the same as ``foo.script`` run with the argument 2, even
|
|
though they have the same code.
|
|
|
|
Examples:
|
|
|
|
The following example will try to kill a script named ``foo.script`` on the
|
|
``foodnstuff`` server that was ran with no arguments:
|
|
|
|
.. code-block:: javascript
|
|
|
|
kill("foo.script", "foodnstuff");
|
|
|
|
The following will try to kill a script named ``foo.script`` on the current
|
|
server that was ran with no arguments:
|
|
|
|
.. code-block:: javascript
|
|
|
|
kill("foo.script", getHostname());
|
|
|
|
The following will try to kill a script named ``foo.script`` on the current
|
|
server that was ran with the arguments 1 and "foodnstuff":
|
|
|
|
.. code-block:: javascript
|
|
|
|
kill("foo.script", getHostname(), 1, "foodnstuff");
|
|
|
|
.. js:function:: kill(scriptPid)
|
|
|
|
:RAM cost: 0.5 GB
|
|
:param number scriptPid: PID of the script to kill
|
|
:returns: ``true`` that script was killed.
|
|
|
|
Kills the script with the specified PID. Killing a script by its PID will
|
|
typically have better performance, especially if you have many scripts
|
|
running.
|
|
|
|
|
|
Example:
|
|
|
|
.. code-block:: javascript
|
|
|
|
if (kill(10)) {
|
|
print("Killed script with PID 10!");
|
|
}
|