bitburner-src/markdown/bitburner.ns.tail.md

59 lines
1.5 KiB
Markdown
Raw Normal View History

2021-10-30 18:34:14 +02:00
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [NS](./bitburner.ns.md) &gt; [tail](./bitburner.ns.tail.md)
## NS.tail() method
Opens a scripts logs. This is functionally the same as the tail Terminal command.
If the function is called with no arguments, it will open the current scripts logs.
Otherwise, the fn, hostname/ip, and args… arguments can be used to get the logs from another script. Remember that scripts are uniquely identified by both their names and arguments.
<b>Signature:</b>
```typescript
2021-10-30 21:46:34 +02:00
tail(fn?: string, host?: string, ...args: any[]): void;
2021-10-30 18:34:14 +02:00
```
## Parameters
| Parameter | Type | Description |
| --- | --- | --- |
2021-10-30 21:46:34 +02:00
| fn | string | Optional. Filename of the script being tailed. If omitted, the current script is tailed. |
| host | string | Optional. Hostname of the script being tailed. Defaults to the server this script is running on. If args are specified, this is not optional. |
2021-10-30 18:34:14 +02:00
| args | any\[\] | Arguments for the script being tailed. |
<b>Returns:</b>
void
## Remarks
2021-10-30 21:46:34 +02:00
RAM cost: 0 GB
2021-10-30 18:34:14 +02:00
## Example 1
2021-10-30 21:46:34 +02:00
```ts
2021-10-30 18:34:14 +02:00
//Open logs from foo.script on the current server that was run with no args
tail("foo.script");
```
## Example 2
2021-10-30 21:46:34 +02:00
```ts
2021-10-30 18:34:14 +02:00
//Get logs from foo.script on the foodnstuff server that was run with no args
tail("foo.script", "foodnstuff");
```
## Example 3
2021-10-30 21:46:34 +02:00
```ts
2021-10-30 18:34:14 +02:00
//Get logs from foo.script on the foodnstuff server that was run with the arguments [1, "test"]
tail("foo.script", "foodnstuff", 1, "test");
```