#include "elevation.h" #include "child_process.h" #include "kernel_context.h" #include "text.h" #include #include #include #include #include namespace raven { namespace { // Folder locations by CSIDL, relative to the user profile unless the path is absolute. std::optional folder_for(int csidl, const std::u16string &profile, bool wow64 = false) { switch (csidl & 0xff) { case 0x00: case 0x10: return profile + u"\\Desktop"; case 0x02: return profile + u"\\AppData\\Roaming\\Microsoft\\Windows\\Start Menu\\Programs"; case 0x05: return profile + u"\\Documents"; case 0x06: return profile + u"\\Favorites"; case 0x07: return profile + u"\\AppData\\Roaming\\Microsoft\\Windows\\Start Menu\\Programs\\Startup"; case 0x08: return profile + u"\\AppData\\Roaming\\Microsoft\\Windows\\Recent"; case 0x09: return profile + u"\\AppData\\Roaming\\Microsoft\\Windows\\SendTo"; case 0x0b: return profile + u"\\AppData\\Roaming\\Microsoft\\Windows\\Start Menu"; case 0x0d: return profile + u"\\Music"; case 0x0e: return profile + u"\\Videos"; case 0x14: return std::u16string(u"C:\\Windows\\Fonts"); case 0x15: return profile + u"\\AppData\\Roaming\\Microsoft\\Windows\\Templates"; case 0x16: return std::u16string(u"C:\\ProgramData\\Microsoft\\Windows\\Start Menu"); case 0x17: return std::u16string(u"C:\\ProgramData\\Microsoft\\Windows\\Start Menu\\Programs"); case 0x19: return std::u16string(u"C:\\Users\\Public\\Desktop"); case 0x1a: return profile + u"\\AppData\\Roaming"; case 0x1c: return profile + u"\\AppData\\Local"; case 0x20: return profile + u"\\AppData\\Local\\Microsoft\\Windows\\INetCache"; case 0x21: return profile + u"\\AppData\\Local\\Microsoft\\Windows\\INetCookies"; case 0x22: return profile + u"\\AppData\\Local\\Microsoft\\Windows\\History"; case 0x23: return std::u16string(u"C:\\ProgramData"); case 0x24: return std::u16string(u"C:\\Windows"); case 0x25: case 0x29: return std::u16string(u"C:\\Windows\\System32"); // A 32-bit program sees the 32-bit program directories, as on a 64-bit Windows. case 0x26: case 0x2b: if (wow64) return csidl == 0x2b ? std::u16string(u"C:\\Program Files (x86)\\Common Files") : std::u16string(u"C:\\Program Files (x86)"); return csidl == 0x2b ? std::u16string(u"C:\\Program Files\\Common Files") : std::u16string(u"C:\\Program Files"); case 0x27: return profile + u"\\Pictures"; case 0x28: return profile; case 0x2a: return std::u16string(u"C:\\Program Files (x86)"); case 0x2c: return std::u16string(u"C:\\Program Files (x86)\\Common Files"); default: return std::nullopt; } } // The folders a known folder id names, by the first word of the id; those that no CSIDL covers carry their own path. struct KnownFolder { uint32_t first; int csidl; const char16_t *path; }; constexpr KnownFolder known_folders[] = { {0xb4bfcc3a, 0x10, nullptr}, {0xfdd39ad0, 0x05, nullptr}, {0x374de290, -1, u"%PROFILE%\\Downloads"}, {0x4bd8d571, 0x0d, nullptr}, {0x33e28130, 0x27, nullptr}, {0x18989b1d, 0x0e, nullptr}, {0xf1b32785, 0x1c, nullptr}, {0xa520a1a4, -1, u"%PROFILE%\\AppData\\LocalLow"}, {0x3eb685db, 0x1a, nullptr}, {0x62ab5d82, 0x23, nullptr}, {0x905e63b6, 0x26, nullptr}, {0x7c5a40ef, 0x2a, nullptr}, {0x6d809377, -1, u"C:\\Program Files"}, {0xf7f1ed05, 0x2b, nullptr}, {0xde974d24, 0x2c, nullptr}, {0xf38bf404, 0x24, nullptr}, {0x1ac14e77, 0x25, nullptr}, {0xd65231b0, -1, u"C:\\Windows\\SysWOW64"}, {0x5e6c858f, 0x28, nullptr}, {0xfd228cb7, 0x14, nullptr}, {0xdfdf76a2, -1, u"C:\\Users\\Public"}, {0x625b53c3, 0x0b, nullptr}, {0xa77f5d77, 0x02, nullptr}, {0xb97d20bb, 0x07, nullptr}, {0x352481e8, 0x20, nullptr}, {0x2b0f765d, 0x21, nullptr}, {0xd9dc8a3b, 0x22, nullptr}, {0x4c5c32ff, -1, u"%PROFILE%\\Saved Games"}, {0x1777f761, 0x06, nullptr}, {0xa4115719, 0x16, nullptr}, {0x0139d44e, 0x17, nullptr}, {0xae50c081, 0x27, nullptr}}; // The double-NUL terminated file lists of SHFileOperation. std::vector file_list(ApiCall &call, uint64_t address) { std::vector result; if (!address) return result; for (;;) { auto item = call.wide(address, 32768); if (item.empty()) return result; address += (item.size() + 1) * 2; result.push_back(std::move(item)); } } } void register_shell_api(ApiRegistry ®istry, KernelContext &context) { auto &paths = context.paths; registry.add("SHGetFolderPathW", 5, [&paths](ApiCall &call) { const int csidl = call.i32(1); const auto location = folder_for(csidl, paths.user_profile(), call.process.mode() == NativeMode::x86); if (!location) { call.ret(0x80070057U); return; } if (const auto resolved = paths.resolve(*location); resolved && csidl & 0x8000) std::filesystem::create_directories(resolved->host); call.put_wide(call[4], *location, 260); call.ret(0); }); // A known folder id names the folder; the path comes in memory the program frees with CoTaskMemFree. registry.add("SHGetKnownFolderPath", 4, [&paths, &context](ApiCall &call) { if (!call[0] || !call[3]) { call.ret(0x80070057U); return; } const uint32_t first = call.load(call[0]); const bool wow64 = call.process.mode() == NativeMode::x86; std::optional location; for (const auto &folder : known_folders) { if (folder.first != first) continue; if (folder.csidl >= 0) location = folder_for(folder.csidl, paths.user_profile(), wow64); else { location = std::u16string(folder.path); if (const auto at = location->find(u"%PROFILE%"); at != location->npos) location->replace(at, 9, paths.user_profile()); } break; } if (!location) { call.ret(0x80070002U); return; } // KF_FLAG_CREATE makes the directory. if (const auto resolved = paths.resolve(*location); resolved && (call.u32(1) & 0x8000)) std::filesystem::create_directories(resolved->host); const auto memory = context.allocator.allocate((location->size() + 1) * 2, true); if (!memory) { call.ret(0x8007000EU); return; } call.put_wide(memory, *location, location->size() + 1); call.store_pointer(call[3], memory); call.ret(0); }); // A folder location as an item id list. Programs treat it as opaque: one item that carries the path, then the terminating empty item. registry.add("SHGetSpecialFolderLocation", 3, [&paths, &context](ApiCall &call) { if (!call[2]) { call.ret(0x80070057U); return; } const auto location = folder_for(call.i32(1), paths.user_profile(), call.process.mode() == NativeMode::x86); if (!location) { call.ret(0x80070002U); return; } if (const auto resolved = paths.resolve(*location); resolved && (call.i32(1) & 0x8000)) std::filesystem::create_directories(resolved->host); const size_t item = 4 + location->size() * 2; const auto address = context.allocator.allocate(item + 2, true); if (!address) { call.ret(0x8007000EU); return; } std::vector bytes(item + 2, 0); bytes[0] = uint8_t(item); bytes[1] = uint8_t(item >> 8); bytes[2] = 'R'; bytes[3] = 'V'; std::memcpy(bytes.data() + 4, location->data(), location->size() * 2); call.write(address, bytes); call.store_pointer(call[2], address); call.ret(0); }); registry.add("SHGetPathFromIDListW", 2, [](ApiCall &call) { if (!call[0] || !call[1]) { call.ret(0); return; } const auto header = call.read(call[0], 4); const size_t size = header[0] | header[1] << 8; if (size < 4 || size > 4 + 520 || header[2] != 'R' || header[3] != 'V') { call.ret(0); return; } const auto raw = call.read(call[0] + 4, size - 4); std::u16string text; for (size_t index = 0; index + 1 < raw.size(); index += 2) text.push_back(char16_t(raw[index] | raw[index + 1] << 8)); call.put_wide(call[1], text, 260); call.ret(1); }); registry.add("SHGetSpecialFolderPathW", 4, [&paths](ApiCall &call) { const int csidl = call.i32(2); const auto location = folder_for(csidl, paths.user_profile(), call.process.mode() == NativeMode::x86); if (!location) { call.ret(0); return; } if (const auto resolved = paths.resolve(*location); resolved && call.u32(3)) std::filesystem::create_directories(resolved->host); call.put_wide(call[1], *location, 260); call.ret(1); }); registry.add("SHCreateDirectory", 2, [&paths](ApiCall &call) { const auto resolved = paths.resolve(call.wide(call[1])); if (!resolved) { call.ret(123); return; } std::error_code error; std::filesystem::create_directories(resolved->host, error); call.ret(error ? 5 : 0); }); registry.add("SHCreateDirectoryExW", 3, [&paths](ApiCall &call) { const auto resolved = paths.resolve(call.wide(call[1])); if (!resolved) { call.ret(123); return; } std::error_code error; std::filesystem::create_directories(resolved->host, error); call.ret(error ? 5 : 0); }); registry.add("CommandLineToArgvW", 2, [&context](ApiCall &call) { const auto line = call.wide(call[0]); std::vector arguments; size_t at = 0; // Program name: quoted up to the next quote, otherwise up to the first blank. if (line.empty()) { arguments.push_back(context.launch.image_path); } else { std::u16string name; if (line[0] == u'"') { const auto end = line.find(u'"', 1); name = line.substr(1, end == line.npos ? line.npos : end - 1); at = end == line.npos ? line.size() : end + 1; } else { const auto end = line.find_first_of(u" \t"); name = line.substr(0, end); at = end == line.npos ? line.size() : end; } arguments.push_back(name); bool quoted = false; std::u16string current; bool started = false; for (; at <= line.size(); ++at) { const char16_t character = at < line.size() ? line[at] : u'\0'; if (!character || (!quoted && (character == u' ' || character == u'\t'))) { if (started) arguments.push_back(current); current.clear(); started = false; continue; } started = true; if (character == u'\\') { size_t slashes = 0; while (at < line.size() && line[at] == u'\\') { ++slashes; ++at; } if (at < line.size() && line[at] == u'"') { current.append(slashes / 2, u'\\'); if (slashes % 2) current.push_back(u'"'); else quoted = !quoted; } else { current.append(slashes, u'\\'); --at; } } else if (character == u'"') { quoted = !quoted; } else { current.push_back(character); } } } // The pointer array has the width of the caller's pointers, then the strings follow it in the same block. const size_t width = call.pointer_width(); size_t bytes = arguments.size() * width + width; for (const auto &argument : arguments) bytes += (argument.size() + 1) * 2; const auto block = context.allocator.allocate(bytes); if (!block) { call.fail(8); return; } uint64_t cursor = block + arguments.size() * width + width; for (size_t index = 0; index < arguments.size(); ++index) { call.store_pointer(block + index * width, cursor); call.put_wide(cursor, arguments[index], arguments[index].size() + 1); cursor += (arguments[index].size() + 1) * 2; } call.store_pointer(block + arguments.size() * width, 0); if (call[1]) call.store(call[1], int32_t(arguments.size())); call.ret(block); }); // The shell cannot show a tray icon or resolve file associations yet; callers see an honest failure. registry.add("Shell_NotifyIconW", 2, [](ApiCall &call) { call.fail(5); }); registry.add("SHGetFileInfoW", 5, [](ApiCall &call) { call.ret(0); }); registry.add("SHCreateItemFromParsingName", 4, [](ApiCall &call) { if (call[3]) call.store_pointer(call[3], 0); call.ret(0x80070002U); }); // The program runs as the host account, which holds administrator rights only when it is root. // The application identity only groups taskbar buttons; there is no taskbar to group them on. registry.add("SetCurrentProcessExplicitAppUserModelID", 1, [](ApiCall &call) { call.ret(0); }); // The account of a prefix is an administrator under User Account Control: the check answers yes only in an elevated process. // Raven does not stand for the privileges of the host account. // There are no default-program associations to ask about: the registration object is not available. registry.add("SHCreateAssociationRegistration", 2, [](ApiCall &call) { if (call[1]) call.store_pointer(call[1], 0); call.ret(0x80040154U); }); registry.add("IsUserAnAdmin", 0, [](ApiCall &call) { call.ret(process_elevated() ? 1 : 0); }); registry.add("DragQueryFileW", 4, [](ApiCall &call) { call.ret(0); }); registry.add("DragQueryPoint", 2, [](ApiCall &call) { call.ret(0); }); registry.add("DragFinish", 1, [](ApiCall &) {}); registry.add("DragAcceptFiles", 2, [](ApiCall &) {}); // Opens a program, a folder, a document or a URL the way the shell does. The result is the value ShellExecute reports: above 32 on // success, otherwise the error. A program that is started is handed back through `started`. const auto open_target = [&context, &paths](const std::u16string &operation, std::u16string target, const std::u16string ¶meters, const std::u16string &directory, std::shared_ptr &started) -> uint64_t { if (!equal_fold(operation, u"open") && !equal_fold(operation, u"edit") && !equal_fold(operation, u"explore") && !equal_fold(operation, u"runas")) return 31; std::string argument; const bool url = target.find(u"://") != target.npos || target.starts_with(u"mailto:"); if (!url) { const auto candidates = target.find_first_of(u"\\/:") != target.npos ? std::vector{target} : std::vector{directory.empty() ? paths.current() + u"\\" + target : directory + u"\\" + target, target}; const auto resolved = [&]() -> std::optional { for (const auto &candidate : candidates) if (const auto found = paths.resolve(candidate); found && found->exists) return found; return std::nullopt; }(); if (!resolved) { // A bare program name is found along the usual program directories, as Windows does for the open verb. uint32_t error = 0; const int standard[3] = {0, 1, 2}; started = start_program(context, u"", u"\"" + target + u"\"" + (parameters.empty() ? u"" : u" " + parameters), directory, standard, context.environment_block ? context.environment_block() : std::u16string(), nullptr, error); return started ? 42 : error == 2 ? 2 : error == 193 ? 11 : 31; } if (equal_fold(from_utf8(std::filesystem::path(resolved->host).extension().string()), u".exe") && !std::filesystem::is_directory(resolved->host)) { uint32_t error = 0; const int standard[3] = {0, 1, 2}; const auto full = paths.dos(resolved->host); started = start_program(context, full, u"\"" + full + u"\"" + (parameters.empty() ? u"" : u" " + parameters), directory.empty() ? full.substr(0, full.find_last_of(u'\\')) : directory, standard, context.environment_block ? context.environment_block() : std::u16string(), nullptr, error); return started ? 42 : error == 193 ? 11 : error; } argument = resolved->host.string(); } else { argument = to_utf8(target); } const pid_t child = ::fork(); if (child == 0) { ::setsid(); ::execlp("xdg-open", "xdg-open", argument.c_str(), static_cast(nullptr)); ::_exit(127); } return child < 0 ? 0 : 42; }; registry.add("ShellExecuteW", 6, [open_target](ApiCall &call) { std::shared_ptr started; call.ret(open_target(call[1] ? call.wide(call[1]) : std::u16string(u"open"), call[2] ? call.wide(call[2]) : std::u16string(), call[3] ? call.wide(call[3]) : std::u16string(), call[4] ? call.wide(call[4]) : std::u16string(), started)); }); // SHELLEXECUTEINFOW: the pointers sit after the size, mask and window, each as wide as the program's. registry.add("ShellExecuteExW", 1, [open_target, &context](ApiCall &call) { const size_t width = call.pointer_width(); const auto at = [&](size_t index) { return call[0] + 8 + index * width; }; if (!call[0] || call.load(call[0]) < 8 + 13 * width) { call.fail(87); return; } const auto text = [&](size_t index) { const auto pointer = call.load_pointer(at(index)); return pointer ? call.wide(pointer) : std::u16string(); }; const uint32_t mask = call.load(call[0] + 4); const auto verb = text(1); std::shared_ptr started; const auto result = open_target(verb.empty() ? std::u16string(u"open") : verb, text(2), text(3), text(4), started); call.store_pointer(at(6), result); if (result <= 32) { call.fail(uint32_t(result == 31 ? 1155 : result)); return; } if (started && (mask & 0x40)) { const auto handle = context.objects.add_object(started); call.store_pointer(at(12), handle.status ? 0 : handle.value); } else if (mask & 0x40) { call.store_pointer(at(12), 0); } call.ret(1); }); registry.add("SHFileOperationW", 1, [&paths](ApiCall &call) { // SHFILEOPSTRUCTW: owner window, function, source and destination lists, flags, then the aborted flag; the pointers are as wide as the program's. const bool narrow = call.process.mode() == NativeMode::x86; const size_t function_at = narrow ? 4 : 8, sources_at = narrow ? 8 : 16, destinations_at = narrow ? 12 : 24, flags_at = narrow ? 16 : 32, aborted_at = narrow ? 20 : 36; const uint32_t function = call.load(call[0] + function_at); const uint64_t sources = narrow ? call.load(call[0] + sources_at) : call.load(call[0] + sources_at); const uint64_t destinations = narrow ? call.load(call[0] + destinations_at) : call.load(call[0] + destinations_at); const uint16_t flags = call.load(call[0] + flags_at); const auto from = file_list(call, sources), to = file_list(call, destinations); call.store(call[0] + aborted_at, 0); std::error_code error; for (size_t index = 0; index < from.size(); ++index) { const auto source = paths.resolve(from[index]); if (!source || !source->exists) { call.ret(0x402); return; } const auto destination = function == 3 ? std::nullopt : paths.resolve(to.size() == from.size() ? to[index] : to.empty() ? std::u16string() : to[0]); if (function == 3) { if (flags & 0x40) { // FOF_ALLOWUNDO: move into the prefix recycle bin instead of destroying the item. const auto bin = paths.resolve(u"C:\\$Recycle.Bin"); std::filesystem::create_directories(bin->host, error); std::filesystem::rename(source->host, bin->host / source->host.filename(), error); if (error) { std::filesystem::remove_all(source->host, error); } } else { std::filesystem::remove_all(source->host, error); } } else if (function == 2 && destination) { auto target = destination->host; if (std::filesystem::is_directory(target) && !(flags & 0x400)) target /= source->host.filename(); std::filesystem::copy(source->host, target, std::filesystem::copy_options::recursive | std::filesystem::copy_options::overwrite_existing, error); } else if ((function == 1 || function == 4) && destination) { auto target = destination->host; if (function == 1 && std::filesystem::is_directory(target)) target /= source->host.filename(); std::filesystem::rename(source->host, target, error); } if (error) { call.ret(0x7c); return; } } call.ret(0); }); } }