Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(276)

Side by Side Diff: components/filesystem/public/interfaces/file.mojom

Issue 2096293002: Eliminate usage of InterfacePtr::WaitForIncomingResponse. (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: Fix trybots failure Created 4 years, 5 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
OLDNEW
1 // Copyright 2015 The Chromium Authors. All rights reserved. 1 // Copyright 2015 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be 2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file. 3 // found in the LICENSE file.
4 4
5 // TODO(vtl): notes to self: 5 // TODO(vtl): notes to self:
6 // - file offsets, file positions, and file sizes are int64 (though positions 6 // - file offsets, file positions, and file sizes are int64 (though positions
7 // and sizes must always be non-negative) 7 // and sizes must always be non-negative)
8 // - buffer size parameters (for read/write) are uint32 8 // - buffer size parameters (for read/write) are uint32
9 9
10 module filesystem.mojom; 10 module filesystem.mojom;
11 11
12 import "components/filesystem/public/interfaces/types.mojom"; 12 import "components/filesystem/public/interfaces/types.mojom";
13 13
14 // TODO(vtl): Write comments. 14 // TODO(vtl): Write comments.
15 interface File { 15 interface File {
16 // Flushes/closes this file; no operations may be performed on this file after 16 // Flushes/closes this file; no operations may be performed on this file after
17 // this. Note that any error code is strictly informational -- the close may 17 // this. Note that any error code is strictly informational -- the close may
18 // not be retried. 18 // not be retried.
19 [Sync]
19 Close() => (FileError err); 20 Close() => (FileError err);
20 21
21 // Reads (at most) |num_bytes_to_read| from the location specified by 22 // Reads (at most) |num_bytes_to_read| from the location specified by
22 // |offset|/|whence|. On success, |bytes_read| is set to the data read. 23 // |offset|/|whence|. On success, |bytes_read| is set to the data read.
23 // TODO(vtl): Define/clarify behavior when less than |num_bytes_to_read| bytes 24 // TODO(vtl): Define/clarify behavior when less than |num_bytes_to_read| bytes
24 // are read. 25 // are read.
25 // TODO(vtl): Clarify when (for what values of |offset|/|whence|) this 26 // TODO(vtl): Clarify when (for what values of |offset|/|whence|) this
26 // modifies the file position. Or maybe there should be a flag? 27 // modifies the file position. Or maybe there should be a flag?
28 [Sync]
27 Read(uint32 num_bytes_to_read, int64 offset, Whence whence) 29 Read(uint32 num_bytes_to_read, int64 offset, Whence whence)
28 => (FileError error, array<uint8>? bytes_read); 30 => (FileError error, array<uint8>? bytes_read);
29 31
30 // Writes |bytes_to_write| to the location specified by |offset|/|whence|. 32 // Writes |bytes_to_write| to the location specified by |offset|/|whence|.
31 // TODO(vtl): Clarify behavior when |num_bytes_written| is less than the size 33 // TODO(vtl): Clarify behavior when |num_bytes_written| is less than the size
32 // of |bytes_to_write|. 34 // of |bytes_to_write|.
35 [Sync]
33 Write(array<uint8> bytes_to_write, int64 offset, Whence whence) 36 Write(array<uint8> bytes_to_write, int64 offset, Whence whence)
34 => (FileError error, uint32 num_bytes_written); 37 => (FileError error, uint32 num_bytes_written);
35 38
36 // Gets the current file position. On success, |position| is the current 39 // Gets the current file position. On success, |position| is the current
37 // offset (in bytes) from the beginning of the file). 40 // offset (in bytes) from the beginning of the file).
41 [Sync]
38 Tell() => (FileError error, int64 position); 42 Tell() => (FileError error, int64 position);
39 43
40 // Sets the current file position to that specified by |offset|/|whence|. On 44 // Sets the current file position to that specified by |offset|/|whence|. On
41 // success, |position| is the offset (in bytes) from the beginning of the 45 // success, |position| is the offset (in bytes) from the beginning of the
42 // file. 46 // file.
47 [Sync]
43 Seek(int64 offset, Whence whence) => (FileError error, int64 position); 48 Seek(int64 offset, Whence whence) => (FileError error, int64 position);
44 49
45 // Gets information about this file. On success, |file_information| is 50 // Gets information about this file. On success, |file_information| is
46 // non-null and will contain this information. 51 // non-null and will contain this information.
52 [Sync]
47 Stat() => (FileError error, FileInformation? file_information); 53 Stat() => (FileError error, FileInformation? file_information);
48 54
49 // Truncates this file to the size specified by |size| (in bytes). 55 // Truncates this file to the size specified by |size| (in bytes).
56 [Sync]
50 Truncate(int64 size) => (FileError error); 57 Truncate(int64 size) => (FileError error);
51 58
52 // Updates this file's atime and/or mtime to the time specified by |atime| (or 59 // Updates this file's atime and/or mtime to the time specified by |atime| (or
53 // |mtime|, respectively), which may also indicate "now". If |atime| or 60 // |mtime|, respectively), which may also indicate "now". If |atime| or
54 // |mtime| is null, then the corresponding time is not modified. 61 // |mtime| is null, then the corresponding time is not modified.
62 [Sync]
55 Touch(TimespecOrNow? atime, TimespecOrNow? mtime) => (FileError error); 63 Touch(TimespecOrNow? atime, TimespecOrNow? mtime) => (FileError error);
56 64
57 // Creates a new |File| instance, which shares the same "file description". 65 // Creates a new |File| instance, which shares the same "file description".
58 // I.e., the access mode, etc. (as specified to |Directory::OpenFile()| by the 66 // I.e., the access mode, etc. (as specified to |Directory::OpenFile()| by the
59 // |open_flags| argument) as well as file position. 67 // |open_flags| argument) as well as file position.
68 [Sync]
60 Dup(File& file) => (FileError error); 69 Dup(File& file) => (FileError error);
61 70
62 // Syncs data to disk. 71 // Syncs data to disk.
72 [Sync]
63 Flush() => (FileError error); 73 Flush() => (FileError error);
64 74
65 // Attempts to take an exclusive write lock on the file. This both takes a 75 // Attempts to take an exclusive write lock on the file. This both takes a
66 // native OS file lock (so that non-chrome, non-mojo processes can't write to 76 // native OS file lock (so that non-chrome, non-mojo processes can't write to
67 // this file). 77 // this file).
68 [Sync] 78 [Sync]
69 Lock() => (FileError error); 79 Lock() => (FileError error);
70 80
71 // Unlocks a previously locked file. 81 // Unlocks a previously locked file.
72 [Sync] 82 [Sync]
73 Unlock() => (FileError error); 83 Unlock() => (FileError error);
74 84
75 // Returns a handle to the file for raw access. 85 // Returns a handle to the file for raw access.
86 [Sync]
76 AsHandle() => (FileError error, handle file_handle); 87 AsHandle() => (FileError error, handle file_handle);
77 }; 88 };
OLDNEW
« no previous file with comments | « components/filesystem/public/interfaces/directory.mojom ('k') | components/filesystem/public/interfaces/file_system.mojom » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698