tahoe-lafs/tahoe-lafs
tahoe-lafs
/
tahoe-lafs
2
0
Fork 0
Code Issues Pull Requests 23 Packages Projects Releases 1 Wiki Activity

Writing a file without a db entry is an overwrite. 

Signed-off-by: Daira Hopwood <daira@jacaranda.org>
This commit is contained in:
Daira Hopwood 2015-10-25 13:13:36 +00:00
parent a2135600f8
commit 7d996dbb19
1 changed files with 6 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/proposed/magic-folder/remote-to-local-sync.rst
View File

@ -350,6 +350,9 @@ remote change has been initially classified as an overwrite.
.. _`Fire Dragons`: #fire-dragons-distinguishing-conflicts-from-overwrites .. _`Fire Dragons`: #fire-dragons-distinguishing-conflicts-from-overwrites
Note that writing a file that does not already have an entry in
the `magic folder db`_ is initially classed as an overwrite.
A *write/download collision* occurs when another program writes A *write/download collision* occurs when another program writes
to ``foo`` in the local filesystem, concurrently with the new to ``foo`` in the local filesystem, concurrently with the new
version being written by the Magic Folder client. We need to version being written by the Magic Folder client. We need to
@ -665,8 +668,9 @@ must not bother the user.
For example, suppose that Alice's Magic Folder client sees a change For example, suppose that Alice's Magic Folder client sees a change
to ``foo`` in Bob's DMD. If the version it downloads from Bob's DMD to ``foo`` in Bob's DMD. If the version it downloads from Bob's DMD
is "based on" the version currently in Alice's local filesystem at is "based on" the version currently in Alice's local filesystem at
the time Alice's client attempts to write the downloaded file, then the time Alice's client attempts to write the downloaded file ‒or if
it is an overwrite. Otherwise it is initially classified as a there is no existing version in Alice's local filesystem at that time‒
then it is an overwrite. Otherwise it is initially classified as a
conflict. conflict.
This initial classification is used by the procedure for writing a This initial classification is used by the procedure for writing a