Skip to content

Commit

Permalink
Update SEMANTICS.md
Browse files Browse the repository at this point in the history
Remove comments unrelated to shadowing.

Signed-off-by: Christian Hagemeier <[email protected]>
  • Loading branch information
c-hagem authored Dec 17, 2024
1 parent c5f1469 commit 8760853
Showing 1 changed file with 1 addition and 3 deletions.
4 changes: 1 addition & 3 deletions doc/SEMANTICS.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ Mountpoint allows multiple readers to access the same object at the same time.
However, a new file can only be written to sequentially and by one writer at a time.
New files that are being written are not available for reading until the writing application closes the file and Mountpoint finishes uploading it to S3.
If you have multiple Mountpoint mounts for the same bucket, on the same or different hosts, there is no coordination between writes to the same object.
Your application should not write to the same object from multiple instances at the same time. If you use multiple instances for writing the same key (or another client modifies the Object while the file is open for writing), be aware that Mountpoint currently uses Multipart Uploads (MPU) that are created after the file is opened to upload the data to S3.
Your application should not write to the same object from multiple instances at the same time.

By default, Mountpoint ensures that new file uploads to a single key are atomic. As soon as an upload completes, other clients are able to see the new key and the entire content of the object. If the `--incremental-upload` flag is set, however, Mountpoint may issue multiple separate uploads during file writes to append data to the object. After each upload, the appended object in your S3 bucket will be visible to other clients.

Expand Down Expand Up @@ -275,5 +275,3 @@ Mountpoint provides strong read-after-write consistency for new object creation
* A process deletes an existing object from your S3 bucket using another client, and then tries to open the object with Mountpoint and read from it. The open operation will fail.
* A process deletes an existing object from your S3 bucket, using either Mountpoint or another client, and then lists the directory the object was previously in with Mountpoint. The object will not appear in the list.
* A process deletes an existing object from your S3 bucket using another client, and then queries the object’s metadata with Mountpoint using the `stat`` system call. The returned metadata could reflect the old object for up to 1 second after the DeleteObject request.
* A process opens a file with Mountpoint, and another Mountpoint client on another instance opens the same file. In this case, the behaviour is determined by the [S3 semantics for concurrent multipart uploads](https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#distributedmpupload).

0 comments on commit 8760853

Please sign in to comment.