1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629
|
/* Distributed under the OSI-approved BSD 3-Clause License. See accompanying
file Copyright.txt or https://cmake.org/licensing for details. */
#pragma once
#include "cmConfigure.h" // IWYU pragma: keep
#if !defined(_WIN32)
# include <sys/types.h>
#endif
#include <cstddef>
#include <functional>
#include <map>
#include <sstream>
#include <string>
#include <vector>
#include <cm/optional>
#include <cm/string_view>
#include <cm3p/uv.h>
#include "cmsys/Status.hxx" // IWYU pragma: export
#include "cmsys/SystemTools.hxx" // IWYU pragma: export
#include "cmDuration.h"
#include "cmProcessOutput.h"
struct cmMessageMetadata;
/** \class cmSystemTools
* \brief A collection of useful functions for CMake.
*
* cmSystemTools is a class that provides helper functions
* for the CMake build system.
*/
class cmSystemTools : public cmsys::SystemTools
{
public:
using Superclass = cmsys::SystemTools;
using Encoding = cmProcessOutput::Encoding;
/**
* Look for and replace registry values in a string
*/
static void ExpandRegistryValues(std::string& source,
KeyWOW64 view = KeyWOW64_Default);
/** Map help document name to file name. */
static std::string HelpFileName(cm::string_view);
using MessageCallback =
std::function<void(const std::string&, const cmMessageMetadata&)>;
/**
* Set the function used by GUIs to display error messages
* Function gets passed: message as a const char*,
* title as a const char*.
*/
static void SetMessageCallback(MessageCallback f);
/**
* Display an error message.
*/
static void Error(const std::string& m);
/**
* Display a message.
*/
static void Message(const std::string& m, const char* title = nullptr);
static void Message(const std::string& m, const cmMessageMetadata& md);
using OutputCallback = std::function<void(std::string const&)>;
//! Send a string to stdout
static void Stdout(const std::string& s);
static void SetStdoutCallback(OutputCallback f);
//! Send a string to stderr
static void Stderr(const std::string& s);
static void SetStderrCallback(OutputCallback f);
using InterruptCallback = std::function<bool()>;
static void SetInterruptCallback(InterruptCallback f);
static bool GetInterruptFlag();
//! Return true if there was an error at any point.
static bool GetErrorOccurredFlag()
{
return cmSystemTools::s_ErrorOccurred ||
cmSystemTools::s_FatalErrorOccurred || GetInterruptFlag();
}
//! If this is set to true, cmake stops processing commands.
static void SetFatalErrorOccurred()
{
cmSystemTools::s_FatalErrorOccurred = true;
}
static void SetErrorOccurred() { cmSystemTools::s_ErrorOccurred = true; }
//! Return true if there was an error at any point.
static bool GetFatalErrorOccurred()
{
return cmSystemTools::s_FatalErrorOccurred || GetInterruptFlag();
}
//! Set the error occurred flag and fatal error back to false
static void ResetErrorOccurredFlag()
{
cmSystemTools::s_FatalErrorOccurred = false;
cmSystemTools::s_ErrorOccurred = false;
}
//! Return true if the path is a framework
static bool IsPathToFramework(const std::string& path);
//! Return true if the path is a xcframework
static bool IsPathToXcFramework(const std::string& path);
//! Return true if the path is a macOS non-framework shared library (aka
//! .dylib)
static bool IsPathToMacOSSharedLibrary(const std::string& path);
static bool DoesFileExistWithExtensions(
const std::string& name, const std::vector<std::string>& sourceExts);
/**
* Check if the given file exists in one of the parent directory of the
* given file or directory and if it does, return the name of the file.
* Toplevel specifies the top-most directory to where it will look.
*/
static std::string FileExistsInParentDirectories(
const std::string& fname, const std::string& directory,
const std::string& toplevel);
static void Glob(const std::string& directory, const std::string& regexp,
std::vector<std::string>& files);
static void GlobDirs(const std::string& fullPath,
std::vector<std::string>& files);
/**
* Try to find a list of files that match the "simple" globbing
* expression. At this point in time the globbing expressions have
* to be in form: /directory/partial_file_name*. The * character has
* to be at the end of the string and it does not support ?
* []... The optional argument type specifies what kind of files you
* want to find. 0 means all files, -1 means directories, 1 means
* files only. This method returns true if search was successful.
*/
static bool SimpleGlob(const std::string& glob,
std::vector<std::string>& files, int type = 0);
enum class CopyWhen
{
Always,
OnlyIfDifferent,
};
enum class CopyInputRecent
{
No,
Yes,
};
enum class CopyResult
{
Success,
Failure,
};
#if defined(_MSC_VER)
/** Visual C++ does not define mode_t. */
using mode_t = unsigned short;
#endif
/**
* Make a new temporary directory. The path must end in "XXXXXX", and will
* be modified to reflect the name of the directory created. This function
* is similar to POSIX mkdtemp (and is implemented using the same where that
* function is available).
*
* This function can make a full path even if none of the directories existed
* prior to calling this function.
*
* Note that this function may modify \p path even if it does not succeed.
*/
static cmsys::Status MakeTempDirectory(char* path,
const mode_t* mode = nullptr);
static cmsys::Status MakeTempDirectory(std::string& path,
const mode_t* mode = nullptr);
/** Copy a file. */
static CopyResult CopySingleFile(std::string const& oldname,
std::string const& newname, CopyWhen when,
CopyInputRecent inputRecent,
std::string* err = nullptr);
enum class Replace
{
Yes,
No,
};
enum class RenameResult
{
Success,
NoReplace,
Failure,
};
/** Rename a file or directory within a single disk volume (atomic
if possible). */
static bool RenameFile(const std::string& oldname,
const std::string& newname);
static RenameResult RenameFile(std::string const& oldname,
std::string const& newname, Replace replace,
std::string* err = nullptr);
//! Rename a file if contents are different, delete the source otherwise
static cmsys::Status MoveFileIfDifferent(const std::string& source,
const std::string& destination);
/**
* Run a single executable command
*
* Output is controlled with outputflag. If outputflag is OUTPUT_NONE, no
* user-viewable output from the program being run will be generated.
* OUTPUT_MERGE is the legacy behavior where stdout and stderr are merged
* into stdout. OUTPUT_FORWARD copies the output to stdout/stderr as
* it was received. OUTPUT_PASSTHROUGH passes through the original handles.
*
* If timeout is specified, the command will be terminated after
* timeout expires. Timeout is specified in seconds.
*
* Argument retVal should be a pointer to the location where the
* exit code will be stored. If the retVal is not specified and
* the program exits with a code other than 0, then the this
* function will return false.
*
* If the command has spaces in the path the caller MUST call
* cmSystemTools::ConvertToRunCommandPath on the command before passing
* it into this function or it will not work. The command must be correctly
* escaped for this to with spaces.
*/
enum OutputOption
{
OUTPUT_NONE = 0,
OUTPUT_MERGE,
OUTPUT_FORWARD,
OUTPUT_PASSTHROUGH
};
static bool RunSingleCommand(const std::string& command,
std::string* captureStdOut = nullptr,
std::string* captureStdErr = nullptr,
int* retVal = nullptr,
const char* dir = nullptr,
OutputOption outputflag = OUTPUT_MERGE,
cmDuration timeout = cmDuration::zero());
/**
* In this version of RunSingleCommand, command[0] should be
* the command to run, and each argument to the command should
* be in command[1]...command[command.size()]
*/
static bool RunSingleCommand(std::vector<std::string> const& command,
std::string* captureStdOut = nullptr,
std::string* captureStdErr = nullptr,
int* retVal = nullptr,
const char* dir = nullptr,
OutputOption outputflag = OUTPUT_MERGE,
cmDuration timeout = cmDuration::zero(),
Encoding encoding = cmProcessOutput::Auto);
static std::string PrintSingleCommand(std::vector<std::string> const&);
/**
* Parse arguments out of a single string command
*/
static std::vector<std::string> ParseArguments(const std::string& command);
/** Parse arguments out of a windows command line string. */
static void ParseWindowsCommandLine(const char* command,
std::vector<std::string>& args);
/** Parse arguments out of a unix command line string. */
static void ParseUnixCommandLine(const char* command,
std::vector<std::string>& args);
/** Split a command-line string into the parsed command and the unparsed
arguments. Returns false on unfinished quoting or escaping. */
static bool SplitProgramFromArgs(std::string const& command,
std::string& program, std::string& args);
/**
* Handle response file in an argument list and return a new argument list
* **/
static std::vector<std::string> HandleResponseFile(
std::vector<std::string>::const_iterator argBeg,
std::vector<std::string>::const_iterator argEnd);
static std::size_t CalculateCommandLineLengthLimit();
static void DisableRunCommandOutput() { s_DisableRunCommandOutput = true; }
static void EnableRunCommandOutput() { s_DisableRunCommandOutput = false; }
static bool GetRunCommandOutput() { return s_DisableRunCommandOutput; }
enum CompareOp
{
OP_EQUAL = 1,
OP_LESS = 2,
OP_GREATER = 4,
OP_LESS_EQUAL = OP_LESS | OP_EQUAL,
OP_GREATER_EQUAL = OP_GREATER | OP_EQUAL
};
/**
* Compare versions
*/
static bool VersionCompare(CompareOp op, const std::string& lhs,
const std::string& rhs);
static bool VersionCompare(CompareOp op, const std::string& lhs,
const char rhs[]);
static bool VersionCompareEqual(std::string const& lhs,
std::string const& rhs);
static bool VersionCompareGreater(std::string const& lhs,
std::string const& rhs);
static bool VersionCompareGreaterEq(std::string const& lhs,
std::string const& rhs);
/**
* Compare two ASCII strings using natural versioning order.
* Non-numerical characters are compared directly.
* Numerical characters are first globbed such that, e.g.
* `test000 < test01 < test0 < test1 < test10`.
* Return a value less than, equal to, or greater than zero if lhs
* precedes, equals, or succeeds rhs in the defined ordering.
*/
static int strverscmp(std::string const& lhs, std::string const& rhs);
/** Windows if this is true, the CreateProcess in RunCommand will
* not show new console windows when running programs.
*/
static void SetRunCommandHideConsole(bool v) { s_RunCommandHideConsole = v; }
static bool GetRunCommandHideConsole() { return s_RunCommandHideConsole; }
/** Call cmSystemTools::Error with the message m, plus the
* result of strerror(errno)
*/
static void ReportLastSystemError(const char* m);
enum class WaitForLineResult
{
None,
STDOUT,
STDERR,
Timeout,
};
/** a general output handler for libuv */
static WaitForLineResult WaitForLine(uv_loop_t* loop, uv_stream_t* outPipe,
uv_stream_t* errPipe, std::string& line,
cmDuration timeout,
std::vector<char>& out,
std::vector<char>& err);
static void SetForceUnixPaths(bool v) { s_ForceUnixPaths = v; }
static bool GetForceUnixPaths() { return s_ForceUnixPaths; }
// ConvertToOutputPath use s_ForceUnixPaths
static std::string ConvertToOutputPath(std::string const& path);
static void ConvertToOutputSlashes(std::string& path);
// ConvertToRunCommandPath does not use s_ForceUnixPaths and should
// be used when RunCommand is called from cmake, because the
// running cmake needs paths to be in its format
static std::string ConvertToRunCommandPath(const std::string& path);
/**
* For windows computes the long path for the given path,
* For Unix, it is a noop
*/
static void ConvertToLongPath(std::string& path);
/** compute the relative path from local to remote. local must
be a directory. remote can be a file or a directory.
Both remote and local must be full paths. Basically, if
you are in directory local and you want to access the file in remote
what is the relative path to do that. For example:
/a/b/c/d to /a/b/c1/d1 -> ../../c1/d1
from /usr/src to /usr/src/test/blah/foo.cpp -> test/blah/foo.cpp
*/
static std::string RelativePath(std::string const& local,
std::string const& remote);
/**
* Convert the given remote path to a relative path with respect to
* the given local path. Both paths must use forward slashes and not
* already be escaped or quoted.
*/
static std::string ForceToRelativePath(std::string const& local_path,
std::string const& remote_path);
/**
* Express the 'in' path relative to 'top' if it does not start in '../'.
*/
static std::string RelativeIfUnder(std::string const& top,
std::string const& in);
static cm::optional<std::string> GetEnvVar(std::string const& var);
static std::vector<std::string> SplitEnvPath(std::string const& value);
#ifndef CMAKE_BOOTSTRAP
/** Remove an environment variable */
static bool UnsetEnv(const char* value);
/** Get the list of all environment variables */
static std::vector<std::string> GetEnvironmentVariables();
/** Append multiple variables to the current environment. */
static void AppendEnv(std::vector<std::string> const& env);
/**
* Helper class to represent an environment diff directly. This is to avoid
* repeated in-place environment modification (i.e. via setenv/putenv), which
* could be slow.
*/
class EnvDiff
{
public:
/** Append multiple variables to the current environment diff */
void AppendEnv(std::vector<std::string> const& env);
/**
* Add a single variable (or remove if no = sign) to the current
* environment diff.
*/
void PutEnv(const std::string& env);
/** Remove a single variable from the current environment diff. */
void UnPutEnv(const std::string& env);
/**
* Apply an ENVIRONMENT_MODIFICATION operation to this diff. Returns
* false and issues an error on parse failure.
*/
bool ParseOperation(const std::string& envmod);
/**
* Apply this diff to the actual environment, optionally writing out the
* modifications to a CTest-compatible measurement stream.
*/
void ApplyToCurrentEnv(std::ostringstream* measurement = nullptr);
private:
std::map<std::string, cm::optional<std::string>> diff;
};
/** Helper class to save and restore the environment.
Instantiate this class as an automatic variable on
the stack. Its constructor saves a copy of the current
environment and then its destructor restores the
original environment. */
class SaveRestoreEnvironment
{
public:
SaveRestoreEnvironment();
~SaveRestoreEnvironment();
SaveRestoreEnvironment(SaveRestoreEnvironment const&) = delete;
SaveRestoreEnvironment& operator=(SaveRestoreEnvironment const&) = delete;
private:
std::vector<std::string> Env;
};
#endif
/** Setup the environment to enable VS 8 IDE output. */
static void EnableVSConsoleOutput();
enum cmTarAction
{
TarActionCreate,
TarActionList,
TarActionExtract,
TarActionNone
};
/** Create tar */
enum cmTarCompression
{
TarCompressGZip,
TarCompressBZip2,
TarCompressXZ,
TarCompressZstd,
TarCompressNone
};
enum class cmTarExtractTimestamps
{
Yes,
No
};
static bool ListTar(const std::string& outFileName,
const std::vector<std::string>& files, bool verbose);
static bool CreateTar(const std::string& outFileName,
const std::vector<std::string>& files,
const std::string& workingDirectory,
cmTarCompression compressType, bool verbose,
std::string const& mtime = std::string(),
std::string const& format = std::string(),
int compressionLevel = 0);
static bool ExtractTar(const std::string& inFileName,
const std::vector<std::string>& files,
cmTarExtractTimestamps extractTimestamps,
bool verbose);
static void EnsureStdPipes();
/** Random seed generation. */
static unsigned int RandomSeed();
/** Find the directory containing CMake executables. */
static void FindCMakeResources(const char* argv0);
/** Get the CMake resource paths, after FindCMakeResources. */
static std::string const& GetCTestCommand();
static std::string const& GetCPackCommand();
static std::string const& GetCMakeCommand();
static std::string const& GetCMakeGUICommand();
static std::string const& GetCMakeCursesCommand();
static std::string const& GetCMClDepsCommand();
static std::string const& GetCMakeRoot();
static std::string const& GetHTMLDoc();
/** Get the CMake config directory **/
static cm::optional<std::string> GetSystemConfigDirectory();
static cm::optional<std::string> GetCMakeConfigDirectory();
/** Get the CWD mapped through the KWSys translation map. */
static std::string GetCurrentWorkingDirectory();
/** Echo a message in color using KWSys's Terminal cprintf. */
static void MakefileColorEcho(int color, const char* message, bool newLine,
bool enabled);
/** Try to guess the soname of a shared library. */
static bool GuessLibrarySOName(std::string const& fullPath,
std::string& soname);
/** Try to guess the install name of a shared library. */
static bool GuessLibraryInstallName(std::string const& fullPath,
std::string& soname);
/** Try to change the RPATH in an ELF binary. */
static bool ChangeRPath(std::string const& file, std::string const& oldRPath,
std::string const& newRPath,
bool removeEnvironmentRPath,
std::string* emsg = nullptr,
bool* changed = nullptr);
/** Try to set the RPATH in an ELF binary. */
static bool SetRPath(std::string const& file, std::string const& newRPath,
std::string* emsg = nullptr, bool* changed = nullptr);
/** Try to remove the RPATH from an ELF binary. */
static bool RemoveRPath(std::string const& file, std::string* emsg = nullptr,
bool* removed = nullptr);
/** Check whether the RPATH in an ELF binary contains the path
given. */
static bool CheckRPath(std::string const& file, std::string const& newRPath);
/** Remove a directory; repeat a few times in case of locked files. */
static bool RepeatedRemoveDirectory(const std::string& dir);
/** Encode a string as a URL. */
static std::string EncodeURL(std::string const& in,
bool escapeSlashes = true);
#ifdef _WIN32
struct WindowsFileRetry
{
unsigned int Count;
unsigned int Delay;
};
static WindowsFileRetry GetWindowsFileRetry();
static WindowsFileRetry GetWindowsDirectoryRetry();
struct WindowsVersion
{
unsigned int dwMajorVersion;
unsigned int dwMinorVersion;
unsigned int dwBuildNumber;
};
static WindowsVersion GetWindowsVersion();
/** Attempt to get full path to COMSPEC, default "cmd.exe" */
static std::string GetComspec();
#endif
/** Get the real path for a given path, removing all symlinks.
This variant of GetRealPath also works on Windows but will
resolve subst drives too. */
static std::string GetRealPathResolvingWindowsSubst(
const std::string& path, std::string* errorMessage = nullptr);
/** Perform one-time initialization of libuv. */
static void InitializeLibUV();
/** Create a symbolic link if the platform supports it. Returns whether
creation succeeded. */
static cmsys::Status CreateSymlink(std::string const& origName,
std::string const& newName);
static cmsys::Status CreateSymlinkQuietly(std::string const& origName,
std::string const& newName);
/** Create a hard link if the platform supports it. Returns whether
creation succeeded. */
static cmsys::Status CreateLink(std::string const& origName,
std::string const& newName);
static cmsys::Status CreateLinkQuietly(std::string const& origName,
std::string const& newName);
/** Get the system name. */
static cm::string_view GetSystemName();
/** Get the system path separator character */
static char GetSystemPathlistSeparator();
private:
static bool s_ForceUnixPaths;
static bool s_RunCommandHideConsole;
static bool s_ErrorOccurred;
static bool s_FatalErrorOccurred;
static bool s_DisableRunCommandOutput;
};
|