cmakemain.cxx 38 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185
  1. /* Distributed under the OSI-approved BSD 3-Clause License. See accompanying
  2. file LICENSE.rst or https://cmake.org/licensing for details. */
  3. #include "cmConfigure.h" // IWYU pragma: keep
  4. #include <algorithm>
  5. #include <cassert>
  6. #include <cctype>
  7. #include <climits>
  8. #include <cstdio>
  9. #include <cstring>
  10. #include <functional>
  11. #include <iostream>
  12. #include <sstream>
  13. #include <string>
  14. #include <utility>
  15. #include <vector>
  16. #include <cm/optional>
  17. #include <cmext/algorithm>
  18. #include <cm3p/uv.h>
  19. #include "cmBuildOptions.h"
  20. #include "cmCommandLineArgument.h"
  21. #include "cmDocumentationEntry.h"
  22. #include "cmGlobalGenerator.h"
  23. #include "cmInstallScriptHandler.h"
  24. #include "cmInstrumentation.h"
  25. #include "cmInstrumentationQuery.h"
  26. #include "cmList.h"
  27. #include "cmMakefile.h"
  28. #include "cmMessageMetadata.h"
  29. #include "cmState.h"
  30. #include "cmStateTypes.h"
  31. #include "cmStdIoConsole.h"
  32. #include "cmStdIoInit.h"
  33. #include "cmStringAlgorithms.h"
  34. #include "cmSystemTools.h"
  35. #include "cmValue.h"
  36. #include "cmake.h"
  37. #include "cmcmd.h"
  38. #ifndef CMAKE_BOOTSTRAP
  39. # include "cmDocumentation.h"
  40. #endif
  41. #include "cmsys/Encoding.hxx"
  42. #include "cmsys/RegularExpression.hxx"
  43. #include "cmsys/Terminal.h"
  44. namespace {
  45. #ifndef CMAKE_BOOTSTRAP
  46. cmDocumentationEntry const cmDocumentationName = {
  47. {},
  48. " cmake - Cross-Platform Makefile Generator."
  49. };
  50. cmDocumentationEntry const cmDocumentationUsage[2] = {
  51. { {},
  52. " cmake [options] <path-to-source>\n"
  53. " cmake [options] <path-to-existing-build>\n"
  54. " cmake [options] -S <path-to-source> -B <path-to-build>" },
  55. { {},
  56. "Specify a source directory to (re-)generate a build system for "
  57. "it in the current working directory. Specify an existing build "
  58. "directory to re-generate its build system." }
  59. };
  60. cmDocumentationEntry const cmDocumentationUsageNote = {
  61. {},
  62. "Run 'cmake --help' for more information."
  63. };
  64. cmDocumentationEntry const cmDocumentationOptions[35] = {
  65. { "--preset <preset>,--preset=<preset>", "Specify a configure preset." },
  66. { "--list-presets[=<type>]", "List available presets." },
  67. { "--workflow [<options>]", "Run a workflow preset." },
  68. { "-E", "CMake command mode. Run \"cmake -E\" for a summary of commands." },
  69. { "-L[A][H]", "List non-advanced cached variables." },
  70. { "-LR[A][H] <regex>", "Show cached variables that match the regex." },
  71. { "--fresh",
  72. "Configure a fresh build tree, removing any existing cache file." },
  73. { "--build <dir>",
  74. "Build a CMake-generated project binary tree. Run \"cmake --build\" to "
  75. "see compatible options and a quick help." },
  76. { "--install <dir>",
  77. "Install a CMake-generated project binary tree. Run \"cmake --install\" "
  78. "to see compatible options and a quick help." },
  79. { "--open <dir>", "Open generated project in the associated application." },
  80. { "-N", "View mode only." },
  81. { "-P <file>", "Process script mode." },
  82. { "--find-package", "Legacy pkg-config like mode. Do not use." },
  83. { "--graphviz=<file>",
  84. "Generate graphviz of dependencies, see CMakeGraphVizOptions.cmake for "
  85. "more." },
  86. { "--system-information [file]", "Dump information about this system." },
  87. { "--print-config-dir",
  88. "Print CMake config directory for user-wide FileAPI queries." },
  89. { "--log-level=<ERROR|WARNING|NOTICE|STATUS|VERBOSE|DEBUG|TRACE>",
  90. "Set the verbosity of messages from CMake files. "
  91. "--loglevel is also accepted for backward compatibility reasons." },
  92. { "--log-context", "Prepend log messages with context, if given" },
  93. { "--debug-trycompile",
  94. "Do not delete the try_compile build tree. Only "
  95. "useful on one try_compile at a time." },
  96. { "--debug-output", "Put cmake in a debug mode." },
  97. { "--debug-find", "Put cmake find in a debug mode." },
  98. { "--debug-find-pkg=<pkg-name>[,...]",
  99. "Limit cmake debug-find to the comma-separated list of packages" },
  100. { "--debug-find-var=<var-name>[,...]",
  101. "Limit cmake debug-find to the comma-separated list of result variables" },
  102. { "--trace", "Put cmake in trace mode." },
  103. { "--trace-expand", "Put cmake in trace mode with variable expansion." },
  104. { "--trace-format=<human|json-v1>", "Set the output format of the trace." },
  105. { "--trace-source=<file>",
  106. "Trace only this CMake file/module. Multiple options allowed." },
  107. { "--trace-redirect=<file>",
  108. "Redirect trace output to a file instead of stderr." },
  109. { "--warn-uninitialized", "Warn about uninitialized values." },
  110. { "--no-warn-unused-cli", "Don't warn about command line options." },
  111. { "--check-system-vars",
  112. "Find problems with variable usage in system files." },
  113. { "--compile-no-warning-as-error",
  114. "Ignore COMPILE_WARNING_AS_ERROR property and "
  115. "CMAKE_COMPILE_WARNING_AS_ERROR variable." },
  116. { "--link-no-warning-as-error",
  117. "Ignore LINK_WARNING_AS_ERROR property and "
  118. "CMAKE_LINK_WARNING_AS_ERROR variable." },
  119. { "--profiling-format=<fmt>",
  120. "Output data for profiling CMake scripts. Supported formats: "
  121. "google-trace" },
  122. { "--profiling-output=<file>",
  123. "Select an output path for the profiling data enabled through "
  124. "--profiling-format." }
  125. };
  126. #endif
  127. int do_command(int ac, char const* const* av,
  128. cm::optional<cm::StdIo::Console> console)
  129. {
  130. std::vector<std::string> args;
  131. args.reserve(ac - 1);
  132. args.emplace_back(av[0]);
  133. cm::append(args, av + 2, av + ac);
  134. return cmcmd::ExecuteCMakeCommand(args, std::move(console));
  135. }
  136. cmMakefile* cmakemainGetMakefile(cmake* cm)
  137. {
  138. if (cm && cm->GetDebugOutput()) {
  139. cmGlobalGenerator* gg = cm->GetGlobalGenerator();
  140. if (gg) {
  141. return gg->GetCurrentMakefile();
  142. }
  143. }
  144. return nullptr;
  145. }
  146. std::string cmakemainGetStack(cmake* cm)
  147. {
  148. std::string msg;
  149. cmMakefile* mf = cmakemainGetMakefile(cm);
  150. if (mf) {
  151. msg = mf->FormatListFileStack();
  152. if (!msg.empty()) {
  153. msg = "\n Called from: " + msg;
  154. }
  155. }
  156. return msg;
  157. }
  158. void cmakemainMessageCallback(std::string const& m,
  159. cmMessageMetadata const& md, cmake* cm)
  160. {
  161. #if defined(_WIN32)
  162. // FIXME: On Windows we replace cerr's streambuf with a custom
  163. // implementation that converts our internal UTF-8 encoding to the
  164. // console's encoding. It also does *not* replace LF with CRLF.
  165. // Since stderr does not convert encoding and does convert LF, we
  166. // cannot use it to print messages. Another implementation will
  167. // be needed to print colored messages on Windows.
  168. static_cast<void>(md);
  169. std::cerr << m << cmakemainGetStack(cm) << std::endl;
  170. #else
  171. cmsysTerminal_cfprintf(md.desiredColor, stderr, "%s", m.c_str());
  172. fflush(stderr); // stderr is buffered in some cases.
  173. std::cerr << cmakemainGetStack(cm) << std::endl;
  174. #endif
  175. }
  176. void cmakemainProgressCallback(std::string const& m, float prog, cmake* cm)
  177. {
  178. cmMakefile* mf = cmakemainGetMakefile(cm);
  179. std::string dir;
  180. if (mf && cmHasLiteralPrefix(m, "Configuring") && (prog < 0)) {
  181. dir = cmStrCat(' ', mf->GetCurrentSourceDirectory());
  182. } else if (mf && cmHasLiteralPrefix(m, "Generating")) {
  183. dir = cmStrCat(' ', mf->GetCurrentBinaryDirectory());
  184. }
  185. if ((prog < 0) || (!dir.empty())) {
  186. std::cout << "-- " << m << dir << cmakemainGetStack(cm) << std::endl;
  187. }
  188. }
  189. std::function<bool(std::string const& value)> getShowCachedCallback(
  190. bool& show_flag, bool* help_flag = nullptr, std::string* filter = nullptr)
  191. {
  192. return [=, &show_flag](std::string const& value) -> bool {
  193. show_flag = true;
  194. if (help_flag) {
  195. *help_flag = true;
  196. }
  197. if (filter) {
  198. *filter = value;
  199. }
  200. return true;
  201. };
  202. }
  203. int do_cmake(int ac, char const* const* av)
  204. {
  205. if (cmSystemTools::GetLogicalWorkingDirectory().empty()) {
  206. std::cerr << "Current working directory cannot be established."
  207. << std::endl;
  208. return 1;
  209. }
  210. #ifndef CMAKE_BOOTSTRAP
  211. cmDocumentation doc;
  212. doc.addCMakeStandardDocSections();
  213. if (doc.CheckOptions(ac, av, "--")) {
  214. // Construct and print requested documentation.
  215. cmake hcm(cmake::RoleInternal, cmState::Help);
  216. hcm.SetHomeDirectory("");
  217. hcm.SetHomeOutputDirectory("");
  218. hcm.AddCMakePaths();
  219. // the command line args are processed here so that you can do
  220. // -DCMAKE_MODULE_PATH=/some/path and have this value accessible here
  221. std::vector<std::string> args(av, av + ac);
  222. hcm.SetCacheArgs(args);
  223. auto generators = hcm.GetGeneratorsDocumentation();
  224. doc.SetName("cmake");
  225. doc.SetSection("Name", cmDocumentationName);
  226. doc.SetSection("Usage", cmDocumentationUsage);
  227. if (ac == 1) {
  228. doc.AppendSection("Usage", cmDocumentationUsageNote);
  229. }
  230. doc.AppendSection("Generators", generators);
  231. doc.PrependSection("Options", cmDocumentationOptions);
  232. doc.PrependSection("Options", cmake::CMAKE_STANDARD_OPTIONS_TABLE);
  233. return !doc.PrintRequestedDocumentation(std::cout);
  234. }
  235. #else
  236. if (ac == 1) {
  237. std::cout
  238. << "Bootstrap CMake should not be used outside CMake build process."
  239. << std::endl;
  240. return 0;
  241. }
  242. #endif
  243. bool wizard_mode = false;
  244. bool sysinfo = false;
  245. bool list_cached = false;
  246. bool list_all_cached = false;
  247. bool list_help = false;
  248. // (Regex) Filter on the cached variable(s) to print.
  249. std::string filter_var_name;
  250. bool view_only = false;
  251. cmake::WorkingMode workingMode = cmake::NORMAL_MODE;
  252. std::vector<std::string> parsedArgs;
  253. using CommandArgument =
  254. cmCommandLineArgument<bool(std::string const& value)>;
  255. std::vector<CommandArgument> arguments = {
  256. CommandArgument{
  257. "-i", CommandArgument::Values::Zero,
  258. [&wizard_mode](std::string const&) -> bool {
  259. /* clang-format off */
  260. std::cerr <<
  261. "The \"cmake -i\" wizard mode is no longer supported.\n"
  262. "Use the -D option to set cache values on the command line.\n"
  263. "Use cmake-gui or ccmake for an interactive dialog.\n";
  264. /* clang-format on */
  265. wizard_mode = true;
  266. return true;
  267. } },
  268. CommandArgument{ "--system-information", CommandArgument::Values::Zero,
  269. CommandArgument::setToTrue(sysinfo) },
  270. CommandArgument{ "-N", CommandArgument::Values::Zero,
  271. CommandArgument::setToTrue(view_only) },
  272. CommandArgument{ "-LAH", CommandArgument::Values::Zero,
  273. getShowCachedCallback(list_all_cached, &list_help) },
  274. CommandArgument{ "-LA", CommandArgument::Values::Zero,
  275. getShowCachedCallback(list_all_cached) },
  276. CommandArgument{ "-LH", CommandArgument::Values::Zero,
  277. getShowCachedCallback(list_cached, &list_help) },
  278. CommandArgument{ "-L", CommandArgument::Values::Zero,
  279. getShowCachedCallback(list_cached) },
  280. CommandArgument{
  281. "-LRAH", CommandArgument::Values::One,
  282. getShowCachedCallback(list_all_cached, &list_help, &filter_var_name) },
  283. CommandArgument{
  284. "-LRA", CommandArgument::Values::One,
  285. getShowCachedCallback(list_all_cached, nullptr, &filter_var_name) },
  286. CommandArgument{
  287. "-LRH", CommandArgument::Values::One,
  288. getShowCachedCallback(list_cached, &list_help, &filter_var_name) },
  289. CommandArgument{
  290. "-LR", CommandArgument::Values::One,
  291. getShowCachedCallback(list_cached, nullptr, &filter_var_name) },
  292. CommandArgument{ "-P", "No script specified for argument -P",
  293. CommandArgument::Values::One,
  294. CommandArgument::RequiresSeparator::No,
  295. [&](std::string const& value) -> bool {
  296. workingMode = cmake::SCRIPT_MODE;
  297. parsedArgs.emplace_back("-P");
  298. parsedArgs.push_back(value);
  299. return true;
  300. } },
  301. CommandArgument{ "--find-package", CommandArgument::Values::Zero,
  302. [&](std::string const&) -> bool {
  303. workingMode = cmake::FIND_PACKAGE_MODE;
  304. parsedArgs.emplace_back("--find-package");
  305. return true;
  306. } },
  307. CommandArgument{ "--list-presets", CommandArgument::Values::ZeroOrOne,
  308. [&](std::string const& value) -> bool {
  309. workingMode = cmake::HELP_MODE;
  310. parsedArgs.emplace_back("--list-presets");
  311. parsedArgs.emplace_back(value);
  312. return true;
  313. } },
  314. };
  315. std::vector<std::string> inputArgs;
  316. inputArgs.reserve(ac);
  317. cm::append(inputArgs, av, av + ac);
  318. for (decltype(inputArgs.size()) i = 0; i < inputArgs.size(); ++i) {
  319. std::string const& arg = inputArgs[i];
  320. bool matched = false;
  321. // Only in script mode do we stop parsing instead
  322. // of preferring the last mode flag provided
  323. if (arg == "--" && workingMode == cmake::SCRIPT_MODE) {
  324. parsedArgs = inputArgs;
  325. break;
  326. }
  327. for (auto const& m : arguments) {
  328. if (m.matches(arg)) {
  329. matched = true;
  330. if (m.parse(arg, i, inputArgs)) {
  331. break;
  332. }
  333. return 1; // failed to parse
  334. }
  335. }
  336. if (!matched) {
  337. parsedArgs.emplace_back(av[i]);
  338. }
  339. }
  340. if (wizard_mode) {
  341. return 1;
  342. }
  343. if (sysinfo) {
  344. cmake cm(cmake::RoleProject, cmState::Project);
  345. cm.SetHomeDirectory("");
  346. cm.SetHomeOutputDirectory("");
  347. int ret = cm.GetSystemInformation(parsedArgs);
  348. return ret;
  349. }
  350. cmake::Role const role =
  351. workingMode == cmake::SCRIPT_MODE ? cmake::RoleScript : cmake::RoleProject;
  352. cmState::Mode mode = cmState::Unknown;
  353. switch (workingMode) {
  354. case cmake::NORMAL_MODE:
  355. case cmake::HELP_MODE:
  356. mode = cmState::Project;
  357. break;
  358. case cmake::SCRIPT_MODE:
  359. mode = cmState::Script;
  360. break;
  361. case cmake::FIND_PACKAGE_MODE:
  362. mode = cmState::FindPackage;
  363. break;
  364. }
  365. auto const failurePolicy = workingMode == cmake::NORMAL_MODE
  366. ? cmake::CommandFailureAction::EXIT_CODE
  367. : cmake::CommandFailureAction::FATAL_ERROR;
  368. cmake cm(role, mode);
  369. cm.SetHomeDirectory("");
  370. cm.SetHomeOutputDirectory("");
  371. cmSystemTools::SetMessageCallback(
  372. [&cm](std::string const& msg, cmMessageMetadata const& md) {
  373. cmakemainMessageCallback(msg, md, &cm);
  374. });
  375. cm.SetProgressCallback([&cm](std::string const& msg, float prog) {
  376. cmakemainProgressCallback(msg, prog, &cm);
  377. });
  378. cm.SetWorkingMode(workingMode, failurePolicy);
  379. int res = cm.Run(parsedArgs, view_only);
  380. if (list_cached || list_all_cached) {
  381. std::cout << "-- Cache values" << std::endl;
  382. std::vector<std::string> keys = cm.GetState()->GetCacheEntryKeys();
  383. cmsys::RegularExpression regex_var_name;
  384. if (!filter_var_name.empty()) {
  385. regex_var_name.compile(filter_var_name);
  386. }
  387. for (std::string const& k : keys) {
  388. if (regex_var_name.is_valid() && !regex_var_name.find(k)) {
  389. continue;
  390. }
  391. cmStateEnums::CacheEntryType t = cm.GetState()->GetCacheEntryType(k);
  392. if (t != cmStateEnums::INTERNAL && t != cmStateEnums::STATIC &&
  393. t != cmStateEnums::UNINITIALIZED) {
  394. cmValue advancedProp =
  395. cm.GetState()->GetCacheEntryProperty(k, "ADVANCED");
  396. if (list_all_cached || !advancedProp) {
  397. if (list_help) {
  398. cmValue help =
  399. cm.GetState()->GetCacheEntryProperty(k, "HELPSTRING");
  400. std::cout << "// " << (help ? *help : "") << std::endl;
  401. }
  402. std::cout << k << ":" << cmState::CacheEntryTypeToString(t) << "="
  403. << cm.GetState()->GetSafeCacheEntryValue(k) << std::endl;
  404. if (list_help) {
  405. std::cout << std::endl;
  406. }
  407. }
  408. }
  409. }
  410. }
  411. // Always return a non-negative value (except exit code from SCRIPT_MODE).
  412. // Windows tools do not always interpret negative return values as errors.
  413. if (res != 0) {
  414. auto scriptModeExitCode =
  415. cm.HasScriptModeExitCode() ? cm.GetScriptModeExitCode() : 0;
  416. res = scriptModeExitCode ? scriptModeExitCode : 1;
  417. #ifdef CMake_ENABLE_DEBUGGER
  418. cm.StopDebuggerIfNeeded(res);
  419. #endif
  420. return res;
  421. }
  422. #ifdef CMake_ENABLE_DEBUGGER
  423. cm.StopDebuggerIfNeeded(0);
  424. #endif
  425. return 0;
  426. }
  427. #ifndef CMAKE_BOOTSTRAP
  428. int extract_job_number(std::string const& command,
  429. std::string const& jobString)
  430. {
  431. int jobs = -1;
  432. unsigned long numJobs = 0;
  433. if (jobString.empty()) {
  434. jobs = cmake::DEFAULT_BUILD_PARALLEL_LEVEL;
  435. } else if (cmStrToULong(jobString, &numJobs)) {
  436. if (numJobs == 0) {
  437. std::cerr
  438. << "The <jobs> value requires a positive integer argument.\n\n";
  439. } else if (numJobs > INT_MAX) {
  440. std::cerr << "The <jobs> value is too large.\n\n";
  441. } else {
  442. jobs = static_cast<int>(numJobs);
  443. }
  444. } else {
  445. std::cerr << "'" << command << "' invalid number '" << jobString
  446. << "' given.\n\n";
  447. }
  448. return jobs;
  449. }
  450. std::function<bool(std::string const&)> extract_job_number_lambda_builder(
  451. std::string& dir, int& jobs, std::string const& flag)
  452. {
  453. return [&dir, &jobs, flag](std::string const& value) -> bool {
  454. jobs = extract_job_number(flag, value);
  455. if (jobs < 0) {
  456. dir.clear();
  457. }
  458. return true;
  459. };
  460. };
  461. #endif
  462. int do_build(int ac, char const* const* av)
  463. {
  464. #ifdef CMAKE_BOOTSTRAP
  465. std::cerr << "This cmake does not support --build\n";
  466. return -1;
  467. #else
  468. int jobs = cmake::NO_BUILD_PARALLEL_LEVEL;
  469. std::vector<std::string> targets;
  470. std::string config;
  471. std::string dir;
  472. std::vector<std::string> nativeOptions;
  473. bool nativeOptionsPassed = false;
  474. bool cleanFirst = false;
  475. bool foundClean = false;
  476. bool foundNonClean = false;
  477. PackageResolveMode resolveMode = PackageResolveMode::Default;
  478. bool verbose = cmSystemTools::HasEnv("VERBOSE");
  479. std::string presetName;
  480. bool listPresets = false;
  481. auto jLambda = extract_job_number_lambda_builder(dir, jobs, "-j");
  482. auto parallelLambda =
  483. extract_job_number_lambda_builder(dir, jobs, "--parallel");
  484. auto targetLambda = [&](std::string const& value) -> bool {
  485. if (!value.empty()) {
  486. cmList values{ value };
  487. for (auto const& v : values) {
  488. targets.emplace_back(v);
  489. if (v == "clean") {
  490. foundClean = true;
  491. } else {
  492. foundNonClean = true;
  493. }
  494. }
  495. return true;
  496. }
  497. return false;
  498. };
  499. auto resolvePackagesLambda = [&](std::string const& value) -> bool {
  500. std::string v = value;
  501. std::transform(v.begin(), v.end(), v.begin(), ::tolower);
  502. if (v == "on") {
  503. resolveMode = PackageResolveMode::Force;
  504. } else if (v == "only") {
  505. resolveMode = PackageResolveMode::OnlyResolve;
  506. } else if (v == "off") {
  507. resolveMode = PackageResolveMode::Disable;
  508. } else {
  509. return false;
  510. }
  511. return true;
  512. };
  513. auto verboseLambda = [&](std::string const&) -> bool {
  514. verbose = true;
  515. return true;
  516. };
  517. using CommandArgument =
  518. cmCommandLineArgument<bool(std::string const& value)>;
  519. std::vector<CommandArgument> arguments = {
  520. CommandArgument{ "--preset", CommandArgument::Values::One,
  521. CommandArgument::setToValue(presetName) },
  522. CommandArgument{ "--list-presets", CommandArgument::Values::Zero,
  523. CommandArgument::setToTrue(listPresets) },
  524. CommandArgument{ "-j", CommandArgument::Values::ZeroOrOne,
  525. CommandArgument::RequiresSeparator::No, jLambda },
  526. CommandArgument{ "--parallel", CommandArgument::Values::ZeroOrOne,
  527. CommandArgument::RequiresSeparator::No, parallelLambda },
  528. CommandArgument{ "-t", CommandArgument::Values::OneOrMore, targetLambda },
  529. CommandArgument{ "--target", CommandArgument::Values::OneOrMore,
  530. targetLambda },
  531. CommandArgument{ "--config", CommandArgument::Values::One,
  532. CommandArgument::setToValue(config) },
  533. CommandArgument{ "--clean-first", CommandArgument::Values::Zero,
  534. CommandArgument::setToTrue(cleanFirst) },
  535. CommandArgument{ "--resolve-package-references",
  536. CommandArgument::Values::One, resolvePackagesLambda },
  537. CommandArgument{ "-v", CommandArgument::Values::Zero, verboseLambda },
  538. CommandArgument{ "--verbose", CommandArgument::Values::Zero,
  539. verboseLambda },
  540. /* legacy option no-op*/
  541. CommandArgument{ "--use-stderr", CommandArgument::Values::Zero,
  542. [](std::string const&) -> bool { return true; } },
  543. CommandArgument{ "--", CommandArgument::Values::Zero,
  544. CommandArgument::setToTrue(nativeOptionsPassed) },
  545. };
  546. if (ac >= 3) {
  547. std::vector<std::string> inputArgs;
  548. inputArgs.reserve(ac - 2);
  549. cm::append(inputArgs, av + 2, av + ac);
  550. decltype(inputArgs.size()) i = 0;
  551. for (; i < inputArgs.size() && !nativeOptionsPassed; ++i) {
  552. std::string const& arg = inputArgs[i];
  553. bool matched = false;
  554. bool parsed = false;
  555. for (auto const& m : arguments) {
  556. matched = m.matches(arg);
  557. if (matched) {
  558. parsed = m.parse(arg, i, inputArgs);
  559. break;
  560. }
  561. }
  562. if (!matched && i == 0) {
  563. dir = cmSystemTools::ToNormalizedPathOnDisk(arg);
  564. matched = true;
  565. parsed = true;
  566. }
  567. if (!(matched && parsed)) {
  568. dir.clear();
  569. if (!matched) {
  570. std::cerr << "Unknown argument " << arg << std::endl;
  571. }
  572. break;
  573. }
  574. }
  575. if (nativeOptionsPassed) {
  576. cm::append(nativeOptions, inputArgs.begin() + i, inputArgs.end());
  577. }
  578. }
  579. if (foundClean && foundNonClean) {
  580. std::cerr << "Error: Building 'clean' and other targets together "
  581. "is not supported."
  582. << std::endl;
  583. dir.clear();
  584. }
  585. if (jobs == cmake::NO_BUILD_PARALLEL_LEVEL) {
  586. std::string parallel;
  587. if (cmSystemTools::GetEnv("CMAKE_BUILD_PARALLEL_LEVEL", parallel)) {
  588. if (parallel.empty()) {
  589. jobs = cmake::DEFAULT_BUILD_PARALLEL_LEVEL;
  590. } else {
  591. unsigned long numJobs = 0;
  592. if (cmStrToULong(parallel, &numJobs)) {
  593. if (numJobs == 0) {
  594. std::cerr << "The CMAKE_BUILD_PARALLEL_LEVEL environment variable "
  595. "requires a positive integer argument.\n\n";
  596. dir.clear();
  597. } else if (numJobs > INT_MAX) {
  598. std::cerr << "The CMAKE_BUILD_PARALLEL_LEVEL environment variable "
  599. "is too large.\n\n";
  600. dir.clear();
  601. } else {
  602. jobs = static_cast<int>(numJobs);
  603. }
  604. } else {
  605. std::cerr << "'CMAKE_BUILD_PARALLEL_LEVEL' environment variable\n"
  606. << "invalid number '" << parallel << "' given.\n\n";
  607. dir.clear();
  608. }
  609. }
  610. }
  611. }
  612. if (dir.empty() && presetName.empty() && !listPresets) {
  613. /* clang-format off */
  614. std::cerr <<
  615. "Usage: cmake --build <dir> "
  616. " [options] [-- [native-options]]\n"
  617. " cmake --build --preset <preset>"
  618. " [options] [-- [native-options]]\n"
  619. "Options:\n"
  620. " <dir> = Project binary directory to be built.\n"
  621. " --preset <preset>, --preset=<preset>\n"
  622. " = Specify a build preset.\n"
  623. " --list-presets[=<type>]\n"
  624. " = List available build presets.\n"
  625. " --parallel [<jobs>], -j [<jobs>]\n"
  626. " = Build in parallel using the given number of jobs. \n"
  627. " If <jobs> is omitted the native build tool's \n"
  628. " default number is used.\n"
  629. " The CMAKE_BUILD_PARALLEL_LEVEL environment "
  630. "variable\n"
  631. " specifies a default parallel level when this "
  632. "option\n"
  633. " is not given.\n"
  634. " -t <tgt>..., --target <tgt>...\n"
  635. " = Build <tgt> instead of default targets.\n"
  636. " --config <cfg> = For multi-configuration tools, choose <cfg>.\n"
  637. " --clean-first = Build target 'clean' first, then build.\n"
  638. " (To clean only, use --target 'clean'.)\n"
  639. " --resolve-package-references={on|only|off}\n"
  640. " = Restore/resolve package references during build.\n"
  641. " -v, --verbose = Enable verbose output - if supported - including\n"
  642. " the build commands to be executed. \n"
  643. " -- = Pass remaining options to the native tool.\n"
  644. ;
  645. /* clang-format on */
  646. return 1;
  647. }
  648. cmake cm(cmake::RoleInternal, cmState::Project);
  649. cmSystemTools::SetMessageCallback(
  650. [&cm](std::string const& msg, cmMessageMetadata const& md) {
  651. cmakemainMessageCallback(msg, md, &cm);
  652. });
  653. cm.SetProgressCallback([&cm](std::string const& msg, float prog) {
  654. cmakemainProgressCallback(msg, prog, &cm);
  655. });
  656. cmBuildOptions buildOptions(cleanFirst, false, resolveMode);
  657. std::vector<std::string> cmd;
  658. cm::append(cmd, av, av + ac);
  659. return cm.Build(jobs, dir, std::move(targets), std::move(config),
  660. std::move(nativeOptions), buildOptions, verbose, presetName,
  661. listPresets, cmd);
  662. #endif
  663. }
  664. bool parse_default_directory_permissions(std::string const& permissions,
  665. std::string& parsedPermissionsVar)
  666. {
  667. std::vector<std::string> parsedPermissions;
  668. enum Doing
  669. {
  670. DoingNone,
  671. DoingOwner,
  672. DoingGroup,
  673. DoingWorld,
  674. DoingOwnerAssignment,
  675. DoingGroupAssignment,
  676. DoingWorldAssignment,
  677. };
  678. Doing doing = DoingNone;
  679. auto uniquePushBack = [&parsedPermissions](std::string const& e) {
  680. if (std::find(parsedPermissions.begin(), parsedPermissions.end(), e) ==
  681. parsedPermissions.end()) {
  682. parsedPermissions.push_back(e);
  683. }
  684. };
  685. for (auto const& e : permissions) {
  686. switch (doing) {
  687. case DoingNone:
  688. if (e == 'u') {
  689. doing = DoingOwner;
  690. } else if (e == 'g') {
  691. doing = DoingGroup;
  692. } else if (e == 'o') {
  693. doing = DoingWorld;
  694. } else {
  695. return false;
  696. }
  697. break;
  698. case DoingOwner:
  699. if (e == '=') {
  700. doing = DoingOwnerAssignment;
  701. } else {
  702. return false;
  703. }
  704. break;
  705. case DoingGroup:
  706. if (e == '=') {
  707. doing = DoingGroupAssignment;
  708. } else {
  709. return false;
  710. }
  711. break;
  712. case DoingWorld:
  713. if (e == '=') {
  714. doing = DoingWorldAssignment;
  715. } else {
  716. return false;
  717. }
  718. break;
  719. case DoingOwnerAssignment:
  720. if (e == 'r') {
  721. uniquePushBack("OWNER_READ");
  722. } else if (e == 'w') {
  723. uniquePushBack("OWNER_WRITE");
  724. } else if (e == 'x') {
  725. uniquePushBack("OWNER_EXECUTE");
  726. } else if (e == ',') {
  727. doing = DoingNone;
  728. } else {
  729. return false;
  730. }
  731. break;
  732. case DoingGroupAssignment:
  733. if (e == 'r') {
  734. uniquePushBack("GROUP_READ");
  735. } else if (e == 'w') {
  736. uniquePushBack("GROUP_WRITE");
  737. } else if (e == 'x') {
  738. uniquePushBack("GROUP_EXECUTE");
  739. } else if (e == ',') {
  740. doing = DoingNone;
  741. } else {
  742. return false;
  743. }
  744. break;
  745. case DoingWorldAssignment:
  746. if (e == 'r') {
  747. uniquePushBack("WORLD_READ");
  748. } else if (e == 'w') {
  749. uniquePushBack("WORLD_WRITE");
  750. } else if (e == 'x') {
  751. uniquePushBack("WORLD_EXECUTE");
  752. } else if (e == ',') {
  753. doing = DoingNone;
  754. } else {
  755. return false;
  756. }
  757. break;
  758. }
  759. }
  760. if (doing != DoingOwnerAssignment && doing != DoingGroupAssignment &&
  761. doing != DoingWorldAssignment) {
  762. return false;
  763. }
  764. std::ostringstream oss;
  765. for (auto i = 0u; i < parsedPermissions.size(); i++) {
  766. if (i != 0) {
  767. oss << ';';
  768. }
  769. oss << parsedPermissions[i];
  770. }
  771. parsedPermissionsVar = oss.str();
  772. return true;
  773. }
  774. int do_install(int ac, char const* const* av)
  775. {
  776. #ifdef CMAKE_BOOTSTRAP
  777. std::cerr << "This cmake does not support --install\n";
  778. return -1;
  779. #else
  780. assert(1 < ac);
  781. std::string config;
  782. std::string component;
  783. std::string defaultDirectoryPermissions;
  784. std::string prefix;
  785. std::string dir;
  786. int jobs = 0;
  787. bool strip = false;
  788. bool verbose = cmSystemTools::HasEnv("VERBOSE");
  789. auto jLambda = extract_job_number_lambda_builder(dir, jobs, "-j");
  790. auto parallelLambda =
  791. extract_job_number_lambda_builder(dir, jobs, "--parallel");
  792. auto verboseLambda = [&](std::string const&) -> bool {
  793. verbose = true;
  794. return true;
  795. };
  796. using CommandArgument =
  797. cmCommandLineArgument<bool(std::string const& value)>;
  798. std::vector<CommandArgument> arguments = {
  799. CommandArgument{ "--config", CommandArgument::Values::One,
  800. CommandArgument::setToValue(config) },
  801. CommandArgument{ "--component", CommandArgument::Values::One,
  802. CommandArgument::setToValue(component) },
  803. CommandArgument{
  804. "--default-directory-permissions", CommandArgument::Values::One,
  805. CommandArgument::setToValue(defaultDirectoryPermissions) },
  806. CommandArgument{ "-j", CommandArgument::Values::One, jLambda },
  807. CommandArgument{ "--parallel", CommandArgument::Values::One,
  808. parallelLambda },
  809. CommandArgument{ "--prefix", CommandArgument::Values::One,
  810. CommandArgument::setToValue(prefix) },
  811. CommandArgument{ "--strip", CommandArgument::Values::Zero,
  812. CommandArgument::setToTrue(strip) },
  813. CommandArgument{ "-v", CommandArgument::Values::Zero, verboseLambda },
  814. CommandArgument{ "--verbose", CommandArgument::Values::Zero,
  815. verboseLambda }
  816. };
  817. if (ac >= 3) {
  818. dir = cmSystemTools::ToNormalizedPathOnDisk(av[2]);
  819. std::vector<std::string> inputArgs;
  820. inputArgs.reserve(ac - 3);
  821. cm::append(inputArgs, av + 3, av + ac);
  822. for (decltype(inputArgs.size()) i = 0; i < inputArgs.size(); ++i) {
  823. std::string const& arg = inputArgs[i];
  824. bool matched = false;
  825. bool parsed = false;
  826. for (auto const& m : arguments) {
  827. matched = m.matches(arg);
  828. if (matched) {
  829. parsed = m.parse(arg, i, inputArgs);
  830. break;
  831. }
  832. }
  833. if (!(matched && parsed)) {
  834. dir.clear();
  835. if (!matched) {
  836. std::cerr << "Unknown argument " << arg << std::endl;
  837. }
  838. break;
  839. }
  840. }
  841. }
  842. if (dir.empty()) {
  843. /* clang-format off */
  844. std::cerr <<
  845. "Usage: cmake --install <dir> [options]\n"
  846. "Options:\n"
  847. " <dir> = Project binary directory to install.\n"
  848. " --config <cfg> = For multi-configuration tools, choose <cfg>.\n"
  849. " --component <comp> = Component-based install. Only install <comp>.\n"
  850. " --default-directory-permissions <permission> \n"
  851. " Default install permission. Use default permission <permission>.\n"
  852. " -j <jobs> --parallel <jobs>\n"
  853. " Build in parallel using the given number of jobs. \n"
  854. " The CMAKE_INSTALL_PARALLEL_LEVEL environment variable\n"
  855. " specifies a default parallel level when this option is not given.\n"
  856. " --prefix <prefix> = The installation prefix CMAKE_INSTALL_PREFIX.\n"
  857. " --strip = Performing install/strip.\n"
  858. " -v --verbose = Enable verbose output.\n"
  859. ;
  860. /* clang-format on */
  861. return 1;
  862. }
  863. std::vector<std::string> args{ av[0] };
  864. if (!prefix.empty()) {
  865. args.emplace_back("-DCMAKE_INSTALL_PREFIX=" + prefix);
  866. }
  867. if (!component.empty()) {
  868. args.emplace_back("-DCMAKE_INSTALL_COMPONENT=" + component);
  869. }
  870. if (strip) {
  871. args.emplace_back("-DCMAKE_INSTALL_DO_STRIP=1");
  872. }
  873. if (!defaultDirectoryPermissions.empty()) {
  874. std::string parsedPermissionsVar;
  875. if (!parse_default_directory_permissions(defaultDirectoryPermissions,
  876. parsedPermissionsVar)) {
  877. std::cerr << "--default-directory-permissions is in incorrect format"
  878. << std::endl;
  879. return 1;
  880. }
  881. args.emplace_back("-DCMAKE_INSTALL_DEFAULT_DIRECTORY_PERMISSIONS=" +
  882. parsedPermissionsVar);
  883. }
  884. args.emplace_back("-P");
  885. cmInstrumentation instrumentation(dir);
  886. auto handler = cmInstallScriptHandler(dir, component, config, args);
  887. int ret = 0;
  888. if (!jobs && handler.IsParallel()) {
  889. jobs = 1;
  890. auto envvar = cmSystemTools::GetEnvVar("CMAKE_INSTALL_PARALLEL_LEVEL");
  891. if (envvar.has_value()) {
  892. jobs = extract_job_number("", envvar.value());
  893. if (jobs < 1) {
  894. std::cerr << "Value of CMAKE_INSTALL_PARALLEL_LEVEL environment"
  895. " variable must be a positive integer.\n";
  896. return 1;
  897. }
  898. }
  899. }
  900. auto doInstall = [&handler, &verbose, &jobs, &instrumentation]() -> int {
  901. int ret_ = 0;
  902. if (handler.IsParallel()) {
  903. ret_ = handler.Install(jobs, instrumentation);
  904. } else {
  905. for (auto const& cmd : handler.GetCommands()) {
  906. cmake cm(cmake::RoleScript, cmState::Script);
  907. cmSystemTools::SetMessageCallback(
  908. [&cm](std::string const& msg, cmMessageMetadata const& md) {
  909. cmakemainMessageCallback(msg, md, &cm);
  910. });
  911. cm.SetProgressCallback([&cm](std::string const& msg, float prog) {
  912. cmakemainProgressCallback(msg, prog, &cm);
  913. });
  914. cm.SetHomeDirectory("");
  915. cm.SetHomeOutputDirectory("");
  916. cm.SetDebugOutputOn(verbose);
  917. cm.SetWorkingMode(cmake::SCRIPT_MODE,
  918. cmake::CommandFailureAction::FATAL_ERROR);
  919. ret_ = int(bool(cm.Run(cmd)));
  920. }
  921. }
  922. return int(ret_ > 0);
  923. };
  924. std::vector<std::string> cmd;
  925. cm::append(cmd, av, av + ac);
  926. ret = instrumentation.InstrumentCommand(
  927. "cmakeInstall", cmd, [doInstall]() { return doInstall(); });
  928. instrumentation.CollectTimingData(cmInstrumentationQuery::Hook::PostInstall);
  929. return ret;
  930. #endif
  931. }
  932. int do_workflow(int ac, char const* const* av)
  933. {
  934. #ifdef CMAKE_BOOTSTRAP
  935. std::cerr << "This cmake does not support --workflow\n";
  936. return -1;
  937. #else
  938. using WorkflowListPresets = cmake::WorkflowListPresets;
  939. using WorkflowFresh = cmake::WorkflowFresh;
  940. std::string presetName;
  941. auto listPresets = WorkflowListPresets::No;
  942. auto fresh = WorkflowFresh::No;
  943. using CommandArgument =
  944. cmCommandLineArgument<bool(std::string const& value)>;
  945. std::vector<CommandArgument> arguments = {
  946. CommandArgument{ "--preset", CommandArgument::Values::One,
  947. CommandArgument::setToValue(presetName) },
  948. CommandArgument{ "--list-presets", CommandArgument::Values::Zero,
  949. [&listPresets](std::string const&) -> bool {
  950. listPresets = WorkflowListPresets::Yes;
  951. return true;
  952. } },
  953. CommandArgument{ "--fresh", CommandArgument::Values::Zero,
  954. [&fresh](std::string const&) -> bool {
  955. fresh = WorkflowFresh::Yes;
  956. return true;
  957. } },
  958. };
  959. std::vector<std::string> inputArgs;
  960. inputArgs.reserve(ac - 2);
  961. cm::append(inputArgs, av + 2, av + ac);
  962. decltype(inputArgs.size()) i = 0;
  963. for (; i < inputArgs.size(); ++i) {
  964. std::string const& arg = inputArgs[i];
  965. bool matched = false;
  966. bool parsed = false;
  967. for (auto const& m : arguments) {
  968. matched = m.matches(arg);
  969. if (matched) {
  970. parsed = m.parse(arg, i, inputArgs);
  971. break;
  972. }
  973. }
  974. if (!matched && i == 0) {
  975. inputArgs.insert(inputArgs.begin(), "--preset");
  976. matched = true;
  977. parsed = arguments[0].parse("--preset", i, inputArgs);
  978. }
  979. if (!(matched && parsed)) {
  980. if (!matched) {
  981. presetName.clear();
  982. listPresets = WorkflowListPresets::No;
  983. std::cerr << "Unknown argument " << arg << std::endl;
  984. }
  985. break;
  986. }
  987. }
  988. if (presetName.empty() && listPresets == WorkflowListPresets::No) {
  989. /* clang-format off */
  990. std::cerr <<
  991. "Usage: cmake --workflow <options>\n"
  992. "Options:\n"
  993. " --preset <preset> = Workflow preset to execute.\n"
  994. " --list-presets = List available workflow presets.\n"
  995. " --fresh = Configure a fresh build tree, removing any "
  996. "existing cache file.\n"
  997. ;
  998. /* clang-format on */
  999. return 1;
  1000. }
  1001. cmake cm(cmake::RoleInternal, cmState::Project);
  1002. cmSystemTools::SetMessageCallback(
  1003. [&cm](std::string const& msg, cmMessageMetadata const& md) {
  1004. cmakemainMessageCallback(msg, md, &cm);
  1005. });
  1006. cm.SetProgressCallback([&cm](std::string const& msg, float prog) {
  1007. cmakemainProgressCallback(msg, prog, &cm);
  1008. });
  1009. return cm.Workflow(presetName, listPresets, fresh);
  1010. #endif
  1011. }
  1012. int do_open(int ac, char const* const* av)
  1013. {
  1014. #ifdef CMAKE_BOOTSTRAP
  1015. std::cerr << "This cmake does not support --open\n";
  1016. return -1;
  1017. #else
  1018. std::string dir;
  1019. enum Doing
  1020. {
  1021. DoingNone,
  1022. DoingDir,
  1023. };
  1024. Doing doing = DoingDir;
  1025. for (int i = 2; i < ac; ++i) {
  1026. switch (doing) {
  1027. case DoingDir:
  1028. dir = cmSystemTools::ToNormalizedPathOnDisk(av[i]);
  1029. doing = DoingNone;
  1030. break;
  1031. default:
  1032. std::cerr << "Unknown argument " << av[i] << std::endl;
  1033. dir.clear();
  1034. break;
  1035. }
  1036. }
  1037. if (dir.empty()) {
  1038. std::cerr << "Usage: cmake --open <dir>\n";
  1039. return 1;
  1040. }
  1041. cmake cm(cmake::RoleInternal, cmState::Unknown);
  1042. cmSystemTools::SetMessageCallback(
  1043. [&cm](std::string const& msg, cmMessageMetadata const& md) {
  1044. cmakemainMessageCallback(msg, md, &cm);
  1045. });
  1046. cm.SetProgressCallback([&cm](std::string const& msg, float prog) {
  1047. cmakemainProgressCallback(msg, prog, &cm);
  1048. });
  1049. return cm.Open(dir, cmake::DryRun::No) ? 0 : 1;
  1050. #endif
  1051. }
  1052. } // namespace
  1053. int main(int ac, char const* const* av)
  1054. {
  1055. cm::StdIo::Init();
  1056. cm::optional<cm::StdIo::Console> console = cm::StdIo::Console();
  1057. cmsys::Encoding::CommandLineArguments args =
  1058. cmsys::Encoding::CommandLineArguments::Main(ac, av);
  1059. ac = args.argc();
  1060. av = args.argv();
  1061. cmSystemTools::InitializeLibUV();
  1062. cmSystemTools::FindCMakeResources(av[0]);
  1063. if (ac > 1) {
  1064. if (strcmp(av[1], "--build") == 0) {
  1065. return do_build(ac, av);
  1066. }
  1067. if (strcmp(av[1], "--install") == 0) {
  1068. return do_install(ac, av);
  1069. }
  1070. if (strcmp(av[1], "--open") == 0) {
  1071. return do_open(ac, av);
  1072. }
  1073. if (strcmp(av[1], "--workflow") == 0) {
  1074. return do_workflow(ac, av);
  1075. }
  1076. if (strcmp(av[1], "-E") == 0) {
  1077. return do_command(ac, av, std::move(console));
  1078. }
  1079. if (strcmp(av[1], "--print-config-dir") == 0) {
  1080. std::cout << cmSystemTools::ConvertToOutputPath(
  1081. cmSystemTools::GetCMakeConfigDirectory().value_or(
  1082. std::string()))
  1083. << std::endl;
  1084. return 0;
  1085. }
  1086. }
  1087. int ret = do_cmake(ac, av);
  1088. if (uv_loop_t* loop = uv_default_loop()) {
  1089. uv_loop_close(loop);
  1090. }
  1091. return ret;
  1092. }