com.facebook.buck.cxx.toolchain.nativelink

Enum NativeLinkStrategy

java.lang.Object

java.lang.Enum<NativeLinkStrategy>

com.facebook.buck.cxx.toolchain.nativelink.NativeLinkStrategy

All Implemented Interfaces:

Serializable, Comparable<NativeLinkStrategy>

public enum NativeLinkStrategy
extends Enum<NativeLinkStrategy>

The ways that other language (e.g. Python, Lua) binaries pull in native linkable dependencies.

Enum Constant Summary

Enum Constants

Enum Constant and Description
MERGED Statically link all transitive native deps, which don't have an explicit dep from non-C/C++ code (e.g.
SEPARATE Pull transitive native deps in as fully linked standalone shared libraries.

Method Summary

Modifier and Type	Method and Description
static NativeLinkStrategy	valueOf(String name) Returns the enum constant of this type with the specified name.
static NativeLinkStrategy[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

SEPARATE

public static final NativeLinkStrategy SEPARATE

Pull transitive native deps in as fully linked standalone shared libraries. This is typically the fastest build-time link strategy, as it requires no top-level context and therefore can shared build artifacts with all other binaries using this strategy.

MERGED

public static final NativeLinkStrategy MERGED

Statically link all transitive native deps, which don't have an explicit dep from non-C/C++ code (e.g. Python), into a monolithic shared library. Native dep roots, which have an explicit dep from non-C/C++ code, remain as fully linked standalone shared libraries so that, typically, application code doesn't need to change to work with this strategy. This strategy incurs a relatively big build-time cost, but can significantly reduce the size of native code and number of shared libraries pulled into the binary.

Method Detail

values

public static NativeLinkStrategy[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (NativeLinkStrategy c : NativeLinkStrategy.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static NativeLinkStrategy valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null