autoconf

Functions

autoconf

load("@rules_cc_autoconf//autoconf:autoconf.bzl", "autoconf")

autoconf(*, name, build_settings, cc_deps, checks, conlyopts, copts, cxxopts, default_deps, deps,
         **kwargs)

Run autoconf-like checks and produce results.

This rule resolves the autoconf_toolchain (when registered) to skip redundant checker actions. If a check's cache variable name already has a result in the toolchain or in transitive deps, the existing result file is reused.

Use autoconf_cache instead for targets that feed into autoconf_toolchain to avoid a dependency cycle.

Example:

load("@rules_cc_autoconf//autoconf:autoconf.bzl", "autoconf")
load("@rules_cc_autoconf//autoconf:checks.bzl", "checks")

autoconf(
    name = "config",
    checks = [
        checks.AC_CHECK_HEADER("stdio.h"),
        checks.AC_CHECK_HEADER("stdlib.h"),
        checks.AC_CHECK_FUNC("printf"),
    ],
)

The results can then be used by autoconf_hdr or autoconf_srcs to generate headers or wrapped source files.

PARAMETERS

NameDescriptionDefault Value
nameA unique name for this target.none
build_settingsList of checks.AC_BUILD_SETTING(...) entries associating Bazel build setting targets (any rule providing BuildSettingInfo) with autoconf-style defines and substitutions.None
cc_depsLibraries the checks compile against and link, as configure's CPPFLAGS and LIBS carry a project's dependencies: every check sees their include directories and defines, and every link probe links their archives after its own object. Their flags are part of each check's identity, so a check never shares a result between targets with different cc_deps. Prefer cc_deps = ["@gmp//:gmp"] with a real AC_CHECK_LIB over a static AC_DEFINE.None
checksList of JSON-encoded checks from checks (e.g., checks.AC_CHECK_HEADER('stdio.h')).None
conlyoptsFlags for the C compiles of this target's checks only, after copts (as on a cc_library). Not transitive: flags for every check of a build, the gnulib ports included, are --copt.None
coptsFlags for every compile of this target's checks, after the toolchain's and --copt / --cxxopt and before a check's own copts (the order of a cc_library's), so they win over the command line where the last flag counts. Not transitive.None
cxxoptsFlags for the C++ compiles of this target's checks only, after copts (as on a cc_library). Not transitive.None
default_depsautoconf_defaults targets. Their values stand where no result of the name comes through deps; a result overrides a default silently, and two defaults of one name must agree. The defaults a deps entry carries are read as well, and dependents of this target read all of them in turn. This is gnulib's *_H_DEFAULTS pattern (HAVE_X=1, REPLACE_X=0 before the probes may reassign them): list a header's :defaults here where the m4 AC_REQUIREs gl_<HEADER>_H_DEFAULTS.None
depsAdditional autoconf, autoconf_cache, or autoconf_package_info dependencies.None
kwargsStandard Bazel attributes (e.g. visibility, tags).none