process.h

Go to the documentation of this file.

 
#pragma once
 
#include <cstdio>
#include <filesystem>
#include <memory>
#include <optional>
#include <span>
#include <string>
#include <string_view>
#include <utility>
#include <vector>
 
#include <rex/platform.h>
#include <rex/result.h>
#include <rex/types.h>
#include <rex/utility.h>
 
namespace rex::platform {
 
namespace detail {
struct LockHandle;

REX_API std::wstring BuildCommandLine(std::wstring_view exe, std::span<const std::string> args);
}  // namespace detail

class REX_API InstanceLock : public MoveOnly {
 public:
  InstanceLock(InstanceLock&& other) noexcept;
  InstanceLock& operator=(InstanceLock&& other) noexcept;
  ~InstanceLock();

  [[nodiscard]] static Result<InstanceLock> Acquire(std::string_view name);
 
 private:
  explicit InstanceLock(std::unique_ptr<detail::LockHandle> handle);
  std::unique_ptr<detail::LockHandle> handle_;
};

[[nodiscard]] REX_API Result<void> Relaunch(std::span<const std::string> args);

[[nodiscard]] REX_API Result<void> Relaunch(const std::filesystem::path& exe,
                                            std::span<const std::string> args,
                                            const std::filesystem::path& working_directory = {});

REX_API bool CanRelaunch();
 
struct OpenFileLimit {
  u64 before = 0; 
  u64 after = 0;  
  u64 hard = 0;   
};

[[nodiscard]] REX_API Result<OpenFileLimit> RaiseOpenFileLimit();

[[nodiscard]] REX_API std::string DescribeResourceUse();
 
}  // namespace rex::platform
 
namespace rex::platform {

REX_API bool IsTerminal(FILE* stream);

REX_API bool EnableANSIEscapes(FILE* stream);

REX_API void SetUTF8OutputCodePage();
 
}  // namespace rex::platform
 
namespace rex::platform {

REX_API bool IsDebuggerAttached();

REX_API void Break();
 
}  // namespace rex::platform
 
namespace rex::platform {

REX_API std::optional<std::string> GetEnvironmentValue(std::string_view name);

REX_API bool SetEnvironmentValue(std::string_view name, std::string_view value);

REX_API bool UnsetEnvironmentValue(std::string_view name);

REX_API std::vector<std::pair<std::string, std::string>> EnumerateEnvironment();
 
}  // namespace rex::platform
 
namespace rex {

enum class MessageType : u8 {
  kInfo,
  kWarning,
  kError,
};

REX_API void ShowMessageBox(MessageType type, std::string_view message);
 
}  // namespace rex
 
namespace rex::platform {
 
struct CrashReporterOptions {
  // NOLINTNEXTLINE(readability-redundant-member-init): designated initializers omit this field
  std::string app_name = {};
  bool show_dialog = false;
};

using CrashAddressDescriber = u32 (*)(u64 host_address, std::span<char> out);

[[nodiscard]] REX_API Result<void> InstallCrashReporter(const CrashReporterOptions& options);

REX_API void UninstallCrashReporter();

REX_API void SetCrashAddressDescriber(CrashAddressDescriber describer);

REX_API void PrepareThreadForCrash();
 
}  // namespace rex::platform