From 005a5c7ae22020c13420a0bedfda66fe2808ce18 Mon Sep 17 00:00:00 2001 From: Ashmeen Kaur Date: Mon, 25 Sep 2023 05:30:09 +0000 Subject: [PATCH] remove todo --- docs/semantics.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/semantics.md b/docs/semantics.md index f2b827dfef..6b179b8844 100644 --- a/docs/semantics.md +++ b/docs/semantics.md @@ -8,13 +8,20 @@ Files that have not been modified are read portion by portion on demand. Cloud S **Writes** -For modifications to existing objects, Cloud Storage FUSE downloads the entire backing object's contents from Cloud Storage. The contents are stored in a local temporary file whose location is controlled by the flag ```--temp-dir```. Later, when the file is closed or fsync'd, Cloud Storage FUSE writes the contents of the local file back to Cloud Storage as a new object generation. Modifying even a single bit of an object results in the full re-upload of the object. The exception is if an append is done to the end of a file, where the original file is at least 2MB, then only the appended content is uploaded. +For modifications to existing objects, Cloud Storage FUSE downloads the entire +backing object's contents from Cloud Storage. The contents are stored in a local +temporary file whose location is controlled by the flag ```--temp-dir```. Later, +when the file is closed or fsync'd, Cloud Storage FUSE writes the contents of +the local file back to Cloud Storage as a new object generation. Modifying even +a single bit of an object results in the full re-upload of the object. The +exception is if an append is done to the end of a file, where the original file +is at least 2MB, then only the appended content is uploaded. For new objects, objects are first written to the same temporary directory as mentioned above. Upon closing or fsyncing the file, the file is then written to your Cloud Storage bucket. As new and modified files are fully staged in the local temporary directory -until they are written out to Cloud Storage from being closed or fsync'd, you +until they are written out to Cloud Storage, you must ensure that there is enough free space available to handle staged content when writing large files. @@ -24,8 +31,7 @@ when writing large files. empty file now reflecting the accurate file size and content. Starting with version 1.2, the default behavior is to not create this zero-byte file, which increases write performance. If needed, it can be re-enabled by setting - the `create-empty-file: true` configuration in the [config file](TODO: link - public documentation here). + the `create-empty-file: true` configuration in the config file. **Concurrency**