[Xapian-tickets] [Xapian] #746: Locking Behavior Documentation Out of Date

[Xapian]

#746: Locking Behavior Documentation Out of Date
----------------------------------+------------------
        Reporter:  tim            |      Owner:  olly
            Type:  defect         |     Status:  new
        Priority:  normal         |  Milestone:
       Component:  Documentation  |    Version:
        Severity:  normal         |   Keywords:
      Blocked By:                 |   Blocking:
Operating System:  All            |
----------------------------------+------------------
 Within the [http://getting-started-with-
 xapian.readthedocs.io/en/latest/concepts/indexing/databases.html#locking
 databases description of locking], the following text is provided:

   With the disk-based Xapian backends, when a database is opened for
 writing, a lock is obtained on the database to ensure that no further
 writers are opened concurrently. This lock will be released when the
 database writer is closed (or automatically if the writer process dies).

   One unusual feature of Xapian’s locking mechanism (at least on POSIX
 operating systems) is that Xapian forks a subprocess to hold the lock,
 rather than holding it in the main process. This is to avoid the lock
 being accidentally released due to the slightly unhelpful semantics of
 fcntl locks.

--
Ticket URL: <https://trac.xapian.org/ticket/746>
Xapian <https://xapian.org/>
Xapian