| // Copyright 2015 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 COMPONENTS_FILESYSTEM_UTIL_H_ |
| #define COMPONENTS_FILESYSTEM_UTIL_H_ |
| |
| #include <stdint.h> |
| |
| #include "base/files/file.h" |
| #include "components/filesystem/public/interfaces/types.mojom.h" |
| |
| namespace filesystem { |
| |
| // Validation functions (typically used to check arguments; they return |
| // |ERROR_OK| if valid, else the standard/recommended error for the validation |
| // error): |
| |
| // Checks if |path| is (looks like) a valid (relative) path. (On failure, |
| // returns |ERROR_INVALID_ARGUMENT| if |path| is not UTF-8, or |
| // |ERROR_PERMISSION_DENIED| if it is not relative.) |
| mojom::FileError IsPathValid(const std::string& path); |
| |
| // Checks if |whence| is a valid (known) |Whence| value. (On failure, returns |
| // |ERROR_UNIMPLEMENTED|.) |
| mojom::FileError IsWhenceValid(mojom::Whence whence); |
| |
| // Checks if |offset| is a valid file offset (from some point); this is |
| // implementation-dependent (typically checking if |offset| fits in an |off_t|). |
| // (On failure, returns |ERROR_OUT_OF_RANGE|.) |
| mojom::FileError IsOffsetValid(int64_t offset); |
| |
| // Conversion functions: |
| |
| // Returns the platform dependent error details converted to the |
| // filesystem.Error enum. |
| mojom::FileError GetError(const base::File& file); |
| |
| // Serializes Info to the wire format. |
| mojom::FileInformationPtr MakeFileInformation(const base::File::Info& info); |
| |
| // Creates an absolute file path and ensures that we don't try to traverse up. |
| mojom::FileError ValidatePath(const std::string& raw_path, |
| const base::FilePath& filesystem_base, |
| base::FilePath* out); |
| |
| } // namespace filesystem |
| |
| #endif // COMPONENTS_FILESYSTEM_UTIL_H_ |