-
Notifications
You must be signed in to change notification settings - Fork 172
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Address shadowing divergence in reftest, update semantics doc #1201
Conversation
b3d7045
to
f405d75
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think this is the right change and semantics, I've put some feedback on docs mainly
This PR closes #1066. |
This commit addresses a case where MP model and property tests diverge (awslabs#1066). The issue was caused by the reference not correctly implementing the shadowing order defined in [#4f8cf0b](awslabs@4f8cf0b). Additionally, it clarifies the Semantics arising from concurrent MPUs. Signed-off-by: Christian Hagemeier <[email protected]>
f405d75
to
c5f1469
Compare
doc/SEMANTICS.md
Outdated
@@ -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. | |||
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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Why does Mountpoint using MPU matter? What are the consequences you might need to be aware of?
Remove comments unrelated to shadowing. Signed-off-by: Christian Hagemeier <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM! Thanks for these improvements, Christian!
This commit addresses a case where MP model and property tests diverge (#1066). The issue was caused by the reference not correctly implementing the shadowing order defined in #4f8cf0b. This commit fixes the reference model, and clarifies the semantics arising from concurrent MPUs.
This is not a breaking change, as it only impacts the reference tests.
This does not need a Changelog entry, as the change does not impact Mountpoint's behaviour.
By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and I agree to the terms of the Developer Certificate of Origin (DCO).