Index: chrome/browser/win/jumplist_file_util.h |
diff --git a/chrome/browser/win/jumplist_file_util.h b/chrome/browser/win/jumplist_file_util.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..ec618162aa256fcb35c3043ea52cd6b481928141 |
--- /dev/null |
+++ b/chrome/browser/win/jumplist_file_util.h |
@@ -0,0 +1,80 @@ |
+// Copyright (c) 2017 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. |
+ |
+#ifndef CHROME_BROWSER_WIN_JUMPLIST_FILE_UTIL_H_ |
+#define CHROME_BROWSER_WIN_JUMPLIST_FILE_UTIL_H_ |
+ |
+#include "base/files/file_path.h" |
+ |
+// Maximum number of icon files allowed to delete per jumplist update. |
+const int kFileDeleteLimit = 100; |
+ |
+// Folder delete status enumeration, used in Delete* methods below. |
+// This is used for UMA. Do not delete entries, and keep in sync with |
+// histograms.xml. |
+enum FolderDeleteResult { |
+ SUCCEED = 0, |
+ // File name's length exceeds MAX_PATH. This shouldn't happen. |
+ FAIL_INVALID_FILE_PATH, |
+ // JumpListIcons{,Old} directories are read-only. This may heppen. |
+ FAIL_READ_ONLY_DIRECTORY, |
+ // Since JumpListIcons{,Old} are directories. This shouldn't happen. |
+ FAIL_DELETE_SINGLE_FILE, |
+ // JumpListIcons{,Old} should not have sub-directories, so this shouldn't |
+ // happen. If this happens, the root cause must be found. |
+ FAIL_SUBDIRECTORY_EXISTS, |
+ // Delete maximum files allowed succeeds. However, in the process of deleting |
+ // these files, it fails to delete some other files. This may happen. |
+ FAIL_DELETE_MAX_FILES_WITH_ERRORS, |
+ // Fail to delete maximum files allowed when the maximum attempt failures |
+ // are hit. This may heppen. |
+ FAIL_MAX_DELETE_FAILURES, |
+ // Fail to remove the raw empty directory. This may happen. |
+ FAIL_REMOVE_RAW_DIRECTORY, |
+ // Add new items before this one, always keep this one at the end. |
+ END |
+}; |
+ |
+// An enumeration indicating if a directory is empty or not. |
+// This is used for UMA. Do not delete entries, and keep in sync with |
+// histograms.xml. |
+enum DirectoryEmptyStatus { |
+ EMPTY = 0, |
+ NON_EMPTY, |
+ // Add new items before this one, always keep this one at the end. |
+ EMPTY_STATUS_END |
+}; |
+ |
+// This method is similar to base::DeleteFileRecursive in |
+// file_util_win.cc with the following differences. |
+// 1) It has an input parameter |max_file_deleted| to specify the maximum files |
+// allowed to delete as well as the maximum attempt failures allowd per run. |
+// 2) It deletes only the files in |path|. All subdirectories in |path| are |
+// untouched but are considered as attempt failures. |
+// 3) Detailed delete status is returned. |
+FolderDeleteResult DeleteFiles(const base::FilePath& path, |
+ const base::FilePath::StringType& pattern, |
+ int max_file_deleted); |
+ |
+// This method is similar to base::DeleteFile in file_util_win.cc |
+// with the following differences. |
+// 1) It has an input parameter |max_file_deleted| to specify the maximum files |
+// allowed to delete as well as the maximum attempt failures allowd per run. |
+// 2) It deletes only the files in |path|. All subdirectories in |path| are |
+// untouched but are considered as attempt failures. |
+// 3) |path| won't be removed even if all its contents are deleted successfully. |
+// 4) Detailed delete status is returned. |
+FolderDeleteResult DeleteDirectoryContent(const base::FilePath& path, |
+ int max_file_deleted); |
+ |
+// This method firstly calls DeleteDirectoryContent() to delete the contents in |
+// |path|. If |path| is empty after the call, it is removed. |
+FolderDeleteResult DeleteDirectory(const base::FilePath& path, |
+ int max_file_deleted); |
+ |
+// Deletes the directory at |path| and records the result to UMA. |
+void DeleteDirectoryAndLogResults(const base::FilePath& path, |
+ int max_file_deleted); |
+ |
+#endif // CHROME_BROWSER_WIN_JUMPLIST_FILE_UTIL_H_ |