com.facebook.buck.cxx.toolchain

Class ClangWindowsArchiver

java.lang.Object

com.facebook.buck.core.toolchain.tool.DelegatingTool

com.facebook.buck.cxx.toolchain.ClangWindowsArchiver

All Implemented Interfaces:

AddsToRuleKey, Tool, Archiver

public class ClangWindowsArchiver
extends DelegatingTool
implements Archiver

Archiver implementation for the Clang for Windows toolchain.

The implementation currently is only suitable for generating .lib archives for Windows-targeted builds, for ingestion by either link.exe or lld-link.exe. If used with lld-link.exe, thin archives are an option. link.exe cannot ingest thin archives generated with this tool.

Constructor Summary

Constructors

Constructor and Description
ClangWindowsArchiver(Tool tool)

Method Summary

Modifier and Type	Method and Description
com.google.common.collect.ImmutableList<String>	getArchiveOptions(boolean isThinArchive)
com.google.common.collect.ImmutableList<FileScrubber>	getScrubbers()
boolean	isArgfileRequired() Whether an argfile is required for a long command line (false means that it is possible to split a long command line into chunks).
boolean	isRanLibStepRequired()
com.google.common.collect.ImmutableList<String>	outputArgs(String outputPath)
boolean	supportsThinArchives()

Methods inherited from class com.facebook.buck.core.toolchain.tool.DelegatingTool

getCommandPrefix, getEnvironment

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.facebook.buck.core.toolchain.tool.Tool

getCommandPrefix, getEnvironment

Constructor Detail

ClangWindowsArchiver

public ClangWindowsArchiver(Tool tool)

Method Detail

getScrubbers

public com.google.common.collect.ImmutableList<FileScrubber> getScrubbers()

Specified by:

getScrubbers in interface Archiver

supportsThinArchives

public boolean supportsThinArchives()

Specified by:

supportsThinArchives in interface Archiver

getArchiveOptions

public com.google.common.collect.ImmutableList<String> getArchiveOptions(boolean isThinArchive)

Specified by:

getArchiveOptions in interface Archiver

outputArgs

public com.google.common.collect.ImmutableList<String> outputArgs(String outputPath)

Specified by:

outputArgs in interface Archiver

isRanLibStepRequired

public boolean isRanLibStepRequired()

Specified by:

isRanLibStepRequired in interface Archiver

isArgfileRequired

public boolean isArgfileRequired()

Description copied from interface: Archiver

Whether an argfile is required for a long command line (false means that it is possible to split a long command line into chunks). Eg, ar on *nix allows to add new files to an already created archive, but doesn't accept argfiles. On the contrary, VS lib.exe on windows always overrides the previous archive, but supports argfiles.

Specified by:

isArgfileRequired in interface Archiver

Returns:

whether @argfile is required for a long command line