NAME
atf-config
- queries static configuration information of ATF
SYNOPSIS
atf-config
[-t]
[var1[ .. varN]]
atf-config
-h
DESCRIPTION
atf-config
is a utility that queries static configuration information of ATF.
Static configuration refers to all those values for settings that
were built into the ATF binaries at build time.
In the first synopsis form,
atf-config
will print variable-value pairs for all built-in static variables if
no variable names are provided as arguments.
If any is provided, it will only print the variable-value pairs for
those variables.
The output of the utility does not use the
`='
symbol to separate the variable name from its corresponding value in
an attempt to avoid sourcing the output in shell scripts or Makefiles.
If you need to do that, the
-t
flag allows you to query the value of individual variables without any
surrounding text.
In the second synopsis form,
atf-config
will print information about all supported options and their purpose.
The following options are available:
- -h
-
Shows a short summary of all available options and their purpose.
- -t
-
Changes the output of the utility to show the variable values, one
per line, without the variable names.
Static configuration variables
The following list describes all the variables that are part of ATF's
static configuration:
- atf_arch
-
The architecture name detected by ATF.
This is derived from
atf_machine
because it is a subset of it.
Given that this name might be misdetected, it is provided to the user
as a configuration variable so that he can fix its value temporarily
until a real fix is incorporated into mainstream sources.
- atf_confdir
-
The path to the directory that contains the system-wide configuration
files for ATF.
- atf_libexecdir
-
The path to the directory that contains the auxiliary utilities of ATF,
used internally by the public tools.
- atf_machine
-
The machine type name detected by ATF.
This should not be tunable but is provided for symmetry with
atf_arch.
- atf_pkgdatadir
-
The path to the directory that contains the files that form the ATF's
shell-scripting library.
- atf_shell
-
The path to the shell interpreter that will be used by ATF.
- atf_workdir
-
The path to the temporary directory that the utilities and the test
programs will use to store temporary files in.
ENVIRONMENT
Every variable that is part of the static configuration can be
overridden at run-time by defining an environment variable.
This environment variable has the exact same name as the one shown by
atf-config
except that the name is all composed of uppercase letters.
The recognized environment variables are:
ATF_ARCH
-
Overrides the built-in value of
atf_arch.
ATF_CONFDIR
-
Overrides the built-in value of
atf_confdir.
ATF_LIBEXECDIR
-
Overrides the built-in value of
atf_libexecdir.
ATF_MACHINE
-
Overrides the built-in value of
atf_machine.
ATF_PKGDATADIR
-
Overrides the built-in value of
atf_pkgdatadir.
ATF_SHELL
-
Overrides the built-in value of
atf_shell.
ATF_WORKDIR
-
Overrides the built-in value of
atf_workdir.
SEE ALSO
atf(7)