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
===============================
.. js:function:: closeTail([scriptPid])
.. js:function:: closeTail([scriptPid = current script])
:RAM cost: 0 GB

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

@ -8,12 +8,12 @@ exec() Netscript Function
:param string script: Filename of script to execute.
: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
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
being run. Note that if any arguments are being
passed into the new script, then the third argument ``numThreads`` must
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
the :doc:`run<run>` function except that it can be used to run a script on any

@ -1,7 +1,7 @@
fileExists() Netscript Function
===============================
.. js:function:: fileExists(filename[, hostname])
.. js:function:: fileExists(filename[, hostname = current hostname])
:RAM cost: 0.1 GB
@ -9,9 +9,9 @@ fileExists() Netscript Function
:param string hostname:
Hostname of target server. This is optional. If it is not specified then
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
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
=================================
.. js:function:: getScriptRam(filename[, hostname])
.. js:function:: getScriptRam(filename[, hostname = current hostname])
:RAM cost: 0.1 GB
:param string filename: Filename of script.

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

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

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

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

@ -1,10 +1,14 @@
mv() Netscript Function
==============================
.. js:function:: mv(serverName, sourceFile, targetFile)
.. js:function:: mv(hostname, sourceFile, targetFile)
: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.
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 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.
Examples:

@ -6,7 +6,7 @@ ps() Netscript Function
:RAM cost: 0.2 GB
:param string hostname: Hostname address of the target server.
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
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
===============================
.. js:function:: resizeTail(width, heigth[, pid])
.. js:function:: resizeTail(width, heigth[, pid = current script])
: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
:param string script: Filename of script to run
: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 being run. Note
that if any arguments are being passed into the new script, then the
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
scripts located on the current server (the server running the script that

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

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

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

@ -1,12 +1,13 @@
tFormat() Netscript Function
==============================
.. js:function:: tFormat(milliseconds[, milliPrecision])
.. js:function:: tFormat(milliseconds[, milliPrecision = false])
:RAM cost: 0 GB
: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.

@ -7,7 +7,7 @@ upgradePurchasedServer() Netscript Function
:param string hostname: Hostname of the purchased server.
:param number ram: Amount of RAM of the purchased server. Must be a power of
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.

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