mirror of
https://github.com/bitburner-official/bitburner-src.git
synced 2024-12-25 23:47:34 +01:00
ae15914efa
Unfortunately, I haven't used most of the specialty APIs yet, so I'm not intimately familiar with where their documentation might be wrong. I figured some fixes were better than no fixes, and I can always make more fixes later. Fixes #1023.
59 lines
1.6 KiB
ReStructuredText
59 lines
1.6 KiB
ReStructuredText
tail() Netscript Function
|
|
==================================
|
|
|
|
.. js:function:: tail([fn[, hostname=current hostname[, ...args]])
|
|
|
|
:RAM cost: 0 GB
|
|
:param string fn: Optional. Filename of script to get logs from.
|
|
:param string hostname: Optional. Hostname of the server that the script is on.
|
|
:param args...: Arguments to identify which scripts to get logs for.
|
|
|
|
Opens a script's logs. This is functionally the same as the
|
|
:ref:`tail_terminal_command` Terminal command.
|
|
|
|
If the function is called with no arguments, it will open the current script's logs.
|
|
|
|
Otherwise, the ``fn``, ``hostname``, and ``args...`` arguments can be
|
|
used to get the logs from another script. Remember that scripts are uniquely
|
|
identified by both their names and arguments.
|
|
|
|
Example:
|
|
|
|
.. code-block:: javascript
|
|
|
|
// Open logs from foo.script on the current server that was run with no args
|
|
tail("foo.script");
|
|
|
|
// Open logs from foo.script on the foodnstuff server that was run with no args
|
|
tail("foo.script", "foodnstuff");
|
|
|
|
// Open logs from foo.script on the foodnstuff server that was run with the arguments [1, "test"]
|
|
tail("foo.script", "foodnstuff", 1, "test");
|
|
|
|
.. js:function:: tail(scriptPid)
|
|
|
|
:RAM cost: 0 GB
|
|
:param number scriptPid: PID of the script to tail.
|
|
|
|
Opens a script's logs by pid
|
|
|
|
Example:
|
|
|
|
.. code-block:: javascript
|
|
|
|
// Open logs from process with id 42
|
|
tail(42);
|
|
|
|
.. js:function:: tail()
|
|
|
|
:RAM cost: 0 GB
|
|
|
|
Opens the current script logs.
|
|
|
|
Example:
|
|
|
|
.. code-block:: javascript
|
|
|
|
// Open the current script logs.
|
|
tail();
|