com.github.maven_nar.cpptasks.compiler

类 CommandLineLinker

java.lang.Object

com.github.maven_nar.cpptasks.compiler.AbstractProcessor

com.github.maven_nar.cpptasks.compiler.AbstractLinker

com.github.maven_nar.cpptasks.compiler.CommandLineLinker

所有已实现的接口:

Linker, Processor, Cloneable

直接已知子类:

AbstractArLibrarian, AbstractLdLinker, ADSLibrarian, ADSLinker, BorlandLibrarian, BorlandLinker, C89Linker, ClxxLibrarian, ClxxLinker, CompaqVisualFortranLibrarian, IccLinker, MsvcCompatibleLibrarian, MsvcCompatibleLinker, OpenWatcomLibrarian, OpenWatcomLinker, OS390Linker

public abstract class CommandLineLinker
extends AbstractLinker

An abstract Linker implementation that performs the link via an external command.

作者:

Adam Murdoch

字段概要

从类继承的字段 com.github.maven_nar.cpptasks.compiler.AbstractProcessor

DEFAULT_DISCARD_BID, DEFAULT_PROCESS_BID

构造器概要

构造器

构造器和说明
CommandLineLinker(String command, String identifierArg, String[] extensions, String[] ignoredExtensions, String outputSuffix, boolean isLibtool, CommandLineLinker libtoolLinker) Creates a comand line linker invocation

方法概要

限定符和类型	方法和说明
protected void	addBase(CCTask task, long base, Vector<String> args)
protected void	addEntry(CCTask task, String entry, Vector<String> args)
protected void	addFixed(CCTask task, Boolean fixed, Vector<String> args)
protected void	addImpliedArgs(CCTask task, boolean debug, LinkType linkType, Vector<String> args)
protected void	addIncremental(CCTask task, boolean incremental, Vector<String> args)
protected void	addLibraryDirectory(File libraryDirectory, Vector<String> preargs)
protected void	addLibraryPath(Vector<String> preargs, String path)
protected String[]	addLibrarySets(CCTask task, LibrarySet[] libsets, Vector<String> preargs, Vector<String> midargs, Vector<String> endargs)
protected void	addMap(CCTask task, boolean map, Vector<String> args)
protected void	addStack(CCTask task, int stack, Vector<String> args)
protected LinkerConfiguration	createConfiguration(CCTask task, LinkType linkType, ProcessorDef[] baseDefs, LinkerDef specificDef, TargetDef targetPlatform, VersionInfo versionInfo)
protected String	decorateLinkerOption(StringBuffer buf, String arg) Allows drived linker to decorate linker option.
protected String	getCommand()
protected abstract String	getCommandFileSwitch(String commandFile)
String	getCommandWithPath(CommandLineLinkerConfiguration config)
String	getIdentifier() Retrieve an identifier that identifies the specific version of the compiler.
CommandLineLinker	getLibtoolLinker()
protected abstract int	getMaximumCommandLength()
String[]	getOutputFileNames(String baseName, VersionInfo versionInfo) Output file name (no path components) corresponding to source file
protected String[]	getOutputFileSwitch(CCTask task, String outputFile)
protected abstract String[]	getOutputFileSwitch(String outputFile)
protected String	getStartupObject(LinkType linkType)
void	link(CCTask task, File outputFile, String[] sourceFiles, CommandLineLinkerConfiguration config) Performs a link using a command line linker
protected String[]	prepareArguments(CCTask task, String outputDir, String outputFile, String[] sourceFiles, CommandLineLinkerConfiguration config) Prepares argument list for exec command.
protected String	prepareFilename(StringBuffer buf, String outputDir, String sourceFile) Processes filename into argument form
protected String[]	prepareResponseFile(File outputFile, String[] args) Prepares argument list to execute the linker using a response file.
protected String	quoteFilename(StringBuffer buf, String filename)
protected int	runCommand(CCTask task, File workingDir, String[] cmdline) This method is exposed so test classes can overload and test the arguments without actually spawning the compiler
protected void	setCommand(String command)

从类继承的方法 com.github.maven_nar.cpptasks.compiler.AbstractLinker

addVersionFiles, bid, changeEnvironment, createConfiguration, getLibraryKey

从类继承的方法 com.github.maven_nar.cpptasks.compiler.AbstractProcessor

clone, getHeaderExtensions, getIdentifier, getOSArch, getOSName, getSourceExtensions, isDarwin, isWindows, toString

从类继承的方法 java.lang.Object

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

从接口继承的方法 com.github.maven_nar.cpptasks.compiler.Linker

getLibraryPath, getLibraryPatterns, getLinker, isCaseSensitive

构造器详细资料

CommandLineLinker

public CommandLineLinker(String command,
                         String identifierArg,
                         String[] extensions,
                         String[] ignoredExtensions,
                         String outputSuffix,
                         boolean isLibtool,
                         CommandLineLinker libtoolLinker)

