| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321 |
- /*=========================================================================
- Program: CMake - Cross-Platform Makefile Generator
- Module: $RCSfile$
- Language: C++
- Date: $Date$
- Version: $Revision$
- Copyright (c) 2002 Kitware, Inc., Insight Consortium. All rights reserved.
- See Copyright.txt or http://www.cmake.org/HTML/Copyright.html for details.
- This software is distributed WITHOUT ANY WARRANTY; without even
- the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
- PURPOSE. See the above copyright notices for more information.
- =========================================================================*/
- #include "cmTarget.h"
- #include "cmake.h"
- #include "cmMakefile.h"
- #include "cmSourceFile.h"
- #include "cmLocalGenerator.h"
- #include "cmGlobalGenerator.h"
- #include "cmComputeLinkInformation.h"
- #include <map>
- #include <set>
- #include <queue>
- #include <stdlib.h> // required for atof
- #include <assert.h>
- const char* cmTarget::TargetTypeNames[] = {
- "EXECUTABLE", "STATIC_LIBRARY",
- "SHARED_LIBRARY", "MODULE_LIBRARY", "UTILITY", "GLOBAL_TARGET",
- "INSTALL_FILES", "INSTALL_PROGRAMS", "INSTALL_DIRECTORY"
- };
- //----------------------------------------------------------------------------
- cmTarget::cmTarget()
- {
- this->Makefile = 0;
- this->LinkLibrariesAnalyzed = false;
- this->HaveInstallRule = false;
- this->DLLPlatform = false;
- this->IsImportedTarget = false;
- }
- //----------------------------------------------------------------------------
- void cmTarget::DefineProperties(cmake *cm)
- {
- cm->DefineProperty
- ("BUILD_WITH_INSTALL_RPATH", cmProperty::TARGET,
- "Should build tree targets have install tree rpaths.",
- "BUILD_WITH_INSTALL_RPATH is a boolean specifying whether to link "
- "the target in the build tree with the INSTALL_RPATH. This takes "
- "precedence over SKIP_BUILD_RPATH and avoids the need for relinking "
- "before installation.");
- cm->DefineProperty
- ("CLEAN_DIRECT_OUTPUT", cmProperty::TARGET,
- "Do not delete other variants of this target.",
- "When a library is built CMake by default generates code to remove "
- "any existing library using all possible names. This is needed "
- "to support libraries that switch between STATIC and SHARED by "
- "a user option. However when using OUTPUT_NAME to build a static "
- "and shared library of the same name using different logical target "
- "names the two targets will remove each other's files. This can be "
- "prevented by setting the CLEAN_DIRECT_OUTPUT property to 1.");
- cm->DefineProperty
- ("COMPILE_FLAGS", cmProperty::TARGET,
- "Additional flags to use when compiling this target's sources.",
- "The COMPILE_FLAGS property sets additional compiler flags used "
- "to build sources within the target. Use COMPILE_DEFINITIONS "
- "to pass additional preprocessor definitions.");
- cm->DefineProperty
- ("COMPILE_DEFINITIONS", cmProperty::TARGET,
- "Preprocessor definitions for compiling a target's sources.",
- "The COMPILE_DEFINITIONS property may be set to a list of preprocessor "
- "definitions using the syntax VAR or VAR=value. Function-style "
- "definitions are not supported. CMake will automatically escape "
- "the value correctly for the native build system (note that CMake "
- "language syntax may require escapes to specify some values). "
- "This property may be set on a per-configuration basis using the name "
- "COMPILE_DEFINITIONS_<CONFIG> where <CONFIG> is an upper-case name "
- "(ex. \"COMPILE_DEFINITIONS_DEBUG\").\n"
- "CMake will automatically drop some definitions that "
- "are not supported by the native build tool. "
- "The VS6 IDE does not support definitions with values "
- "(but NMake does).\n"
- "Dislaimer: Most native build tools have poor support for escaping "
- "certain values. CMake has work-arounds for many cases but some "
- "values may just not be possible to pass correctly. If a value "
- "does not seem to be escaped correctly, do not attempt to "
- "work-around the problem by adding escape sequences to the value. "
- "Your work-around may break in a future version of CMake that "
- "has improved escape support. Instead consider defining the macro "
- "in a (configured) header file. Then report the limitation.");
- cm->DefineProperty
- ("COMPILE_DEFINITIONS_<CONFIG>", cmProperty::TARGET,
- "Per-configuration preprocessor definitions on a target.",
- "This is the configuration-specific version of COMPILE_DEFINITIONS.");
- cm->DefineProperty
- ("DEFINE_SYMBOL", cmProperty::TARGET,
- "Define a symbol when compiling this target's sources.",
- "DEFINE_SYMBOL sets the name of the preprocessor symbol defined when "
- "compiling sources in a shared library. "
- "If not set here then it is set to target_EXPORTS by default "
- "(with some substitutions if the target is not a valid C "
- "identifier). This is useful for headers to know whether they are "
- "being included from inside their library our outside to properly "
- "setup dllexport/dllimport decorations. ");
- cm->DefineProperty
- ("DEBUG_POSTFIX", cmProperty::TARGET,
- "A postfix that will be applied to this target when build debug.",
- "A property on a target that specifies a postfix to add to the "
- "target name when built in debug mode. For example foo.dll "
- "versus fooD.dll");
- cm->DefineProperty
- ("EchoString", cmProperty::TARGET,
- "A message to be displayed when the target is built.",
- "A message to display on some generators (such as makefiles) when "
- "the target is built.");
- cm->DefineProperty
- ("FRAMEWORK", cmProperty::TARGET,
- "This target is a framework on the Mac.",
- "If a shared library target has this property set to true it will "
- "be built as a framework when built on the mac. It will have the "
- "directory structure required for a framework and will be suitable "
- "to be used with the -framework option");
- cm->DefineProperty
- ("HAS_CXX", cmProperty::TARGET,
- "Force a target to use the CXX linker.",
- "Setting HAS_CXX on a target will force the target to use the "
- "C++ linker (and C++ runtime libraries) for linking even if the "
- "target has no C++ code in it.");
- cm->DefineProperty
- ("IMPORT_PREFIX", cmProperty::TARGET,
- "What comes before the import library name.",
- "Similar to the target property PREFIX, but used for import libraries "
- "(typically corresponding to a DLL) instead of regular libraries. "
- "A target property that can be set to override the prefix "
- "(such as \"lib\") on an import library name.");
- cm->DefineProperty
- ("IMPORT_SUFFIX", cmProperty::TARGET,
- "What comes after the import library name.",
- "Similar to the target property SUFFIX, but used for import libraries "
- "(typically corresponding to a DLL) instead of regular libraries. "
- "A target property that can be set to override the suffix "
- "(such as \".lib\") on an import library name.");
- cm->DefineProperty
- ("IMPORTED", cmProperty::TARGET,
- "Read-only indication of whether a target is IMPORTED.",
- "The boolean value of this property is true for targets created with "
- "the IMPORTED option to add_executable or add_library. "
- "It is false for targets built within the project.");
- cm->DefineProperty
- ("IMPORTED_CONFIGURATIONS", cmProperty::TARGET,
- "Configurations provided for an IMPORTED target.",
- "Lists configuration names available for an IMPORTED target. "
- "The names correspond to configurations defined in the project from "
- "which the target is imported. "
- "If the importing project uses a different set of configurations "
- "the names may be mapped using the MAP_IMPORTED_CONFIG_<CONFIG> "
- "property. "
- "Ignored for non-imported targets.");
- cm->DefineProperty
- ("IMPORTED_IMPLIB", cmProperty::TARGET,
- "Full path to the import library for an IMPORTED target.",
- "Specifies the location of the \".lib\" part of a windows DLL. "
- "Ignored for non-imported targets.");
- cm->DefineProperty
- ("IMPORTED_IMPLIB_<CONFIG>", cmProperty::TARGET,
- "Per-configuration version of IMPORTED_IMPLIB property.",
- "This property is used when loading settings for the <CONFIG> "
- "configuration of an imported target. "
- "Configuration names correspond to those provided by the project "
- "from which the target is imported.");
- cm->DefineProperty
- ("IMPORTED_LINK_DEPENDENT_LIBRARIES", cmProperty::TARGET,
- "Dependent shared libraries of an imported shared library.",
- "Shared libraries may be linked to other shared libraries as part "
- "of their implementation. On some platforms the linker searches "
- "for the dependent libraries of shared libraries they are including "
- "in the link. This property lists "
- "the dependent shared libraries of an imported library. The list "
- "should be disjoint from the list of interface libraries in the "
- "IMPORTED_LINK_INTERFACE_LIBRARIES property. On platforms requiring "
- "dependent shared libraries to be found at link time CMake uses this "
- "list to add appropriate files or paths to the link command line. "
- "Ignored for non-imported targets.");
- cm->DefineProperty
- ("IMPORTED_LINK_DEPENDENT_LIBRARIES_<CONFIG>", cmProperty::TARGET,
- "Per-configuration version of IMPORTED_LINK_DEPENDENT_LIBRARIES.",
- "This property is used when loading settings for the <CONFIG> "
- "configuration of an imported target. "
- "Configuration names correspond to those provided by the project "
- "from which the target is imported.");
- cm->DefineProperty
- ("IMPORTED_LINK_INTERFACE_LIBRARIES", cmProperty::TARGET,
- "Transitive link interface of an IMPORTED target.",
- "Lists libraries whose interface is included when an IMPORTED library "
- "target is linked to another target. "
- "The libraries will be included on the link line for the target. "
- "Ignored for non-imported targets.");
- cm->DefineProperty
- ("IMPORTED_LINK_INTERFACE_LIBRARIES_<CONFIG>", cmProperty::TARGET,
- "Per-configuration version of IMPORTED_LINK_INTERFACE_LIBRARIES.",
- "This property is used when loading settings for the <CONFIG> "
- "configuration of an imported target. "
- "Configuration names correspond to those provided by the project "
- "from which the target is imported.");
- cm->DefineProperty
- ("IMPORTED_LOCATION", cmProperty::TARGET,
- "Full path to the main file on disk for an IMPORTED target.",
- "Specifies the location of an IMPORTED target file on disk. "
- "For executables this is the location of the executable file. "
- "For bundles on OS X this is the location of the executable file "
- "inside Contents/MacOS under the application bundle folder. "
- "For static libraries and modules this is the location of the "
- "library or module. "
- "For shared libraries on non-DLL platforms this is the location of "
- "the shared library. "
- "For frameworks on OS X this is the location of the library file "
- "symlink just inside the framework folder. "
- "For DLLs this is the location of the \".dll\" part of the library. "
- "Ignored for non-imported targets.");
- cm->DefineProperty
- ("IMPORTED_LOCATION_<CONFIG>", cmProperty::TARGET,
- "Per-configuration version of IMPORTED_LOCATION property.",
- "This property is used when loading settings for the <CONFIG> "
- "configuration of an imported target. "
- "Configuration names correspond to those provided by the project "
- "from which the target is imported.");
- cm->DefineProperty
- ("IMPORTED_SONAME", cmProperty::TARGET,
- "The \"soname\" of an IMPORTED target of shared library type.",
- "Specifies the \"soname\" embedded in an imported shared library. "
- "This is meaningful only on platforms supporting the feature. "
- "Ignored for non-imported targets.");
- cm->DefineProperty
- ("IMPORTED_SONAME_<CONFIG>", cmProperty::TARGET,
- "Per-configuration version of IMPORTED_SONAME property.",
- "This property is used when loading settings for the <CONFIG> "
- "configuration of an imported target. "
- "Configuration names correspond to those provided by the project "
- "from which the target is imported.");
- cm->DefineProperty
- ("EXCLUDE_FROM_ALL", cmProperty::TARGET,
- "Exclude the target from the all target.",
- "A property on a target that indicates if the target is excluded "
- "from the default build target. If it is not, then with a Makefile "
- "for example typing make will cause this target to be built. "
- "The same concept applies to the default build of other generators. "
- "Installing a target with EXCLUDE_FROM_ALL set to true has "
- "undefined behavior.");
- cm->DefineProperty
- ("INSTALL_NAME_DIR", cmProperty::TARGET,
- "Mac OSX directory name for installed targets.",
- "INSTALL_NAME_DIR is a string specifying the "
- "directory portion of the \"install_name\" field of shared libraries "
- "on Mac OSX to use in the installed targets. ");
- cm->DefineProperty
- ("INSTALL_RPATH", cmProperty::TARGET,
- "The rpath to use for installed targets.",
- "A semicolon-separated list specifying the rpath "
- "to use in installed targets (for platforms that support it).");
- cm->DefineProperty
- ("INSTALL_RPATH_USE_LINK_PATH", cmProperty::TARGET,
- "Add paths to linker search and installed rpath.",
- "INSTALL_RPATH_USE_LINK_PATH is a boolean that if set to true will "
- "append directories in the linker search path and outside the "
- "project to the INSTALL_RPATH. ");
- cm->DefineProperty
- ("LINK_FLAGS", cmProperty::TARGET,
- "Additional flags to use when linking this target.",
- "The LINK_FLAGS property can be used to add extra flags to the "
- "link step of a target. LINK_FLAGS_<CONFIG> will add to the "
- "configuration <CONFIG>, "
- "for example, DEBUG, RELEASE, MINSIZEREL, RELWITHDEBINFO. ");
- cm->DefineProperty
- ("LINK_FLAGS_<CONFIG>", cmProperty::TARGET,
- "Per-configuration linker flags for a target.",
- "This is the configuration-specific version of LINK_FLAGS.");
- cm->DefineProperty
- ("LINK_SEARCH_END_STATIC", cmProperty::TARGET,
- "End a link line such that static system libraries are used.",
- "Some linkers support switches such as -Bstatic and -Bdynamic "
- "to determine whether to use static or shared libraries for -lXXX "
- "options. CMake uses these options to set the link type for "
- "libraries whose full paths are not known or (in some cases) are in "
- "implicit link directories for the platform. By default the "
- "linker search type is left at -Bdynamic by the end of the library "
- "list. This property switches the final linker search type to "
- "-Bstatic.");
- cm->DefineProperty
- ("LINKER_LANGUAGE", cmProperty::TARGET,
- "What tool to use for linking, based on language.",
- "The LINKER_LANGUAGE property is used to change the tool "
- "used to link an executable or shared library. The default is "
- "set the language to match the files in the library. CXX and C "
- "are common values for this property.");
- cm->DefineProperty
- ("LOCATION", cmProperty::TARGET,
- "Deprecated. Use LOCATION_<CONFIG> or avoid altogether.",
- "This property is provided for compatibility with CMake 2.4 and below. "
- "It was meant to get the location of an executable target's output file "
- "for use in add_custom_command. "
- "In CMake 2.6 and above add_custom_command automatically recognizes a "
- "target name in its COMMAND and DEPENDS options and computes the "
- "target location. Therefore this property need not be used. "
- "This property is not defined for IMPORTED targets because they "
- "were not available in CMake 2.4 or below anyway.");
- cm->DefineProperty
- ("LOCATION_<CONFIG>", cmProperty::TARGET,
- "Read-only property providing a target location on disk.",
- "A read-only property that indicates where a target's main file is "
- "located on disk for the configuration <CONFIG>. "
- "The property is defined only for library and executable targets.");
- cm->DefineProperty
- ("LINK_INTERFACE_LIBRARIES", cmProperty::TARGET,
- "List public interface libraries for a shared library or executable.",
- "By default linking to a shared library target transitively "
- "links to targets with which the library itself was linked. "
- "For an executable with exports (see the ENABLE_EXPORTS property) "
- "no default transitive link dependencies are used. "
- "This property replaces the default transitive link dependencies with "
- "an explict list. "
- "When the target is linked into another target the libraries "
- "listed (and recursively their link interface libraries) will be "
- "provided to the other target also. "
- "If the list is empty then no transitive link dependencies will be "
- "incorporated when this target is linked into another target even if "
- "the default set is non-empty.");
- cm->DefineProperty
- ("LINK_INTERFACE_LIBRARIES_<CONFIG>", cmProperty::TARGET,
- "Per-configuration list of public interface libraries for a target.",
- "This is the configuration-specific version of "
- "LINK_INTERFACE_LIBRARIES.");
- cm->DefineProperty
- ("MAP_IMPORTED_CONFIG_<CONFIG>", cmProperty::TARGET,
- "Map from project configuration to IMPORTED target's configuration.",
- "List configurations of an imported target that may be used for "
- "the current project's <CONFIG> configuration. "
- "Targets imported from another project may not provide the same set "
- "of configuration names available in the current project. "
- "Setting this property tells CMake what imported configurations are "
- "suitable for use when building the <CONFIG> configuration. "
- "The first configuration in the list found to be provided by the "
- "imported target is selected. If no matching configurations are "
- "available the imported target is considered to be not found. "
- "This property is ignored for non-imported targets.",
- false /* TODO: make this chained */ );
- cm->DefineProperty
- ("OUTPUT_NAME", cmProperty::TARGET,
- "Sets the real name of a target when it is built.",
- "Sets the real name of a target when it is built and "
- "can be used to help create two targets of the same name even though "
- "CMake requires unique logical target names. There is also a "
- "<CONFIG>_OUTPUT_NAME that can set the output name on a "
- "per-configuration basis.");
- cm->DefineProperty
- ("PRE_INSTALL_SCRIPT", cmProperty::TARGET,
- "Deprecated install support.",
- "The PRE_INSTALL_SCRIPT and POST_INSTALL_SCRIPT properties are the "
- "old way to specify CMake scripts to run before and after "
- "installing a target. They are used only when the old "
- "INSTALL_TARGETS command is used to install the target. Use the "
- "INSTALL command instead.");
- cm->DefineProperty
- ("PREFIX", cmProperty::TARGET,
- "What comes before the library name.",
- "A target property that can be set to override the prefix "
- "(such as \"lib\") on a library name.");
- cm->DefineProperty
- ("POST_INSTALL_SCRIPT", cmProperty::TARGET,
- "Deprecated install support.",
- "The PRE_INSTALL_SCRIPT and POST_INSTALL_SCRIPT properties are the "
- "old way to specify CMake scripts to run before and after "
- "installing a target. They are used only when the old "
- "INSTALL_TARGETS command is used to install the target. Use the "
- "INSTALL command instead.");
- cm->DefineProperty
- ("PRIVATE_HEADER", cmProperty::TARGET,
- "Specify private header files in a FRAMEWORK shared library target.",
- "Shared library targets marked with the FRAMEWORK property generate "
- "frameworks on OS X and normal shared libraries on other platforms. "
- "This property may be set to a list of header files to be placed "
- "in the PrivateHeaders directory inside the framework folder. "
- "On non-Apple platforms these headers may be installed using the "
- "PRIVATE_HEADER option to the install(TARGETS) command.");
- cm->DefineProperty
- ("PUBLIC_HEADER", cmProperty::TARGET,
- "Specify public header files in a FRAMEWORK shared library target.",
- "Shared library targets marked with the FRAMEWORK property generate "
- "frameworks on OS X and normal shared libraries on other platforms. "
- "This property may be set to a list of header files to be placed "
- "in the Headers directory inside the framework folder. "
- "On non-Apple platforms these headers may be installed using the "
- "PUBLIC_HEADER option to the install(TARGETS) command.");
- cm->DefineProperty
- ("RESOURCE", cmProperty::TARGET,
- "Specify resource files in a FRAMEWORK shared library target.",
- "Shared library targets marked with the FRAMEWORK property generate "
- "frameworks on OS X and normal shared libraries on other platforms. "
- "This property may be set to a list of files to be placed "
- "in the Resources directory inside the framework folder. "
- "On non-Apple platforms these files may be installed using the "
- "RESOURCE option to the install(TARGETS) command.");
- cm->DefineProperty
- ("SKIP_BUILD_RPATH", cmProperty::TARGET,
- "Should rpaths be used for the build tree.",
- "SKIP_BUILD_RPATH is a boolean specifying whether to skip automatic "
- "generation of an rpath allowing the target to run from the "
- "build tree. ");
- cm->DefineProperty
- ("SOVERSION", cmProperty::TARGET,
- "What version number is this target.",
- "For shared libraries VERSION and SOVERSION can be used to specify "
- "the build version and api version respectively. When building or "
- "installing appropriate symlinks are created if the platform "
- "supports symlinks and the linker supports so-names. "
- "If only one of both is specified the missing is assumed to have "
- "the same version number. "
- "For shared libraries and executables on Windows the VERSION "
- "attribute is parsed to extract a \"major.minor\" version number. "
- "These numbers are used as the image version of the binary. ");
- cm->DefineProperty
- ("STATIC_LIBRARY_FLAGS", cmProperty::TARGET,
- "Extra flags to use when linking static libraries.",
- "Extra flags to use when linking a static library.");
- cm->DefineProperty
- ("SUFFIX", cmProperty::TARGET,
- "What comes after the library name.",
- "A target property that can be set to override the suffix "
- "(such as \".so\") on a library name.");
- cm->DefineProperty
- ("VERSION", cmProperty::TARGET,
- "What version number is this target.",
- "For shared libraries VERSION and SOVERSION can be used to specify "
- "the build version and api version respectively. When building or "
- "installing appropriate symlinks are created if the platform "
- "supports symlinks and the linker supports so-names. "
- "If only one of both is specified the missing is assumed to have "
- "the same version number. "
- "For executables VERSION can be used to specify the build version. "
- "When building or installing appropriate symlinks are created if "
- "the platform supports symlinks. "
- "For shared libraries and executables on Windows the VERSION "
- "attribute is parsed to extract a \"major.minor\" version number. "
- "These numbers are used as the image version of the binary. ");
- cm->DefineProperty
- ("WIN32_EXECUTABLE", cmProperty::TARGET,
- "Used to specify Windows executable with a WinMain entry point.",
- "This can be set to indicate that a target is a Windows executable "
- "in contrast to a console application for example. This changes "
- "how the executable will be linked.");
- cm->DefineProperty
- ("ENABLE_EXPORTS", cmProperty::TARGET,
- "Specify whether an executable exports symbols for loadable modules.",
- "Normally an executable does not export any symbols because it is "
- "the final program. It is possible for an executable to export "
- "symbols to be used by loadable modules. When this property is "
- "set to true CMake will allow other targets to \"link\" to the "
- "executable with the TARGET_LINK_LIBRARIES command. "
- "On all platforms a target-level dependency on the executable is "
- "created for targets that link to it. "
- "For non-DLL platforms the link rule is simply ignored since "
- "the dynamic loader will automatically bind symbols when the "
- "module is loaded. "
- "For DLL platforms an import library will be created for the "
- "exported symbols and then used for linking. "
- "All Windows-based systems including Cygwin are DLL platforms.");
- cm->DefineProperty
- ("Fortran_MODULE_DIRECTORY", cmProperty::TARGET,
- "Specify output directory for Fortran modules provided by the target.",
- "If the target contains Fortran source files that provide modules "
- "and the compiler supports a module output directory this specifies "
- "the directory in which the modules will be placed. "
- "When this property is not set the modules will be placed in the "
- "build directory corresponding to the target's source directory.");
- cm->DefineProperty
- ("XCODE_ATTRIBUTE_<an-attribute>", cmProperty::TARGET,
- "Set Xcode target attributes directly.",
- "Tell the Xcode generator to set '<an-attribute>' to a given value "
- "in the generated Xcode project. Ignored on other generators.");
- cm->DefineProperty
- ("GENERATOR_FILE_NAME", cmProperty::TARGET,
- "Generator's file for this target.",
- "An internal property used by some generators to record the name of "
- "project or dsp file associated with this target.");
- cm->DefineProperty
- ("SOURCES", cmProperty::TARGET,
- "Source names specified for a target.",
- "Read-only list of sources specified for a target. "
- "The names returned are suitable for passing to the "
- "set_source_files_properties command.");
- #if 0
- cm->DefineProperty
- ("OBJECT_FILES", cmProperty::TARGET,
- "Used to get the resulting list of object files that make up a "
- "target.",
- "This can be used to put object files from one library "
- "into another library. It is a read only property. It "
- "converts the source list for the target into a list of full "
- "paths to object names that will be produced by the target.");
- #endif
- #define CM_TARGET_FILE_TYPES_DOC \
- "There are three kinds of target files that may be built: " \
- "archive, library, and runtime. " \
- "Executables are always treated as runtime targets. " \
- "Static libraries are always treated as archive targets. " \
- "Module libraries are always treated as library targets. " \
- "For non-DLL platforms shared libraries are treated as library " \
- "targets. " \
- "For DLL platforms the DLL part of a shared library is treated as " \
- "a runtime target and the corresponding import library is treated as " \
- "an archive target. " \
- "All Windows-based systems including Cygwin are DLL platforms."
- cm->DefineProperty
- ("ARCHIVE_OUTPUT_DIRECTORY", cmProperty::TARGET,
- "Output directory in which to build ARCHIVE target files.",
- "This property specifies the directory into which archive target files "
- "should be built. "
- CM_TARGET_FILE_TYPES_DOC " "
- "This property is initialized by the value of the variable "
- "CMAKE_ARCHIVE_OUTPUT_DIRECTORY if it is set when a target is created.");
- cm->DefineProperty
- ("LIBRARY_OUTPUT_DIRECTORY", cmProperty::TARGET,
- "Output directory in which to build LIBRARY target files.",
- "This property specifies the directory into which library target files "
- "should be built. "
- CM_TARGET_FILE_TYPES_DOC " "
- "This property is initialized by the value of the variable "
- "CMAKE_LIBRARY_OUTPUT_DIRECTORY if it is set when a target is created.");
- cm->DefineProperty
- ("RUNTIME_OUTPUT_DIRECTORY", cmProperty::TARGET,
- "Output directory in which to build RUNTIME target files.",
- "This property specifies the directory into which runtime target files "
- "should be built. "
- CM_TARGET_FILE_TYPES_DOC " "
- "This property is initialized by the value of the variable "
- "CMAKE_RUNTIME_OUTPUT_DIRECTORY if it is set when a target is created.");
- // define some properties without documentation
- cm->DefineProperty("DEBUG_OUTPUT_NAME", cmProperty::TARGET,0,0);
- cm->DefineProperty("RELEASE_OUTPUT_NAME", cmProperty::TARGET,0,0);
- }
- void cmTarget::SetType(TargetType type, const char* name)
- {
- this->Name = name;
- if(type == cmTarget::INSTALL_FILES ||
- type == cmTarget::INSTALL_PROGRAMS ||
- type == cmTarget::INSTALL_DIRECTORY)
- {
- abort();
- }
- // only add dependency information for library targets
- this->TargetTypeValue = type;
- if(this->TargetTypeValue >= STATIC_LIBRARY
- && this->TargetTypeValue <= MODULE_LIBRARY)
- {
- this->RecordDependencies = true;
- }
- else
- {
- this->RecordDependencies = false;
- }
- }
- //----------------------------------------------------------------------------
- void cmTarget::SetMakefile(cmMakefile* mf)
- {
- // Set our makefile.
- this->Makefile = mf;
- // set the cmake instance of the properties
- this->Properties.SetCMakeInstance(mf->GetCMakeInstance());
- // Check whether this is a DLL platform.
- this->DLLPlatform = (this->Makefile->IsOn("WIN32") ||
- this->Makefile->IsOn("CYGWIN") ||
- this->Makefile->IsOn("MINGW"));
- // Setup default property values.
- this->SetPropertyDefault("INSTALL_NAME_DIR", "");
- this->SetPropertyDefault("INSTALL_RPATH", "");
- this->SetPropertyDefault("INSTALL_RPATH_USE_LINK_PATH", "OFF");
- this->SetPropertyDefault("SKIP_BUILD_RPATH", "OFF");
- this->SetPropertyDefault("BUILD_WITH_INSTALL_RPATH", "OFF");
- this->SetPropertyDefault("ARCHIVE_OUTPUT_DIRECTORY", 0);
- this->SetPropertyDefault("LIBRARY_OUTPUT_DIRECTORY", 0);
- this->SetPropertyDefault("RUNTIME_OUTPUT_DIRECTORY", 0);
- this->SetPropertyDefault("Fortran_MODULE_DIRECTORY", 0);
- // Collect the set of configuration types.
- std::vector<std::string> configNames;
- if(const char* configurationTypes =
- mf->GetDefinition("CMAKE_CONFIGURATION_TYPES"))
- {
- cmSystemTools::ExpandListArgument(configurationTypes, configNames);
- }
- else if(const char* buildType = mf->GetDefinition("CMAKE_BUILD_TYPE"))
- {
- if(*buildType)
- {
- configNames.push_back(buildType);
- }
- }
- // Setup per-configuration property default values.
- for(std::vector<std::string>::iterator ci = configNames.begin();
- ci != configNames.end(); ++ci)
- {
- // Initialize per-configuration name postfix property from the
- // variable only for non-executable targets. This preserves
- // compatibility with previous CMake versions in which executables
- // did not support this variable. Projects may still specify the
- // property directly. TODO: Make this depend on backwards
- // compatibility setting.
- if(this->TargetTypeValue != cmTarget::EXECUTABLE)
- {
- std::string property = cmSystemTools::UpperCase(*ci);
- property += "_POSTFIX";
- this->SetPropertyDefault(property.c_str(), 0);
- }
- }
- }
- //----------------------------------------------------------------------------
- bool cmTarget::IsExecutableWithExports()
- {
- return (this->GetType() == cmTarget::EXECUTABLE &&
- this->GetPropertyAsBool("ENABLE_EXPORTS"));
- }
- //----------------------------------------------------------------------------
- bool cmTarget::IsFrameworkOnApple()
- {
- return (this->GetType() == cmTarget::SHARED_LIBRARY &&
- this->Makefile->IsOn("APPLE") &&
- this->GetPropertyAsBool("FRAMEWORK"));
- }
- //----------------------------------------------------------------------------
- bool cmTarget::IsAppBundleOnApple()
- {
- return (this->GetType() == cmTarget::EXECUTABLE &&
- this->Makefile->IsOn("APPLE") &&
- this->GetPropertyAsBool("MACOSX_BUNDLE"));
- }
- //----------------------------------------------------------------------------
- class cmTargetTraceDependencies
- {
- public:
- cmTargetTraceDependencies(cmTarget* target, const char* vsProjectFile);
- void Trace();
- private:
- cmTarget* Target;
- cmMakefile* Makefile;
- cmGlobalGenerator* GlobalGenerator;
- std::queue<cmStdString> DependencyQueue;
- std::set<cmStdString> DependenciesQueued;
- std::set<cmSourceFile*> TargetSources;
- void QueueOnce(std::string const& name);
- void QueueOnce(std::vector<std::string> const& names);
- void QueueDependencies(cmSourceFile* sf);
- bool IsUtility(std::string const& dep);
- void CheckCustomCommand(cmCustomCommand const& cc);
- void CheckCustomCommands(const std::vector<cmCustomCommand>& commands);
- };
- //----------------------------------------------------------------------------
- cmTargetTraceDependencies
- ::cmTargetTraceDependencies(cmTarget* target, const char* vsProjectFile):
- Target(target)
- {
- // Convenience.
- this->Makefile = this->Target->GetMakefile();
- this->GlobalGenerator =
- this->Makefile->GetLocalGenerator()->GetGlobalGenerator();
- // Queue all the source files already specified for the target.
- std::vector<cmSourceFile*> const& sources = this->Target->GetSourceFiles();
- for(std::vector<cmSourceFile*>::const_iterator si = sources.begin();
- si != sources.end(); ++si)
- {
- // Queue the source file itself in case it is generated.
- this->QueueOnce((*si)->GetFullPath());
- // Queue the dependencies of the source file in case they are
- // generated.
- this->QueueDependencies(*si);
- // Track the sources already known to the target.
- this->TargetSources.insert(*si);
- }
- // Queue the VS project file to check dependencies on the rule to
- // generate it.
- if(vsProjectFile)
- {
- this->QueueOnce(vsProjectFile);
- }
- // Queue pre-build, pre-link, and post-build rule dependencies.
- this->CheckCustomCommands(this->Target->GetPreBuildCommands());
- this->CheckCustomCommands(this->Target->GetPreLinkCommands());
- this->CheckCustomCommands(this->Target->GetPostBuildCommands());
- }
- //----------------------------------------------------------------------------
- void cmTargetTraceDependencies::Trace()
- {
- // Process one dependency at a time until the queue is empty.
- while(!this->DependencyQueue.empty())
- {
- // Get the next dependency in from queue.
- std::string dep = this->DependencyQueue.front();
- this->DependencyQueue.pop();
- // Check if we know how to generate this dependency.
- if(cmSourceFile* sf =
- this->Makefile->GetSourceFileWithOutput(dep.c_str()))
- {
- // Queue dependencies needed to generate this file.
- this->QueueDependencies(sf);
- // Make sure this file is in the target.
- if(this->TargetSources.insert(sf).second)
- {
- this->Target->AddSourceFile(sf);
- }
- }
- }
- }
- //----------------------------------------------------------------------------
- void cmTargetTraceDependencies::QueueOnce(std::string const& name)
- {
- if(this->DependenciesQueued.insert(name).second)
- {
- this->DependencyQueue.push(name);
- }
- }
- //----------------------------------------------------------------------------
- void
- cmTargetTraceDependencies::QueueOnce(std::vector<std::string> const& names)
- {
- for(std::vector<std::string>::const_iterator i = names.begin();
- i != names.end(); ++i)
- {
- this->QueueOnce(*i);
- }
- }
- //----------------------------------------------------------------------------
- bool cmTargetTraceDependencies::IsUtility(std::string const& dep)
- {
- // Dependencies on targets (utilities) are supposed to be named by
- // just the target name. However for compatibility we support
- // naming the output file generated by the target (assuming there is
- // no output-name property which old code would not have set). In
- // that case the target name will be the file basename of the
- // dependency.
- std::string util = cmSystemTools::GetFilenameName(dep);
- if(cmSystemTools::GetFilenameLastExtension(util) == ".exe")
- {
- util = cmSystemTools::GetFilenameWithoutLastExtension(util);
- }
- // Check for a non-imported target with this name.
- if(cmTarget* t = this->GlobalGenerator->FindTarget(0, util.c_str()))
- {
- // If we find the target and the dep was given as a full path,
- // then make sure it was not a full path to something else, and
- // the fact that the name matched a target was just a coincidence.
- if(cmSystemTools::FileIsFullPath(dep.c_str()))
- {
- // This is really only for compatibility so we do not need to
- // worry about configuration names and output names.
- std::string tLocation = t->GetLocation(0);
- tLocation = cmSystemTools::GetFilenamePath(tLocation);
- std::string depLocation = cmSystemTools::GetFilenamePath(dep);
- depLocation = cmSystemTools::CollapseFullPath(depLocation.c_str());
- tLocation = cmSystemTools::CollapseFullPath(tLocation.c_str());
- if(depLocation == tLocation)
- {
- this->Target->AddUtility(util.c_str());
- return true;
- }
- }
- else
- {
- // The original name of the dependency was not a full path. It
- // must name a target, so add the target-level dependency.
- this->Target->AddUtility(util.c_str());
- return true;
- }
- }
- // The dependency does not name a target built in this project.
- return false;
- }
- //----------------------------------------------------------------------------
- void cmTargetTraceDependencies::QueueDependencies(cmSourceFile* sf)
- {
- // Queue dependency added explicitly by the user.
- if(const char* additionalDeps = sf->GetProperty("OBJECT_DEPENDS"))
- {
- std::vector<std::string> objDeps;
- cmSystemTools::ExpandListArgument(additionalDeps, objDeps);
- this->QueueOnce(objDeps);
- }
- // Queue dependencies added programatically by commands.
- this->QueueOnce(sf->GetDepends());
- // Queue custom command dependencies.
- if(cmCustomCommand const* cc = sf->GetCustomCommand())
- {
- this->CheckCustomCommand(*cc);
- }
- }
- //----------------------------------------------------------------------------
- void
- cmTargetTraceDependencies
- ::CheckCustomCommand(cmCustomCommand const& cc)
- {
- // Transform command names that reference targets built in this
- // project to corresponding target-level dependencies.
- for(cmCustomCommandLines::const_iterator cit = cc.GetCommandLines().begin();
- cit != cc.GetCommandLines().end(); ++cit)
- {
- std::string const& command = *cit->begin();
- // Look for a non-imported target with this name.
- if(cmTarget* t = this->GlobalGenerator->FindTarget(0, command.c_str()))
- {
- if(t->GetType() == cmTarget::EXECUTABLE)
- {
- // The command refers to an executable target built in
- // this project. Add the target-level dependency to make
- // sure the executable is up to date before this custom
- // command possibly runs.
- this->Target->AddUtility(command.c_str());
- }
- }
- }
- // Queue the custom command dependencies.
- std::vector<std::string> const& depends = cc.GetDepends();
- for(std::vector<std::string>::const_iterator di = depends.begin();
- di != depends.end(); ++di)
- {
- std::string const& dep = *di;
- if(!this->IsUtility(dep))
- {
- // The dependency does not name a target and may be a file we
- // know how to generate. Queue it.
- this->QueueOnce(dep);
- }
- }
- }
- //----------------------------------------------------------------------------
- void
- cmTargetTraceDependencies
- ::CheckCustomCommands(const std::vector<cmCustomCommand>& commands)
- {
- for(std::vector<cmCustomCommand>::const_iterator cli = commands.begin();
- cli != commands.end(); ++cli)
- {
- this->CheckCustomCommand(*cli);
- }
- }
- //----------------------------------------------------------------------------
- void cmTarget::TraceDependencies(const char* vsProjectFile)
- {
- // Use a helper object to trace the dependencies.
- cmTargetTraceDependencies tracer(this, vsProjectFile);
- tracer.Trace();
- }
- //----------------------------------------------------------------------------
- void cmTarget::AddSources(std::vector<std::string> const& srcs)
- {
- for(std::vector<std::string>::const_iterator i = srcs.begin();
- i != srcs.end(); ++i)
- {
- this->AddSource(i->c_str());
- }
- }
- //----------------------------------------------------------------------------
- cmSourceFile* cmTarget::AddSource(const char* s)
- {
- std::string src = s;
- // For backwards compatibility replace varibles in source names.
- // This should eventually be removed.
- this->Makefile->ExpandVariablesInString(src);
- cmSourceFile* sf = this->Makefile->GetOrCreateSource(src.c_str());
- this->AddSourceFile(sf);
- return sf;
- }
- //----------------------------------------------------------------------------
- struct cmTarget::SourceFileFlags
- cmTarget::GetTargetSourceFileFlags(const cmSourceFile* sf)
- {
- struct SourceFileFlags flags;
- const char* files;
- std::vector<std::string>::iterator it;
- flags.PrivateHeader = false;
- flags.PublicHeader = false;
- flags.Resource = false;
- files = this->GetProperty("PRIVATE_HEADER");
- if ((files) && (*files))
- {
- std::vector<std::string> relFiles;
- cmSystemTools::ExpandListArgument(files, relFiles);
- for(it = relFiles.begin(); it != relFiles.end(); ++it)
- {
- if(sf == this->GetMakefile()->GetSource(it->c_str()))
- {
- flags.PrivateHeader = true;
- break;
- }
- }
- }
- // Only consider marking it as a public header if it is *NOT* already marked
- // as a private header:
- //
- if(!flags.PrivateHeader)
- {
- files = this->GetProperty("PUBLIC_HEADER");
- if ((files) && (*files))
- {
- std::vector<std::string> relFiles;
- cmSystemTools::ExpandListArgument(files, relFiles);
- for(it = relFiles.begin(); it != relFiles.end(); ++it)
- {
- if(sf == this->GetMakefile()->GetSource(it->c_str()))
- {
- flags.PublicHeader = true;
- break;
- }
- }
- }
- }
- const char* location = sf->GetProperty("MACOSX_PACKAGE_LOCATION");
- if(location && cmStdString(location) == "Resources")
- {
- flags.Resource = true;
- }
- // Don't bother with the loop if it's already marked as a resource:
- //
- if(!flags.Resource)
- {
- files = this->GetProperty("RESOURCE");
- if ((files) && (*files))
- {
- std::vector<std::string> relFiles;
- cmSystemTools::ExpandListArgument(files, relFiles);
- for(it = relFiles.begin(); it != relFiles.end(); ++it)
- {
- if(sf == this->GetMakefile()->GetSource(it->c_str()))
- {
- flags.Resource = true;
- break;
- }
- }
- }
- }
- return flags;
- }
- //----------------------------------------------------------------------------
- void cmTarget::MergeLinkLibraries( cmMakefile& mf,
- const char *selfname,
- const LinkLibraryVectorType& libs )
- {
- // Only add on libraries we haven't added on before.
- // Assumption: the global link libraries could only grow, never shrink
- LinkLibraryVectorType::const_iterator i = libs.begin();
- i += this->PrevLinkedLibraries.size();
- for( ; i != libs.end(); ++i )
- {
- // We call this so that the dependencies get written to the cache
- this->AddLinkLibrary( mf, selfname, i->first.c_str(), i->second );
- }
- this->PrevLinkedLibraries = libs;
- }
- //----------------------------------------------------------------------------
- void cmTarget::AddLinkDirectory(const char* d)
- {
- // Make sure we don't add unnecessary search directories.
- if(this->LinkDirectoriesEmmitted.insert(d).second)
- {
- this->LinkDirectories.push_back(d);
- }
- }
- //----------------------------------------------------------------------------
- const std::vector<std::string>& cmTarget::GetLinkDirectories()
- {
- return this->LinkDirectories;
- }
- //----------------------------------------------------------------------------
- void cmTarget::ClearDependencyInformation( cmMakefile& mf,
- const char* target )
- {
- // Clear the dependencies. The cache variable must exist iff we are
- // recording dependency information for this target.
- std::string depname = target;
- depname += "_LIB_DEPENDS";
- if (this->RecordDependencies)
- {
- mf.AddCacheDefinition(depname.c_str(), "",
- "Dependencies for target", cmCacheManager::STATIC);
- }
- else
- {
- if (mf.GetDefinition( depname.c_str() ))
- {
- std::string message = "Target ";
- message += target;
- message += " has dependency information when it shouldn't.\n";
- message += "Your cache is probably stale. Please remove the entry\n ";
- message += depname;
- message += "\nfrom the cache.";
- cmSystemTools::Error( message.c_str() );
- }
- }
- }
- //----------------------------------------------------------------------------
- void cmTarget::AddLinkLibrary(const std::string& lib,
- LinkLibraryType llt)
- {
- this->AddFramework(lib.c_str(), llt);
- cmTarget::LibraryID tmp;
- tmp.first = lib;
- tmp.second = llt;
- this->LinkLibraries.push_back(tmp);
- this->OriginalLinkLibraries.push_back(tmp);
- }
- //----------------------------------------------------------------------------
- bool cmTarget::NameResolvesToFramework(const std::string& libname)
- {
- return this->GetMakefile()->GetLocalGenerator()->GetGlobalGenerator()->
- NameResolvesToFramework(libname);
- }
- //----------------------------------------------------------------------------
- bool cmTarget::AddFramework(const std::string& libname, LinkLibraryType llt)
- {
- (void)llt; // TODO: What is this?
- if(this->NameResolvesToFramework(libname.c_str()))
- {
- std::string frameworkDir = libname;
- frameworkDir += "/../";
- frameworkDir = cmSystemTools::CollapseFullPath(frameworkDir.c_str());
- std::vector<std::string>::iterator i =
- std::find(this->Frameworks.begin(),
- this->Frameworks.end(), frameworkDir);
- if(i == this->Frameworks.end())
- {
- this->Frameworks.push_back(frameworkDir);
- }
- return true;
- }
- return false;
- }
- //----------------------------------------------------------------------------
- void cmTarget::AddLinkLibrary(cmMakefile& mf,
- const char *target, const char* lib,
- LinkLibraryType llt)
- {
- // Never add a self dependency, even if the user asks for it.
- if(strcmp( target, lib ) == 0)
- {
- return;
- }
- this->AddFramework(lib, llt);
- cmTarget::LibraryID tmp;
- tmp.first = lib;
- tmp.second = llt;
- this->LinkLibraries.push_back( tmp );
- this->OriginalLinkLibraries.push_back(tmp);
- // Add the explicit dependency information for this target. This is
- // simply a set of libraries separated by ";". There should always
- // be a trailing ";". These library names are not canonical, in that
- // they may be "-framework x", "-ly", "/path/libz.a", etc.
- // We shouldn't remove duplicates here because external libraries
- // may be purposefully duplicated to handle recursive dependencies,
- // and we removing one instance will break the link line. Duplicates
- // will be appropriately eliminated at emit time.
- if(this->RecordDependencies)
- {
- std::string targetEntry = target;
- targetEntry += "_LIB_DEPENDS";
- std::string dependencies;
- const char* old_val = mf.GetDefinition( targetEntry.c_str() );
- if( old_val )
- {
- dependencies += old_val;
- }
- switch (llt)
- {
- case cmTarget::GENERAL:
- dependencies += "general";
- break;
- case cmTarget::DEBUG:
- dependencies += "debug";
- break;
- case cmTarget::OPTIMIZED:
- dependencies += "optimized";
- break;
- }
- dependencies += ";";
- dependencies += lib;
- dependencies += ";";
- mf.AddCacheDefinition( targetEntry.c_str(), dependencies.c_str(),
- "Dependencies for the target",
- cmCacheManager::STATIC );
- }
- }
- //----------------------------------------------------------------------------
- void
- cmTarget::AnalyzeLibDependencies( const cmMakefile& mf )
- {
- // There are two key parts of the dependency analysis: (1)
- // determining the libraries in the link line, and (2) constructing
- // the dependency graph for those libraries.
- //
- // The latter is done using the cache entries that record the
- // dependencies of each library.
- //
- // The former is a more thorny issue, since it is not clear how to
- // determine if two libraries listed on the link line refer to the a
- // single library or not. For example, consider the link "libraries"
- // /usr/lib/libtiff.so -ltiff
- // Is this one library or two? The solution implemented here is the
- // simplest (and probably the only practical) one: two libraries are
- // the same if their "link strings" are identical. Thus, the two
- // libraries above are considered distinct. This also means that for
- // dependency analysis to be effective, the CMake user must specify
- // libraries build by his project without using any linker flags or
- // file extensions. That is,
- // LINK_LIBRARIES( One Two )
- // instead of
- // LINK_LIBRARIES( -lOne ${binarypath}/libTwo.a )
- // The former is probably what most users would do, but it never
- // hurts to document the assumptions. :-) Therefore, in the analysis
- // code, the "canonical name" of a library is simply its name as
- // given to a LINK_LIBRARIES command.
- //
- // Also, we will leave the original link line intact; we will just add any
- // dependencies that were missing.
- //
- // There is a problem with recursive external libraries
- // (i.e. libraries with no dependency information that are
- // recursively dependent). We must make sure that the we emit one of
- // the libraries twice to satisfy the recursion, but we shouldn't
- // emit it more times than necessary. In particular, we must make
- // sure that handling this improbable case doesn't cost us when
- // dealing with the common case of non-recursive libraries. The
- // solution is to assume that the recursion is satisfied at one node
- // of the dependency tree. To illustrate, assume libA and libB are
- // extrenal and mutually dependent. Suppose libX depends on
- // libA, and libY on libA and libX. Then
- // TARGET_LINK_LIBRARIES( Y X A B A )
- // TARGET_LINK_LIBRARIES( X A B A )
- // TARGET_LINK_LIBRARIES( Exec Y )
- // would result in "-lY -lX -lA -lB -lA". This is the correct way to
- // specify the dependencies, since the mutual dependency of A and B
- // is resolved *every time libA is specified*.
- //
- // Something like
- // TARGET_LINK_LIBRARIES( Y X A B A )
- // TARGET_LINK_LIBRARIES( X A B )
- // TARGET_LINK_LIBRARIES( Exec Y )
- // would result in "-lY -lX -lA -lB", and the mutual dependency
- // information is lost. This is because in some case (Y), the mutual
- // dependency of A and B is listed, while in another other case (X),
- // it is not. Depending on which line actually emits A, the mutual
- // dependency may or may not be on the final link line. We can't
- // handle this pathalogical case cleanly without emitting extra
- // libraries for the normal cases. Besides, the dependency
- // information for X is wrong anyway: if we build an executable
- // depending on X alone, we would not have the mutual dependency on
- // A and B resolved.
- //
- // IMPROVEMENTS:
- // -- The current algorithm will not always pick the "optimal" link line
- // when recursive dependencies are present. It will instead break the
- // cycles at an aribtrary point. The majority of projects won't have
- // cyclic dependencies, so this is probably not a big deal. Note that
- // the link line is always correct, just not necessary optimal.
- {
- // Expand variables in link library names. This is for backwards
- // compatibility with very early CMake versions and should
- // eventually be removed. This code was moved here from the end of
- // old source list processing code which was called just before this
- // method.
- for(LinkLibraryVectorType::iterator p = this->LinkLibraries.begin();
- p != this->LinkLibraries.end(); ++p)
- {
- this->Makefile->ExpandVariablesInString(p->first, true, true);
- }
- }
- typedef std::vector< std::string > LinkLine;
- // The dependency map.
- DependencyMap dep_map;
- // 1. Build the dependency graph
- //
- for(LinkLibraryVectorType::reverse_iterator lib
- = this->LinkLibraries.rbegin();
- lib != this->LinkLibraries.rend(); ++lib)
- {
- this->GatherDependencies( mf, *lib, dep_map);
- }
- // 2. Remove any dependencies that are already satisfied in the original
- // link line.
- //
- for(LinkLibraryVectorType::iterator lib = this->LinkLibraries.begin();
- lib != this->LinkLibraries.end(); ++lib)
- {
- for( LinkLibraryVectorType::iterator lib2 = lib;
- lib2 != this->LinkLibraries.end(); ++lib2)
- {
- this->DeleteDependency( dep_map, *lib, *lib2);
- }
- }
- // 3. Create the new link line by simply emitting any dependencies that are
- // missing. Start from the back and keep adding.
- //
- std::set<DependencyMap::key_type> done, visited;
- std::vector<DependencyMap::key_type> newLinkLibraries;
- for(LinkLibraryVectorType::reverse_iterator lib =
- this->LinkLibraries.rbegin();
- lib != this->LinkLibraries.rend(); ++lib)
- {
- // skip zero size library entries, this may happen
- // if a variable expands to nothing.
- if (lib->first.size() != 0)
- {
- this->Emit( *lib, dep_map, done, visited, newLinkLibraries );
- }
- }
- // 4. Add the new libraries to the link line.
- //
- for( std::vector<DependencyMap::key_type>::reverse_iterator k =
- newLinkLibraries.rbegin();
- k != newLinkLibraries.rend(); ++k )
- {
- // get the llt from the dep_map
- this->LinkLibraries.push_back( std::make_pair(k->first,k->second) );
- }
- this->LinkLibrariesAnalyzed = true;
- }
- //----------------------------------------------------------------------------
- void cmTarget::InsertDependency( DependencyMap& depMap,
- const LibraryID& lib,
- const LibraryID& dep)
- {
- depMap[lib].push_back(dep);
- }
- //----------------------------------------------------------------------------
- void cmTarget::DeleteDependency( DependencyMap& depMap,
- const LibraryID& lib,
- const LibraryID& dep)
- {
- // Make sure there is an entry in the map for lib. If so, delete all
- // dependencies to dep. There may be repeated entries because of
- // external libraries that are specified multiple times.
- DependencyMap::iterator map_itr = depMap.find( lib );
- if( map_itr != depMap.end() )
- {
- DependencyList& depList = map_itr->second;
- DependencyList::iterator itr;
- while( (itr = std::find(depList.begin(), depList.end(), dep)) !=
- depList.end() )
- {
- depList.erase( itr );
- }
- }
- }
- //----------------------------------------------------------------------------
- void cmTarget::Emit(const LibraryID lib,
- const DependencyMap& dep_map,
- std::set<LibraryID>& emitted,
- std::set<LibraryID>& visited,
- DependencyList& link_line )
- {
- // It's already been emitted
- if( emitted.find(lib) != emitted.end() )
- {
- return;
- }
- // Emit the dependencies only if this library node hasn't been
- // visited before. If it has, then we have a cycle. The recursion
- // that got us here should take care of everything.
- if( visited.insert(lib).second )
- {
- if( dep_map.find(lib) != dep_map.end() ) // does it have dependencies?
- {
- const DependencyList& dep_on = dep_map.find( lib )->second;
- DependencyList::const_reverse_iterator i;
- // To cater for recursive external libraries, we must emit
- // duplicates on this link line *unless* they were emitted by
- // some other node, in which case we assume that the recursion
- // was resolved then. We making the simplifying assumption that
- // any duplicates on a single link line are on purpose, and must
- // be preserved.
- // This variable will keep track of the libraries that were
- // emitted directory from the current node, and not from a
- // recursive call. This way, if we come across a library that
- // has already been emitted, we repeat it iff it has been
- // emitted here.
- std::set<DependencyMap::key_type> emitted_here;
- for( i = dep_on.rbegin(); i != dep_on.rend(); ++i )
- {
- if( emitted_here.find(*i) != emitted_here.end() )
- {
- // a repeat. Must emit.
- emitted.insert(*i);
- link_line.push_back( *i );
- }
- else
- {
- // Emit only if no-one else has
- if( emitted.find(*i) == emitted.end() )
- {
- // emit dependencies
- Emit( *i, dep_map, emitted, visited, link_line );
- // emit self
- emitted.insert(*i);
- emitted_here.insert(*i);
- link_line.push_back( *i );
- }
- }
- }
- }
- }
- }
- //----------------------------------------------------------------------------
- void cmTarget::GatherDependencies( const cmMakefile& mf,
- const LibraryID& lib,
- DependencyMap& dep_map)
- {
- // If the library is already in the dependency map, then it has
- // already been fully processed.
- if( dep_map.find(lib) != dep_map.end() )
- {
- return;
- }
- const char* deps = mf.GetDefinition( (lib.first+"_LIB_DEPENDS").c_str() );
- if( deps && strcmp(deps,"") != 0 )
- {
- // Make sure this library is in the map, even if it has an empty
- // set of dependencies. This distinguishes the case of explicitly
- // no dependencies with that of unspecified dependencies.
- dep_map[lib];
- // Parse the dependency information, which is a set of
- // type, library pairs separated by ";". There is always a trailing ";".
- cmTarget::LinkLibraryType llt = cmTarget::GENERAL;
- std::string depline = deps;
- std::string::size_type start = 0;
- std::string::size_type end;
- end = depline.find( ";", start );
- while( end != std::string::npos )
- {
- std::string l = depline.substr( start, end-start );
- if( l.size() != 0 )
- {
- if (l == "debug")
- {
- llt = cmTarget::DEBUG;
- }
- else if (l == "optimized")
- {
- llt = cmTarget::OPTIMIZED;
- }
- else if (l == "general")
- {
- llt = cmTarget::GENERAL;
- }
- else
- {
- LibraryID lib2(l,llt);
- this->InsertDependency( dep_map, lib, lib2);
- this->GatherDependencies( mf, lib2, dep_map);
- llt = cmTarget::GENERAL;
- }
- }
- start = end+1; // skip the ;
- end = depline.find( ";", start );
- }
- // cannot depend on itself
- this->DeleteDependency( dep_map, lib, lib);
- }
- }
- //----------------------------------------------------------------------------
- void cmTarget::SetProperty(const char* prop, const char* value)
- {
- if (!prop)
- {
- return;
- }
- if (!value)
- {
- value = "NOTFOUND";
- }
- this->Properties.SetProperty(prop, value, cmProperty::TARGET);
- // If imported information is being set, wipe out cached
- // information.
- if(this->IsImported() && strncmp(prop, "IMPORTED", 8) == 0)
- {
- this->ImportInfoMap.clear();
- }
- }
- //----------------------------------------------------------------------------
- void cmTarget::AppendProperty(const char* prop, const char* value)
- {
- if (!prop)
- {
- return;
- }
- this->Properties.AppendProperty(prop, value, cmProperty::TARGET);
- // If imported information is being set, wipe out cached
- // information.
- if(this->IsImported() && strncmp(prop, "IMPORTED", 8) == 0)
- {
- this->ImportInfoMap.clear();
- }
- }
- //----------------------------------------------------------------------------
- void cmTarget::MarkAsImported()
- {
- this->IsImportedTarget = true;
- }
- //----------------------------------------------------------------------------
- const char* cmTarget::GetDirectory(const char* config, bool implib)
- {
- if (this->IsImported())
- {
- return this->ImportedGetDirectory(config, implib);
- }
- else
- {
- return this->NormalGetDirectory(config, implib);
- }
- }
- //----------------------------------------------------------------------------
- const char* cmTarget::ImportedGetDirectory(const char* config, bool implib)
- {
- this->Directory =
- cmSystemTools::GetFilenamePath(
- this->ImportedGetFullPath(config, implib));
- return this->Directory.c_str();
- }
- //----------------------------------------------------------------------------
- const char* cmTarget::NormalGetDirectory(const char* config, bool implib)
- {
- if(config && *config)
- {
- // Do not create the directory when config is given:
- this->Directory = this->GetAndCreateOutputDir(implib, true);
- // Add the configuration's subdirectory.
- this->Makefile->GetLocalGenerator()->GetGlobalGenerator()->
- AppendDirectoryForConfig("/", config, "", this->Directory);
- return this->Directory.c_str();
- }
- else
- {
- return this->GetOutputDir(implib);
- }
- }
- //----------------------------------------------------------------------------
- const char* cmTarget::GetLocation(const char* config)
- {
- if (this->IsImported())
- {
- return this->ImportedGetLocation(config);
- }
- else
- {
- return this->NormalGetLocation(config);
- }
- }
- //----------------------------------------------------------------------------
- const char* cmTarget::ImportedGetLocation(const char* config)
- {
- this->Location = this->ImportedGetFullPath(config, false);
- return this->Location.c_str();
- }
- //----------------------------------------------------------------------------
- const char* cmTarget::NormalGetLocation(const char* config)
- {
- this->Location = this->GetDirectory(config);
- if(!this->Location.empty())
- {
- this->Location += "/";
- }
- if(!config)
- {
- // No specific configuration was given so it will not appear on
- // the result of GetDirectory. Add a name here to be replaced at
- // build time.
- const char* cfgid = this->Makefile->GetDefinition("CMAKE_CFG_INTDIR");
- if(cfgid && strcmp(cfgid, ".") != 0)
- {
- this->Location += cfgid;
- this->Location += "/";
- }
- }
- this->Location += this->GetFullName(config, false);
- return this->Location.c_str();
- }
- //----------------------------------------------------------------------------
- void cmTarget::GetTargetVersion(int& major, int& minor)
- {
- // Set the default values.
- major = 0;
- minor = 0;
- // Look for a VERSION property.
- if(const char* version = this->GetProperty("VERSION"))
- {
- // Try to parse the version number and store the results that were
- // successfully parsed.
- int parsed_major;
- int parsed_minor;
- switch(sscanf(version, "%d.%d", &parsed_major, &parsed_minor))
- {
- case 2: minor = parsed_minor; // no break!
- case 1: major = parsed_major; // no break!
- default: break;
- }
- }
- }
- //----------------------------------------------------------------------------
- const char *cmTarget::GetProperty(const char* prop)
- {
- return this->GetProperty(prop, cmProperty::TARGET);
- }
- //----------------------------------------------------------------------------
- void cmTarget::ComputeObjectFiles()
- {
- if (this->IsImported())
- {
- return;
- }
- #if 0
- std::vector<std::string> dirs;
- this->Makefile->GetLocalGenerator()->
- GetTargetObjectFileDirectories(this,
- dirs);
- std::string objectFiles;
- std::string objExtensionLookup1 = "CMAKE_";
- std::string objExtensionLookup2 = "_OUTPUT_EXTENSION";
- for(std::vector<std::string>::iterator d = dirs.begin();
- d != dirs.end(); ++d)
- {
- for(std::vector<cmSourceFile*>::iterator s = this->SourceFiles.begin();
- s != this->SourceFiles.end(); ++s)
- {
- cmSourceFile* sf = *s;
- if(const char* lang = sf->GetLanguage())
- {
- std::string lookupObj = objExtensionLookup1 + lang;
- lookupObj += objExtensionLookup2;
- const char* obj = this->Makefile->GetDefinition(lookupObj.c_str());
- if(obj)
- {
- if(objectFiles.size())
- {
- objectFiles += ";";
- }
- std::string objFile = *d;
- objFile += "/";
- objFile += this->Makefile->GetLocalGenerator()->
- GetSourceObjectName(*sf);
- objFile += obj;
- objectFiles += objFile;
- }
- }
- }
- }
- this->SetProperty("OBJECT_FILES", objectFiles.c_str());
- #endif
- }
- //----------------------------------------------------------------------------
- const char *cmTarget::GetProperty(const char* prop,
- cmProperty::ScopeType scope)
- {
- if(!prop)
- {
- return 0;
- }
- // Watch for special "computed" properties that are dependent on
- // other properties or variables. Always recompute them.
- if(this->GetType() == cmTarget::EXECUTABLE ||
- this->GetType() == cmTarget::STATIC_LIBRARY ||
- this->GetType() == cmTarget::SHARED_LIBRARY ||
- this->GetType() == cmTarget::MODULE_LIBRARY)
- {
- if(!this->IsImported() && strcmp(prop,"LOCATION") == 0)
- {
- // Set the LOCATION property of the target. Note that this
- // cannot take into account the per-configuration name of the
- // target because the configuration type may not be known at
- // CMake time. It is now deprecated as described in the
- // documentation.
- this->SetProperty("LOCATION", this->GetLocation(0));
- }
- // Support "LOCATION_<CONFIG>".
- if(strncmp(prop, "LOCATION_", 9) == 0)
- {
- std::string configName = prop+9;
- this->SetProperty(prop, this->GetLocation(configName.c_str()));
- }
- else
- {
- // Support "<CONFIG>_LOCATION" for compatiblity.
- int len = static_cast<int>(strlen(prop));
- if(len > 9 && strcmp(prop+len-9, "_LOCATION") == 0)
- {
- std::string configName(prop, len-9);
- if(configName != "IMPORTED")
- {
- this->SetProperty(prop, this->GetLocation(configName.c_str()));
- }
- }
- }
- }
- if (strcmp(prop,"IMPORTED") == 0)
- {
- return this->IsImported()?"TRUE":"FALSE";
- }
- if(!strcmp(prop,"SOURCES"))
- {
- cmOStringStream ss;
- const char* sep = "";
- for(std::vector<cmSourceFile*>::const_iterator
- i = this->SourceFiles.begin();
- i != this->SourceFiles.end(); ++i)
- {
- // Separate from the previous list entries.
- ss << sep;
- sep = ";";
- // Construct what is known about this source file location.
- cmSourceFileLocation const& location = (*i)->GetLocation();
- std::string sname = location.GetDirectory();
- if(!sname.empty())
- {
- sname += "/";
- }
- sname += location.GetName();
- // Append this list entry.
- ss << sname;
- }
- this->SetProperty("SOURCES", ss.str().c_str());
- }
- // the type property returns what type the target is
- if (!strcmp(prop,"TYPE"))
- {
- switch( this->GetType() )
- {
- case cmTarget::STATIC_LIBRARY:
- return "STATIC_LIBRARY";
- // break; /* unreachable */
- case cmTarget::MODULE_LIBRARY:
- return "MODULE_LIBRARY";
- // break; /* unreachable */
- case cmTarget::SHARED_LIBRARY:
- return "SHARED_LIBRARY";
- // break; /* unreachable */
- case cmTarget::EXECUTABLE:
- return "EXECUTABLE";
- // break; /* unreachable */
- case cmTarget::UTILITY:
- return "UTILITY";
- // break; /* unreachable */
- case cmTarget::GLOBAL_TARGET:
- return "GLOBAL_TARGET";
- // break; /* unreachable */
- case cmTarget::INSTALL_FILES:
- return "INSTALL_FILES";
- // break; /* unreachable */
- case cmTarget::INSTALL_PROGRAMS:
- return "INSTALL_PROGRAMS";
- // break; /* unreachable */
- case cmTarget::INSTALL_DIRECTORY:
- return "INSTALL_DIRECTORY";
- // break; /* unreachable */
- }
- return 0;
- }
- bool chain = false;
- const char *retVal =
- this->Properties.GetPropertyValue(prop, scope, chain);
- if (chain)
- {
- return this->Makefile->GetProperty(prop,scope);
- }
- return retVal;
- }
- //----------------------------------------------------------------------------
- bool cmTarget::GetPropertyAsBool(const char* prop)
- {
- return cmSystemTools::IsOn(this->GetProperty(prop));
- }
- //----------------------------------------------------------------------------
- const char* cmTarget::GetLinkerLanguage(cmGlobalGenerator* gg)
- {
- if(this->GetProperty("HAS_CXX"))
- {
- const_cast<cmTarget*>(this)->SetProperty("LINKER_LANGUAGE", "CXX");
- }
- const char* linkerLang = this->GetProperty("LINKER_LANGUAGE");
- if (linkerLang==0)
- {
- // if the property has not yet been set, collect all languages in the
- // target and then find the language with the highest preference value
- std::set<cmStdString> languages;
- this->GetLanguages(languages);
- std::string linkerLangList; // only used for the error message
- int maxLinkerPref = 0;
- bool multiplePreferedLanguages = false;
- for(std::set<cmStdString>::const_iterator sit = languages.begin();
- sit != languages.end(); ++sit)
- {
- int linkerPref = gg->GetLinkerPreference(sit->c_str());
- if ((linkerPref > maxLinkerPref) || (linkerLang==0))
- {
- maxLinkerPref = linkerPref;
- linkerLang = sit->c_str();
- linkerLangList = *sit;
- multiplePreferedLanguages = false;
- }
- else if (linkerPref == maxLinkerPref)
- {
- linkerLangList += "; ";
- linkerLangList += *sit;
- multiplePreferedLanguages = true;
- }
- }
- if (linkerLang!=0)
- {
- const_cast<cmTarget*>(this)->SetProperty("LINKER_LANGUAGE", linkerLang);
- }
- if (multiplePreferedLanguages)
- {
- cmOStringStream err;
- err << "Error: Target " << this->Name << " contains multiple languages "
- << "with the highest linker preference (" << maxLinkerPref << "): "
- << linkerLangList << "\n"
- << "You must set the LINKER_LANGUAGE property for this target.";
- cmSystemTools::Error(err.str().c_str());
- }
- }
- return this->GetProperty("LINKER_LANGUAGE");
- }
- //----------------------------------------------------------------------------
- const char* cmTarget::GetCreateRuleVariable()
- {
- switch(this->GetType())
- {
- case cmTarget::STATIC_LIBRARY:
- return "_CREATE_STATIC_LIBRARY";
- case cmTarget::SHARED_LIBRARY:
- return "_CREATE_SHARED_LIBRARY";
- case cmTarget::MODULE_LIBRARY:
- return "_CREATE_SHARED_MODULE";
- case cmTarget::EXECUTABLE:
- return "_LINK_EXECUTABLE";
- case cmTarget::UTILITY:
- case cmTarget::GLOBAL_TARGET:
- case cmTarget::INSTALL_FILES:
- case cmTarget::INSTALL_PROGRAMS:
- case cmTarget::INSTALL_DIRECTORY:
- break;
- }
- return "";
- }
- //----------------------------------------------------------------------------
- const char* cmTarget::GetSuffixVariableInternal(TargetType type,
- bool implib)
- {
- switch(type)
- {
- case cmTarget::STATIC_LIBRARY:
- return "CMAKE_STATIC_LIBRARY_SUFFIX";
- case cmTarget::SHARED_LIBRARY:
- return (implib
- ? "CMAKE_IMPORT_LIBRARY_SUFFIX"
- : "CMAKE_SHARED_LIBRARY_SUFFIX");
- case cmTarget::MODULE_LIBRARY:
- return (implib
- ? "CMAKE_IMPORT_LIBRARY_SUFFIX"
- : "CMAKE_SHARED_MODULE_SUFFIX");
- case cmTarget::EXECUTABLE:
- return (implib
- ? "CMAKE_IMPORT_LIBRARY_SUFFIX"
- : "CMAKE_EXECUTABLE_SUFFIX");
- case cmTarget::UTILITY:
- case cmTarget::GLOBAL_TARGET:
- case cmTarget::INSTALL_FILES:
- case cmTarget::INSTALL_PROGRAMS:
- case cmTarget::INSTALL_DIRECTORY:
- break;
- }
- return "";
- }
- //----------------------------------------------------------------------------
- const char* cmTarget::GetPrefixVariableInternal(TargetType type,
- bool implib)
- {
- switch(type)
- {
- case cmTarget::STATIC_LIBRARY:
- return "CMAKE_STATIC_LIBRARY_PREFIX";
- case cmTarget::SHARED_LIBRARY:
- return (implib
- ? "CMAKE_IMPORT_LIBRARY_PREFIX"
- : "CMAKE_SHARED_LIBRARY_PREFIX");
- case cmTarget::MODULE_LIBRARY:
- return (implib
- ? "CMAKE_IMPORT_LIBRARY_PREFIX"
- : "CMAKE_SHARED_MODULE_PREFIX");
- case cmTarget::EXECUTABLE:
- return (implib? "CMAKE_IMPORT_LIBRARY_PREFIX" : "");
- case cmTarget::UTILITY:
- case cmTarget::GLOBAL_TARGET:
- case cmTarget::INSTALL_FILES:
- case cmTarget::INSTALL_PROGRAMS:
- case cmTarget::INSTALL_DIRECTORY:
- break;
- }
- return "";
- }
- //----------------------------------------------------------------------------
- std::string cmTarget::GetPDBName(const char* config)
- {
- std::string prefix;
- std::string base;
- std::string suffix;
- this->GetFullNameInternal(this->GetType(), config, false,
- prefix, base, suffix);
- return prefix+base+".pdb";
- }
- //----------------------------------------------------------------------------
- std::string cmTarget::GetSOName(const char* config)
- {
- if(this->IsImported())
- {
- // Lookup the imported soname.
- if(cmTarget::ImportInfo const* info = this->GetImportInfo(config))
- {
- return info->SOName;
- }
- else
- {
- return "";
- }
- }
- else
- {
- // Compute the soname that will be built.
- std::string name;
- std::string soName;
- std::string realName;
- std::string impName;
- std::string pdbName;
- this->GetLibraryNames(name, soName, realName, impName, pdbName, config);
- return soName;
- }
- }
- //----------------------------------------------------------------------------
- std::string cmTarget::GetFullName(const char* config, bool implib)
- {
- if(this->IsImported())
- {
- return this->GetFullNameImported(config, implib);
- }
- else
- {
- return this->GetFullNameInternal(this->GetType(), config, implib);
- }
- }
- //----------------------------------------------------------------------------
- std::string cmTarget::GetFullNameImported(const char* config, bool implib)
- {
- return cmSystemTools::GetFilenameName(
- this->ImportedGetFullPath(config, implib));
- }
- //----------------------------------------------------------------------------
- void cmTarget::GetFullNameComponents(std::string& prefix, std::string& base,
- std::string& suffix, const char* config,
- bool implib)
- {
- this->GetFullNameInternal(this->GetType(), config, implib,
- prefix, base, suffix);
- }
- //----------------------------------------------------------------------------
- std::string cmTarget::GetFullPath(const char* config, bool implib)
- {
- if(this->IsImported())
- {
- return this->ImportedGetFullPath(config, implib);
- }
- else
- {
- return this->NormalGetFullPath(config, implib);
- }
- }
- //----------------------------------------------------------------------------
- std::string cmTarget::NormalGetFullPath(const char* config, bool implib)
- {
- // Start with the output directory for the target.
- std::string fpath = this->GetDirectory(config, implib);
- fpath += "/";
- // Add the full name of the target.
- fpath += this->GetFullName(config, implib);
- return fpath;
- }
- //----------------------------------------------------------------------------
- std::string cmTarget::ImportedGetFullPath(const char* config, bool implib)
- {
- if(cmTarget::ImportInfo const* info = this->GetImportInfo(config))
- {
- if(implib)
- {
- return info->ImportLibrary;
- }
- else
- {
- return info->Location;
- }
- }
- else
- {
- std::string result = this->GetName();
- result += "-NOTFOUND";
- return result;
- }
- }
- //----------------------------------------------------------------------------
- std::string
- cmTarget::GetFullNameInternal(TargetType type, const char* config,
- bool implib)
- {
- std::string prefix;
- std::string base;
- std::string suffix;
- this->GetFullNameInternal(type, config, implib, prefix, base, suffix);
- return prefix+base+suffix;
- }
- //----------------------------------------------------------------------------
- void cmTarget::GetFullNameInternal(TargetType type,
- const char* config,
- bool implib,
- std::string& outPrefix,
- std::string& outBase,
- std::string& outSuffix)
- {
- // Use just the target name for non-main target types.
- if(type != cmTarget::STATIC_LIBRARY &&
- type != cmTarget::SHARED_LIBRARY &&
- type != cmTarget::MODULE_LIBRARY &&
- type != cmTarget::EXECUTABLE)
- {
- outPrefix = "";
- outBase = this->GetName();
- outSuffix = "";
- return;
- }
- // Return an empty name for the import library if this platform
- // does not support import libraries.
- if(implib &&
- !this->Makefile->GetDefinition("CMAKE_IMPORT_LIBRARY_SUFFIX"))
- {
- outPrefix = "";
- outBase = "";
- outSuffix = "";
- return;
- }
- // The implib option is only allowed for shared libraries, module
- // libraries, and executables.
- if(type != cmTarget::SHARED_LIBRARY &&
- type != cmTarget::MODULE_LIBRARY &&
- type != cmTarget::EXECUTABLE)
- {
- implib = false;
- }
- // Compute the full name for main target types.
- const char* targetPrefix = (implib
- ? this->GetProperty("IMPORT_PREFIX")
- : this->GetProperty("PREFIX"));
- const char* targetSuffix = (implib
- ? this->GetProperty("IMPORT_SUFFIX")
- : this->GetProperty("SUFFIX"));
- const char* configPostfix = 0;
- if(config && *config)
- {
- std::string configProp = cmSystemTools::UpperCase(config);
- configProp += "_POSTFIX";
- configPostfix = this->GetProperty(configProp.c_str());
- }
- const char* prefixVar = this->GetPrefixVariableInternal(type, implib);
- const char* suffixVar = this->GetSuffixVariableInternal(type, implib);
- const char* ll =
- this->GetLinkerLanguage(
- this->Makefile->GetLocalGenerator()->GetGlobalGenerator());
- // first try language specific suffix
- if(ll)
- {
- if(!targetSuffix && suffixVar && *suffixVar)
- {
- std::string langSuff = suffixVar + std::string("_") + ll;
- targetSuffix = this->Makefile->GetDefinition(langSuff.c_str());
- }
- if(!targetPrefix && prefixVar && *prefixVar)
- {
- std::string langPrefix = prefixVar + std::string("_") + ll;
- targetPrefix = this->Makefile->GetDefinition(langPrefix.c_str());
- }
- }
- // if there is no prefix on the target use the cmake definition
- if(!targetPrefix && prefixVar)
- {
- targetPrefix = this->Makefile->GetSafeDefinition(prefixVar);
- }
- // if there is no suffix on the target use the cmake definition
- if(!targetSuffix && suffixVar)
- {
- targetSuffix = this->Makefile->GetSafeDefinition(suffixVar);
- }
- // frameworks do not have a prefix or a suffix
- if(this->IsFrameworkOnApple())
- {
- targetPrefix = 0;
- targetSuffix = 0;
- }
- // Begin the final name with the prefix.
- outPrefix = targetPrefix?targetPrefix:"";
- // Append the target name or property-specified name.
- const char* outName = 0;
- if(config && *config)
- {
- std::string configProp = cmSystemTools::UpperCase(config);
- configProp += "_OUTPUT_NAME";
- outName = this->GetProperty(configProp.c_str());
- }
- if(!outName)
- {
- outName = this->GetProperty("OUTPUT_NAME");
- }
- if(outName)
- {
- outBase = outName;
- }
- else
- {
- outBase = this->GetName();
- }
- // Append the per-configuration postfix.
- outBase += configPostfix?configPostfix:"";
- // Name shared libraries with their version number on some platforms.
- if(const char* version = this->GetProperty("VERSION"))
- {
- if(type == cmTarget::SHARED_LIBRARY && !implib &&
- this->Makefile->IsOn("CMAKE_SHARED_LIBRARY_NAME_WITH_VERSION"))
- {
- outBase += "-";
- outBase += version;
- }
- }
- // Append the suffix.
- outSuffix = targetSuffix?targetSuffix:"";
- }
- //----------------------------------------------------------------------------
- void cmTarget::GetLibraryNames(std::string& name,
- std::string& soName,
- std::string& realName,
- std::string& impName,
- std::string& pdbName,
- const char* config)
- {
- // Get the names based on the real type of the library.
- this->GetLibraryNamesInternal(name, soName, realName, impName, pdbName,
- this->GetType(), config);
- }
- //----------------------------------------------------------------------------
- void cmTarget::GetLibraryCleanNames(std::string& staticName,
- std::string& sharedName,
- std::string& sharedSOName,
- std::string& sharedRealName,
- std::string& importName,
- std::string& pdbName,
- const char* config)
- {
- // Get the name as if this were a static library.
- std::string soName;
- std::string realName;
- std::string impName;
- this->GetLibraryNamesInternal(staticName, soName, realName, impName,
- pdbName, cmTarget::STATIC_LIBRARY, config);
- // Get the names as if this were a shared library.
- if(this->GetType() == cmTarget::STATIC_LIBRARY)
- {
- // Since the real type is static then the user either specified
- // STATIC or did not specify a type. In the former case the
- // shared library will never be present. In the latter case the
- // type will never be MODULE. Either way the only names that
- // might have to be cleaned are the shared library names.
- this->GetLibraryNamesInternal(sharedName, sharedSOName, sharedRealName,
- importName, pdbName,
- cmTarget::SHARED_LIBRARY, config);
- }
- else
- {
- // Use the name of the real type of the library (shared or module).
- this->GetLibraryNamesInternal(sharedName, sharedSOName, sharedRealName,
- importName, pdbName, this->GetType(),
- config);
- }
- }
- //----------------------------------------------------------------------------
- void cmTarget::GetLibraryNamesInternal(std::string& name,
- std::string& soName,
- std::string& realName,
- std::string& impName,
- std::string& pdbName,
- TargetType type,
- const char* config)
- {
- // This should not be called for imported targets.
- // TODO: Split cmTarget into a class hierarchy to get compile-time
- // enforcement of the limited imported target API.
- if(this->IsImported())
- {
- abort();
- }
- // Construct the name of the soname flag variable for this language.
- const char* ll =
- this->GetLinkerLanguage(
- this->Makefile->GetLocalGenerator()->GetGlobalGenerator());
- std::string sonameFlag = "CMAKE_SHARED_LIBRARY_SONAME";
- if(ll)
- {
- sonameFlag += "_";
- sonameFlag += ll;
- }
- sonameFlag += "_FLAG";
- // Check for library version properties.
- const char* version = this->GetProperty("VERSION");
- const char* soversion = this->GetProperty("SOVERSION");
- if((type != cmTarget::SHARED_LIBRARY && type != cmTarget::MODULE_LIBRARY) ||
- !this->Makefile->GetDefinition(sonameFlag.c_str()))
- {
- // Versioning is supported only for shared libraries and modules,
- // and then only when the platform supports an soname flag.
- version = 0;
- soversion = 0;
- }
- if(version && !soversion)
- {
- // The soversion must be set if the library version is set. Use
- // the library version as the soversion.
- soversion = version;
- }
- // Get the components of the library name.
- std::string prefix;
- std::string base;
- std::string suffix;
- this->GetFullNameInternal(type, config, false, prefix, base, suffix);
- // The library name.
- name = prefix+base+suffix;
- // The library's soname.
- #if defined(__APPLE__)
- soName = prefix+base;
- #else
- soName = name;
- #endif
- if(soversion)
- {
- soName += ".";
- soName += soversion;
- }
- #if defined(__APPLE__)
- soName += suffix;
- #endif
- // The library's real name on disk.
- #if defined(__APPLE__)
- realName = prefix+base;
- #else
- realName = name;
- #endif
- if(version)
- {
- realName += ".";
- realName += version;
- }
- else if(soversion)
- {
- realName += ".";
- realName += soversion;
- }
- #if defined(__APPLE__)
- realName += suffix;
- #endif
- // The import library name.
- if(type == cmTarget::SHARED_LIBRARY ||
- type == cmTarget::MODULE_LIBRARY)
- {
- impName = this->GetFullNameInternal(type, config, true);
- }
- else
- {
- impName = "";
- }
- // The program database file name.
- pdbName = prefix+base+".pdb";
- }
- //----------------------------------------------------------------------------
- void cmTarget::GetExecutableNames(std::string& name,
- std::string& realName,
- std::string& impName,
- std::string& pdbName,
- const char* config)
- {
- // Get the names based on the real type of the executable.
- this->GetExecutableNamesInternal(name, realName, impName, pdbName,
- this->GetType(), config);
- }
- //----------------------------------------------------------------------------
- void cmTarget::GetExecutableCleanNames(std::string& name,
- std::string& realName,
- std::string& impName,
- std::string& pdbName,
- const char* config)
- {
- // Get the name and versioned name of this executable.
- this->GetExecutableNamesInternal(name, realName, impName, pdbName,
- cmTarget::EXECUTABLE, config);
- }
- //----------------------------------------------------------------------------
- void cmTarget::GetExecutableNamesInternal(std::string& name,
- std::string& realName,
- std::string& impName,
- std::string& pdbName,
- TargetType type,
- const char* config)
- {
- // This should not be called for imported targets.
- // TODO: Split cmTarget into a class hierarchy to get compile-time
- // enforcement of the limited imported target API.
- if(this->IsImported())
- {
- abort();
- }
- // This versioning is supported only for executables and then only
- // when the platform supports symbolic links.
- #if defined(_WIN32) && !defined(__CYGWIN__)
- const char* version = 0;
- #else
- // Check for executable version properties.
- const char* version = this->GetProperty("VERSION");
- if(type != cmTarget::EXECUTABLE)
- {
- version = 0;
- }
- #endif
- // Get the components of the executable name.
- std::string prefix;
- std::string base;
- std::string suffix;
- this->GetFullNameInternal(type, config, false, prefix, base, suffix);
- // The executable name.
- name = prefix+base+suffix;
- // The executable's real name on disk.
- #if defined(__CYGWIN__)
- realName = prefix+base;
- #else
- realName = name;
- #endif
- if(version)
- {
- realName += "-";
- realName += version;
- }
- #if defined(__CYGWIN__)
- realName += suffix;
- #endif
- // The import library name.
- impName = this->GetFullNameInternal(type, config, true);
- // The program database file name.
- pdbName = prefix+base+".pdb";
- }
- //----------------------------------------------------------------------------
- void cmTarget::GenerateTargetManifest(const char* config)
- {
- cmMakefile* mf = this->Makefile;
- cmLocalGenerator* lg = mf->GetLocalGenerator();
- cmGlobalGenerator* gg = lg->GetGlobalGenerator();
- // Get the names.
- std::string name;
- std::string soName;
- std::string realName;
- std::string impName;
- std::string pdbName;
- if(this->GetType() == cmTarget::EXECUTABLE)
- {
- this->GetExecutableNames(name, realName, impName, pdbName, config);
- }
- else if(this->GetType() == cmTarget::STATIC_LIBRARY ||
- this->GetType() == cmTarget::SHARED_LIBRARY ||
- this->GetType() == cmTarget::MODULE_LIBRARY)
- {
- this->GetLibraryNames(name, soName, realName, impName, pdbName, config);
- }
- else
- {
- return;
- }
- // Get the directory.
- std::string dir = this->GetDirectory(config, false);
- // Add each name.
- std::string f;
- if(!name.empty())
- {
- f = dir;
- f += "/";
- f += name;
- gg->AddToManifest(config? config:"", f);
- }
- if(!soName.empty())
- {
- f = dir;
- f += "/";
- f += soName;
- gg->AddToManifest(config? config:"", f);
- }
- if(!realName.empty())
- {
- f = dir;
- f += "/";
- f += realName;
- gg->AddToManifest(config? config:"", f);
- }
- if(!pdbName.empty())
- {
- f = dir;
- f += "/";
- f += pdbName;
- gg->AddToManifest(config? config:"", f);
- }
- if(!impName.empty())
- {
- f = this->GetDirectory(config, true);
- f += "/";
- f += impName;
- gg->AddToManifest(config? config:"", f);
- }
- }
- //----------------------------------------------------------------------------
- void cmTarget::SetPropertyDefault(const char* property,
- const char* default_value)
- {
- // Compute the name of the variable holding the default value.
- std::string var = "CMAKE_";
- var += property;
- if(const char* value = this->Makefile->GetDefinition(var.c_str()))
- {
- this->SetProperty(property, value);
- }
- else if(default_value)
- {
- this->SetProperty(property, default_value);
- }
- }
- //----------------------------------------------------------------------------
- bool cmTarget::HaveBuildTreeRPATH()
- {
- return (!this->GetPropertyAsBool("SKIP_BUILD_RPATH") &&
- !this->LinkLibraries.empty());
- }
- //----------------------------------------------------------------------------
- bool cmTarget::HaveInstallTreeRPATH()
- {
- const char* install_rpath = this->GetProperty("INSTALL_RPATH");
- return install_rpath && *install_rpath;
- }
- //----------------------------------------------------------------------------
- bool cmTarget::NeedRelinkBeforeInstall()
- {
- // Only executables and shared libraries can have an rpath and may
- // need relinking.
- if(this->TargetTypeValue != cmTarget::EXECUTABLE &&
- this->TargetTypeValue != cmTarget::SHARED_LIBRARY &&
- this->TargetTypeValue != cmTarget::MODULE_LIBRARY)
- {
- return false;
- }
- // If there is no install location this target will not be installed
- // and therefore does not need relinking.
- if(!this->GetHaveInstallRule())
- {
- return false;
- }
- // If skipping all rpaths completely then no relinking is needed.
- if(this->Makefile->IsOn("CMAKE_SKIP_RPATH"))
- {
- return false;
- }
- // If building with the install-tree rpath no relinking is needed.
- if(this->GetPropertyAsBool("BUILD_WITH_INSTALL_RPATH"))
- {
- return false;
- }
- // If chrpath is going to be used no relinking is needed.
- if(this->IsChrpathUsed())
- {
- return false;
- }
- // Check for rpath support on this platform.
- if(const char* ll = this->GetLinkerLanguage(
- this->Makefile->GetLocalGenerator()->GetGlobalGenerator()))
- {
- std::string flagVar = "CMAKE_SHARED_LIBRARY_RUNTIME_";
- flagVar += ll;
- flagVar += "_FLAG";
- if(!this->Makefile->IsSet(flagVar.c_str()))
- {
- // There is no rpath support on this platform so nothing needs
- // relinking.
- return false;
- }
- }
- else
- {
- // No linker language is known. This error will be reported by
- // other code.
- return false;
- }
- // If either a build or install tree rpath is set then the rpath
- // will likely change between the build tree and install tree and
- // this target must be relinked.
- return this->HaveBuildTreeRPATH() || this->HaveInstallTreeRPATH();
- }
- //----------------------------------------------------------------------------
- std::string cmTarget::GetInstallNameDirForBuildTree(const char* config)
- {
- // If building directly for installation then the build tree install_name
- // is the same as the install tree.
- if(this->GetPropertyAsBool("BUILD_WITH_INSTALL_RPATH"))
- {
- return GetInstallNameDirForInstallTree(config);
- }
- // Use the build tree directory for the target.
- if(this->Makefile->IsOn("CMAKE_PLATFORM_HAS_INSTALLNAME") &&
- !this->Makefile->IsOn("CMAKE_SKIP_RPATH") &&
- !this->GetPropertyAsBool("SKIP_BUILD_RPATH"))
- {
- std::string dir = this->GetDirectory(config);
- dir += "/";
- return dir;
- }
- else
- {
- return "";
- }
- }
- //----------------------------------------------------------------------------
- std::string cmTarget::GetInstallNameDirForInstallTree(const char*)
- {
- // Lookup the target property.
- const char* install_name_dir = this->GetProperty("INSTALL_NAME_DIR");
- if(this->Makefile->IsOn("CMAKE_PLATFORM_HAS_INSTALLNAME") &&
- !this->Makefile->IsOn("CMAKE_SKIP_RPATH") &&
- install_name_dir && *install_name_dir)
- {
- std::string dir = install_name_dir;
- dir += "/";
- return dir;
- }
- else
- {
- return "";
- }
- }
- //----------------------------------------------------------------------------
- const char* cmTarget::GetAndCreateOutputDir(bool implib, bool create)
- {
- // The implib option is only allowed for shared libraries, module
- // libraries, and executables.
- if(this->GetType() != cmTarget::SHARED_LIBRARY &&
- this->GetType() != cmTarget::MODULE_LIBRARY &&
- this->GetType() != cmTarget::EXECUTABLE)
- {
- implib = false;
- }
- // Sanity check. Only generators on platforms supporting import
- // libraries should be asking for the import library output
- // directory.
- if(implib &&
- !this->Makefile->GetDefinition("CMAKE_IMPORT_LIBRARY_SUFFIX"))
- {
- abort();
- }
- if(implib && !this->DLLPlatform)
- {
- abort();
- }
- // Select whether we are constructing the directory for the main
- // target or the import library.
- std::string& out = implib? this->OutputDirImplib : this->OutputDir;
- if(out.empty())
- {
- // Look for a target property defining the target output directory
- // based on the target type.
- const char* propertyName = 0;
- switch(this->GetType())
- {
- case cmTarget::SHARED_LIBRARY:
- {
- // For non-DLL platforms shared libraries are treated as
- // library targets. For DLL platforms the DLL part of a
- // shared library is treated as a runtime target and the
- // corresponding import library is treated as an archive
- // target.
- if(this->DLLPlatform)
- {
- if(implib)
- {
- propertyName = "ARCHIVE_OUTPUT_DIRECTORY";
- }
- else
- {
- propertyName = "RUNTIME_OUTPUT_DIRECTORY";
- }
- }
- else
- {
- propertyName = "LIBRARY_OUTPUT_DIRECTORY";
- }
- } break;
- case cmTarget::STATIC_LIBRARY:
- {
- // Static libraries are always treated as archive targets.
- propertyName = "ARCHIVE_OUTPUT_DIRECTORY";
- } break;
- case cmTarget::MODULE_LIBRARY:
- {
- // Module libraries are always treated as library targets.
- // Module import libraries are treated as archive targets.
- if(implib)
- {
- propertyName = "ARCHIVE_OUTPUT_DIRECTORY";
- }
- else
- {
- propertyName = "LIBRARY_OUTPUT_DIRECTORY";
- }
- } break;
- case cmTarget::EXECUTABLE:
- {
- // Executables are always treated as runtime targets.
- // Executable import libraries are treated as archive targets.
- if(implib)
- {
- propertyName = "ARCHIVE_OUTPUT_DIRECTORY";
- }
- else
- {
- propertyName = "RUNTIME_OUTPUT_DIRECTORY";
- }
- } break;
- default: break;
- }
- // Select an output directory.
- if(const char* outdir = this->GetProperty(propertyName))
- {
- // Use the user-specified output directory.
- out = outdir;
- }
- else if(this->GetType() == cmTarget::EXECUTABLE)
- {
- // Lookup the output path for executables.
- out = this->Makefile->GetSafeDefinition("EXECUTABLE_OUTPUT_PATH");
- }
- else if(this->GetType() == cmTarget::STATIC_LIBRARY ||
- this->GetType() == cmTarget::SHARED_LIBRARY ||
- this->GetType() == cmTarget::MODULE_LIBRARY)
- {
- // Lookup the output path for libraries.
- out = this->Makefile->GetSafeDefinition("LIBRARY_OUTPUT_PATH");
- }
- if(out.empty())
- {
- // Default to the current output directory.
- out = ".";
- }
- // Convert the output path to a full path in case it is
- // specified as a relative path. Treat a relative path as
- // relative to the current output directory for this makefile.
- out =
- cmSystemTools::CollapseFullPath
- (out.c_str(), this->Makefile->GetStartOutputDirectory());
- if(this->IsFrameworkOnApple())
- {
- out += "/";
- out += this->GetFullName(0, implib);
- out += ".framework";
- }
- // Optionally make sure the output path exists on disk.
- if(create)
- {
- if(!cmSystemTools::MakeDirectory(out.c_str()))
- {
- cmSystemTools::Error("Error failed to create output directory: ",
- out.c_str());
- }
- }
- }
- return out.c_str();
- }
- //----------------------------------------------------------------------------
- const char* cmTarget::GetOutputDir(bool implib)
- {
- return this->GetAndCreateOutputDir(implib, true);
- }
- //----------------------------------------------------------------------------
- const char* cmTarget::GetExportMacro()
- {
- // Define the symbol for targets that export symbols.
- if(this->GetType() == cmTarget::SHARED_LIBRARY ||
- this->GetType() == cmTarget::MODULE_LIBRARY ||
- this->IsExecutableWithExports())
- {
- if(const char* custom_export_name = this->GetProperty("DEFINE_SYMBOL"))
- {
- this->ExportMacro = custom_export_name;
- }
- else
- {
- std::string in = this->GetName();
- in += "_EXPORTS";
- this->ExportMacro = cmSystemTools::MakeCindentifier(in.c_str());
- }
- return this->ExportMacro.c_str();
- }
- else
- {
- return 0;
- }
- }
- //----------------------------------------------------------------------------
- void cmTarget::GetLanguages(std::set<cmStdString>& languages) const
- {
- for(std::vector<cmSourceFile*>::const_iterator
- i = this->SourceFiles.begin(); i != this->SourceFiles.end(); ++i)
- {
- if(const char* lang = (*i)->GetLanguage())
- {
- languages.insert(lang);
- }
- }
- }
- //----------------------------------------------------------------------------
- bool cmTarget::IsChrpathUsed()
- {
- // Enable use of "chrpath" if it is available, the user has turned
- // on the feature, and the rpath flag uses a separator.
- if(const char* ll = this->GetLinkerLanguage(
- this->Makefile->GetLocalGenerator()->GetGlobalGenerator()))
- {
- std::string sepVar = "CMAKE_SHARED_LIBRARY_RUNTIME_";
- sepVar += ll;
- sepVar += "_FLAG_SEP";
- const char* sep = this->Makefile->GetDefinition(sepVar.c_str());
- if(sep && *sep)
- {
- if(this->Makefile->IsSet("CMAKE_CHRPATH") &&
- this->Makefile->IsOn("CMAKE_USE_CHRPATH"))
- {
- return true;
- }
- }
- }
- return false;
- }
- //----------------------------------------------------------------------------
- cmTarget::ImportInfo const*
- cmTarget::GetImportInfo(const char* config)
- {
- // There is no imported information for non-imported targets.
- if(!this->IsImported())
- {
- return 0;
- }
- // Lookup/compute/cache the import information for this
- // configuration.
- std::string config_upper;
- if(config && *config)
- {
- config_upper = cmSystemTools::UpperCase(config);
- }
- else
- {
- config_upper = "NOCONFIG";
- }
- ImportInfoMapType::const_iterator i =
- this->ImportInfoMap.find(config_upper);
- if(i == this->ImportInfoMap.end())
- {
- ImportInfo info;
- this->ComputeImportInfo(config_upper, info);
- ImportInfoMapType::value_type entry(config_upper, info);
- i = this->ImportInfoMap.insert(entry).first;
- }
- // If the location is empty then the target is not available for
- // this configuration.
- if(i->second.Location.empty())
- {
- return 0;
- }
- // Return the import information.
- return &i->second;
- }
- //----------------------------------------------------------------------------
- void cmTarget::ComputeImportInfo(std::string const& desired_config,
- ImportInfo& info)
- {
- // This method finds information about an imported target from its
- // properties. The "IMPORTED_" namespace is reserved for properties
- // defined by the project exporting the target.
- // Track the configuration-specific property suffix.
- std::string suffix = "_";
- suffix += desired_config;
- // Look for a mapping from the current project's configuration to
- // the imported project's configuration.
- std::vector<std::string> mappedConfigs;
- {
- std::string mapProp = "MAP_IMPORTED_CONFIG_";
- mapProp += desired_config;
- if(const char* mapValue = this->GetProperty(mapProp.c_str()))
- {
- cmSystemTools::ExpandListArgument(mapValue, mappedConfigs);
- }
- }
- // If a mapping was found, check its configurations.
- const char* loc = 0;
- for(std::vector<std::string>::const_iterator mci = mappedConfigs.begin();
- !loc && mci != mappedConfigs.end(); ++mci)
- {
- // Look for this configuration.
- std::string mcUpper = cmSystemTools::UpperCase(mci->c_str());
- std::string locProp = "IMPORTED_LOCATION_";
- locProp += mcUpper;
- loc = this->GetProperty(locProp.c_str());
- // If it was found, use it for all properties below.
- if(loc)
- {
- suffix = "_";
- suffix += mcUpper;
- }
- }
- // If we needed to find one of the mapped configurations but did not
- // then the target is not found. The project does not want any
- // other configuration.
- if(!mappedConfigs.empty() && !loc)
- {
- return;
- }
- // If we have not yet found it then there are no mapped
- // configurations. Look for an exact-match.
- if(!loc)
- {
- std::string locProp = "IMPORTED_LOCATION";
- locProp += suffix;
- loc = this->GetProperty(locProp.c_str());
- }
- // If we have not yet found it then there are no mapped
- // configurations and no exact match.
- if(!loc)
- {
- // The suffix computed above is not useful.
- suffix = "";
- // Look for a configuration-less location. This may be set by
- // manually-written code.
- loc = this->GetProperty("IMPORTED_LOCATION");
- }
- // If we have not yet found it then the project is willing to try
- // any available configuration.
- if(!loc)
- {
- std::vector<std::string> availableConfigs;
- if(const char* iconfigs = this->GetProperty("IMPORTED_CONFIGURATIONS"))
- {
- cmSystemTools::ExpandListArgument(iconfigs, availableConfigs);
- }
- for(std::vector<std::string>::const_iterator
- aci = availableConfigs.begin();
- !loc && aci != availableConfigs.end(); ++aci)
- {
- suffix = "_";
- suffix += cmSystemTools::UpperCase(availableConfigs[0]);
- std::string locProp = "IMPORTED_LOCATION";
- locProp += suffix;
- loc = this->GetProperty(locProp.c_str());
- }
- }
- // If we have not yet found it then the target is not available.
- if(!loc)
- {
- return;
- }
- // A provided configuration has been chosen. Load the
- // configuration's properties.
- info.Location = loc;
- // Get the soname.
- if(this->GetType() == cmTarget::SHARED_LIBRARY)
- {
- std::string soProp = "IMPORTED_SONAME";
- soProp += suffix;
- if(const char* config_soname = this->GetProperty(soProp.c_str()))
- {
- info.SOName = config_soname;
- }
- else if(const char* soname = this->GetProperty("IMPORTED_SONAME"))
- {
- info.SOName = soname;
- }
- }
- // Get the import library.
- if(this->GetType() == cmTarget::SHARED_LIBRARY ||
- this->IsExecutableWithExports())
- {
- std::string impProp = "IMPORTED_IMPLIB";
- impProp += suffix;
- if(const char* config_implib = this->GetProperty(impProp.c_str()))
- {
- info.ImportLibrary = config_implib;
- }
- else if(const char* implib = this->GetProperty("IMPORTED_IMPLIB"))
- {
- info.ImportLibrary = implib;
- }
- }
- // Get the link interface.
- {
- std::string linkProp = "IMPORTED_LINK_INTERFACE_LIBRARIES";
- linkProp += suffix;
- if(const char* config_libs = this->GetProperty(linkProp.c_str()))
- {
- cmSystemTools::ExpandListArgument(config_libs,
- info.LinkInterface.Libraries);
- }
- else if(const char* libs =
- this->GetProperty("IMPORTED_LINK_INTERFACE_LIBRARIES"))
- {
- cmSystemTools::ExpandListArgument(libs,
- info.LinkInterface.Libraries);
- }
- }
- // Get the link dependencies.
- {
- std::string linkProp = "IMPORTED_LINK_DEPENDENT_LIBRARIES";
- linkProp += suffix;
- if(const char* config_libs = this->GetProperty(linkProp.c_str()))
- {
- cmSystemTools::ExpandListArgument(config_libs,
- info.LinkInterface.SharedDeps);
- }
- else if(const char* libs =
- this->GetProperty("IMPORTED_LINK_DEPENDENT_LIBRARIES"))
- {
- cmSystemTools::ExpandListArgument(libs, info.LinkInterface.SharedDeps);
- }
- }
- }
- //----------------------------------------------------------------------------
- cmTargetLinkInterface const* cmTarget::GetLinkInterface(const char* config)
- {
- // Imported targets have their own link interface.
- if(this->IsImported())
- {
- if(cmTarget::ImportInfo const* info = this->GetImportInfo(config))
- {
- return &info->LinkInterface;
- }
- return 0;
- }
- // Link interfaces are supported only for shared libraries and
- // executables that export symbols.
- if((this->GetType() != cmTarget::SHARED_LIBRARY &&
- !this->IsExecutableWithExports()))
- {
- return 0;
- }
- // Lookup any existing link interface for this configuration.
- std::map<cmStdString, cmTargetLinkInterface*>::iterator
- i = this->LinkInterface.find(config?config:"");
- if(i == this->LinkInterface.end())
- {
- // Compute the link interface for this configuration.
- cmTargetLinkInterface* interface = this->ComputeLinkInterface(config);
- // Store the information for this configuration.
- std::map<cmStdString, cmTargetLinkInterface*>::value_type
- entry(config?config:"", interface);
- i = this->LinkInterface.insert(entry).first;
- }
- return i->second;
- }
- //----------------------------------------------------------------------------
- cmTargetLinkInterface* cmTarget::ComputeLinkInterface(const char* config)
- {
- // Construct the property name suffix for this configuration.
- std::string suffix = "_";
- if(config && *config)
- {
- suffix += cmSystemTools::UpperCase(config);
- }
- else
- {
- suffix += "NOCONFIG";
- }
- // Lookup the link interface libraries.
- const char* libs = 0;
- {
- // Lookup the per-configuration property.
- std::string propName = "LINK_INTERFACE_LIBRARIES";
- propName += suffix;
- libs = this->GetProperty(propName.c_str());
- // If not set, try the generic property.
- if(!libs)
- {
- libs = this->GetProperty("LINK_INTERFACE_LIBRARIES");
- }
- }
- // If still not set, there is no link interface.
- if(!libs)
- {
- return 0;
- }
- // Allocate the interface.
- cmTargetLinkInterface* interface = new cmTargetLinkInterface;
- if(!interface)
- {
- return 0;
- }
- // Expand the list of libraries in the interface.
- cmSystemTools::ExpandListArgument(libs, interface->Libraries);
- // Now we need to construct a list of shared library dependencies
- // not included in the interface.
- if(this->GetType() == cmTarget::SHARED_LIBRARY)
- {
- // Use a set to keep track of what libraries have been emitted to
- // either list.
- std::set<cmStdString> emitted;
- for(std::vector<std::string>::const_iterator
- li = interface->Libraries.begin();
- li != interface->Libraries.end(); ++li)
- {
- emitted.insert(*li);
- }
- // Compute which library configuration to link.
- cmTarget::LinkLibraryType linkType = cmTarget::OPTIMIZED;
- if(config && cmSystemTools::UpperCase(config) == "DEBUG")
- {
- linkType = cmTarget::DEBUG;
- }
- // Construct the list of libs linked for this configuration.
- cmTarget::LinkLibraryVectorType const& llibs =
- this->GetOriginalLinkLibraries();
- for(cmTarget::LinkLibraryVectorType::const_iterator li = llibs.begin();
- li != llibs.end(); ++li)
- {
- // Skip entries that will resolve to the target itself, are empty,
- // or are not meant for this configuration.
- if(li->first == this->GetName() || li->first.empty() ||
- !(li->second == cmTarget::GENERAL || li->second == linkType))
- {
- continue;
- }
- // Skip entries that have already been emitted into either list.
- if(!emitted.insert(li->first).second)
- {
- continue;
- }
- // Add this entry if it is a shared library.
- if(cmTarget* tgt = this->Makefile->FindTargetToUse(li->first.c_str()))
- {
- if(tgt->GetType() == cmTarget::SHARED_LIBRARY)
- {
- interface->SharedDeps.push_back(li->first);
- }
- }
- else
- {
- // TODO: Recognize shared library file names. Perhaps this
- // should be moved to cmComputeLinkInformation, but that creates
- // a chicken-and-egg problem since this list is needed for its
- // construction.
- }
- }
- }
- // Return the completed interface.
- return interface;
- }
- //----------------------------------------------------------------------------
- cmComputeLinkInformation*
- cmTarget::GetLinkInformation(const char* config)
- {
- // Lookup any existing information for this configuration.
- std::map<cmStdString, cmComputeLinkInformation*>::iterator
- i = this->LinkInformation.find(config?config:"");
- if(i == this->LinkInformation.end())
- {
- // Compute information for this configuration.
- cmComputeLinkInformation* info =
- new cmComputeLinkInformation(this, config);
- if(!info || !info->Compute())
- {
- delete info;
- info = 0;
- }
- // Store the information for this configuration.
- std::map<cmStdString, cmComputeLinkInformation*>::value_type
- entry(config?config:"", info);
- i = this->LinkInformation.insert(entry).first;
- }
- return i->second;
- }
- //----------------------------------------------------------------------------
- cmTargetLinkInformationMap
- ::cmTargetLinkInformationMap(cmTargetLinkInformationMap const& r): derived()
- {
- // Ideally cmTarget instances should never be copied. However until
- // we can make a sweep to remove that, this copy constructor avoids
- // allowing the resources (LinkInformation) from getting copied. In
- // the worst case this will lead to extra cmComputeLinkInformation
- // instances. We also enforce in debug mode that the map be emptied
- // when copied.
- static_cast<void>(r);
- assert(r.empty());
- }
- //----------------------------------------------------------------------------
- cmTargetLinkInformationMap::~cmTargetLinkInformationMap()
- {
- for(derived::iterator i = this->begin(); i != this->end(); ++i)
- {
- delete i->second;
- }
- }
- //----------------------------------------------------------------------------
- cmTargetLinkInterfaceMap
- ::cmTargetLinkInterfaceMap(cmTargetLinkInterfaceMap const& r): derived()
- {
- // Ideally cmTarget instances should never be copied. However until
- // we can make a sweep to remove that, this copy constructor avoids
- // allowing the resources (LinkInterface) from getting copied. In
- // the worst case this will lead to extra cmTargetLinkInterface
- // instances. We also enforce in debug mode that the map be emptied
- // when copied.
- static_cast<void>(r);
- assert(r.empty());
- }
- //----------------------------------------------------------------------------
- cmTargetLinkInterfaceMap::~cmTargetLinkInterfaceMap()
- {
- for(derived::iterator i = this->begin(); i != this->end(); ++i)
- {
- delete i->second;
- }
- }
|