cmakemain.cxx 37 KB

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