FUNCTION::RETURN\_STR(3stap) Errno Tapset FUNCTION::RETURN\_STR(3stap)

# [NAME](#NAME)

function::return\_str - Formats the return value as a string

# [SYNOPSIS](#SYNOPSIS)

```


    return_str:string(format:long,ret:long)
```

# [ARGUMENTS](#ARGUMENTS)

*format*

Variable to determine return type base value

*ret*

Return value (typically **$return**)

# [DESCRIPTION](#DESCRIPTION)

This function is used by the syscall tapset, and returns a string. Set format equal to 1 for a decimal, 2 for hex, 3 for octal.

Note that this function is preferred over **returnstr**.

# [SEE ALSO0](#SEE_ALSO0)

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

September 2026 SystemTap Tapset Reference Ver

---

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