From 34575dba02e14db5c1a9e874b3fccfc5fbfab87b Mon Sep 17 00:00:00 2001 From: Derick Rethans Date: Wed, 30 Oct 2013 11:05:02 +0000 Subject: [PATCH] PHP-938: please update description of 'fsync' write concern flag. git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@332016 c90b9560-bf6c-de11-be94-00142212c4b1 --- language-snippets.ent | 2 +- reference/mongo/mongoclient/construct.xml | 18 +++++++++++++----- 2 files changed, 14 insertions(+), 6 deletions(-) diff --git a/language-snippets.ent b/language-snippets.ent index 652d48b191..61e6b3da7c 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1729,7 +1729,7 @@ paths This function returns an array describing the read preference. The array contains the values type for the string read preference mode (corresponding to the MongoClient constants), and tagsets containing a list of all tag set criteria. If no tag sets were specified, tagsets will not be present in the array.'> "w"See WriteConcerns. The default value for MongoClient is 1.'> "wtimeout"How long to wait for WriteConcern acknowledgement. The default value for MongoClient is 10000 milliseconds.'> -"fsync"Boolean, defaults to &false;. Forces the insert to be synced to disk before returning success. If &true;, an acknowledged insert is implied and will override setting w to 0.'> +"fsync"Boolean, defaults to &false;. If journalling is enabled, it works exactly like "j". If journalling is not enabled, it forces the insert to be synced to disk before returning success. If &true;, an acknowledged insert is implied and will override setting w to 0.This option is deprecated. Please use the "j" option instead.'> "j"Boolean, defaults to &false;. Forces the insert to be synced to the journal before returning success. If &true;, an acknowledged insert is implied and will override setting w to 0.'> "safe"Deprecated. Please use the WriteConcern w option.'> diff --git a/reference/mongo/mongoclient/construct.xml b/reference/mongo/mongoclient/construct.xml index 989f00d82b..ddf7c7497e 100644 --- a/reference/mongo/mongoclient/construct.xml +++ b/reference/mongo/mongoclient/construct.xml @@ -131,13 +131,21 @@ mongodb://[username:password@]host1[:port1][,host2[:port2:],...]/db When fsync is set, all write operations on the - database will block until the database server has flushed its - database files to disk. This makes write operations a lot slower, + database will only return when the write has been synched to disk. + This makes write operations a lot slower, but it guarantees that the write operation has succeeded and - committed to disk. Please avoid using this - option and use the journal option instead, - perhaps in combination with the w option. + committed to disk. If you have journalling enabled in MongoDB (the + default) then the sync happens only to the + journal. If journalling is not enabled, then + using fsync requires a full flush to disk. + + + Please do not use this option as it is + deprecated, but use journal option instead, + perhaps in combination with the w option. + +