cmakemain.cxx 37 KB

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