ATF-CONFIG(1)           NetBSD General Commands Manual           ATF-CONFIG(1)

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 vari-
     able 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)

NetBSD 5.0_STABLE               January 4, 2008              NetBSD 5.0_STABLE
