2019-03-03 04:08:54 +01:00
|
|
|
scp() Netscript Function
|
|
|
|
========================
|
|
|
|
|
2022-09-05 13:52:30 +02:00
|
|
|
.. js:function:: scp(files, destination [, source])
|
2019-03-03 04:08:54 +01:00
|
|
|
|
2021-03-12 08:51:56 +01:00
|
|
|
:RAM cost: 0.6 GB
|
2019-03-03 04:08:54 +01:00
|
|
|
: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.
|
2019-03-03 04:08:54 +01:00
|
|
|
: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.
|
2019-03-03 04:08:54 +01:00
|
|
|
This argument is optional and if it's omitted the source will be the current server.
|
2021-07-02 23:27:59 +02:00
|
|
|
: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.
|
2019-03-03 04:08:54 +01:00
|
|
|
|
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.
|
2019-03-03 04:08:54 +01:00
|
|
|
|
2021-03-12 08:51:56 +01:00
|
|
|
Example:
|
2019-03-03 04:08:54 +01:00
|
|
|
|
2021-03-12 08:51:56 +01:00
|
|
|
.. code-block:: javascript
|
2019-03-03 04:08:54 +01:00
|
|
|
|
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
|
2019-03-03 04:08:54 +01:00
|
|
|
|
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
|
2019-03-03 04:08:54 +01:00
|
|
|
|
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
|