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.
27 DIR_WATCHER_DATA
, // Directory where the Chrome watcher stores
30 DIR_RESOURCES
, // Directory containing separate file resources
31 // used by Chrome at runtime.
32 DIR_INSPECTOR
, // Directory where web inspector is located.
33 DIR_APP_DICTIONARIES
, // Directory where the global dictionaries are.
34 DIR_USER_DOCUMENTS
, // Directory for a user's "My Documents".
35 DIR_USER_MUSIC
, // Directory for a user's music.
36 DIR_USER_PICTURES
, // Directory for a user's pictures.
37 DIR_USER_VIDEOS
, // Directory for a user's videos.
38 DIR_DEFAULT_DOWNLOADS_SAFE
, // Directory for a user's
39 // "My Documents/Downloads", (Windows) or
40 // "Downloads". (Linux)
41 DIR_DEFAULT_DOWNLOADS
, // Directory for a user's downloads.
42 DIR_INTERNAL_PLUGINS
, // Directory where internal plugins reside.
43 #if defined(OS_POSIX) && !defined(OS_MACOSX)
44 DIR_POLICY_FILES
, // Directory for system-wide read-only
45 // policy files that allow sys-admins
46 // to set policies for chrome. This directory
47 // contains subdirectories.
49 #if defined(OS_MACOSX) && !defined(OS_IOS)
50 DIR_USER_APPLICATIONS
, // ~/Applications
51 DIR_USER_LIBRARY
, // ~/Library
53 #if defined(OS_CHROMEOS) || (defined(OS_MACOSX) && !defined(OS_IOS))
54 DIR_USER_EXTERNAL_EXTENSIONS
, // Directory for per-user external extensions
55 // on Chrome Mac. On Chrome OS, this path is
56 // used for OEM customization.
57 // Getting this path does not create it.
61 DIR_STANDALONE_EXTERNAL_EXTENSIONS
, // Directory for 'per-extension'
62 // definition manifest files that
63 // describe extensions which are to be
64 // installed when chrome is run.
66 DIR_EXTERNAL_EXTENSIONS
, // Directory where installer places .crx files.
68 DIR_DEFAULT_APPS
, // Directory where installer places .crx files
69 // to be installed when chrome is first run.
70 DIR_PEPPER_FLASH_PLUGIN
, // Directory to the bundled Pepper Flash plugin,
71 // containing the plugin and the manifest.
72 DIR_COMPONENT_UPDATED_PEPPER_FLASH_PLUGIN
, // Base directory of the Pepper
73 // Flash plugins downloaded by the
75 FILE_RESOURCE_MODULE
, // Full path and filename of the module that
76 // contains embedded resources (version,
77 // strings, images, etc.).
78 FILE_LOCAL_STATE
, // Path and filename to the file in which
79 // machine/installation-specific state is saved.
80 FILE_RECORDED_SCRIPT
, // Full path to the script.log file that
81 // contains recorded browser events for
83 FILE_PEPPER_FLASH_PLUGIN
, // Full path to the bundled Pepper Flash plugin
85 FILE_PEPPER_FLASH_SYSTEM_PLUGIN
, // Full path to the system version of the
86 // Pepper Flash plugin, downloadable from
87 // Adobe website. Querying this path might
88 // succeed no matter the file exists or not.
89 FILE_FLASH_SYSTEM_PLUGIN
, // Full path to the system version of NPAPI
90 // Flash plugin, downloadable from Adobe
91 // website. Querying this path might succeed no
92 // matter the file exists or not.
93 FILE_NACL_PLUGIN
, // Full path to the internal NaCl plugin file.
94 DIR_PNACL_BASE
, // Full path to the base dir for PNaCl.
95 DIR_PNACL_COMPONENT
, // Full path to the latest PNaCl version
96 // (subdir of DIR_PNACL_BASE).
97 DIR_COMPONENT_WIDEVINE_CDM
, // Directory that contains component-updated
98 // Widevine CDM files.
99 FILE_WIDEVINE_CDM_ADAPTER
, // Full path to the Widevine CDM adapter file.
100 FILE_RESOURCES_PACK
, // Full path to the .pak file containing
101 // binary data (e.g., html files and images
102 // used by internal pages).
103 DIR_RESOURCES_EXTENSION
, // Full path to extension resources.
104 #if defined(OS_CHROMEOS)
105 DIR_CHROMEOS_WALLPAPERS
, // Directory where downloaded chromeos
106 // wallpapers reside.
107 DIR_CHROMEOS_WALLPAPER_THUMBNAILS
, // Directory where downloaded chromeos
108 // wallpaper thumbnails reside.
109 DIR_CHROMEOS_CUSTOM_WALLPAPERS
, // Directory where custom wallpapers
112 DIR_SUPERVISED_USERS_DEFAULT_APPS
, // Directory where installer places .crx
113 // files to be installed when managed user
115 #if defined(OS_LINUX) || (defined(OS_MACOSX) && !defined(OS_IOS))
116 DIR_NATIVE_MESSAGING
, // System directory where native messaging host
117 // manifest files are stored.
118 DIR_USER_NATIVE_MESSAGING
, // Directory with Native Messaging Hosts
119 // installed per-user.
121 #if !defined(OS_ANDROID)
122 DIR_GLOBAL_GCM_STORE
, // Directory where the global GCM instance
125 #if defined(OS_ANDROID)
126 DIR_OFFLINE_PAGE_METADATA
, // Directory where offline page metadata is
130 // Valid only in development environment; TODO(darin): move these
131 DIR_GEN_TEST_DATA
, // Directory where generated test data resides.
132 DIR_TEST_DATA
, // Directory where unit test data resides.
133 DIR_TEST_TOOLS
, // Directory where unit test tools reside.
138 // Call once to register the provider for the path keys defined above.
139 void RegisterPathProvider();
141 // Get or set the invalid user data dir that was originally specified.
142 void SetInvalidSpecifiedUserDataDir(const base::FilePath
& user_data_dir
);
143 const base::FilePath
& GetInvalidSpecifiedUserDataDir();
145 } // namespace chrome
147 #endif // CHROME_COMMON_CHROME_PATHS_H__