---
name: "function::remote_id"
section: "3stap"
platform: "linux"
package: "systemtap-doc"
version: "5.1-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/function::remote_id"
---

# function::remote\_id(3stap)

The index of this instance in a remote execution.

## NAME

function::remote\_id - The index of this instance in a remote execution.

## SYNOPSIS

```
    remote_id:long()
```

## ARGUMENTS

None

## DESCRIPTION

This function returns a number 0..N, which is the unique index of this particular script execution from a swarm of “stap --remote A --remote B ...” runs, and is the same number “stap --remote-prefix” would print. The function returns -1 if the script was not launched with “stap --remote”, or if the remote staprun/stapsh are older than version 1.7.

## SEE ALSO0

[*tapset::context*(3stap)](/tapset::context/3stap.md)