doc function updates and additions (#387)

This commit is contained in:
Mughur 2023-02-24 13:57:17 +02:00 committed by GitHub
parent 71051cde9c
commit 6839a456ac
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
27 changed files with 161 additions and 30 deletions

@ -1,7 +1,7 @@
closeTail() Netscript Function closeTail() Netscript Function
=============================== ===============================
.. js:function:: closeTail([scriptPid]) .. js:function:: closeTail([scriptPid = current script])
:RAM cost: 0 GB :RAM cost: 0 GB

@ -5,7 +5,7 @@ deleteServer() Netscript Function
:RAM cost: 2.25 GB :RAM cost: 2.25 GB
:param string hostname: Hostname of the server to delete. :param string hostname: Hostname of the server to delete.
:returns: ``true`` if successful, ``false`` otherwise. :returns: ``true`` if successful.
Deletes the specified purchased server. Deletes the specified purchased server.

@ -8,12 +8,12 @@ exec() Netscript Function
:param string script: Filename of script to execute. :param string script: Filename of script to execute.
:param string hostname: Hostname of the target server on which to execute the script. :param string hostname: Hostname of the target server on which to execute the script.
:param number numThreads: Optional thread count for new script. Set to 1 by :param number numThreads: Optional thread count for new script. Set to 1 by
default. Will be rounded to nearest integer default. Has to be an integer.
:param args...: Additional arguments to pass into the new script that is :param args...: Additional arguments to pass into the new script that is
being run. Note that if any arguments are being being run. Note that if any arguments are being
passed into the new script, then the third argument ``numThreads`` must passed into the new script, then the third argument ``numThreads`` must
be filled in with a value. be filled in with a value.
:returns: Newly created process id on success, 0 on failure. :returns: Newly created process id (PID) on success, 0 on failure.
Run a script as a separate process on a specified server. This is similar to Run a script as a separate process on a specified server. This is similar to
the :doc:`run<run>` function except that it can be used to run a script on any the :doc:`run<run>` function except that it can be used to run a script on any

@ -1,7 +1,7 @@
fileExists() Netscript Function fileExists() Netscript Function
=============================== ===============================
.. js:function:: fileExists(filename[, hostname]) .. js:function:: fileExists(filename[, hostname = current hostname])
:RAM cost: 0.1 GB :RAM cost: 0.1 GB
@ -9,9 +9,9 @@ fileExists() Netscript Function
:param string hostname: :param string hostname:
Hostname of target server. This is optional. If it is not specified then Hostname of target server. This is optional. If it is not specified then
the function will use the current server as the target server. the function will use the current server as the target server.
:returns: ``true`` if the file exists, ``false`` if it doesn't. :returns: ``true`` if the file exists.
The filename for scripts is case-sensitive, but for other types of files it The filename for scripts and .txt files is case-sensitive, but for other types of files it
is not. For example, ``fileExists("brutessh.exe")`` will work fine, even is not. For example, ``fileExists("brutessh.exe")`` will work fine, even
though the actual program is named ``BruteSSH.exe``. though the actual program is named ``BruteSSH.exe``.

@ -0,0 +1,28 @@
formatRam() Netscript Function
==============================
.. js:function:: formatRam(number[, fractionalDigits = 3[, suffixStart = 1000[, isInteger = false]]])
:RAM cost: 0 GB
:param number number: Number to format.
:param number fractionalDigits: Number of digits to show in the fractional part of the decimal number.
:param number suffixStart: How high a number must be before a suffix will be added.
:param boolean isInteger: Whether the number represents an integer. Integers do not display fractional digits until a suffix is present.
:returns: Formatted string.
Converts a number into a string with ram formatting.
The format depends on the Numeric Display settings (all options on the "Numeric Display" options page).
Examples:
.. code-block:: javascript
const number = 1.23456789
ns.print(ns.formatNumber(number)); //1.235
ns.print(ns.formatNumber(number,4)); //1.2346
ns.print(ns.formatNumber(number*1e9,3,1e10)); //1234567890
ns.print(ns.formatNumber(number*1e10,5,1e6)); //12.34568b or 1.23457e9
ns.print(ns.formatNumber(number,4,1000, true)); //1.235
ns.print(ns.formatNumber(number,4,1000, false)); //1.2346

@ -0,0 +1,23 @@
formatPercent() Netscript Function
==============================
.. js:function:: formatPercent(number[, fractionalDigits = 2])
:RAM cost: 0 GB
:param number number: Number to format.
:param number fractionalDigits: Number of digits to show in the fractional part of the decimal number.
:returns: Formatted string.
Converts a number into a string with percent formatting.
The format depends on the Numeric Display settings (all options on the "Numeric Display" options page).
Examples:
.. code-block:: javascript
const number = 1.23456789
ns.print(ns.formatPercent(number)); //123.46%
ns.print(ns.formatPercent(number,4)); //123.4568%

@ -0,0 +1,26 @@
formatRam() Netscript Function
==============================
.. js:function:: formatRam(number[, fractionalDigits = 2])
:RAM cost: 0 GB
:param number number: Number to format.
:param number fractionalDigits: Number of digits to show in the fractional part of the decimal number.
:returns: Formatted string.
Converts a number into a string with ram formatting.
The format depends on the Numeric Display settings (all options on the "Numeric Display" options page).
Examples:
.. code-block:: javascript
const number = 1.23456789
ns.print(ns.formatRam(number)); //1.23GB or 1.23GiB
ns.print(ns.formatRam(number,0)); //1GB or 1GiB
ns.print(ns.formatRam(number,3)); //1.235GB or 1.235GiB
ns.print(ns.formatRam(2**12,3)); //4.096tB or 4tiB
ns.print(ns.formatRam(2**20,3)); //1.049PB or 1PiB

@ -1,7 +1,7 @@
getScriptRam() Netscript Function getScriptRam() Netscript Function
================================= =================================
.. js:function:: getScriptRam(filename[, hostname]) .. js:function:: getScriptRam(filename[, hostname = current hostname])
:RAM cost: 0.1 GB :RAM cost: 0.1 GB
:param string filename: Filename of script. :param string filename: Filename of script.

@ -5,8 +5,9 @@ getSharePower() Netscript Function
:RAM cost: 0.2 GB :RAM cost: 0.2 GB
Calculate your share power. Based on all the active share calls. :returns: Reputation gain rate multiplier from sharing. i.e. 1.5 means +50% rep gain rate.
Returns the reputation gain rate multiplier, i.e. 1.5 means +50% rep gain rate.
Calculate your share power, based on all the active share calls.
Examples: Examples:

@ -1,7 +1,7 @@
isRunning() Netscript Function isRunning() Netscript Function
============================== ==============================
.. js:function:: isRunning(filename[, hostname=current hostname[, args...]]) .. js:function:: isRunning(filename[, hostname = current hostname[, args...]])
.. js:function:: isRunning(PID) .. js:function:: isRunning(PID)
:RAM cost: 0.1 GB :RAM cost: 0.1 GB

@ -1,8 +1,7 @@
kill() Netscript Function kill() Netscript Function
========================= =========================
.. js:function:: kill(script, [hostname=current hostname, [args...]]) .. js:function:: kill(script[, hostname=current hostname[, args...]])
.. js:function:: kill(PID)
:RAM cost: 0.5 GB :RAM cost: 0.5 GB
:param string script: Filename of the script to kill. :param string script: Filename of the script to kill.

@ -1,7 +1,7 @@
killall() Netscript Function killall() Netscript Function
============================ ============================
.. js:function:: killall([hostname = current hostname,[safetyguard = true]]) .. js:function:: killall([hostname = current hostname[, safetyguard = true]])
:RAM cost: 0.5 GB :RAM cost: 0.5 GB
:param string hostname: Hostname of the server on which to kill all scripts. :param string hostname: Hostname of the server on which to kill all scripts.

@ -1,7 +1,7 @@
moveTail() Netscript Function moveTail() Netscript Function
=============================== ===============================
.. js:function:: moveTail(x , y[, pid]) .. js:function:: moveTail(x , y[, pid = current script])
:RAM cost: 0 GB :RAM cost: 0 GB

@ -1,10 +1,14 @@
mv() Netscript Function mv() Netscript Function
============================== ==============================
.. js:function:: mv(serverName, sourceFile, targetFile) .. js:function:: mv(hostname, sourceFile, targetFile)
:RAM cost: 0 GB :RAM cost: 0 GB
:param string hostname: Hostname of the target server.
:param string sourceFile: Name of the file to be moved/renamed.
:param string targetFile: Target name of the file.
Move the source file to target file on the given server. Move the source file to target file on the given server.
This command only works for scripts and text files (.txt). It cannot, however, be used to convert from script to text file, or vice versa. This command only works for scripts and text files (.txt). It cannot, however, be used to convert from script to text file, or vice versa.

@ -7,8 +7,12 @@ nFormat() Netscript Function
:param number number: Number to format. :param number number: Number to format.
:param string format: Formatting to use. Read http://numeraljs.com/#format for specifics. :param string format: Formatting to use. Read http://numeraljs.com/#format for specifics.
:returns: Formatted string.
onverts a number into a string with the specified formatter. Deprecated, might be removed in 2.3 version of the game. Use :doc:`formatPercent<formatPercent>` for formatting percentages,
:doc:`formatRam<formatRam>` for formatting ram amounts and :doc:`formatNumber<formatNumber>` for formatting other numbers.
Converts a number into a string with the specified formatter.
This uses the numeral.js library, so the formatters must be compatible with that. This uses the numeral.js library, so the formatters must be compatible with that.
Examples: Examples:

@ -6,7 +6,7 @@ ps() Netscript Function
:RAM cost: 0.2 GB :RAM cost: 0.2 GB
:param string hostname: Hostname address of the target server. :param string hostname: Hostname address of the target server.
If not specified, it will be the current server's IP by default. If not specified, it will be the current server's IP by default.
:returns: array of object :returns: array of objects
Returns an array with general information about all scripts running on the Returns an array with general information about all scripts running on the
specified target server. The information for each server is given in an specified target server. The information for each server is given in an

@ -0,0 +1,22 @@
renamePurchasedServer() Netscript Function
===================================
.. js:function:: renamePurchasedServer(hostname, newName)
:RAM cost: 2 GB
:param string hostname: Hostname of the purchased server.
:param string newName: New name for the given server.
:returns: ``true`` if the renaming was succesful.
Upgrades the purchased server with the specified hostname to have specified amount of RAM.
The ``hostname`` argument can be any data type, but it will be converted to
a string and have whitespace removed. New RAM amount has to be higher than the current RAM
and a power of 2. Upgrading a server costs the difference of old RAM server cost and new RAM
server cost.
Example:
.. code-block:: javascript
ns.renamePurchasedServer("server", "old_server");

@ -1,7 +1,7 @@
resizeTail() Netscript Function resizeTail() Netscript Function
=============================== ===============================
.. js:function:: resizeTail(width, heigth[, pid]) .. js:function:: resizeTail(width, heigth[, pid = current script])
:RAM cost: 0 GB :RAM cost: 0 GB

@ -0,0 +1,19 @@
mv() Netscript Function
==============================
.. js:function:: rm(Filename [,hostname = current hostname])
:RAM cost: 0 GB
:param string Filename: Name of the file to be deleted.
:param string hostname: Hostname of the target server.
Delete a file on the given server.
.. warning!:: There is no safetychecks or recycling bins. Deleted files are lost.
Examples:
.. code-block:: javascript
ns.rm("foo.js");

@ -6,12 +6,12 @@ run() Netscript Function
:RAM cost: 1 GB :RAM cost: 1 GB
:param string script: Filename of script to run :param string script: Filename of script to run
:param number numThreads: Optional thread count for new script. Set to 1 by :param number numThreads: Optional thread count for new script. Set to 1 by
default. Will be rounded to nearest integer. default. Has to be an integer.
:param args...: :param args...:
Additional arguments to pass into the new script that is being run. Note Additional arguments to pass into the new script that is being run. Note
that if any arguments are being passed into the new script, then the that if any arguments are being passed into the new script, then the
second argument ``numThreads`` must be filled in with a value. second argument ``numThreads`` must be filled in with a value.
:returns: The process id of the new process or 0 on failure. :returns: The process id (PID) of the new process or 0 on failure.
Run a script as a separate process. This function can only be used to run Run a script as a separate process. This function can only be used to run
scripts located on the current server (the server running the script that scripts located on the current server (the server running the script that

@ -1,7 +1,7 @@
scan() Netscript Function scan() Netscript Function
========================= =========================
.. js:function:: scan(hostname=current hostname) .. js:function:: scan(hostname = current hostname)
:RAM cost: 0.2 GB :RAM cost: 0.2 GB
:param string hostname: Hostname of the server to scan. :param string hostname: Hostname of the server to scan.

@ -1,7 +1,7 @@
scp() Netscript Function scp() Netscript Function
======================== ========================
.. js:function:: scp(files, destination [, source]) .. js:function:: scp(files, destination [, source = current hostname])
:RAM cost: 0.6 GB :RAM cost: 0.6 GB
:param string/array files: Filename or an array of filenames of script/literature files to copy :param string/array files: Filename or an array of filenames of script/literature files to copy

@ -1,7 +1,7 @@
sleep() Netscript Function sleep() Netscript Function
========================== ==========================
.. js:function:: sleep(n) .. js:function:: sleep([n = 0])
:RAM cost: 0 GB :RAM cost: 0 GB
:param number n: Number of milliseconds to sleep :param number n: Number of milliseconds to sleep

@ -1,12 +1,11 @@
spawn() Netscript Function spawn() Netscript Function
========================== ==========================
.. js:function:: spawn(script, numThreads[, args...]) .. js:function:: spawn(script[, numThreads = 1[, args...]])
:RAM cost: 2 GB :RAM cost: 2 GB
:param string script: Filename of script to execute :param string script: Filename of script to execute
:param number numThreads: Number of threads to spawn new script with. Will :param number numThreads: Number of threads to spawn new script with. Has to be an integer.
be rounded to nearest integer.
:param args...: :param args...:
Additional arguments to pass into the new script that is being run. Additional arguments to pass into the new script that is being run.

@ -1,12 +1,13 @@
tFormat() Netscript Function tFormat() Netscript Function
============================== ==============================
.. js:function:: tFormat(milliseconds[, milliPrecision]) .. js:function:: tFormat(milliseconds[, milliPrecision = false])
:RAM cost: 0 GB :RAM cost: 0 GB
:param string milliseconds: Number of millisecond to format. :param string milliseconds: Number of millisecond to format.
:param boolean milliPrecision: Format time with subsecond precision. Defaults to false. :param boolean milliPrecision: Format time with subsecond precision.
:returns: Formatted string.
Format time to a readable string. Format time to a readable string.

@ -7,7 +7,7 @@ upgradePurchasedServer() Netscript Function
:param string hostname: Hostname of the purchased server. :param string hostname: Hostname of the purchased server.
:param number ram: Amount of RAM of the purchased server. Must be a power of :param number ram: Amount of RAM of the purchased server. Must be a power of
2. Maximum value of :doc:`getPurchasedServerMaxRam<getPurchasedServerMaxRam>` 2. Maximum value of :doc:`getPurchasedServerMaxRam<getPurchasedServerMaxRam>`
:returns: ``true`` if the upgrade succeeded, ``false`` otherwise :returns: ``true`` if the upgrade succeeded.
Upgrades the purchased server with the specified hostname to have specified amount of RAM. Upgrades the purchased server with the specified hostname to have specified amount of RAM.

@ -18,6 +18,9 @@ This includes information such as function signatures, what they do, and their r
tprint() <basicfunctions/tprint> tprint() <basicfunctions/tprint>
tFormat() <basicfunctions/tFormat> tFormat() <basicfunctions/tFormat>
nFormat() <basicfunctions/nFormat> nFormat() <basicfunctions/nFormat>
formatNumber() <basicfunctions/nFormat>
formatPercent() <basicfunctions/nFormat>
formatRam() <basicfunctions/nFormat>
disableLog() <basicfunctions/disableLog> disableLog() <basicfunctions/disableLog>
enableLog() <basicfunctions/enableLog> enableLog() <basicfunctions/enableLog>
isLogEnabled() <basicfunctions/isLogEnabled> isLogEnabled() <basicfunctions/isLogEnabled>
@ -44,6 +47,7 @@ This includes information such as function signatures, what they do, and their r
ls() <basicfunctions/ls> ls() <basicfunctions/ls>
ps() <basicfunctions/ps> ps() <basicfunctions/ps>
mv() <basicfunctions/mv> mv() <basicfunctions/mv>
rm() <basicfunctions/rm>
hasRootAccess() <basicfunctions/hasRootAccess> hasRootAccess() <basicfunctions/hasRootAccess>
getHostname() <basicfunctions/getHostname> getHostname() <basicfunctions/getHostname>
getHackingLevel() <basicfunctions/getHackingLevel> getHackingLevel() <basicfunctions/getHackingLevel>
@ -63,6 +67,7 @@ This includes information such as function signatures, what they do, and their r
purchaseServer() <basicfunctions/purchaseServer> purchaseServer() <basicfunctions/purchaseServer>
deleteServer() <basicfunctions/deleteServer> deleteServer() <basicfunctions/deleteServer>
upgradePurchasedServer() <basicfunctions/upgradePurchasedServer> upgradePurchasedServer() <basicfunctions/upgradePurchasedServer>
renamePurchasedServer() <basicfunctions/renamePurchasedServer>
getPurchasedServers() <basicfunctions/getPurchasedServers> getPurchasedServers() <basicfunctions/getPurchasedServers>
getPurchasedServerLimit() <basicfunctions/getPurchasedServerLimit> getPurchasedServerLimit() <basicfunctions/getPurchasedServerLimit>
getPurchasedServerMaxRam() <basicfunctions/getPurchasedServerMaxRam> getPurchasedServerMaxRam() <basicfunctions/getPurchasedServerMaxRam>