[CDRIVER-246] please update description of 'fsync' write concern flag Created: 30/Oct/13  Updated: 18/Mar/14  Resolved: 12/Dec/13

Status: Closed
Project: C Driver
Component/s: None
Affects Version/s: None
Fix Version/s: 0.92.0

Type: Improvement Priority: Major - P3
Reporter: Duraid Madina Assignee: Unassigned
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Related
related to DRIVERS-125 update description of 'fsync' write c... Closed

 Description   

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!



 Comments   
Comment by Christian Hergert [ 12/Dec/13 ]

Fixed in the man pages for libmongoc as commit dd6756b2fbaa5579707d6f0cec9a6d62400d247c.

Generated at Wed Feb 07 21:08:53 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.