FUNCTION::REMOTE\_ID(3stap) Context Functions FUNCTION::REMOTE\_ID(3stap)

# [NAME](#NAME)

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

# [SYNOPSIS](#SYNOPSIS)

```


    remote_id:long()
```

# [ARGUMENTS](#ARGUMENTS)

None

# [DESCRIPTION](#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](#SEE_ALSO0)

[*tapset::context*(3stap)](/man/enterprise-packages/systemtap/tapset::context.3stap)

September 2026 SystemTap Tapset Reference Ver

---

Document: function::remote_id(3stap) from systemtap 5.6-r1 (Chainguard OS)
Source: https://sourceware.org/git/systemtap.git