Creates a comand line linker invocation

方法详细资料

addBase

protected void addBase(CCTask task,
                       long base,
                       Vector<String> args)

addEntry

protected void addEntry(CCTask task,
                        String entry,
                        Vector<String> args)

addFixed

protected void addFixed(CCTask task,
                        Boolean fixed,
                        Vector<String> args)

addImpliedArgs

protected void addImpliedArgs(CCTask task,
                              boolean debug,
                              LinkType linkType,
                              Vector<String> args)

addIncremental

protected void addIncremental(CCTask task,
                              boolean incremental,
                              Vector<String> args)

addLibraryDirectory

protected void addLibraryDirectory(File libraryDirectory,
                                   Vector<String> preargs)

addLibraryPath

protected void addLibraryPath(Vector<String> preargs,
                              String path)

addLibrarySets

protected String[] addLibrarySets(CCTask task,
                                  LibrarySet[] libsets,
                                  Vector<String> preargs,
                                  Vector<String> midargs,
                                  Vector<String> endargs)

addMap

protected void addMap(CCTask task,
                      boolean map,
                      Vector<String> args)

addStack

protected void addStack(CCTask task,
                        int stack,
                        Vector<String> args)

createConfiguration

protected LinkerConfiguration createConfiguration(CCTask task,
                                                  LinkType linkType,
                                                  ProcessorDef[] baseDefs,
                                                  LinkerDef specificDef,
                                                  TargetDef targetPlatform,
                                                  VersionInfo versionInfo)

指定者:

createConfiguration 在类中 AbstractLinker

decorateLinkerOption

protected String decorateLinkerOption(StringBuffer buf,
                                      String arg)

Allows drived linker to decorate linker option. Override by GccLinker to prepend a "-Wl," to pass option to through gcc to linker.

参数:

buf - buffer that may be used and abused in the decoration process, must not be null.

arg - linker argument

getCommand

protected final String getCommand()

getCommandFileSwitch

protected abstract String getCommandFileSwitch(String commandFile)

getCommandWithPath

public String getCommandWithPath(CommandLineLinkerConfiguration config)

getIdentifier

public String getIdentifier()

从接口复制的说明: Processor

Retrieve an identifier that identifies the specific version of the compiler. Compilers with the same identifier should produce the same output files for the same input files and command line switches.

指定者:

getIdentifier 在接口中 Processor

指定者:

getIdentifier 在类中 AbstractProcessor

getLibtoolLinker

public final CommandLineLinker getLibtoolLinker()

getMaximumCommandLength

protected abstract int getMaximumCommandLength()

getOutputFileNames

public String[] getOutputFileNames(String baseName,
                                   VersionInfo versionInfo)

从接口复制的说明: Processor

Output file name (no path components) corresponding to source file

指定者:

getOutputFileNames 在接口中 Processor

指定者:

getOutputFileNames 在类中 AbstractLinker

参数:

baseName - input file

返回:

output file name or null if no output file or name not determined by input file

getOutputFileSwitch

protected String[] getOutputFileSwitch(CCTask task,
                                       String outputFile)

getOutputFileSwitch

protected abstract String[] getOutputFileSwitch(String outputFile)

getStartupObject

protected String getStartupObject(LinkType linkType)

link

public void link(CCTask task,
                 File outputFile,
                 String[] sourceFiles,
                 CommandLineLinkerConfiguration config)
          throws org.apache.tools.ant.BuildException

Performs a link using a command line linker

抛出:

org.apache.tools.ant.BuildException

prepareArguments

protected String[] prepareArguments(CCTask task,
                                    String outputDir,
                                    String outputFile,
                                    String[] sourceFiles,
                                    CommandLineLinkerConfiguration config)

Prepares argument list for exec command. Will return null if command line would exceed allowable command line buffer.

参数:

task - compilation task.

outputFile - linker output file

sourceFiles - linker input files (.obj, .o, .res)

config - linker configuration

返回:

arguments for runTask

prepareFilename

protected String prepareFilename(StringBuffer buf,
                                 String outputDir,
                                 String sourceFile)

Processes filename into argument form

prepareResponseFile

protected String[] prepareResponseFile(File outputFile,
                                       String[] args)
                                throws IOException

Prepares argument list to execute the linker using a response file.

参数:

outputFile - linker output file

args - output of prepareArguments

返回:

arguments for runTask

抛出:

IOException

quoteFilename

protected String quoteFilename(StringBuffer buf,
                               String filename)

runCommand

protected int runCommand(CCTask task,
                         File workingDir,
                         String[] cmdline)
                  throws org.apache.tools.ant.BuildException

This method is exposed so test classes can overload and test the arguments without actually spawning the compiler

抛出:

org.apache.tools.ant.BuildException

setCommand

protected final void setCommand(String command)