FreeBSD manual
download PDF document: atf-sh.1.pdf
ATF-SH(1) FreeBSD General Commands Manual ATF-SH(1)
NAME
atf-sh - interpreter for shell-based test programs
SYNOPSIS
atf-sh [-s shell] script
DESCRIPTION
atf-sh is an interpreter that runs the test program given in script after
loading the atf-sh(3) library.
atf-sh is not a real interpreter though: it is just a wrapper around the
system-wide shell defined by ATF_SHELL. atf-sh executes the interpreter,
loads the atf-sh(3) library and then runs the script. You must consider
atf-sh to be a POSIX shell by default and thus should not use any non-
standard extensions.
The following options are available:
-s shell Specifies the shell to use instead of the value provided by
ATF_SHELL.
ENVIRONMENT
ATF_LIBEXECDIR Overrides the builtin directory where atf-sh is
located. Should not be overridden other than for
testing purposes.
ATF_PKGDATADIR Overrides the builtin directory where libatf-sh.subr is
located. Should not be overridden other than for
testing purposes.
ATF_SHELL Path to the system shell to be used in the generated
scripts. Scripts must not rely on this variable being
set to select a specific interpreter.
ATF_SHELL Path to the system shell to be used in the generated
scripts.
EXAMPLES
Scripts using atf-sh(3) should start with:
#! /usr/bin/env atf-sh
Alternatively, if you want to explicitly choose a shell interpreter, you
cannot rely on env(1) to find atf-sh. Instead, you have to hardcode the
path to atf-sh in the script and then use the -s option afterwards as a
single parameter:
#! /path/to/bin/atf-sh -s/bin/bash
SEE ALSO
atf-sh(3)
FreeBSD 14.0-RELEASE-p11 March 6, 2017 FreeBSD 14.0-RELEASE-p11