OLD | NEW |
(Empty) | |
| 1 // Copyright (c) 2017 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. |
| 4 |
| 5 #ifndef CHROME_BROWSER_WIN_JUMPLIST_FILE_UTIL_H_ |
| 6 #define CHROME_BROWSER_WIN_JUMPLIST_FILE_UTIL_H_ |
| 7 |
| 8 #include "base/files/file_path.h" |
| 9 |
| 10 // Maximum number of icon files allowed to delete per jumplist update. |
| 11 const int kFileDeleteLimit = 100; |
| 12 |
| 13 // Folder delete status enumeration, used in Delete* methods below. |
| 14 // This is used for UMA. Do not delete entries, and keep in sync with |
| 15 // histograms.xml. |
| 16 enum FolderDeleteResult { |
| 17 SUCCEED = 0, |
| 18 // File name's length exceeds MAX_PATH. This shouldn't happen. |
| 19 FAIL_INVALID_FILE_PATH, |
| 20 // JumpListIcons{,Old} directories are read-only. This may heppen. |
| 21 FAIL_READ_ONLY_DIRECTORY, |
| 22 // Since JumpListIcons{,Old} are directories. This shouldn't happen. |
| 23 FAIL_DELETE_SINGLE_FILE, |
| 24 // JumpListIcons{,Old} should not have sub-directories, so this shouldn't |
| 25 // happen. If this happens, the root cause must be found. |
| 26 FAIL_SUBDIRECTORY_EXISTS, |
| 27 // Delete maximum files allowed succeeds. However, in the process of deleting |
| 28 // these files, it fails to delete some other files. This may happen. |
| 29 FAIL_DELETE_MAX_FILES_WITH_ERRORS, |
| 30 // Fail to delete maximum files allowed when the maximum attempt failures |
| 31 // are hit. This may heppen. |
| 32 FAIL_MAX_DELETE_FAILURES, |
| 33 // Fail to remove the raw empty directory. This may happen. |
| 34 FAIL_REMOVE_RAW_DIRECTORY, |
| 35 // Add new items before this one, always keep this one at the end. |
| 36 END |
| 37 }; |
| 38 |
| 39 // An enumeration indicating if a directory is empty or not. |
| 40 // This is used for UMA. Do not delete entries, and keep in sync with |
| 41 // histograms.xml. |
| 42 enum DirectoryEmptyStatus { |
| 43 EMPTY = 0, |
| 44 NON_EMPTY, |
| 45 // Add new items before this one, always keep this one at the end. |
| 46 EMPTY_STATUS_END |
| 47 }; |
| 48 |
| 49 // This method is similar to base::DeleteFileRecursive in |
| 50 // file_util_win.cc with the following differences. |
| 51 // 1) It has an input parameter |max_file_deleted| to specify the maximum files |
| 52 // allowed to delete as well as the maximum attempt failures allowd per run. |
| 53 // 2) It deletes only the files in |path|. All subdirectories in |path| are |
| 54 // untouched but are considered as attempt failures. |
| 55 // 3) Detailed delete status is returned. |
| 56 FolderDeleteResult DeleteFiles(const base::FilePath& path, |
| 57 const base::FilePath::StringType& pattern, |
| 58 int max_file_deleted); |
| 59 |
| 60 // This method is similar to base::DeleteFile in file_util_win.cc |
| 61 // with the following differences. |
| 62 // 1) It has an input parameter |max_file_deleted| to specify the maximum files |
| 63 // allowed to delete as well as the maximum attempt failures allowd per run. |
| 64 // 2) It deletes only the files in |path|. All subdirectories in |path| are |
| 65 // untouched but are considered as attempt failures. |
| 66 // 3) |path| won't be removed even if all its contents are deleted successfully. |
| 67 // 4) Detailed delete status is returned. |
| 68 FolderDeleteResult DeleteDirectoryContent(const base::FilePath& path, |
| 69 int max_file_deleted); |
| 70 |
| 71 // This method firstly calls DeleteDirectoryContent() to delete the contents in |
| 72 // |path|. If |path| is empty after the call, it is removed. |
| 73 FolderDeleteResult DeleteDirectory(const base::FilePath& path, |
| 74 int max_file_deleted); |
| 75 |
| 76 // Deletes the directory at |path| and records the result to UMA. |
| 77 void DeleteDirectoryAndLogResults(const base::FilePath& path, |
| 78 int max_file_deleted); |
| 79 |
| 80 #endif // CHROME_BROWSER_WIN_JUMPLIST_FILE_UTIL_H_ |
OLD | NEW |