bitburner-src/doc/source/netscript/basicfunctions/scp.rst

34 lines
1.5 KiB
ReStructuredText
Raw Normal View History

scp() Netscript Function
========================
.. js:function:: scp(files, destination [, source = current hostname])
2021-03-12 08:51:56 +01:00
:RAM cost: 0.6 GB
:param string/array files: Filename or an array of filenames of script/literature files to copy
2022-08-20 11:03:47 +02:00
:param string destination: Hostname of the destination server, which is the server to which the file will be copied.
:param string source:
2021-03-12 08:51:56 +01:00
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.
2021-03-12 08:51:56 +01:00
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.
2021-03-12 08:51:56 +01:00
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.
2021-03-12 08:51:56 +01:00
Example:
2021-03-12 08:51:56 +01:00
.. code-block:: javascript
2021-03-12 08:51:56 +01:00
//Copies "hack-template.script" from the current server to "foodnstuff"
2023-01-06 13:43:09 +01:00
ns.scp("hack-template.script", "foodnstuff"); // returns: true
2021-03-12 08:51:56 +01:00
//Copies "foo.lit" from the helios server to the "home" computer
2023-01-06 13:43:09 +01:00
ns.scp("foo.lit", "home", "helios"); // returns: true
2021-03-12 08:51:56 +01:00
//Tries to copy three files from "rothman-uni" to "home" computer
2023-01-06 13:43:09 +01:00
const files = ["foo1.lit", "foo2.script", "foo3.script"];
ns.scp(files, "home", "rothman-uni"); // returns: true