//--------------------------------------------------------------------------- // // SCSI Target Emulator RaSCSI Reloaded // for Raspberry Pi // // Copyright (C) 2021-2022 Uwe Seimet // //--------------------------------------------------------------------------- #include "log.h" #include "controllers/controller_manager.h" #include "controllers/scsi_controller.h" #include "devices/device_factory.h" #include "devices/primary_device.h" #include "devices/disk.h" #include "devices/file_support.h" #include "rascsi_service.h" #include "rascsi_response.h" #include "rascsi_image.h" #include "rascsi_exceptions.h" #include "localizer.h" #include "command_util.h" #include "rasutil.h" #include "spdlog/spdlog.h" #include "rascsi_executor.h" #include using namespace spdlog; using namespace command_util; using namespace ras_util; bool RascsiExecutor::ProcessCmd(const CommandContext& context, const PbDeviceDefinition& pb_device, const PbCommand& command, bool dryRun) { PrintCommand(command, pb_device, dryRun); const int id = pb_device.id(); const int lun = pb_device.unit(); if (!ValidateIdAndLun(context, id, lun)) { return false; } const PbOperation operation = command.operation(); // For all commands except ATTACH the device and LUN must exist if (operation != ATTACH && !VerifyExistingIdAndLun(context, id, lun)) { return false; } auto device = controller_manager.GetDeviceByIdAndLun(id, lun); if (!ValidationOperationAgainstDevice(context, device, operation)) { return false; } switch (operation) { case START: return Start(device, dryRun); case STOP: return Stop(device, dryRun); case ATTACH: return Attach(context, pb_device, dryRun); case DETACH: return Detach(context, device, dryRun); case INSERT: return Insert(context, pb_device, device, dryRun); case EJECT: return Eject(device, dryRun); case PROTECT: return Protect(device, dryRun); case UNPROTECT: return Unprotect(device, dryRun); break; case CHECK_AUTHENTICATION: case NO_OPERATION: // Do nothing, just log LOGTRACE("Received %s command", PbOperation_Name(operation).c_str()) break; default: return ReturnLocalizedError(context, LocalizationKey::ERROR_OPERATION); } return true; } bool RascsiExecutor::ProcessCmd(const CommandContext& context, const PbCommand& command) { switch (command.operation()) { case DETACH_ALL: DetachAll(); return ReturnStatus(context); case RESERVE_IDS: { const string ids = GetParam(command, "ids"); if (string error = SetReservedIds(ids); !error.empty()) { return ReturnStatus(context, false, error); } return ReturnStatus(context); } case CREATE_IMAGE: return rascsi_image.CreateImage(context, command); case DELETE_IMAGE: return rascsi_image.DeleteImage(context, command); case RENAME_IMAGE: return rascsi_image.RenameImage(context, command); case COPY_IMAGE: return rascsi_image.CopyImage(context, command); case PROTECT_IMAGE: case UNPROTECT_IMAGE: return rascsi_image.SetImagePermissions(context, command); default: // This is a device-specific command handled below break; } // Remember the list of reserved files, than run the dry run const auto& reserved_files = FileSupport::GetReservedFiles(); for (const auto& device : command.devices()) { if (!ProcessCmd(context, device, command, true)) { // Dry run failed, restore the file list FileSupport::SetReservedFiles(reserved_files); return false; } } // Restore the list of reserved files before proceeding FileSupport::SetReservedFiles(reserved_files); if (string result = ValidateLunSetup(command); !result.empty()) { return ReturnStatus(context, false, result); } for (const auto& device : command.devices()) { if (!ProcessCmd(context, device, command, false)) { return false; } } // ATTACH and DETACH return the device list if (context.fd != -1 && (command.operation() == ATTACH || command.operation() == DETACH)) { // A new command with an empty device list is required here in order to return data for all devices PbCommand cmd; PbResult result; rascsi_response.GetDevicesInfo(result, cmd, rascsi_image.GetDefaultFolder()); serializer.SerializeMessage(context.fd, result); return true; } return ReturnStatus(context); } bool RascsiExecutor::SetLogLevel(const string& log_level) const { if (log_level == "trace") { set_level(level::trace); } else if (log_level == "debug") { set_level(level::debug); } else if (log_level == "info") { set_level(level::info); } else if (log_level == "warn") { set_level(level::warn); } else if (log_level == "err") { set_level(level::err); } else if (log_level == "critical") { set_level(level::critical); } else if (log_level == "off") { set_level(level::off); } else { LOGWARN("Invalid log level '%s'", log_level.c_str()) return false; } LOGINFO("Set log level to '%s'", log_level.c_str()) return true; } bool RascsiExecutor::Start(shared_ptr device, bool dryRun) const { if (!dryRun) { LOGINFO("Start requested for %s ID %d, unit %d", device->GetType().c_str(), device->GetId(), device->GetLun()) if (!device->Start()) { LOGWARN("Starting %s ID %d, unit %d failed", device->GetType().c_str(), device->GetId(), device->GetLun()) } } return true; } bool RascsiExecutor::Stop(shared_ptr device, bool dryRun) const { if (!dryRun) { LOGINFO("Stop requested for %s ID %d, unit %d", device->GetType().c_str(), device->GetId(), device->GetLun()) // STOP is idempotent device->Stop(); } return true; } bool RascsiExecutor::Eject(shared_ptr device, bool dryRun) const { if (!dryRun) { LOGINFO("Eject requested for %s ID %d, unit %d", device->GetType().c_str(), device->GetId(), device->GetLun()) if (!device->Eject(true)) { LOGWARN("Ejecting %s ID %d, unit %d failed", device->GetType().c_str(), device->GetId(), device->GetLun()) } } return true; } bool RascsiExecutor::Protect(shared_ptr device, bool dryRun) const { if (!dryRun) { LOGINFO("Write protection requested for %s ID %d, unit %d", device->GetType().c_str(), device->GetId(), device->GetLun()) // PROTECT is idempotent device->SetProtected(true); } return true; } bool RascsiExecutor::Unprotect(shared_ptr device, bool dryRun) const { if (!dryRun) { LOGINFO("Write unprotection requested for %s ID %d, unit %d", device->GetType().c_str(), device->GetId(), device->GetLun()) // UNPROTECT is idempotent device->SetProtected(false); } return true; } bool RascsiExecutor::Attach(const CommandContext& context, const PbDeviceDefinition& pb_device, bool dryRun) { const int id = pb_device.id(); const int lun = pb_device.unit(); const PbDeviceType type = pb_device.type(); if (lun >= ScsiController::LUN_MAX) { return ReturnLocalizedError(context, LocalizationKey::ERROR_INVALID_LUN, to_string(lun), to_string(ScsiController::LUN_MAX)); } if (controller_manager.GetDeviceByIdAndLun(id, lun) != nullptr) { return ReturnLocalizedError(context, LocalizationKey::ERROR_DUPLICATE_ID, to_string(id), to_string(lun)); } if (reserved_ids.find(id) != reserved_ids.end()) { return ReturnLocalizedError(context, LocalizationKey::ERROR_RESERVED_ID, to_string(id)); } string filename = GetParam(pb_device, "file"); auto device = CreateDevice(context, type, lun, filename); if (device == nullptr) { return false; } // If no filename was provided the medium is considered removed auto file_support = dynamic_cast(device.get()); device->SetRemoved(file_support != nullptr ? filename.empty() : false); if (!SetProductData(context, pb_device, device)) { return false; } if (!SetSectorSize(context, PbDeviceType_Name(type), device, pb_device.block_size())) { return false; } string full_path; if (file_support != nullptr) { // File check (type is HD, for removable media drives, CD and MO the medium (=file) may be inserted later if (!device->IsRemovable() && filename.empty()) { return ReturnLocalizedError(context, LocalizationKey::ERROR_MISSING_FILENAME, PbDeviceType_Name(type)); } if (!ValidateImageFile(context, device, filename, full_path)) { return false; } } // Only non read-only devices support protect/unprotect // This operation must not be executed before Open() because Open() overrides some settings. if (device->IsProtectable() && !device->IsReadOnly()) { device->SetProtected(pb_device.protected_()); } // Stop the dry run here, before permanently modifying something if (dryRun) { return true; } unordered_map params = { pb_device.params().begin(), pb_device.params().end() }; if (!device->SupportsFile()) { params.erase("file"); } if (!device->Init(params)) { return ReturnLocalizedError(context, LocalizationKey::ERROR_INITIALIZATION, PbDeviceType_Name(type), to_string(id), to_string(lun)); } if (!controller_manager.AttachToScsiController(id, device)) { return ReturnLocalizedError(context, LocalizationKey::ERROR_SCSI_CONTROLLER); } Filepath filepath; filepath.SetPath(full_path.c_str()); file_support->ReserveFile(filepath, id, lun); string msg = "Attached "; if (device->IsReadOnly()) { msg += "read-only "; } else if (device->IsProtectable() && device->IsProtected()) { msg += "protected "; } msg += device->GetType() + " device, ID " + to_string(id) + ", unit " + to_string(lun); LOGINFO("%s", msg.c_str()) return true; } bool RascsiExecutor::Insert(const CommandContext& context, const PbDeviceDefinition& pb_device, shared_ptr device, bool dryRun) const { if (!device->IsRemoved()) { return ReturnLocalizedError(context, LocalizationKey::ERROR_EJECT_REQUIRED); } if (!pb_device.vendor().empty() || !pb_device.product().empty() || !pb_device.revision().empty()) { return ReturnLocalizedError(context, LocalizationKey::ERROR_DEVICE_NAME_UPDATE); } string filename = GetParam(pb_device, "file"); if (filename.empty()) { return ReturnLocalizedError(context, LocalizationKey::ERROR_MISSING_FILENAME); } if (dryRun) { return true; } LOGINFO("Insert %sfile '%s' requested into %s ID %d, unit %d", pb_device.protected_() ? "protected " : "", filename.c_str(), device->GetType().c_str(), pb_device.id(), pb_device.unit()) if (!SetSectorSize(context, device->GetType(), device, pb_device.block_size())) { return false; } string full_path; if (!ValidateImageFile(context, device, filename, full_path)) { return false; } Filepath filepath; filepath.SetPath(full_path.c_str()); dynamic_pointer_cast(device)->ReserveFile(filepath, device->GetId(), device->GetLun()); // Only non read-only devices support protect/unprotect. // This operation must not be executed before Open() because Open() overrides some settings. if (device->IsProtectable() && !device->IsReadOnly()) { device->SetProtected(pb_device.protected_()); } if (auto disk = dynamic_pointer_cast(device); disk != nullptr) { disk->MediumChanged(); } return true; } bool RascsiExecutor::Detach(const CommandContext& context, shared_ptr device, bool dryRun) const { // LUN 0 can only be detached if there is no other LUN anymore if (!device->GetLun() && controller_manager.FindController(device->GetId())->GetLunCount() > 1) { return ReturnLocalizedError(context, LocalizationKey::ERROR_LUN0); } if (!dryRun) { // Prepare log string before the device data are lost due to deletion string s = "Detached " + device->GetType() + " device with ID " + to_string(device->GetId()) + ", unit " + to_string(device->GetLun()); if (auto file_support = dynamic_pointer_cast(device); file_support != nullptr) { file_support->UnreserveFile(); } auto controller = controller_manager.FindController(device->GetId()); if (controller == nullptr || !controller->DeleteDevice(device)) { return ReturnLocalizedError(context, LocalizationKey::ERROR_DETACH); } // If no LUN is left also delete the controller if (!controller->GetLunCount()) { controller_manager.DeleteController(controller); } LOGINFO("%s", s.c_str()) } return true; } void RascsiExecutor::DetachAll() { controller_manager.DeleteAllControllers(); FileSupport::UnreserveAll(); LOGINFO("Detached all devices") } bool RascsiExecutor::ShutDown(const CommandContext& context, const string& mode) { if (mode.empty()) { return ReturnLocalizedError(context, LocalizationKey::ERROR_SHUTDOWN_MODE_MISSING); } PbResult result; result.set_status(true); if (mode == "rascsi") { LOGINFO("RaSCSI shutdown requested") serializer.SerializeMessage(context.fd, result); return true; } if (mode != "system" && mode != "reboot") { return ReturnLocalizedError(context, LocalizationKey::ERROR_SHUTDOWN_MODE_INVALID, mode); } // The root user has UID 0 if (getuid()) { return ReturnLocalizedError(context, LocalizationKey::ERROR_SHUTDOWN_PERMISSION); } if (mode == "system") { LOGINFO("System shutdown requested") serializer.SerializeMessage(context.fd, result); DetachAll(); if (system("init 0") == -1) { LOGERROR("System shutdown failed: %s", strerror(errno)) } } else if (mode == "reboot") { LOGINFO("System reboot requested") serializer.SerializeMessage(context.fd, result); DetachAll(); if (system("init 6") == -1) { LOGERROR("System reboot failed: %s", strerror(errno)) } } else { assert(false); } return false; } string RascsiExecutor::SetReservedIds(string_view ids) { list ids_to_reserve; stringstream ss(ids.data()); string id; while (getline(ss, id, ',')) { if (!id.empty()) { ids_to_reserve.push_back(id); } } unordered_set reserved; for (string id_to_reserve : ids_to_reserve) { int res_id; if (!GetAsInt(id_to_reserve, res_id) || res_id > 7) { return "Invalid ID " + id_to_reserve; } if (controller_manager.FindController(res_id) != nullptr) { return "ID " + id_to_reserve + " is currently in use"; } reserved.insert(res_id); } reserved_ids = reserved; if (!reserved_ids.empty()) { string s; bool isFirst = true; for (auto const& reserved_id : reserved_ids) { if (!isFirst) { s += ", "; } isFirst = false; s += to_string(reserved_id); } LOGINFO("Reserved ID(s) set to %s", s.c_str()) } else { LOGINFO("Cleared reserved ID(s)") } return ""; } bool RascsiExecutor::ValidateImageFile(const CommandContext& context, shared_ptr device, const string& filename, string& full_path) const { auto file_support = dynamic_pointer_cast(device); if (file_support == nullptr || filename.empty()) { return true; } int id; int lun; Filepath filepath; filepath.SetPath(filename.c_str()); if (FileSupport::GetIdsForReservedFile(filepath, id, lun)) { return ReturnLocalizedError(context, LocalizationKey::ERROR_IMAGE_IN_USE, filename, to_string(id), to_string(lun)); } string initial_filename = filepath.GetPath(); try { if (!file_support->FileExists(filepath)) { // If the file does not exist search for it in the default image folder filepath.SetPath((rascsi_image.GetDefaultFolder() + "/" + filename).c_str()); if (FileSupport::GetIdsForReservedFile(filepath, id, lun)) { return ReturnLocalizedError(context, LocalizationKey::ERROR_IMAGE_IN_USE, filename, to_string(id), to_string(lun)); } file_support->Open(filepath); } } catch(const io_exception& e) { return ReturnLocalizedError(context, LocalizationKey::ERROR_FILE_OPEN, initial_filename, e.get_msg()); } full_path = filepath.GetPath(); return true; } void RascsiExecutor::PrintCommand(const PbCommand& command, const PbDeviceDefinition& pb_device, bool dryRun) const { const map> params = { command.params().begin(), command.params().end() }; ostringstream s; s << (dryRun ? "Validating" : "Executing"); s << ": operation=" << PbOperation_Name(command.operation()); if (!params.empty()) { s << ", command params="; bool isFirst = true; for (const auto& [key, value]: params) { if (!isFirst) { s << ", "; } isFirst = false; string v = key != "token" ? value : "???"; s << "'" << key << "=" << v << "'"; } } s << ", device id=" << pb_device.id() << ", lun=" << pb_device.unit() << ", type=" << PbDeviceType_Name(pb_device.type()); if (pb_device.params_size()) { s << ", device params="; bool isFirst = true; for (const auto& [key, value]: pb_device.params()) { if (!isFirst) { s << ":"; } isFirst = false; s << "'" << key << "=" << value << "'"; } } s << ", vendor='" << pb_device.vendor() << "', product='" << pb_device.product() << "', revision='" << pb_device.revision() << "', block size=" << pb_device.block_size(); LOGINFO("%s", s.str().c_str()) } string RascsiExecutor::ValidateLunSetup(const PbCommand& command) const { // Mapping of available LUNs (bit vector) to devices unordered_map luns; // Collect LUN bit vectors of new devices for (const auto& device : command.devices()) { luns[device.id()] |= 1 << device.unit(); } // Collect LUN bit vectors of existing devices for (const auto& device : controller_manager.GetAllDevices()) { luns[device->GetId()] |= 1 << device->GetLun(); } // LUN 0 must exist for all devices for (auto const& [id, lun]: luns) { if (!(lun & 0x01)) { return "LUN 0 is missing for device ID " + to_string(id); } } return ""; } bool RascsiExecutor::VerifyExistingIdAndLun(const CommandContext& context, int id, int lun) const { if (controller_manager.FindController(id) == nullptr) { return ReturnLocalizedError(context, LocalizationKey::ERROR_NON_EXISTING_DEVICE, to_string(id)); } if (controller_manager.GetDeviceByIdAndLun(id, lun) == nullptr) { return ReturnLocalizedError(context, LocalizationKey::ERROR_NON_EXISTING_UNIT, to_string(id), to_string(lun)); } return true; } shared_ptr RascsiExecutor::CreateDevice(const CommandContext& context, const PbDeviceType type, int lun, const string& filename) const { auto device = device_factory.CreateDevice(controller_manager, type, lun, filename); if (device == nullptr) { if (type == UNDEFINED) { ReturnLocalizedError(context, LocalizationKey::ERROR_MISSING_DEVICE_TYPE, filename); } else { ReturnLocalizedError(context, LocalizationKey::ERROR_UNKNOWN_DEVICE_TYPE, PbDeviceType_Name(type)); } } return device; } bool RascsiExecutor::SetSectorSize(const CommandContext& context, const string& type, shared_ptr device, int block_size) const { if (block_size) { auto disk = dynamic_pointer_cast(device); if (disk != nullptr && disk->IsSectorSizeConfigurable()) { if (!disk->SetConfiguredSectorSize(device_factory, block_size)) { return ReturnLocalizedError(context, LocalizationKey::ERROR_BLOCK_SIZE, to_string(block_size)); } } else { return ReturnLocalizedError(context, LocalizationKey::ERROR_BLOCK_SIZE_NOT_CONFIGURABLE, type); } } return true; } bool RascsiExecutor::ValidationOperationAgainstDevice(const CommandContext& context, const shared_ptr device, const PbOperation& operation) { const string& type = device->GetType(); if ((operation == START || operation == STOP) && !device->IsStoppable()) { return ReturnLocalizedError(context, LocalizationKey::ERROR_OPERATION_DENIED_STOPPABLE, type); } if ((operation == INSERT || operation == EJECT) && !device->IsRemovable()) { return ReturnLocalizedError(context, LocalizationKey::ERROR_OPERATION_DENIED_REMOVABLE, type); } if ((operation == PROTECT || operation == UNPROTECT) && !device->IsProtectable()) { return ReturnLocalizedError(context, LocalizationKey::ERROR_OPERATION_DENIED_PROTECTABLE, type); } if ((operation == PROTECT || operation == UNPROTECT) && !device->IsReady()) { return ReturnLocalizedError(context, LocalizationKey::ERROR_OPERATION_DENIED_READY, type); } return true; } bool RascsiExecutor::ValidateIdAndLun(const CommandContext& context, int id, int lun) { // Validate the device ID and LUN if (id < 0) { return ReturnLocalizedError(context, LocalizationKey::ERROR_MISSING_DEVICE_ID); } if (id >= ControllerManager::DEVICE_MAX) { return ReturnLocalizedError(context, LocalizationKey::ERROR_INVALID_ID, to_string(id), to_string(ControllerManager::DEVICE_MAX - 1)); } if (lun < 0 || lun >= ScsiController::LUN_MAX) { return ReturnLocalizedError(context, LocalizationKey::ERROR_INVALID_LUN, to_string(lun), to_string(ScsiController::LUN_MAX - 1)); } return true; } bool RascsiExecutor::SetProductData(const CommandContext& context, const PbDeviceDefinition& pb_device, shared_ptr device) { try { if (!pb_device.vendor().empty()) { device->SetVendor(pb_device.vendor()); } if (!pb_device.product().empty()) { device->SetProduct(pb_device.product()); } if (!pb_device.revision().empty()) { device->SetRevision(pb_device.revision()); } } catch(const invalid_argument& e) { return ReturnStatus(context, false, e.what()); } return true; }