blob: 5ff27c1a4b0de5f433599b7871974c0a586d445d [file] [log] [blame]
#!/usr/bin/env python3
# Copyright 2022 The Pigweed Authors
#
# Licensed under the Apache License, Version 2.0 (the "License"); you may not
# use this file except in compliance with the License. You may obtain a copy of
# the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
# License for the specific language governing permissions and limitations under
# the License.
""" An internal set of tools for creating embedded CC targets. """
load("@rules_cc//cc:action_names.bzl", "C_COMPILE_ACTION_NAME")
load("@rules_cc//cc:toolchain_utils.bzl", "find_cpp_toolchain")
DEBUGGING = [
"-g",
]
# Standard compiler flags to reduce output binary size.
REDUCED_SIZE_COPTS = [
"-fno-common",
"-fno-exceptions",
"-ffunction-sections",
"-fdata-sections",
]
STRICT_WARNINGS_COPTS = [
"-Wall",
"-Wextra",
# Make all warnings errors, except for the exemptions below.
"-Werror",
"-Wno-error=cpp", # preprocessor #warning statement
"-Wno-error=deprecated-declarations", # [[deprecated]] attribute
]
CPP17_COPTS = [
"-std=c++17",
"-fno-rtti",
"-Wnon-virtual-dtor",
# Allow uses of the register keyword, which may appear in C headers.
"-Wno-register",
]
DISABLE_PENDING_WORKAROUND_COPTS = [
"-Wno-private-header",
]
PW_DEFAULT_COPTS = (
DEBUGGING +
REDUCED_SIZE_COPTS +
STRICT_WARNINGS_COPTS +
DISABLE_PENDING_WORKAROUND_COPTS
)
KYTHE_COPTS = [
"-Wno-unknown-warning-option",
]
PW_DEFAULT_LINKOPTS = []
def add_defaults(kwargs):
"""Adds default arguments suitable for both C and C++ code to kwargs.
Args:
kwargs: cc_* arguments to be modified.
"""
copts = PW_DEFAULT_COPTS + kwargs.get("copts", [])
kwargs["copts"] = select({
"@pigweed//pw_build:kythe": copts + KYTHE_COPTS,
"//conditions:default": copts,
})
kwargs["linkopts"] = kwargs.get("linkopts", []) + PW_DEFAULT_LINKOPTS
# Set linkstatic to avoid building .so files.
kwargs["linkstatic"] = True
kwargs.setdefault("features", [])
# Crosstool--adding this line to features disables header modules, which
# don't work with -fno-rtti. Note: this is not a command-line argument,
# it's "minus use_header_modules".
kwargs["features"].append("-use_header_modules")
def default_cc_and_c_kwargs(kwargs):
"""Splits kwargs into C and C++ arguments adding defaults.
Args:
kwargs: cc_* arguments to be modified.
Returns:
A tuple of (cc_cxx_kwargs cc_c_kwargs)
"""
add_defaults(kwargs)
kwargs.setdefault("srcs", [])
cc = dict(kwargs.items())
cc["srcs"] = [src for src in kwargs["srcs"] if not src.endswith(".c")]
cc["copts"] = cc["copts"] + CPP17_COPTS
c_srcs = [src for src in kwargs["srcs"] if src.endswith(".c")]
if c_srcs:
c = dict(kwargs.items())
c["name"] += "_c"
c["srcs"] = c_srcs + [src for src in kwargs["srcs"] if src.endswith(".h")]
cc["deps"] = cc.get("deps", []) + [":" + c["name"]]
return cc, c
return cc, None
def add_cc_and_c_targets(target, kwargs): # buildifier: disable=unnamed-macro
"""Splits target into C and C++ targets adding defaults.
Args:
target: cc_* target to be split.
kwargs: cc_* arguments to be modified.
"""
cc_kwargs, c_kwargs = default_cc_and_c_kwargs(kwargs)
if c_kwargs:
native.cc_library(**c_kwargs)
target(**cc_kwargs)
def has_pw_assert_dep(deps):
"""Checks if the given deps contain a pw_assert dependency
Args:
deps: List of dependencies
Returns:
True if the list contains a pw_assert dependency.
"""
pw_assert_targets = ["//pw_assert", "//pw_assert:pw_assert"]
pw_assert_targets.extend(["@pigweed" + t for t in pw_assert_targets])
for dep in deps:
if dep in pw_assert_targets:
return True
return False
def _preprocess_linker_script_impl(ctx):
cc_toolchain = find_cpp_toolchain(ctx)
output_script = ctx.actions.declare_file(ctx.label.name + ".ld")
feature_configuration = cc_common.configure_features(
ctx = ctx,
cc_toolchain = cc_toolchain,
requested_features = ctx.features,
unsupported_features = ctx.disabled_features,
)
cxx_compiler_path = cc_common.get_tool_for_action(
feature_configuration = feature_configuration,
action_name = C_COMPILE_ACTION_NAME,
)
c_compile_variables = cc_common.create_compile_variables(
feature_configuration = feature_configuration,
cc_toolchain = cc_toolchain,
user_compile_flags = ctx.fragments.cpp.copts + ctx.fragments.cpp.conlyopts,
)
env = cc_common.get_environment_variables(
feature_configuration = feature_configuration,
action_name = C_COMPILE_ACTION_NAME,
variables = c_compile_variables,
)
ctx.actions.run(
outputs = [output_script],
inputs = depset(
[ctx.file.linker_script],
transitive = [cc_toolchain.all_files],
),
executable = cxx_compiler_path,
arguments = [
"-E",
"-P",
"-xc",
ctx.file.linker_script.short_path,
"-o",
output_script.path,
] + [
"-D" + d
for d in ctx.attr.defines
] + ctx.attr.copts,
env = env,
)
return [DefaultInfo(files = depset([output_script]))]
pw_linker_script = rule(
_preprocess_linker_script_impl,
attrs = {
"copts": attr.string_list(doc = "C compile options."),
"defines": attr.string_list(doc = "C preprocessor defines."),
"linker_script": attr.label(
mandatory = True,
allow_single_file = True,
doc = "Linker script to preprocess.",
),
"_cc_toolchain": attr.label(default = Label("@bazel_tools//tools/cpp:current_cc_toolchain")),
},
toolchains = ["@bazel_tools//tools/cpp:toolchain_type"],
fragments = ["cpp"],
)