mirror of
https://github.com/bitburner-official/bitburner-src.git
synced 2024-12-27 16:37:33 +01:00
30 lines
1.3 KiB
ReStructuredText
30 lines
1.3 KiB
ReStructuredText
|
kill() Netscript Function
|
||
|
|
=========================
|
||
|
|
|
||
|
|
.. js:function:: kill(script, hostname/ip, [args...])
|
||
|
|
|
||
|
|
:param string script: Filename of the script to kill
|
||
|
|
:param string hostname/ip: IP or hostname of the server on which to kill the script
|
||
|
|
:param args...: Arguments to identify which script to kill
|
||
|
|
:RAM cost: 0.5 GB
|
||
|
|
|
||
|
|
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.
|
||
|
|
|
||
|
|
If this function successfully kills the specified script, then it will return true. Otherwise, it will return false.
|
||
|
|
|
||
|
|
Examples:
|
||
|
|
|
||
|
|
The following example will try to kill a script named *foo.script* on the *foodnstuff* server that was ran with no arguments::
|
||
|
|
|
||
|
|
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::
|
||
|
|
|
||
|
|
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"::
|
||
|
|
|
||
|
|
kill("foo.script", getHostname(), 1, "foodnstuff");
|