mirror of
https://github.com/bitburner-official/bitburner-src.git
synced 2024-12-23 14:42:28 +01:00
34 lines
1.5 KiB
ReStructuredText
34 lines
1.5 KiB
ReStructuredText
scp() Netscript Function
|
|
========================
|
|
|
|
.. 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
|
|
:param string destination: Hostname of the destination server, which is the server to which the file will be copied.
|
|
:param string source:
|
|
Hostname of the source server, which is the server from which the file will be copied.
|
|
This argument is optional and if it's omitted the source will be the current server.
|
|
:returns: ``true`` if the copy was a success.
|
|
|
|
Copies a script or literature (.lit) file(s) to another server. The
|
|
``files`` argument can be either a string specifying a single file to copy,
|
|
or an array of strings specifying multiple files to copy.
|
|
|
|
If the ``files`` argument is an array then this function will return true if
|
|
at least one of the files in the array is successfully copied.
|
|
|
|
Example:
|
|
|
|
.. code-block:: javascript
|
|
|
|
//Copies "hack-template.script" from the current server to "foodnstuff"
|
|
ns.scp("hack-template.script", "foodnstuff"); // returns: true
|
|
|
|
//Copies "foo.lit" from the helios server to the "home" computer
|
|
ns.scp("foo.lit", "home", "helios"); // returns: true
|
|
|
|
//Tries to copy three files from "rothman-uni" to "home" computer
|
|
const files = ["foo1.lit", "foo2.script", "foo3.script"];
|
|
ns.scp(files, "home", "rothman-uni"); // returns: true
|