tahoe-lafs/docs/write_coordination.rst

==================================
Avoiding Write Collisions in Tahoe
==================================

Tahoe does not provide locking of the mutable files and directories.  
If there is more than one simultaneous attempt to change a mutable file 
or directory, then an <cite>UncoordinatedWriteError</p> will result.  
This might, in rare cases, cause the file or directory contents to be 
accidentally deleted.  The user is expected to ensure that there is at 
most one outstanding write or update request for a given file or 
directory at a time.  One convenient way to accomplish this is to make 
a different file or directory for each person or process which wants to 
write.
replace remaining .html docs with .rst docs Remove install.html (long since deprecated). Also replace some obsolete references to install.html with references to quickstart.rst. Fix some broken internal references within docs/historical/historical_known_issues.txt. Thanks to Ravi Pinjala and Patrick McDonald. refs #1227 2011-05-10 19:16:50 +00:00			`==================================`
			`Avoiding Write Collisions in Tahoe`
			`==================================`

			`Tahoe does not provide locking of the mutable files and directories.`
			`If there is more than one simultaneous attempt to change a mutable file`
			`or directory, then an <cite>UncoordinatedWriteError</p> will result.`
			`This might, in rare cases, cause the file or directory contents to be`
			`accidentally deleted. The user is expected to ensure that there is at`
			`most one outstanding write or update request for a given file or`
			`directory at a time. One convenient way to accomplish this is to make`
			`a different file or directory for each person or process which wants to`
			`write.`