1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #ifndef CHROME_COMMON_CHROME_PATHS_H__
6 #define CHROME_COMMON_CHROME_PATHS_H__
8 #include "build/build_config.h"
14 // This file declares path keys for the chrome module. These can be used with
15 // the PathService to access various special directories and files.
22 DIR_APP = PATH_START, // Directory where dlls and data reside.
23 DIR_LOGS, // Directory where logs should be written.
24 DIR_USER_DATA, // Directory where user data can be written.
25 DIR_CRASH_DUMPS, // Directory where crash dumps are written.
26 DIR_RESOURCES, // Directory containing separate file resources
27 // used by Chrome at runtime.
28 DIR_INSPECTOR, // Directory where web inspector is located.
29 DIR_APP_DICTIONARIES, // Directory where the global dictionaries are.
30 DIR_USER_DOCUMENTS, // Directory for a user's "My Documents".
31 DIR_USER_MUSIC, // Directory for a user's music.
32 DIR_USER_PICTURES, // Directory for a user's pictures.
33 DIR_USER_VIDEOS, // Directory for a user's videos.
34 DIR_DEFAULT_DOWNLOADS_SAFE, // Directory for a user's
35 // "My Documents/Downloads", (Windows) or
36 // "Downloads". (Linux)
37 DIR_DEFAULT_DOWNLOADS, // Directory for a user's downloads.
38 DIR_INTERNAL_PLUGINS, // Directory where internal plugins reside.
39 #if defined(OS_POSIX) && !defined(OS_MACOSX)
40 DIR_POLICY_FILES, // Directory for system-wide read-only
41 // policy files that allow sys-admins
42 // to set policies for chrome. This directory
43 // contains subdirectories.
45 #if defined(OS_MACOSX) && !defined(OS_IOS)
46 DIR_MANAGED_PREFS, // Directory that stores the managed prefs plist
47 // files for the current user.
49 #if defined(OS_CHROMEOS) || (defined(OS_MACOSX) && !defined(OS_IOS))
50 DIR_USER_EXTERNAL_EXTENSIONS, // Directory for per-user external extensions
51 // on Chrome Mac. On Chrome OS, this path is
52 // used for OEM customization.
53 // Getting this path does not create it.
57 DIR_STANDALONE_EXTERNAL_EXTENSIONS, // Directory for 'per-extension'
58 // definition manifest files that
59 // describe extensions which are to be
60 // installed when chrome is run.
62 DIR_EXTERNAL_EXTENSIONS, // Directory where installer places .crx files.
64 DIR_DEFAULT_APPS, // Directory where installer places .crx files
65 // to be installed when chrome is first run.
66 DIR_PEPPER_FLASH_PLUGIN, // Directory to the bundled Pepper Flash plugin,
67 // containing the plugin and the manifest.
68 DIR_COMPONENT_UPDATED_PEPPER_FLASH_PLUGIN, // Base directory of the Pepper
69 // Flash plugins downloaded by the
71 FILE_RESOURCE_MODULE, // Full path and filename of the module that
72 // contains embedded resources (version,
73 // strings, images, etc.).
74 FILE_LOCAL_STATE, // Path and filename to the file in which
75 // machine/installation-specific state is saved.
76 FILE_RECORDED_SCRIPT, // Full path to the script.log file that
77 // contains recorded browser events for
79 FILE_FLASH_PLUGIN, // Full path to the internal NPAPI Flash plugin
80 // file. Querying this path will succeed no
81 // matter the file exists or not.
82 FILE_PEPPER_FLASH_PLUGIN, // Full path to the bundled Pepper Flash plugin
84 FILE_PDF_PLUGIN, // Full path to the internal PDF plugin file.
86 FILE_NACL_PLUGIN, // Full path to the internal NaCl plugin file.
87 DIR_PNACL_BASE, // Full path to the base dir for PNaCl.
88 DIR_PNACL_COMPONENT, // Full path to the latest PNaCl version
89 // (subdir of DIR_PNACL_BASE).
90 FILE_O1D_PLUGIN, // Full path to the O1D Pepper plugin file.
91 FILE_EFFECTS_PLUGIN, // Full path to the Effects Pepper plugin file.
92 FILE_GTALK_PLUGIN, // Full path to the GTalk Pepper plugin file.
93 DIR_COMPONENT_WIDEVINE_CDM, // Directory that contains component-updated
94 // Widevine CDM files.
95 FILE_WIDEVINE_CDM_ADAPTER, // Full path to the Widevine CDM adapter file.
96 FILE_RESOURCES_PACK, // Full path to the .pak file containing
97 // binary data (e.g., html files and images
98 // used by internal pages).
99 DIR_RESOURCES_EXTENSION, // Full path to extension resources.
100 #if defined(OS_CHROMEOS)
101 DIR_CHROMEOS_WALLPAPERS, // Directory where downloaded chromeos
102 // wallpapers reside.
103 DIR_CHROMEOS_WALLPAPER_THUMBNAILS, // Directory where downloaded chromeos
104 // wallpaper thumbnails reside.
105 DIR_CHROMEOS_CUSTOM_WALLPAPERS, // Directory where custom wallpapers
108 DIR_MANAGED_USERS_DEFAULT_APPS, // Directory where installer places .crx
109 // files to be installed when managed user
112 #if defined(OS_LINUX) || (defined(OS_MACOSX) && !defined(OS_IOS))
113 DIR_NATIVE_MESSAGING, // System directory where native messaging host
114 // manifest files are stored.
115 DIR_USER_NATIVE_MESSAGING, // Directory with Native Messaging Hosts
116 // installed per-user.
119 // Valid only in development environment; TODO(darin): move these
120 DIR_GEN_TEST_DATA, // Directory where generated test data resides.
121 DIR_TEST_DATA, // Directory where unit test data resides.
122 DIR_TEST_TOOLS, // Directory where unit test tools reside.
127 // Call once to register the provider for the path keys defined above.
128 void RegisterPathProvider();
130 // Get or set the invalid user data dir that was originally specified.
131 void SetInvalidSpecifiedUserDataDir(const base::FilePath& user_data_dir);
132 const base::FilePath& GetInvalidSpecifiedUserDataDir();
134 } // namespace chrome
136 #endif // CHROME_COMMON_CHROME_PATHS_H__