docs/write_coordination.rst

   1 ==================================
   2 Avoiding Write Collisions in Tahoe
   3 ==================================
   4
   5 Tahoe does not provide locking of mutable files and directories.
   6 If there is more than one simultaneous attempt to change a mutable file
   7 or directory, then an ``UncoordinatedWriteError`` may result.
   8 This might, in rare cases, cause the file or directory contents to be
   9 accidentally deleted.  The user is expected to ensure that there is at
  10 most one outstanding write or update request for a given file or
  11 directory at a time.  One convenient way to accomplish this is to make
  12 a different file or directory for each person or process that wants to
  13 write.
  14
  15 If mutable parts of a filesystem are accessed via sshfs, only a single
  16 sshfs mount should be used. There may be data loss if mutable files or
  17 directories are accessed via two sshfs mounts, or written both via sshfs
  18 and from other clients.