From: david-sarah Date: Wed, 31 Aug 2011 23:21:48 +0000 (-0700) Subject: docs/write_coordination.rst: fix formatting and add more specific warning about acces... X-Git-Tag: allmydata-tahoe-1.9.0a2~65 X-Git-Url: https://git.rkrishnan.org/components/%22news.html/frontends/wapi.txt?a=commitdiff_plain;h=08ea3dc512be2e331aa486f818ba9d5f2fe2c4cb;p=tahoe-lafs%2Ftahoe-lafs.git docs/write_coordination.rst: fix formatting and add more specific warning about access via sshfs. --- diff --git a/docs/write_coordination.rst b/docs/write_coordination.rst index eebb0dd9..e855aec4 100644 --- a/docs/write_coordination.rst +++ b/docs/write_coordination.rst @@ -2,12 +2,17 @@ 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 UncoordinatedWriteError

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 +Tahoe does not provide locking of mutable files and directories. +If there is more than one simultaneous attempt to change a mutable file +or directory, then an ``UncoordinatedWriteError`` may 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 that wants to write. + +If mutable parts of a filesystem are accessed via sshfs, only a single +sshfs mount should be used. There may be data loss if mutable files or +directories are accessed via two sshfs mounts, or written both via sshfs +and from other clients.