tail head cat sleep
QR code linking to this page

Manual Pages  — ATF-SH

NAME

atf-sh – interpreter for shell-based test programs

CONTENTS

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)

ATF-SH (1) March 6, 2017

tail head cat sleep
QR code linking to this page


Please direct any comments about this manual page service to Ben Bullock.

Not only is UNIX dead, it's starting to smell really bad.
— Rob Pike