mirror of
https://github.com/bitburner-official/bitburner-src.git
synced 2024-11-18 05:33:54 +01:00
65cd14e33b
* Add specific types for sleeve tasks * Moved LocationName enum to overall enums file * Add LocationName enum to those provided to player * remove trailing s on CompanyPosNames enum (now CompanyPosName, in line with LocationName) * Also regenerated all ns documentation. This leads to an expected error when checking for generated files, because PRs should not normally touch markdown files. Also leads to a lint failure in generated file bitburner.d.ts * also removed some exporting from NetscriptDefinitions.d.ts for anything that wasn't imported somewhere else.
71 lines
2.0 KiB
Markdown
71 lines
2.0 KiB
Markdown
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
||
|
||
[Home](./index.md) > [bitburner](./bitburner.md) > [NS](./bitburner.ns.md) > [scp](./bitburner.ns.scp.md)
|
||
|
||
## NS.scp() method
|
||
|
||
Copy file between servers.
|
||
|
||
<b>Signature:</b>
|
||
|
||
```typescript
|
||
scp(files: string | string[], destination: string, source?: string): boolean;
|
||
```
|
||
|
||
## Parameters
|
||
|
||
| Parameter | Type | Description |
|
||
| --- | --- | --- |
|
||
| files | string \| string\[\] | Filename or an array of filenames of script/literature files to copy. |
|
||
| destination | string | Hostname of the destination server, which is the server to which the file will be copied. |
|
||
| source | string | 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. |
|
||
|
||
<b>Returns:</b>
|
||
|
||
boolean
|
||
|
||
True if the file is successfully copied over and false otherwise. If the files argument is an array then this function will return false if any of the operations failed.
|
||
|
||
## Remarks
|
||
|
||
RAM cost: 0.6 GB
|
||
|
||
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.
|
||
|
||
## Example 1
|
||
|
||
|
||
```ts
|
||
// NS1:
|
||
//Copies foo.lit from the helios server to the home computer:
|
||
scp("foo.lit", "home", "helios");
|
||
|
||
//Tries to copy three files from rothman-uni to home computer:
|
||
files = ["foo1.lit", "foo2.script", "foo3.script"];
|
||
scp(files, "home", "rothman-uni");
|
||
```
|
||
|
||
## Example 2
|
||
|
||
|
||
```ts
|
||
// NS2:
|
||
//Copies foo.lit from the helios server to the home computer:
|
||
ns.scp("foo.lit", "home", "helios" );
|
||
|
||
//Tries to copy three files from rothman-uni to home computer:
|
||
files = ["foo1.lit", "foo2.script", "foo3.script"];
|
||
ns.scp(files, "home", "rothman-uni");
|
||
```
|
||
|
||
## Example 3
|
||
|
||
|
||
```ts
|
||
//ns2, copies files from home to a target server
|
||
const server = ns.args[0];
|
||
const files = ["hack.js","weaken.js","grow.js"];
|
||
ns.scp(files, server, "home");
|
||
```
|
||
|