---
name: "atf-sh"
section: "1"
platform: "macos"
package: "bind9"
version: "65"
release: "macOS 26.5"
platforms: ["linux", "freebsd", "macos"]
url: "https://new.carta.tech/atf-sh"
---

# atf-sh(1)

interpreter for shell-based test programs

## NAME

**atf-sh** – interpreter for shell-based test programs

## SYNOPSIS

**atf-sh** *script*

**atf-sh** **-h**

## DESCRIPTION

**atf-sh** is an interpreter that runs the test program given in *script* after loading the [atf-sh-api(3)](/atf-sh-api/3.md) library.

**atf-sh** is not a real interpreter though: it is just a wrapper around the system-wide shell defined by the ‘atf\_shell’ configuration value in [atf-config(1)](/atf-config/1.md). **atf-sh** executes the interpreter, loads the [atf-sh-api(3)](/atf-sh-api/3.md) library and then runs the script.

Scripts using [atf-sh-api(3)](/atf-sh-api/3.md) should start with:

```
#! /usr/bin/env atf-sh
```

The following options are available:

- **-h**

  Shows a short summary of all available options and their purpose. For those formats that write to a single file, specifying a ‘-’ as the path will redirect the report to the standard output.

## SEE ALSO

[atf-config(1)](/atf-config/1.md), [atf-sh-api(3)](/atf-sh-api/3.md), [atf(7)](/atf/7.md)