//===-- CommandObjectPlatform.cpp -------------------------------*- C++ -*-===// // // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. // See https://llvm.org/LICENSE.txt for license information. // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception // //===----------------------------------------------------------------------===// #include #include "CommandObjectPlatform.h" #include "lldb/Core/Debugger.h" #include "lldb/Core/Module.h" #include "lldb/Core/PluginManager.h" #include "lldb/Host/OptionParser.h" #include "lldb/Host/StringConvert.h" #include "lldb/Interpreter/CommandInterpreter.h" #include "lldb/Interpreter/CommandOptionValidators.h" #include "lldb/Interpreter/CommandReturnObject.h" #include "lldb/Interpreter/OptionGroupFile.h" #include "lldb/Interpreter/OptionGroupPlatform.h" #include "lldb/Target/ExecutionContext.h" #include "lldb/Target/Platform.h" #include "lldb/Target/Process.h" #include "lldb/Utility/Args.h" #include "lldb/Utility/DataExtractor.h" #include "llvm/ADT/SmallString.h" #include "llvm/Support/Threading.h" using namespace lldb; using namespace lldb_private; static mode_t ParsePermissionString(const char *) = delete; static mode_t ParsePermissionString(llvm::StringRef permissions) { if (permissions.size() != 9) return (mode_t)(-1); bool user_r, user_w, user_x, group_r, group_w, group_x, world_r, world_w, world_x; user_r = (permissions[0] == 'r'); user_w = (permissions[1] == 'w'); user_x = (permissions[2] == 'x'); group_r = (permissions[3] == 'r'); group_w = (permissions[4] == 'w'); group_x = (permissions[5] == 'x'); world_r = (permissions[6] == 'r'); world_w = (permissions[7] == 'w'); world_x = (permissions[8] == 'x'); mode_t user, group, world; user = (user_r ? 4 : 0) | (user_w ? 2 : 0) | (user_x ? 1 : 0); group = (group_r ? 4 : 0) | (group_w ? 2 : 0) | (group_x ? 1 : 0); world = (world_r ? 4 : 0) | (world_w ? 2 : 0) | (world_x ? 1 : 0); return user | group | world; } static constexpr OptionDefinition g_permissions_options[] = { // clang-format off {LLDB_OPT_SET_ALL, false, "permissions-value", 'v', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypePermissionsNumber, "Give out the numeric value for permissions (e.g. 757)"}, {LLDB_OPT_SET_ALL, false, "permissions-string", 's', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypePermissionsString, "Give out the string value for permissions (e.g. rwxr-xr--)."}, {LLDB_OPT_SET_ALL, false, "user-read", 'r', OptionParser::eNoArgument, nullptr, {}, 0, eArgTypeNone, "Allow user to read."}, {LLDB_OPT_SET_ALL, false, "user-write", 'w', OptionParser::eNoArgument, nullptr, {}, 0, eArgTypeNone, "Allow user to write."}, {LLDB_OPT_SET_ALL, false, "user-exec", 'x', OptionParser::eNoArgument, nullptr, {}, 0, eArgTypeNone, "Allow user to execute."}, {LLDB_OPT_SET_ALL, false, "group-read", 'R', OptionParser::eNoArgument, nullptr, {}, 0, eArgTypeNone, "Allow group to read."}, {LLDB_OPT_SET_ALL, false, "group-write", 'W', OptionParser::eNoArgument, nullptr, {}, 0, eArgTypeNone, "Allow group to write."}, {LLDB_OPT_SET_ALL, false, "group-exec", 'X', OptionParser::eNoArgument, nullptr, {}, 0, eArgTypeNone, "Allow group to execute."}, {LLDB_OPT_SET_ALL, false, "world-read", 'd', OptionParser::eNoArgument, nullptr, {}, 0, eArgTypeNone, "Allow world to read."}, {LLDB_OPT_SET_ALL, false, "world-write", 't', OptionParser::eNoArgument, nullptr, {}, 0, eArgTypeNone, "Allow world to write."}, {LLDB_OPT_SET_ALL, false, "world-exec", 'e', OptionParser::eNoArgument, nullptr, {}, 0, eArgTypeNone, "Allow world to execute."}, // clang-format on }; class OptionPermissions : public OptionGroup { public: OptionPermissions() {} ~OptionPermissions() override = default; lldb_private::Status SetOptionValue(uint32_t option_idx, llvm::StringRef option_arg, ExecutionContext *execution_context) override { Status error; char short_option = (char)GetDefinitions()[option_idx].short_option; switch (short_option) { case 'v': { if (option_arg.getAsInteger(8, m_permissions)) { m_permissions = 0777; error.SetErrorStringWithFormat("invalid value for permissions: %s", option_arg.str().c_str()); } } break; case 's': { mode_t perms = ParsePermissionString(option_arg); if (perms == (mode_t)-1) error.SetErrorStringWithFormat("invalid value for permissions: %s", option_arg.str().c_str()); else m_permissions = perms; } break; case 'r': m_permissions |= lldb::eFilePermissionsUserRead; break; case 'w': m_permissions |= lldb::eFilePermissionsUserWrite; break; case 'x': m_permissions |= lldb::eFilePermissionsUserExecute; break; case 'R': m_permissions |= lldb::eFilePermissionsGroupRead; break; case 'W': m_permissions |= lldb::eFilePermissionsGroupWrite; break; case 'X': m_permissions |= lldb::eFilePermissionsGroupExecute; break; case 'd': m_permissions |= lldb::eFilePermissionsWorldRead; break; case 't': m_permissions |= lldb::eFilePermissionsWorldWrite; break; case 'e': m_permissions |= lldb::eFilePermissionsWorldExecute; break; default: error.SetErrorStringWithFormat("unrecognized option '%c'", short_option); break; } return error; } void OptionParsingStarting(ExecutionContext *execution_context) override { m_permissions = 0; } llvm::ArrayRef GetDefinitions() override { return llvm::makeArrayRef(g_permissions_options); } // Instance variables to hold the values for command options. uint32_t m_permissions; private: DISALLOW_COPY_AND_ASSIGN(OptionPermissions); }; // "platform select " class CommandObjectPlatformSelect : public CommandObjectParsed { public: CommandObjectPlatformSelect(CommandInterpreter &interpreter) : CommandObjectParsed(interpreter, "platform select", "Create a platform if needed and select it as the " "current platform.", "platform select ", 0), m_option_group(), m_platform_options( false) // Don't include the "--platform" option by passing false { m_option_group.Append(&m_platform_options, LLDB_OPT_SET_ALL, 1); m_option_group.Finalize(); } ~CommandObjectPlatformSelect() override = default; int HandleCompletion(CompletionRequest &request) override { CommandCompletions::PlatformPluginNames(GetCommandInterpreter(), request, nullptr); return request.GetNumberOfMatches(); } Options *GetOptions() override { return &m_option_group; } protected: bool DoExecute(Args &args, CommandReturnObject &result) override { if (args.GetArgumentCount() == 1) { const char *platform_name = args.GetArgumentAtIndex(0); if (platform_name && platform_name[0]) { const bool select = true; m_platform_options.SetPlatformName(platform_name); Status error; ArchSpec platform_arch; PlatformSP platform_sp(m_platform_options.CreatePlatformWithOptions( m_interpreter, ArchSpec(), select, error, platform_arch)); if (platform_sp) { GetDebugger().GetPlatformList().SetSelectedPlatform(platform_sp); platform_sp->GetStatus(result.GetOutputStream()); result.SetStatus(eReturnStatusSuccessFinishResult); } else { result.AppendError(error.AsCString()); result.SetStatus(eReturnStatusFailed); } } else { result.AppendError("invalid platform name"); result.SetStatus(eReturnStatusFailed); } } else { result.AppendError( "platform create takes a platform name as an argument\n"); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } OptionGroupOptions m_option_group; OptionGroupPlatform m_platform_options; }; // "platform list" class CommandObjectPlatformList : public CommandObjectParsed { public: CommandObjectPlatformList(CommandInterpreter &interpreter) : CommandObjectParsed(interpreter, "platform list", "List all platforms that are available.", nullptr, 0) {} ~CommandObjectPlatformList() override = default; protected: bool DoExecute(Args &args, CommandReturnObject &result) override { Stream &ostrm = result.GetOutputStream(); ostrm.Printf("Available platforms:\n"); PlatformSP host_platform_sp(Platform::GetHostPlatform()); ostrm.Printf("%s: %s\n", host_platform_sp->GetPluginName().GetCString(), host_platform_sp->GetDescription()); uint32_t idx; for (idx = 0; true; ++idx) { const char *plugin_name = PluginManager::GetPlatformPluginNameAtIndex(idx); if (plugin_name == nullptr) break; const char *plugin_desc = PluginManager::GetPlatformPluginDescriptionAtIndex(idx); if (plugin_desc == nullptr) break; ostrm.Printf("%s: %s\n", plugin_name, plugin_desc); } if (idx == 0) { result.AppendError("no platforms are available\n"); result.SetStatus(eReturnStatusFailed); } else result.SetStatus(eReturnStatusSuccessFinishResult); return result.Succeeded(); } }; // "platform status" class CommandObjectPlatformStatus : public CommandObjectParsed { public: CommandObjectPlatformStatus(CommandInterpreter &interpreter) : CommandObjectParsed(interpreter, "platform status", "Display status for the current platform.", nullptr, 0) {} ~CommandObjectPlatformStatus() override = default; protected: bool DoExecute(Args &args, CommandReturnObject &result) override { Stream &ostrm = result.GetOutputStream(); Target *target = GetDebugger().GetSelectedTarget().get(); PlatformSP platform_sp; if (target) { platform_sp = target->GetPlatform(); } if (!platform_sp) { platform_sp = GetDebugger().GetPlatformList().GetSelectedPlatform(); } if (platform_sp) { platform_sp->GetStatus(ostrm); result.SetStatus(eReturnStatusSuccessFinishResult); } else { result.AppendError("no platform is currently selected\n"); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } }; // "platform connect " class CommandObjectPlatformConnect : public CommandObjectParsed { public: CommandObjectPlatformConnect(CommandInterpreter &interpreter) : CommandObjectParsed( interpreter, "platform connect", "Select the current platform by providing a connection URL.", "platform connect ", 0) {} ~CommandObjectPlatformConnect() override = default; protected: bool DoExecute(Args &args, CommandReturnObject &result) override { Stream &ostrm = result.GetOutputStream(); PlatformSP platform_sp( GetDebugger().GetPlatformList().GetSelectedPlatform()); if (platform_sp) { Status error(platform_sp->ConnectRemote(args)); if (error.Success()) { platform_sp->GetStatus(ostrm); result.SetStatus(eReturnStatusSuccessFinishResult); platform_sp->ConnectToWaitingProcesses(GetDebugger(), error); if (error.Fail()) { result.AppendError(error.AsCString()); result.SetStatus(eReturnStatusFailed); } } else { result.AppendErrorWithFormat("%s\n", error.AsCString()); result.SetStatus(eReturnStatusFailed); } } else { result.AppendError("no platform is currently selected\n"); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } Options *GetOptions() override { PlatformSP platform_sp( GetDebugger().GetPlatformList().GetSelectedPlatform()); OptionGroupOptions *m_platform_options = nullptr; if (platform_sp) { m_platform_options = platform_sp->GetConnectionOptions(m_interpreter); if (m_platform_options != nullptr && !m_platform_options->m_did_finalize) m_platform_options->Finalize(); } return m_platform_options; } }; // "platform disconnect" class CommandObjectPlatformDisconnect : public CommandObjectParsed { public: CommandObjectPlatformDisconnect(CommandInterpreter &interpreter) : CommandObjectParsed(interpreter, "platform disconnect", "Disconnect from the current platform.", "platform disconnect", 0) {} ~CommandObjectPlatformDisconnect() override = default; protected: bool DoExecute(Args &args, CommandReturnObject &result) override { PlatformSP platform_sp( GetDebugger().GetPlatformList().GetSelectedPlatform()); if (platform_sp) { if (args.GetArgumentCount() == 0) { Status error; if (platform_sp->IsConnected()) { // Cache the instance name if there is one since we are about to // disconnect and the name might go with it. const char *hostname_cstr = platform_sp->GetHostname(); std::string hostname; if (hostname_cstr) hostname.assign(hostname_cstr); error = platform_sp->DisconnectRemote(); if (error.Success()) { Stream &ostrm = result.GetOutputStream(); if (hostname.empty()) ostrm.Printf("Disconnected from \"%s\"\n", platform_sp->GetPluginName().GetCString()); else ostrm.Printf("Disconnected from \"%s\"\n", hostname.c_str()); result.SetStatus(eReturnStatusSuccessFinishResult); } else { result.AppendErrorWithFormat("%s", error.AsCString()); result.SetStatus(eReturnStatusFailed); } } else { // Not connected... result.AppendErrorWithFormat( "not connected to '%s'", platform_sp->GetPluginName().GetCString()); result.SetStatus(eReturnStatusFailed); } } else { // Bad args result.AppendError( "\"platform disconnect\" doesn't take any arguments"); result.SetStatus(eReturnStatusFailed); } } else { result.AppendError("no platform is currently selected"); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } }; // "platform settings" class CommandObjectPlatformSettings : public CommandObjectParsed { public: CommandObjectPlatformSettings(CommandInterpreter &interpreter) : CommandObjectParsed(interpreter, "platform settings", "Set settings for the current target's platform, " "or for a platform by name.", "platform settings", 0), m_options(), m_option_working_dir(LLDB_OPT_SET_1, false, "working-dir", 'w', 0, eArgTypePath, "The working directory for the platform.") { m_options.Append(&m_option_working_dir, LLDB_OPT_SET_ALL, LLDB_OPT_SET_1); } ~CommandObjectPlatformSettings() override = default; protected: bool DoExecute(Args &args, CommandReturnObject &result) override { PlatformSP platform_sp( GetDebugger().GetPlatformList().GetSelectedPlatform()); if (platform_sp) { if (m_option_working_dir.GetOptionValue().OptionWasSet()) platform_sp->SetWorkingDirectory( m_option_working_dir.GetOptionValue().GetCurrentValue()); } else { result.AppendError("no platform is currently selected"); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } Options *GetOptions() override { if (!m_options.DidFinalize()) m_options.Finalize(); return &m_options; } protected: OptionGroupOptions m_options; OptionGroupFile m_option_working_dir; }; // "platform mkdir" class CommandObjectPlatformMkDir : public CommandObjectParsed { public: CommandObjectPlatformMkDir(CommandInterpreter &interpreter) : CommandObjectParsed(interpreter, "platform mkdir", "Make a new directory on the remote end.", nullptr, 0), m_options() {} ~CommandObjectPlatformMkDir() override = default; bool DoExecute(Args &args, CommandReturnObject &result) override { PlatformSP platform_sp( GetDebugger().GetPlatformList().GetSelectedPlatform()); if (platform_sp) { std::string cmd_line; args.GetCommandString(cmd_line); uint32_t mode; const OptionPermissions *options_permissions = (const OptionPermissions *)m_options.GetGroupWithOption('r'); if (options_permissions) mode = options_permissions->m_permissions; else mode = lldb::eFilePermissionsUserRWX | lldb::eFilePermissionsGroupRWX | lldb::eFilePermissionsWorldRX; Status error = platform_sp->MakeDirectory(FileSpec(cmd_line), mode); if (error.Success()) { result.SetStatus(eReturnStatusSuccessFinishResult); } else { result.AppendError(error.AsCString()); result.SetStatus(eReturnStatusFailed); } } else { result.AppendError("no platform currently selected\n"); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } Options *GetOptions() override { if (!m_options.DidFinalize()) { m_options.Append(new OptionPermissions()); m_options.Finalize(); } return &m_options; } OptionGroupOptions m_options; }; // "platform fopen" class CommandObjectPlatformFOpen : public CommandObjectParsed { public: CommandObjectPlatformFOpen(CommandInterpreter &interpreter) : CommandObjectParsed(interpreter, "platform file open", "Open a file on the remote end.", nullptr, 0), m_options() {} ~CommandObjectPlatformFOpen() override = default; bool DoExecute(Args &args, CommandReturnObject &result) override { PlatformSP platform_sp( GetDebugger().GetPlatformList().GetSelectedPlatform()); if (platform_sp) { Status error; std::string cmd_line; args.GetCommandString(cmd_line); mode_t perms; const OptionPermissions *options_permissions = (const OptionPermissions *)m_options.GetGroupWithOption('r'); if (options_permissions) perms = options_permissions->m_permissions; else perms = lldb::eFilePermissionsUserRW | lldb::eFilePermissionsGroupRW | lldb::eFilePermissionsWorldRead; lldb::user_id_t fd = platform_sp->OpenFile( FileSpec(cmd_line), File::eOpenOptionRead | File::eOpenOptionWrite | File::eOpenOptionAppend | File::eOpenOptionCanCreate, perms, error); if (error.Success()) { result.AppendMessageWithFormat("File Descriptor = %" PRIu64 "\n", fd); result.SetStatus(eReturnStatusSuccessFinishResult); } else { result.AppendError(error.AsCString()); result.SetStatus(eReturnStatusFailed); } } else { result.AppendError("no platform currently selected\n"); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } Options *GetOptions() override { if (!m_options.DidFinalize()) { m_options.Append(new OptionPermissions()); m_options.Finalize(); } return &m_options; } OptionGroupOptions m_options; }; // "platform fclose" class CommandObjectPlatformFClose : public CommandObjectParsed { public: CommandObjectPlatformFClose(CommandInterpreter &interpreter) : CommandObjectParsed(interpreter, "platform file close", "Close a file on the remote end.", nullptr, 0) {} ~CommandObjectPlatformFClose() override = default; bool DoExecute(Args &args, CommandReturnObject &result) override { PlatformSP platform_sp( GetDebugger().GetPlatformList().GetSelectedPlatform()); if (platform_sp) { std::string cmd_line; args.GetCommandString(cmd_line); const lldb::user_id_t fd = StringConvert::ToUInt64(cmd_line.c_str(), UINT64_MAX); Status error; bool success = platform_sp->CloseFile(fd, error); if (success) { result.AppendMessageWithFormat("file %" PRIu64 " closed.\n", fd); result.SetStatus(eReturnStatusSuccessFinishResult); } else { result.AppendError(error.AsCString()); result.SetStatus(eReturnStatusFailed); } } else { result.AppendError("no platform currently selected\n"); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } }; // "platform fread" static constexpr OptionDefinition g_platform_fread_options[] = { // clang-format off { LLDB_OPT_SET_1, false, "offset", 'o', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypeIndex, "Offset into the file at which to start reading." }, { LLDB_OPT_SET_1, false, "count", 'c', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypeCount, "Number of bytes to read from the file." }, // clang-format on }; class CommandObjectPlatformFRead : public CommandObjectParsed { public: CommandObjectPlatformFRead(CommandInterpreter &interpreter) : CommandObjectParsed(interpreter, "platform file read", "Read data from a file on the remote end.", nullptr, 0), m_options() {} ~CommandObjectPlatformFRead() override = default; bool DoExecute(Args &args, CommandReturnObject &result) override { PlatformSP platform_sp( GetDebugger().GetPlatformList().GetSelectedPlatform()); if (platform_sp) { std::string cmd_line; args.GetCommandString(cmd_line); const lldb::user_id_t fd = StringConvert::ToUInt64(cmd_line.c_str(), UINT64_MAX); std::string buffer(m_options.m_count, 0); Status error; uint32_t retcode = platform_sp->ReadFile( fd, m_options.m_offset, &buffer[0], m_options.m_count, error); result.AppendMessageWithFormat("Return = %d\n", retcode); result.AppendMessageWithFormat("Data = \"%s\"\n", buffer.c_str()); result.SetStatus(eReturnStatusSuccessFinishResult); } else { result.AppendError("no platform currently selected\n"); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } Options *GetOptions() override { return &m_options; } protected: class CommandOptions : public Options { public: CommandOptions() : Options() {} ~CommandOptions() override = default; Status SetOptionValue(uint32_t option_idx, llvm::StringRef option_arg, ExecutionContext *execution_context) override { Status error; char short_option = (char)m_getopt_table[option_idx].val; switch (short_option) { case 'o': if (option_arg.getAsInteger(0, m_offset)) error.SetErrorStringWithFormat("invalid offset: '%s'", option_arg.str().c_str()); break; case 'c': if (option_arg.getAsInteger(0, m_count)) error.SetErrorStringWithFormat("invalid offset: '%s'", option_arg.str().c_str()); break; default: error.SetErrorStringWithFormat("unrecognized option '%c'", short_option); break; } return error; } void OptionParsingStarting(ExecutionContext *execution_context) override { m_offset = 0; m_count = 1; } llvm::ArrayRef GetDefinitions() override { return llvm::makeArrayRef(g_platform_fread_options); } // Instance variables to hold the values for command options. uint32_t m_offset; uint32_t m_count; }; CommandOptions m_options; }; // "platform fwrite" static constexpr OptionDefinition g_platform_fwrite_options[] = { // clang-format off { LLDB_OPT_SET_1, false, "offset", 'o', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypeIndex, "Offset into the file at which to start reading." }, { LLDB_OPT_SET_1, false, "data", 'd', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypeValue, "Text to write to the file." }, // clang-format on }; class CommandObjectPlatformFWrite : public CommandObjectParsed { public: CommandObjectPlatformFWrite(CommandInterpreter &interpreter) : CommandObjectParsed(interpreter, "platform file write", "Write data to a file on the remote end.", nullptr, 0), m_options() {} ~CommandObjectPlatformFWrite() override = default; bool DoExecute(Args &args, CommandReturnObject &result) override { PlatformSP platform_sp( GetDebugger().GetPlatformList().GetSelectedPlatform()); if (platform_sp) { std::string cmd_line; args.GetCommandString(cmd_line); Status error; const lldb::user_id_t fd = StringConvert::ToUInt64(cmd_line.c_str(), UINT64_MAX); uint32_t retcode = platform_sp->WriteFile(fd, m_options.m_offset, &m_options.m_data[0], m_options.m_data.size(), error); result.AppendMessageWithFormat("Return = %d\n", retcode); result.SetStatus(eReturnStatusSuccessFinishResult); } else { result.AppendError("no platform currently selected\n"); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } Options *GetOptions() override { return &m_options; } protected: class CommandOptions : public Options { public: CommandOptions() : Options() {} ~CommandOptions() override = default; Status SetOptionValue(uint32_t option_idx, llvm::StringRef option_arg, ExecutionContext *execution_context) override { Status error; char short_option = (char)m_getopt_table[option_idx].val; switch (short_option) { case 'o': if (option_arg.getAsInteger(0, m_offset)) error.SetErrorStringWithFormat("invalid offset: '%s'", option_arg.str().c_str()); break; case 'd': m_data.assign(option_arg); break; default: error.SetErrorStringWithFormat("unrecognized option '%c'", short_option); break; } return error; } void OptionParsingStarting(ExecutionContext *execution_context) override { m_offset = 0; m_data.clear(); } llvm::ArrayRef GetDefinitions() override { return llvm::makeArrayRef(g_platform_fwrite_options); } // Instance variables to hold the values for command options. uint32_t m_offset; std::string m_data; }; CommandOptions m_options; }; class CommandObjectPlatformFile : public CommandObjectMultiword { public: // Constructors and Destructors CommandObjectPlatformFile(CommandInterpreter &interpreter) : CommandObjectMultiword( interpreter, "platform file", "Commands to access files on the current platform.", "platform file [open|close|read|write] ...") { LoadSubCommand( "open", CommandObjectSP(new CommandObjectPlatformFOpen(interpreter))); LoadSubCommand( "close", CommandObjectSP(new CommandObjectPlatformFClose(interpreter))); LoadSubCommand( "read", CommandObjectSP(new CommandObjectPlatformFRead(interpreter))); LoadSubCommand( "write", CommandObjectSP(new CommandObjectPlatformFWrite(interpreter))); } ~CommandObjectPlatformFile() override = default; private: // For CommandObjectPlatform only DISALLOW_COPY_AND_ASSIGN(CommandObjectPlatformFile); }; // "platform get-file remote-file-path host-file-path" class CommandObjectPlatformGetFile : public CommandObjectParsed { public: CommandObjectPlatformGetFile(CommandInterpreter &interpreter) : CommandObjectParsed( interpreter, "platform get-file", "Transfer a file from the remote end to the local host.", "platform get-file ", 0) { SetHelpLong( R"(Examples: (lldb) platform get-file /the/remote/file/path /the/local/file/path Transfer a file from the remote end with file path /the/remote/file/path to the local host.)"); CommandArgumentEntry arg1, arg2; CommandArgumentData file_arg_remote, file_arg_host; // Define the first (and only) variant of this arg. file_arg_remote.arg_type = eArgTypeFilename; file_arg_remote.arg_repetition = eArgRepeatPlain; // There is only one variant this argument could be; put it into the // argument entry. arg1.push_back(file_arg_remote); // Define the second (and only) variant of this arg. file_arg_host.arg_type = eArgTypeFilename; file_arg_host.arg_repetition = eArgRepeatPlain; // There is only one variant this argument could be; put it into the // argument entry. arg2.push_back(file_arg_host); // Push the data for the first and the second arguments into the // m_arguments vector. m_arguments.push_back(arg1); m_arguments.push_back(arg2); } ~CommandObjectPlatformGetFile() override = default; bool DoExecute(Args &args, CommandReturnObject &result) override { // If the number of arguments is incorrect, issue an error message. if (args.GetArgumentCount() != 2) { result.GetErrorStream().Printf("error: required arguments missing; " "specify both the source and destination " "file paths\n"); result.SetStatus(eReturnStatusFailed); return false; } PlatformSP platform_sp( GetDebugger().GetPlatformList().GetSelectedPlatform()); if (platform_sp) { const char *remote_file_path = args.GetArgumentAtIndex(0); const char *local_file_path = args.GetArgumentAtIndex(1); Status error = platform_sp->GetFile(FileSpec(remote_file_path), FileSpec(local_file_path)); if (error.Success()) { result.AppendMessageWithFormat( "successfully get-file from %s (remote) to %s (host)\n", remote_file_path, local_file_path); result.SetStatus(eReturnStatusSuccessFinishResult); } else { result.AppendMessageWithFormat("get-file failed: %s\n", error.AsCString()); result.SetStatus(eReturnStatusFailed); } } else { result.AppendError("no platform currently selected\n"); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } }; // "platform get-size remote-file-path" class CommandObjectPlatformGetSize : public CommandObjectParsed { public: CommandObjectPlatformGetSize(CommandInterpreter &interpreter) : CommandObjectParsed(interpreter, "platform get-size", "Get the file size from the remote end.", "platform get-size ", 0) { SetHelpLong( R"(Examples: (lldb) platform get-size /the/remote/file/path Get the file size from the remote end with path /the/remote/file/path.)"); CommandArgumentEntry arg1; CommandArgumentData file_arg_remote; // Define the first (and only) variant of this arg. file_arg_remote.arg_type = eArgTypeFilename; file_arg_remote.arg_repetition = eArgRepeatPlain; // There is only one variant this argument could be; put it into the // argument entry. arg1.push_back(file_arg_remote); // Push the data for the first argument into the m_arguments vector. m_arguments.push_back(arg1); } ~CommandObjectPlatformGetSize() override = default; bool DoExecute(Args &args, CommandReturnObject &result) override { // If the number of arguments is incorrect, issue an error message. if (args.GetArgumentCount() != 1) { result.GetErrorStream().Printf("error: required argument missing; " "specify the source file path as the only " "argument\n"); result.SetStatus(eReturnStatusFailed); return false; } PlatformSP platform_sp( GetDebugger().GetPlatformList().GetSelectedPlatform()); if (platform_sp) { std::string remote_file_path(args.GetArgumentAtIndex(0)); user_id_t size = platform_sp->GetFileSize(FileSpec(remote_file_path)); if (size != UINT64_MAX) { result.AppendMessageWithFormat("File size of %s (remote): %" PRIu64 "\n", remote_file_path.c_str(), size); result.SetStatus(eReturnStatusSuccessFinishResult); } else { result.AppendMessageWithFormat( "Error getting file size of %s (remote)\n", remote_file_path.c_str()); result.SetStatus(eReturnStatusFailed); } } else { result.AppendError("no platform currently selected\n"); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } }; // "platform put-file" class CommandObjectPlatformPutFile : public CommandObjectParsed { public: CommandObjectPlatformPutFile(CommandInterpreter &interpreter) : CommandObjectParsed( interpreter, "platform put-file", "Transfer a file from this system to the remote end.", nullptr, 0) { } ~CommandObjectPlatformPutFile() override = default; bool DoExecute(Args &args, CommandReturnObject &result) override { const char *src = args.GetArgumentAtIndex(0); const char *dst = args.GetArgumentAtIndex(1); FileSpec src_fs(src); FileSystem::Instance().Resolve(src_fs); FileSpec dst_fs(dst ? dst : src_fs.GetFilename().GetCString()); PlatformSP platform_sp( GetDebugger().GetPlatformList().GetSelectedPlatform()); if (platform_sp) { Status error(platform_sp->PutFile(src_fs, dst_fs)); if (error.Success()) { result.SetStatus(eReturnStatusSuccessFinishNoResult); } else { result.AppendError(error.AsCString()); result.SetStatus(eReturnStatusFailed); } } else { result.AppendError("no platform currently selected\n"); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } }; // "platform process launch" class CommandObjectPlatformProcessLaunch : public CommandObjectParsed { public: CommandObjectPlatformProcessLaunch(CommandInterpreter &interpreter) : CommandObjectParsed(interpreter, "platform process launch", "Launch a new process on a remote platform.", "platform process launch program", eCommandRequiresTarget | eCommandTryTargetAPILock), m_options() {} ~CommandObjectPlatformProcessLaunch() override = default; Options *GetOptions() override { return &m_options; } protected: bool DoExecute(Args &args, CommandReturnObject &result) override { Target *target = GetDebugger().GetSelectedTarget().get(); PlatformSP platform_sp; if (target) { platform_sp = target->GetPlatform(); } if (!platform_sp) { platform_sp = GetDebugger().GetPlatformList().GetSelectedPlatform(); } if (platform_sp) { Status error; const size_t argc = args.GetArgumentCount(); Target *target = m_exe_ctx.GetTargetPtr(); Module *exe_module = target->GetExecutableModulePointer(); if (exe_module) { m_options.launch_info.GetExecutableFile() = exe_module->GetFileSpec(); llvm::SmallString<128> exe_path; m_options.launch_info.GetExecutableFile().GetPath(exe_path); if (!exe_path.empty()) m_options.launch_info.GetArguments().AppendArgument(exe_path); m_options.launch_info.GetArchitecture() = exe_module->GetArchitecture(); } if (argc > 0) { if (m_options.launch_info.GetExecutableFile()) { // We already have an executable file, so we will use this and all // arguments to this function are extra arguments m_options.launch_info.GetArguments().AppendArguments(args); } else { // We don't have any file yet, so the first argument is our // executable, and the rest are program arguments const bool first_arg_is_executable = true; m_options.launch_info.SetArguments(args, first_arg_is_executable); } } if (m_options.launch_info.GetExecutableFile()) { Debugger &debugger = GetDebugger(); if (argc == 0) target->GetRunArguments(m_options.launch_info.GetArguments()); ProcessSP process_sp(platform_sp->DebugProcess( m_options.launch_info, debugger, target, error)); if (process_sp && process_sp->IsAlive()) { result.SetStatus(eReturnStatusSuccessFinishNoResult); return true; } if (error.Success()) result.AppendError("process launch failed"); else result.AppendError(error.AsCString()); result.SetStatus(eReturnStatusFailed); } else { result.AppendError("'platform process launch' uses the current target " "file and arguments, or the executable and its " "arguments can be specified in this command"); result.SetStatus(eReturnStatusFailed); return false; } } else { result.AppendError("no platform is selected\n"); } return result.Succeeded(); } protected: ProcessLaunchCommandOptions m_options; }; // "platform process list" static OptionDefinition g_platform_process_list_options[] = { // clang-format off { LLDB_OPT_SET_1, false, "pid", 'p', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypePid, "List the process info for a specific process ID." }, { LLDB_OPT_SET_2, true, "name", 'n', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypeProcessName, "Find processes with executable basenames that match a string." }, { LLDB_OPT_SET_3, true, "ends-with", 'e', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypeProcessName, "Find processes with executable basenames that end with a string." }, { LLDB_OPT_SET_4, true, "starts-with", 's', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypeProcessName, "Find processes with executable basenames that start with a string." }, { LLDB_OPT_SET_5, true, "contains", 'c', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypeProcessName, "Find processes with executable basenames that contain a string." }, { LLDB_OPT_SET_6, true, "regex", 'r', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypeRegularExpression, "Find processes with executable basenames that match a regular expression." }, { LLDB_OPT_SET_FROM_TO(2, 6), false, "parent", 'P', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypePid, "Find processes that have a matching parent process ID." }, { LLDB_OPT_SET_FROM_TO(2, 6), false, "uid", 'u', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypeUnsignedInteger, "Find processes that have a matching user ID." }, { LLDB_OPT_SET_FROM_TO(2, 6), false, "euid", 'U', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypeUnsignedInteger, "Find processes that have a matching effective user ID." }, { LLDB_OPT_SET_FROM_TO(2, 6), false, "gid", 'g', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypeUnsignedInteger, "Find processes that have a matching group ID." }, { LLDB_OPT_SET_FROM_TO(2, 6), false, "egid", 'G', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypeUnsignedInteger, "Find processes that have a matching effective group ID." }, { LLDB_OPT_SET_FROM_TO(2, 6), false, "arch", 'a', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypeArchitecture, "Find processes that have a matching architecture." }, { LLDB_OPT_SET_FROM_TO(1, 6), false, "show-args", 'A', OptionParser::eNoArgument, nullptr, {}, 0, eArgTypeNone, "Show process arguments instead of the process executable basename." }, { LLDB_OPT_SET_FROM_TO(1, 6), false, "verbose", 'v', OptionParser::eNoArgument, nullptr, {}, 0, eArgTypeNone, "Enable verbose output." }, // clang-format on }; class CommandObjectPlatformProcessList : public CommandObjectParsed { public: CommandObjectPlatformProcessList(CommandInterpreter &interpreter) : CommandObjectParsed(interpreter, "platform process list", "List processes on a remote platform by name, pid, " "or many other matching attributes.", "platform process list", 0), m_options() {} ~CommandObjectPlatformProcessList() override = default; Options *GetOptions() override { return &m_options; } protected: bool DoExecute(Args &args, CommandReturnObject &result) override { Target *target = GetDebugger().GetSelectedTarget().get(); PlatformSP platform_sp; if (target) { platform_sp = target->GetPlatform(); } if (!platform_sp) { platform_sp = GetDebugger().GetPlatformList().GetSelectedPlatform(); } if (platform_sp) { Status error; if (args.GetArgumentCount() == 0) { if (platform_sp) { Stream &ostrm = result.GetOutputStream(); lldb::pid_t pid = m_options.match_info.GetProcessInfo().GetProcessID(); if (pid != LLDB_INVALID_PROCESS_ID) { ProcessInstanceInfo proc_info; if (platform_sp->GetProcessInfo(pid, proc_info)) { ProcessInstanceInfo::DumpTableHeader(ostrm, m_options.show_args, m_options.verbose); proc_info.DumpAsTableRow(ostrm, platform_sp->GetUserIDResolver(), m_options.show_args, m_options.verbose); result.SetStatus(eReturnStatusSuccessFinishResult); } else { result.AppendErrorWithFormat( "no process found with pid = %" PRIu64 "\n", pid); result.SetStatus(eReturnStatusFailed); } } else { ProcessInstanceInfoList proc_infos; const uint32_t matches = platform_sp->FindProcesses(m_options.match_info, proc_infos); const char *match_desc = nullptr; const char *match_name = m_options.match_info.GetProcessInfo().GetName(); if (match_name && match_name[0]) { switch (m_options.match_info.GetNameMatchType()) { case NameMatch::Ignore: break; case NameMatch::Equals: match_desc = "matched"; break; case NameMatch::Contains: match_desc = "contained"; break; case NameMatch::StartsWith: match_desc = "started with"; break; case NameMatch::EndsWith: match_desc = "ended with"; break; case NameMatch::RegularExpression: match_desc = "matched the regular expression"; break; } } if (matches == 0) { if (match_desc) result.AppendErrorWithFormat( "no processes were found that %s \"%s\" on the \"%s\" " "platform\n", match_desc, match_name, platform_sp->GetPluginName().GetCString()); else result.AppendErrorWithFormat( "no processes were found on the \"%s\" platform\n", platform_sp->GetPluginName().GetCString()); result.SetStatus(eReturnStatusFailed); } else { result.AppendMessageWithFormat( "%u matching process%s found on \"%s\"", matches, matches > 1 ? "es were" : " was", platform_sp->GetName().GetCString()); if (match_desc) result.AppendMessageWithFormat(" whose name %s \"%s\"", match_desc, match_name); result.AppendMessageWithFormat("\n"); ProcessInstanceInfo::DumpTableHeader(ostrm, m_options.show_args, m_options.verbose); for (uint32_t i = 0; i < matches; ++i) { proc_infos.GetProcessInfoAtIndex(i).DumpAsTableRow( ostrm, platform_sp->GetUserIDResolver(), m_options.show_args, m_options.verbose); } } } } } else { result.AppendError("invalid args: process list takes only options\n"); result.SetStatus(eReturnStatusFailed); } } else { result.AppendError("no platform is selected\n"); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } class CommandOptions : public Options { public: CommandOptions() : Options(), match_info(), show_args(false), verbose(false) { static llvm::once_flag g_once_flag; llvm::call_once(g_once_flag, []() { PosixPlatformCommandOptionValidator *posix_validator = new PosixPlatformCommandOptionValidator(); for (auto &Option : g_platform_process_list_options) { switch (Option.short_option) { case 'u': case 'U': case 'g': case 'G': Option.validator = posix_validator; break; default: break; } } }); } ~CommandOptions() override = default; Status SetOptionValue(uint32_t option_idx, llvm::StringRef option_arg, ExecutionContext *execution_context) override { Status error; const int short_option = m_getopt_table[option_idx].val; bool success = false; uint32_t id = LLDB_INVALID_PROCESS_ID; success = !option_arg.getAsInteger(0, id); switch (short_option) { case 'p': { match_info.GetProcessInfo().SetProcessID(id); if (!success) error.SetErrorStringWithFormat("invalid process ID string: '%s'", option_arg.str().c_str()); break; } case 'P': match_info.GetProcessInfo().SetParentProcessID(id); if (!success) error.SetErrorStringWithFormat( "invalid parent process ID string: '%s'", option_arg.str().c_str()); break; case 'u': match_info.GetProcessInfo().SetUserID(success ? id : UINT32_MAX); if (!success) error.SetErrorStringWithFormat("invalid user ID string: '%s'", option_arg.str().c_str()); break; case 'U': match_info.GetProcessInfo().SetEffectiveUserID(success ? id : UINT32_MAX); if (!success) error.SetErrorStringWithFormat( "invalid effective user ID string: '%s'", option_arg.str().c_str()); break; case 'g': match_info.GetProcessInfo().SetGroupID(success ? id : UINT32_MAX); if (!success) error.SetErrorStringWithFormat("invalid group ID string: '%s'", option_arg.str().c_str()); break; case 'G': match_info.GetProcessInfo().SetEffectiveGroupID(success ? id : UINT32_MAX); if (!success) error.SetErrorStringWithFormat( "invalid effective group ID string: '%s'", option_arg.str().c_str()); break; case 'a': { TargetSP target_sp = execution_context ? execution_context->GetTargetSP() : TargetSP(); DebuggerSP debugger_sp = target_sp ? target_sp->GetDebugger().shared_from_this() : DebuggerSP(); PlatformSP platform_sp = debugger_sp ? debugger_sp->GetPlatformList().GetSelectedPlatform() : PlatformSP(); match_info.GetProcessInfo().GetArchitecture() = Platform::GetAugmentedArchSpec(platform_sp.get(), option_arg); } break; case 'n': match_info.GetProcessInfo().GetExecutableFile().SetFile( option_arg, FileSpec::Style::native); match_info.SetNameMatchType(NameMatch::Equals); break; case 'e': match_info.GetProcessInfo().GetExecutableFile().SetFile( option_arg, FileSpec::Style::native); match_info.SetNameMatchType(NameMatch::EndsWith); break; case 's': match_info.GetProcessInfo().GetExecutableFile().SetFile( option_arg, FileSpec::Style::native); match_info.SetNameMatchType(NameMatch::StartsWith); break; case 'c': match_info.GetProcessInfo().GetExecutableFile().SetFile( option_arg, FileSpec::Style::native); match_info.SetNameMatchType(NameMatch::Contains); break; case 'r': match_info.GetProcessInfo().GetExecutableFile().SetFile( option_arg, FileSpec::Style::native); match_info.SetNameMatchType(NameMatch::RegularExpression); break; case 'A': show_args = true; break; case 'v': verbose = true; break; default: error.SetErrorStringWithFormat("unrecognized option '%c'", short_option); break; } return error; } void OptionParsingStarting(ExecutionContext *execution_context) override { match_info.Clear(); show_args = false; verbose = false; } llvm::ArrayRef GetDefinitions() override { return llvm::makeArrayRef(g_platform_process_list_options); } // Instance variables to hold the values for command options. ProcessInstanceInfoMatch match_info; bool show_args; bool verbose; }; CommandOptions m_options; }; // "platform process info" class CommandObjectPlatformProcessInfo : public CommandObjectParsed { public: CommandObjectPlatformProcessInfo(CommandInterpreter &interpreter) : CommandObjectParsed( interpreter, "platform process info", "Get detailed information for one or more process by process ID.", "platform process info [ ...]", 0) { CommandArgumentEntry arg; CommandArgumentData pid_args; // Define the first (and only) variant of this arg. pid_args.arg_type = eArgTypePid; pid_args.arg_repetition = eArgRepeatStar; // There is only one variant this argument could be; put it into the // argument entry. arg.push_back(pid_args); // Push the data for the first argument into the m_arguments vector. m_arguments.push_back(arg); } ~CommandObjectPlatformProcessInfo() override = default; protected: bool DoExecute(Args &args, CommandReturnObject &result) override { Target *target = GetDebugger().GetSelectedTarget().get(); PlatformSP platform_sp; if (target) { platform_sp = target->GetPlatform(); } if (!platform_sp) { platform_sp = GetDebugger().GetPlatformList().GetSelectedPlatform(); } if (platform_sp) { const size_t argc = args.GetArgumentCount(); if (argc > 0) { Status error; if (platform_sp->IsConnected()) { Stream &ostrm = result.GetOutputStream(); for (auto &entry : args.entries()) { lldb::pid_t pid; if (entry.ref.getAsInteger(0, pid)) { result.AppendErrorWithFormat("invalid process ID argument '%s'", entry.ref.str().c_str()); result.SetStatus(eReturnStatusFailed); break; } else { ProcessInstanceInfo proc_info; if (platform_sp->GetProcessInfo(pid, proc_info)) { ostrm.Printf("Process information for process %" PRIu64 ":\n", pid); proc_info.Dump(ostrm, platform_sp->GetUserIDResolver()); } else { ostrm.Printf("error: no process information is available for " "process %" PRIu64 "\n", pid); } ostrm.EOL(); } } } else { // Not connected... result.AppendErrorWithFormat( "not connected to '%s'", platform_sp->GetPluginName().GetCString()); result.SetStatus(eReturnStatusFailed); } } else { // No args result.AppendError("one or more process id(s) must be specified"); result.SetStatus(eReturnStatusFailed); } } else { result.AppendError("no platform is currently selected"); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } }; static constexpr OptionDefinition g_platform_process_attach_options[] = { // clang-format off { LLDB_OPT_SET_ALL, false, "plugin", 'P', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypePlugin, "Name of the process plugin you want to use." }, { LLDB_OPT_SET_1, false, "pid", 'p', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypePid, "The process ID of an existing process to attach to." }, { LLDB_OPT_SET_2, false, "name", 'n', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypeProcessName, "The name of the process to attach to." }, { LLDB_OPT_SET_2, false, "waitfor", 'w', OptionParser::eNoArgument, nullptr, {}, 0, eArgTypeNone, "Wait for the process with to launch." }, // clang-format on }; class CommandObjectPlatformProcessAttach : public CommandObjectParsed { public: class CommandOptions : public Options { public: CommandOptions() : Options() { // Keep default values of all options in one place: OptionParsingStarting // () OptionParsingStarting(nullptr); } ~CommandOptions() override = default; Status SetOptionValue(uint32_t option_idx, llvm::StringRef option_arg, ExecutionContext *execution_context) override { Status error; char short_option = (char)m_getopt_table[option_idx].val; switch (short_option) { case 'p': { lldb::pid_t pid = LLDB_INVALID_PROCESS_ID; if (option_arg.getAsInteger(0, pid)) { error.SetErrorStringWithFormat("invalid process ID '%s'", option_arg.str().c_str()); } else { attach_info.SetProcessID(pid); } } break; case 'P': attach_info.SetProcessPluginName(option_arg); break; case 'n': attach_info.GetExecutableFile().SetFile(option_arg, FileSpec::Style::native); break; case 'w': attach_info.SetWaitForLaunch(true); break; default: error.SetErrorStringWithFormat("invalid short option character '%c'", short_option); break; } return error; } void OptionParsingStarting(ExecutionContext *execution_context) override { attach_info.Clear(); } llvm::ArrayRef GetDefinitions() override { return llvm::makeArrayRef(g_platform_process_attach_options); } bool HandleOptionArgumentCompletion( CompletionRequest &request, OptionElementVector &opt_element_vector, int opt_element_index, CommandInterpreter &interpreter) override { int opt_arg_pos = opt_element_vector[opt_element_index].opt_arg_pos; int opt_defs_index = opt_element_vector[opt_element_index].opt_defs_index; // We are only completing the name option for now... if (GetDefinitions()[opt_defs_index].short_option == 'n') { // Are we in the name? // Look to see if there is a -P argument provided, and if so use that // plugin, otherwise use the default plugin. const char *partial_name = nullptr; partial_name = request.GetParsedLine().GetArgumentAtIndex(opt_arg_pos); PlatformSP platform_sp(interpreter.GetPlatform(true)); if (platform_sp) { ProcessInstanceInfoList process_infos; ProcessInstanceInfoMatch match_info; if (partial_name) { match_info.GetProcessInfo().GetExecutableFile().SetFile( partial_name, FileSpec::Style::native); match_info.SetNameMatchType(NameMatch::StartsWith); } platform_sp->FindProcesses(match_info, process_infos); const uint32_t num_matches = process_infos.GetSize(); if (num_matches > 0) { for (uint32_t i = 0; i < num_matches; ++i) { request.AddCompletion(llvm::StringRef( process_infos.GetProcessNameAtIndex(i), process_infos.GetProcessNameLengthAtIndex(i))); } } } } return false; } // Options table: Required for subclasses of Options. static OptionDefinition g_option_table[]; // Instance variables to hold the values for command options. ProcessAttachInfo attach_info; }; CommandObjectPlatformProcessAttach(CommandInterpreter &interpreter) : CommandObjectParsed(interpreter, "platform process attach", "Attach to a process.", "platform process attach "), m_options() {} ~CommandObjectPlatformProcessAttach() override = default; bool DoExecute(Args &command, CommandReturnObject &result) override { PlatformSP platform_sp( GetDebugger().GetPlatformList().GetSelectedPlatform()); if (platform_sp) { Status err; ProcessSP remote_process_sp = platform_sp->Attach( m_options.attach_info, GetDebugger(), nullptr, err); if (err.Fail()) { result.AppendError(err.AsCString()); result.SetStatus(eReturnStatusFailed); } else if (!remote_process_sp) { result.AppendError("could not attach: unknown reason"); result.SetStatus(eReturnStatusFailed); } else result.SetStatus(eReturnStatusSuccessFinishResult); } else { result.AppendError("no platform is currently selected"); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } Options *GetOptions() override { return &m_options; } protected: CommandOptions m_options; }; class CommandObjectPlatformProcess : public CommandObjectMultiword { public: // Constructors and Destructors CommandObjectPlatformProcess(CommandInterpreter &interpreter) : CommandObjectMultiword(interpreter, "platform process", "Commands to query, launch and attach to " "processes on the current platform.", "platform process [attach|launch|list] ...") { LoadSubCommand( "attach", CommandObjectSP(new CommandObjectPlatformProcessAttach(interpreter))); LoadSubCommand( "launch", CommandObjectSP(new CommandObjectPlatformProcessLaunch(interpreter))); LoadSubCommand("info", CommandObjectSP(new CommandObjectPlatformProcessInfo( interpreter))); LoadSubCommand("list", CommandObjectSP(new CommandObjectPlatformProcessList( interpreter))); } ~CommandObjectPlatformProcess() override = default; private: // For CommandObjectPlatform only DISALLOW_COPY_AND_ASSIGN(CommandObjectPlatformProcess); }; // "platform shell" static constexpr OptionDefinition g_platform_shell_options[] = { // clang-format off { LLDB_OPT_SET_ALL, false, "timeout", 't', OptionParser::eRequiredArgument, nullptr, {}, 0, eArgTypeValue, "Seconds to wait for the remote host to finish running the command." }, // clang-format on }; class CommandObjectPlatformShell : public CommandObjectRaw { public: class CommandOptions : public Options { public: CommandOptions() : Options() {} ~CommandOptions() override = default; llvm::ArrayRef GetDefinitions() override { return llvm::makeArrayRef(g_platform_shell_options); } Status SetOptionValue(uint32_t option_idx, llvm::StringRef option_arg, ExecutionContext *execution_context) override { Status error; const char short_option = (char)GetDefinitions()[option_idx].short_option; switch (short_option) { case 't': uint32_t timeout_sec; if (option_arg.getAsInteger(10, timeout_sec)) error.SetErrorStringWithFormat( "could not convert \"%s\" to a numeric value.", option_arg.str().c_str()); else timeout = std::chrono::seconds(timeout_sec); break; default: error.SetErrorStringWithFormat("invalid short option character '%c'", short_option); break; } return error; } void OptionParsingStarting(ExecutionContext *execution_context) override {} Timeout timeout = std::chrono::seconds(10); }; CommandObjectPlatformShell(CommandInterpreter &interpreter) : CommandObjectRaw(interpreter, "platform shell", "Run a shell command on the current platform.", "platform shell ", 0), m_options() {} ~CommandObjectPlatformShell() override = default; Options *GetOptions() override { return &m_options; } bool DoExecute(llvm::StringRef raw_command_line, CommandReturnObject &result) override { ExecutionContext exe_ctx = GetCommandInterpreter().GetExecutionContext(); m_options.NotifyOptionParsingStarting(&exe_ctx); // Print out an usage syntax on an empty command line. if (raw_command_line.empty()) { result.GetOutputStream().Printf("%s\n", this->GetSyntax().str().c_str()); return true; } OptionsWithRaw args(raw_command_line); const char *expr = args.GetRawPart().c_str(); if (args.HasArgs()) if (!ParseOptions(args.GetArgs(), result)) return false; PlatformSP platform_sp( GetDebugger().GetPlatformList().GetSelectedPlatform()); Status error; if (platform_sp) { FileSpec working_dir{}; std::string output; int status = -1; int signo = -1; error = (platform_sp->RunShellCommand(expr, working_dir, &status, &signo, &output, m_options.timeout)); if (!output.empty()) result.GetOutputStream().PutCString(output); if (status > 0) { if (signo > 0) { const char *signo_cstr = Host::GetSignalAsCString(signo); if (signo_cstr) result.GetOutputStream().Printf( "error: command returned with status %i and signal %s\n", status, signo_cstr); else result.GetOutputStream().Printf( "error: command returned with status %i and signal %i\n", status, signo); } else result.GetOutputStream().Printf( "error: command returned with status %i\n", status); } } else { result.GetOutputStream().Printf( "error: cannot run remote shell commands without a platform\n"); error.SetErrorString( "error: cannot run remote shell commands without a platform"); } if (error.Fail()) { result.AppendError(error.AsCString()); result.SetStatus(eReturnStatusFailed); } else { result.SetStatus(eReturnStatusSuccessFinishResult); } return true; } CommandOptions m_options; }; // "platform install" - install a target to a remote end class CommandObjectPlatformInstall : public CommandObjectParsed { public: CommandObjectPlatformInstall(CommandInterpreter &interpreter) : CommandObjectParsed( interpreter, "platform target-install", "Install a target (bundle or executable file) to the remote end.", "platform target-install ", 0) {} ~CommandObjectPlatformInstall() override = default; bool DoExecute(Args &args, CommandReturnObject &result) override { if (args.GetArgumentCount() != 2) { result.AppendError("platform target-install takes two arguments"); result.SetStatus(eReturnStatusFailed); return false; } // TODO: move the bulk of this code over to the platform itself FileSpec src(args.GetArgumentAtIndex(0)); FileSystem::Instance().Resolve(src); FileSpec dst(args.GetArgumentAtIndex(1)); if (!FileSystem::Instance().Exists(src)) { result.AppendError("source location does not exist or is not accessible"); result.SetStatus(eReturnStatusFailed); return false; } PlatformSP platform_sp( GetDebugger().GetPlatformList().GetSelectedPlatform()); if (!platform_sp) { result.AppendError("no platform currently selected"); result.SetStatus(eReturnStatusFailed); return false; } Status error = platform_sp->Install(src, dst); if (error.Success()) { result.SetStatus(eReturnStatusSuccessFinishNoResult); } else { result.AppendErrorWithFormat("install failed: %s", error.AsCString()); result.SetStatus(eReturnStatusFailed); } return result.Succeeded(); } }; CommandObjectPlatform::CommandObjectPlatform(CommandInterpreter &interpreter) : CommandObjectMultiword( interpreter, "platform", "Commands to manage and create platforms.", "platform [connect|disconnect|info|list|status|select] ...") { LoadSubCommand("select", CommandObjectSP(new CommandObjectPlatformSelect(interpreter))); LoadSubCommand("list", CommandObjectSP(new CommandObjectPlatformList(interpreter))); LoadSubCommand("status", CommandObjectSP(new CommandObjectPlatformStatus(interpreter))); LoadSubCommand("connect", CommandObjectSP( new CommandObjectPlatformConnect(interpreter))); LoadSubCommand( "disconnect", CommandObjectSP(new CommandObjectPlatformDisconnect(interpreter))); LoadSubCommand("settings", CommandObjectSP(new CommandObjectPlatformSettings( interpreter))); LoadSubCommand("mkdir", CommandObjectSP(new CommandObjectPlatformMkDir(interpreter))); LoadSubCommand("file", CommandObjectSP(new CommandObjectPlatformFile(interpreter))); LoadSubCommand("get-file", CommandObjectSP(new CommandObjectPlatformGetFile( interpreter))); LoadSubCommand("get-size", CommandObjectSP(new CommandObjectPlatformGetSize( interpreter))); LoadSubCommand("put-file", CommandObjectSP(new CommandObjectPlatformPutFile( interpreter))); LoadSubCommand("process", CommandObjectSP( new CommandObjectPlatformProcess(interpreter))); LoadSubCommand("shell", CommandObjectSP(new CommandObjectPlatformShell(interpreter))); LoadSubCommand( "target-install", CommandObjectSP(new CommandObjectPlatformInstall(interpreter))); } CommandObjectPlatform::~CommandObjectPlatform() = default;