support for filtering shared library stubs in symlink tree

Summary:
see context from D71155560 and D70927140 and https://fb.workplace.com/groups/930797200910874/permalink/1570732950250626/

This diff gives us the ability to mark cxx library targets as a "stub", which means we will use the shared library during building, but will not copy it to the output folder (letting system libs take precedence).

I have confirmed this helps with packaging common OpenGL, X11, and Cuda libraries.

Reviewed By: jrodal98

Differential Revision: D71352110

fbshipit-source-id: f320b1641f56361bd5e3f38f7beadf20df88223d

Author: EscapeZero

prelude/cxx/cxx.bzl

@@ -721,6 +721,7 @@ def prebuilt_cxx_library_impl(ctx: AnalysisContext) -> list[Provider]:
                 shared_libs = shared_libs,
                 linker_flags = linker_flags,
                 can_be_asset = getattr(ctx.attrs, "can_be_asset", False) or False,
+                stub = getattr(ctx.attrs, "stub", False),
             ),
             excluded = {ctx.label: None} if not value_or(ctx.attrs.supports_merged_linking, True) else {},
         ),

prelude/cxx/cxx_executable.bzl

@@ -547,7 +547,7 @@ def cxx_executable(ctx: AnalysisContext, impl_params: CxxRuleConstructorParams,
                 continue
             preferred_linkage = linkable_node.linkable.preferred_linkage
             output_style = get_lib_output_style(link_strategy, preferred_linkage, PicBehavior("supported"))
-            if output_style == LibOutputStyle("shared_lib"):
+            if output_style == LibOutputStyle("shared_lib") and not linkable_node.linkable.stub:
                 shlib_deps.append(merge_shared_libraries(ctx.actions, node = linkable_node.linkable.shared_libs))
     elif impl_params.runtime_dependency_handling == RuntimeDependencyHandling("symlink_single_level_only"):
         for d in link_deps + impl_params.extra_link_roots:

prelude/cxx/cxx_library.bzl

@@ -878,6 +878,7 @@ def cxx_library_parameterized(ctx: AnalysisContext, impl_params: CxxRuleConstruc
                     can_be_asset = getattr(ctx.attrs, "can_be_asset", False) or False,
                     # We don't want to propagate shared interaces across shared library boundaries.
                     shared_interface_info = None if preferred_linkage == Linkage("shared") else create_shared_interface_info(ctx, exported_symbol_outputs, []),
+                    stub = getattr(ctx.attrs, "stub", False),
                 ),
                 excluded = {ctx.label: None} if not value_or(ctx.attrs.supports_merged_linking, True) else {},
             ),

prelude/cxx/cxx_types.bzl

@@ -248,4 +248,6 @@ CxxRuleConstructorParams = record(
     export_header_unit_filter = field(list[str], []),
     # Additional behavior for how to handle runtime dependencies
     runtime_dependency_handling = field([RuntimeDependencyHandling, None], None),
+    # Should this library only be used for build time linkage
+    stub = field(bool, False),
 )

prelude/linking/linkable_graph.bzl

@@ -116,6 +116,9 @@ LinkableNode = record(
     # It should be SharedInterfaceInfo | None
     shared_interface_info = field(typing.Any),
 
+    # Should this library only be used for build time linkage
+    stub = field(bool),
+
     # Only allow constructing within this file.
     _private = _DisallowConstruction,
 )
@@ -185,7 +188,8 @@ def create_linkable_node(
         # TODO(mattpayne): This type is incompatible with Autodeps.
         # Once the pyautotargets service is rolled out, we can change it back.
         # It should be SharedInterfaceInfo | None
-        shared_interface_info: typing.Any = None) -> LinkableNode:
+        shared_interface_info: typing.Any = None,
+        stub: bool = False) -> LinkableNode:
     for output_style in _get_required_outputs_for_linkage(preferred_linkage):
         expect(
             output_style in link_infos,
@@ -211,6 +215,7 @@ def create_linkable_node(
         linker_flags = linker_flags,
         ignore_force_static_follows_dependents = ignore_force_static_follows_dependents,
         shared_interface_info = shared_interface_info,
+        stub = stub,
         _private = _DisallowConstruction(),
     )
 

prelude/rules_impl.bzl

@@ -454,6 +454,7 @@ inlined_extra_attributes = {
         ),
         "resources": attrs.named_set(attrs.one_of(attrs.dep(), attrs.source(allow_directory = True)), sorted = True, default = []),
         "separate_debug_info": attrs.bool(default = False),
+        "stub": attrs.bool(default = False),
         "supports_header_symlink_subtarget": attrs.bool(default = False),
         "supports_python_dlopen": attrs.option(attrs.bool(), default = None),
         "supports_shlib_interfaces": attrs.bool(default = True),
@@ -590,6 +591,7 @@ inlined_extra_attributes = {
         "public_include_directories": attrs.set(attrs.string(), sorted = True, default = []),
         "public_system_include_directories": attrs.set(attrs.string(), sorted = True, default = []),
         "raw_headers": attrs.set(attrs.source(), sorted = True, default = []),
+        "stub": attrs.bool(default = False),
         "supports_lto": attrs.bool(default = False),
         "supports_python_dlopen": attrs.bool(default = True),
         "versioned_header_dirs": attrs.option(attrs.versioned(attrs.list(attrs.source(allow_directory = True))), default = None),