// Copyright (c) 2012 The Chromium Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #include "chrome/common/chrome_paths.h" #include "base/files/file_util.h" #include "base/logging.h" #include "base/native_library.h" #include "base/no_destructor.h" #include "base/notreached.h" #include "base/path_service.h" #include "base/strings/string_util.h" #include "base/system/sys_info.h" #include "base/threading/thread_restrictions.h" #include "base/version.h" #include "build/build_config.h" #include "build/chromeos_buildflags.h" #include "chrome/common/buildflags.h" #include "chrome/common/chrome_constants.h" #include "chrome/common/chrome_paths_internal.h" #include "media/media_buildflags.h" #include "ppapi/buildflags/buildflags.h" #if BUILDFLAG(IS_ANDROID) #include "base/android/path_utils.h" #include "base/base_paths_android.h" // ui/base must only be used on Android. See BUILD.gn for dependency info. #include "ui/base/ui_base_paths.h" // nogncheck #endif #if BUILDFLAG(IS_MAC) #include "base/mac/bundle_locations.h" #include "base/mac/foundation_util.h" #endif #if BUILDFLAG(IS_WIN) #include "base/win/registry.h" #endif #if BUILDFLAG(ENABLE_WIDEVINE) #include "third_party/widevine/cdm/widevine_cdm_common.h" // nogncheck #endif #if BUILDFLAG(IS_CHROMEOS_LACROS) #include "chrome/common/chrome_paths_lacros.h" // nogncheck #endif namespace { #if BUILDFLAG(IS_LINUX) || BUILDFLAG(IS_CHROMEOS) // The path to the external extension .json files. // /usr/share seems like a good choice, see: http://www.pathname.com/fhs/ const base::FilePath::CharType kFilepathSinglePrefExtensions[] = #if BUILDFLAG(GOOGLE_CHROME_BRANDING) FILE_PATH_LITERAL("/usr/share/google-chrome/extensions"); #else FILE_PATH_LITERAL("/usr/share/chromium/extensions"); #endif // BUILDFLAG(GOOGLE_CHROME_BRANDING) #endif // BUILDFLAG(IS_LINUX) || BUILDFLAG(IS_CHROMEOS) #if BUILDFLAG(ENABLE_WIDEVINE) // The name of the hint file that tells the latest component updated Widevine // CDM directory. This file name should not be changed as otherwise existing // Widevine CDMs might not be loaded. const base::FilePath::CharType kComponentUpdatedWidevineCdmHint[] = FILE_PATH_LITERAL("latest-component-updated-widevine-cdm"); #endif // BUILDFLAG(ENABLE_WIDEVINE) #if BUILDFLAG(IS_CHROMEOS_ASH) const base::FilePath::CharType kChromeOSTPMFirmwareUpdateLocation[] = FILE_PATH_LITERAL("/run/tpm_firmware_update_location"); const base::FilePath::CharType kChromeOSTPMFirmwareUpdateSRKVulnerableROCA[] = FILE_PATH_LITERAL("/run/tpm_firmware_update_srk_vulnerable_roca"); #endif // BUILDFLAG(IS_CHROMEOS_ASH) base::FilePath& GetInvalidSpecifiedUserDataDirInternal() { static base::NoDestructor s; return *s; } // Gets the path for internal plugins. bool GetInternalPluginsDirectory(base::FilePath* result) { #if BUILDFLAG(ENABLE_PLUGINS) #if BUILDFLAG(IS_MAC) // If called from Chrome, get internal plugins from a subdirectory of the // framework. if (base::mac::AmIBundled()) { *result = chrome::GetFrameworkBundlePath(); DCHECK(!result->empty()); *result = result->Append("Internet Plug-Ins"); return true; } // In tests, just look in the module directory (below). #endif // BUILDFLAG(IS_MAC) // The rest of the world expects plugins in the module directory. return base::PathService::Get(base::DIR_MODULE, result); #else // BUILDFLAG(ENABLE_PLUGINS) // Plugins are not enabled, so don't return an internal plugins path. return false; #endif } // Gets the path for bundled implementations of components. Note that these // implementations should not be used if higher-versioned component-updated // implementations are available in DIR_USER_DATA. bool GetComponentDirectory(base::FilePath* result) { #if BUILDFLAG(IS_FUCHSIA) // TODO(crbug.com/1241871): Support bundled components. return false; #else #if BUILDFLAG(IS_MAC) // If called from Chrome, return the framework's Libraries directory. if (base::mac::AmIBundled()) { *result = chrome::GetFrameworkBundlePath(); DCHECK(!result->empty()); *result = result->Append("Libraries"); return true; } // In tests, just look in the module directory (below). #endif // The rest of the world expects components in the module directory. return base::PathService::Get(base::DIR_MODULE, result); #endif } } // namespace namespace chrome { bool PathProvider(int key, base::FilePath* result) { // Some keys are just aliases... switch (key) { case chrome::DIR_LOGS: #ifdef NDEBUG // Release builds write to the data dir return base::PathService::Get(chrome::DIR_USER_DATA, result); #else // Debug builds write next to the binary (in the build tree) // TODO(crbug.com/1262330): implement workable solution for Fuchsia. #if BUILDFLAG(IS_MAC) // Apps may not write into their own bundle. if (base::mac::AmIBundled()) { return base::PathService::Get(chrome::DIR_USER_DATA, result); } #endif // BUILDFLAG(IS_MAC) return base::PathService::Get(base::DIR_EXE, result); #endif // NDEBUG } // Assume that we will not need to create the directory if it does not exist. // This flag can be set to true for the cases where we want to create it. bool create_dir = false; base::FilePath cur; switch (key) { case chrome::DIR_USER_DATA: if (!GetDefaultUserDataDirectory(&cur)) { NOTREACHED(); return false; } create_dir = true; break; case chrome::DIR_USER_DOCUMENTS: if (!GetUserDocumentsDirectory(&cur)) return false; create_dir = true; break; case chrome::DIR_USER_MUSIC: if (!GetUserMusicDirectory(&cur)) return false; break; case chrome::DIR_USER_PICTURES: if (!GetUserPicturesDirectory(&cur)) return false; break; case chrome::DIR_USER_VIDEOS: if (!GetUserVideosDirectory(&cur)) return false; break; case chrome::DIR_DEFAULT_DOWNLOADS_SAFE: #if BUILDFLAG(IS_WIN) || BUILDFLAG(IS_LINUX) || BUILDFLAG(IS_CHROMEOS) if (!GetUserDownloadsDirectorySafe(&cur)) return false; break; #else // Fall through for all other platforms. #endif case chrome::DIR_DEFAULT_DOWNLOADS: #if BUILDFLAG(IS_ANDROID) if (!base::android::GetDownloadsDirectory(&cur)) return false; #else if (!GetUserDownloadsDirectory(&cur)) return false; // Do not create the download directory here, we have done it twice now // and annoyed a lot of users. #endif break; case chrome::DIR_CRASH_DUMPS: #if BUILDFLAG(IS_CHROMEOS_ASH) // ChromeOS uses a separate directory. See http://crosbug.com/25089 cur = base::FilePath("/var/log/chrome"); #elif BUILDFLAG(IS_ANDROID) if (!base::android::GetCacheDirectory(&cur)) return false; #else // The crash reports are always stored relative to the default user data // directory. This avoids the problem of having to re-initialize the // exception handler after parsing command line options, which may // override the location of the app's profile directory. // TODO(scottmg): Consider supporting --user-data-dir. See // https://crbug.com/565446. if (!GetDefaultUserDataDirectory(&cur)) return false; #endif #if BUILDFLAG(IS_MAC) || BUILDFLAG(IS_WIN) || BUILDFLAG(IS_ANDROID) cur = cur.Append(FILE_PATH_LITERAL("Crashpad")); #else cur = cur.Append(FILE_PATH_LITERAL("Crash Reports")); #endif create_dir = true; break; #if BUILDFLAG(IS_WIN) case chrome::DIR_WATCHER_DATA: // The watcher data is always stored relative to the default user data // directory. This allows the watcher to be initialized before // command-line options have been parsed. if (!GetDefaultUserDataDirectory(&cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("Diagnostics")); break; case chrome::DIR_ROAMING_USER_DATA: if (!GetDefaultRoamingUserDataDirectory(&cur)) { NOTREACHED(); return false; } create_dir = true; break; #endif case chrome::DIR_RESOURCES: #if BUILDFLAG(IS_MAC) cur = base::mac::FrameworkBundlePath(); cur = cur.Append(FILE_PATH_LITERAL("Resources")); #else if (!base::PathService::Get(base::DIR_ASSETS, &cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("resources")); #endif break; case chrome::DIR_APP_DICTIONARIES: #if BUILDFLAG(IS_POSIX) // We can't write into the EXE dir on Linux, so keep dictionaries // alongside the safe browsing database in the user data dir. // And we don't want to write into the bundle on the Mac, so push // it to the user data dir there also. if (!base::PathService::Get(chrome::DIR_USER_DATA, &cur)) return false; #else if (!base::PathService::Get(base::DIR_EXE, &cur)) return false; #endif cur = cur.Append(FILE_PATH_LITERAL("Dictionaries")); create_dir = true; break; case chrome::DIR_INTERNAL_PLUGINS: if (!GetInternalPluginsDirectory(&cur)) return false; break; case chrome::DIR_COMPONENTS: if (!GetComponentDirectory(&cur)) return false; break; case chrome::FILE_LOCAL_STATE: if (!base::PathService::Get(chrome::DIR_USER_DATA, &cur)) return false; cur = cur.Append(chrome::kLocalStateFilename); break; case chrome::FILE_RECORDED_SCRIPT: if (!base::PathService::Get(chrome::DIR_USER_DATA, &cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("script.log")); break; // PNaCl is currenly installable via the component updater or by being // simply built-in. DIR_PNACL_BASE is used as the base directory for // installation via component updater. DIR_PNACL_COMPONENT will be // the final location of pnacl, which is a subdir of DIR_PNACL_BASE. case chrome::DIR_PNACL_BASE: if (!base::PathService::Get(chrome::DIR_USER_DATA, &cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("pnacl")); break; // Where PNaCl files are ultimately located. The default finds the files // inside the InternalPluginsDirectory / build directory, as if it // was shipped along with chrome. The value can be overridden // if it is installed via component updater. case chrome::DIR_PNACL_COMPONENT: #if BUILDFLAG(IS_MAC) // PNaCl really belongs in the InternalPluginsDirectory but actually // copying it there would result in the files also being shipped, which // we don't want yet. So for now, just find them in the directory where // they get built. if (!base::PathService::Get(base::DIR_EXE, &cur)) return false; if (base::mac::AmIBundled()) { // If we're called from chrome, it's beside the app (outside the // app bundle), if we're called from a unittest, we'll already be // outside the bundle so use the exe dir. // exe_dir gave us .../Chromium.app/Contents/MacOS/Chromium. cur = cur.DirName(); cur = cur.DirName(); cur = cur.DirName(); } #else if (!GetInternalPluginsDirectory(&cur)) return false; #endif cur = cur.Append(FILE_PATH_LITERAL("pnacl")); break; #if BUILDFLAG(ENABLE_WIDEVINE) case chrome::DIR_BUNDLED_WIDEVINE_CDM: if (!GetComponentDirectory(&cur)) return false; cur = cur.AppendASCII(kWidevineCdmBaseDirectory); break; case chrome::DIR_COMPONENT_UPDATED_WIDEVINE_CDM: if (!base::PathService::Get(chrome::DIR_USER_DATA, &cur)) return false; cur = cur.AppendASCII(kWidevineCdmBaseDirectory); break; case chrome::FILE_COMPONENT_WIDEVINE_CDM_HINT: if (!base::PathService::Get(chrome::DIR_COMPONENT_UPDATED_WIDEVINE_CDM, &cur)) return false; cur = cur.Append(kComponentUpdatedWidevineCdmHint); break; #endif // BUILDFLAG(ENABLE_WIDEVINE) case chrome::FILE_RESOURCES_PACK: // Falls through. case chrome::FILE_DEV_UI_RESOURCES_PACK: #if BUILDFLAG(IS_MAC) cur = base::mac::FrameworkBundlePath(); cur = cur.Append(FILE_PATH_LITERAL("Resources")) .Append(FILE_PATH_LITERAL("resources.pak")); #elif BUILDFLAG(IS_ANDROID) if (!base::PathService::Get(ui::DIR_RESOURCE_PAKS_ANDROID, &cur)) return false; if (key == chrome::FILE_DEV_UI_RESOURCES_PACK) { cur = cur.Append(FILE_PATH_LITERAL("dev_ui_resources.pak")); } else { DCHECK_EQ(chrome::FILE_RESOURCES_PACK, key); cur = cur.Append(FILE_PATH_LITERAL("resources.pak")); } #else // If we're not bundled on mac or Android, resources.pak should be in // the "assets" location (e.g. next to the binary, on many platforms, or // in /pkg/data under Fuchsia, etc). if (!base::PathService::Get(base::DIR_ASSETS, &cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("resources.pak")); #endif break; #if BUILDFLAG(IS_CHROMEOS_LACROS) case chrome::FILE_FALLBACK_RESOURCES_PACK: if (!GetDefaultUserDataDirectory(&cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("resources_fallback.pak")); break; case chrome::FILE_ASH_RESOURCES_PACK: if (!chrome::GetAshResourcesPath(&cur)) return false; cur = cur.Append("resources.pak"); break; case chrome::FILE_RESOURCES_MAP: if (!GetDefaultUserDataDirectory(&cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("resources.map")); break; #endif #if BUILDFLAG(IS_CHROMEOS_ASH) case chrome::DIR_CHROMEOS_WALLPAPERS: if (!base::PathService::Get(chrome::DIR_USER_DATA, &cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("wallpapers")); break; case chrome::DIR_CHROMEOS_WALLPAPER_THUMBNAILS: if (!base::PathService::Get(chrome::DIR_USER_DATA, &cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("wallpaper_thumbnails")); break; case chrome::DIR_CHROMEOS_CUSTOM_WALLPAPERS: if (!base::PathService::Get(chrome::DIR_USER_DATA, &cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("custom_wallpapers")); break; #endif // The following are only valid in the development environment, and // will fail if executed from an installed executable (because the // generated path won't exist). case chrome::DIR_GEN_TEST_DATA: if (!base::PathService::Get(base::DIR_GEN_TEST_DATA_ROOT, &cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("test_data")); if (!base::PathExists(cur)) // We don't want to create this. return false; break; case chrome::DIR_TEST_DATA: if (!base::PathService::Get(base::DIR_SOURCE_ROOT, &cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("chrome")); cur = cur.Append(FILE_PATH_LITERAL("test")); cur = cur.Append(FILE_PATH_LITERAL("data")); if (!base::PathExists(cur)) // We don't want to create this. return false; break; case chrome::DIR_TEST_TOOLS: if (!base::PathService::Get(base::DIR_SOURCE_ROOT, &cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("chrome")); cur = cur.Append(FILE_PATH_LITERAL("tools")); cur = cur.Append(FILE_PATH_LITERAL("test")); if (!base::PathExists(cur)) // We don't want to create this return false; break; #if BUILDFLAG(IS_POSIX) && !BUILDFLAG(IS_MAC) && !BUILDFLAG(IS_OPENBSD) case chrome::DIR_POLICY_FILES: { #if BUILDFLAG(GOOGLE_CHROME_BRANDING) cur = base::FilePath(FILE_PATH_LITERAL("/etc/opt/chrome/policies")); #else cur = base::FilePath(FILE_PATH_LITERAL("/etc/chromium/policies")); #endif break; } #endif // TODO(crbug.com/1052397): Revisit once build flag switch of lacros-chrome is // complete. #if BUILDFLAG(IS_CHROMEOS_ASH) || \ ((BUILDFLAG(IS_LINUX) || BUILDFLAG(IS_CHROMEOS_LACROS)) && \ BUILDFLAG(CHROMIUM_BRANDING)) || \ BUILDFLAG(IS_MAC) case chrome::DIR_USER_EXTERNAL_EXTENSIONS: { if (!base::PathService::Get(chrome::DIR_USER_DATA, &cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("External Extensions")); break; } #endif #if BUILDFLAG(IS_LINUX) || BUILDFLAG(IS_CHROMEOS) case chrome::DIR_STANDALONE_EXTERNAL_EXTENSIONS: { cur = base::FilePath(kFilepathSinglePrefExtensions); break; } #endif case chrome::DIR_EXTERNAL_EXTENSIONS: #if BUILDFLAG(IS_FUCHSIA) // TODO(crbug.com/1241872): Support external extensions. return false; #else #if BUILDFLAG(IS_MAC) if (!chrome::GetGlobalApplicationSupportDirectory(&cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("Google")) .Append(FILE_PATH_LITERAL("Chrome")) .Append(FILE_PATH_LITERAL("External Extensions")); #else if (!base::PathService::Get(base::DIR_MODULE, &cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("extensions")); create_dir = true; #endif break; #endif case chrome::DIR_DEFAULT_APPS: #if BUILDFLAG(IS_FUCHSIA) // TODO(crbug.com/1241872): Support default-installed apps. return false; #else #if BUILDFLAG(IS_MAC) cur = base::mac::FrameworkBundlePath(); cur = cur.Append(FILE_PATH_LITERAL("Default Apps")); #else if (!base::PathService::Get(base::DIR_MODULE, &cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("default_apps")); #endif break; #endif #if BUILDFLAG(IS_LINUX) || BUILDFLAG(IS_CHROMEOS) || BUILDFLAG(IS_MAC) case chrome::DIR_NATIVE_MESSAGING: #if BUILDFLAG(IS_MAC) #if BUILDFLAG(GOOGLE_CHROME_BRANDING) cur = base::FilePath(FILE_PATH_LITERAL( "/Library/Google/Chrome/NativeMessagingHosts")); #else cur = base::FilePath(FILE_PATH_LITERAL( "/Library/Application Support/Chromium/NativeMessagingHosts")); #endif #else // BUILDFLAG(IS_MAC) #if BUILDFLAG(GOOGLE_CHROME_BRANDING) cur = base::FilePath(FILE_PATH_LITERAL( "/etc/opt/chrome/native-messaging-hosts")); #else cur = base::FilePath(FILE_PATH_LITERAL( "/etc/chromium/native-messaging-hosts")); #endif #endif // !BUILDFLAG(IS_MAC) break; case chrome::DIR_USER_NATIVE_MESSAGING: if (!base::PathService::Get(chrome::DIR_USER_DATA, &cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("NativeMessagingHosts")); break; #endif // BUILDFLAG(IS_LINUX) || BUILDFLAG(IS_CHROMEOS) || BUILDFLAG(IS_MAC) #if !BUILDFLAG(IS_ANDROID) case chrome::DIR_GLOBAL_GCM_STORE: if (!base::PathService::Get(chrome::DIR_USER_DATA, &cur)) return false; cur = cur.Append(kGCMStoreDirname); break; #endif // !BUILDFLAG(IS_ANDROID) #if BUILDFLAG(IS_CHROMEOS_ASH) case chrome::FILE_CHROME_OS_TPM_FIRMWARE_UPDATE_LOCATION: cur = base::FilePath(kChromeOSTPMFirmwareUpdateLocation); break; case chrome::FILE_CHROME_OS_TPM_FIRMWARE_UPDATE_SRK_VULNERABLE_ROCA: cur = base::FilePath(kChromeOSTPMFirmwareUpdateSRKVulnerableROCA); break; #endif // BUILDFLAG(IS_CHROMEOS_ASH) case chrome::DIR_OPTIMIZATION_GUIDE_PREDICTION_MODELS: if (!base::PathService::Get(chrome::DIR_USER_DATA, &cur)) return false; cur = cur.Append(FILE_PATH_LITERAL("OptimizationGuidePredictionModels")); create_dir = true; break; default: return false; } // TODO(bauerb): http://crbug.com/259796 base::ThreadRestrictions::ScopedAllowIO allow_io; if (create_dir && !base::PathExists(cur) && !base::CreateDirectory(cur)) return false; *result = cur; return true; } // This cannot be done as a static initializer sadly since Visual Studio will // eliminate this object file if there is no direct entry point into it. void RegisterPathProvider() { base::PathService::RegisterProvider(PathProvider, PATH_START, PATH_END); } void SetInvalidSpecifiedUserDataDir(const base::FilePath& user_data_dir) { GetInvalidSpecifiedUserDataDirInternal() = user_data_dir; } const base::FilePath& GetInvalidSpecifiedUserDataDir() { return GetInvalidSpecifiedUserDataDirInternal(); } } // namespace chrome