Uploaded image for project: 'C Driver'
  1. C Driver
  2. CDRIVER-246

please update description of 'fsync' write concern flag

    • Type: Icon: Improvement Improvement
    • Resolution: Done
    • Priority: Icon: Major - P3 Major - P3
    • 0.92.0
    • Affects Version/s: None
    • Component/s: None
    • Labels:
      None

      Since your driver's documentation (e.g. here) describes the 'fsync' write concern flag, can you please update its description so that it accurately describes the current behavior, which is:

      1. 'fsync' is identical to 'j' if mongod is running with a journal (today, 99% of users should be here)
      2. 'fsync' requests that the write be sync()'d to disk only if mongod is not running with a journal
      3. 'fsync' cannot be used simultaneously with the 'j' flag

      The point is that:

      • 'j' means 'sync via the journal if present, or error if not, or if 'fsync' is also set'
      • 'fsync' means 'sync via the journal if present, or sync via msync() if there is no journal, and error if 'j' is also set'

      Additionally, could you please mark the 'fsync' flag as "Deprecated; do not use", following this commit here

      Please see SERVER-11399 for background.

      Thanks!

            Assignee:
            Unassigned Unassigned
            Reporter:
            duraid.madina@10gen.com Duraid Madina
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: