Subject: doc: Adds a bug section to sync.1 page to draw attention to unexpected behavior allowed by POSIX.

From: [email-masked]
Date: Wed, 4 Mar 2015 01:06:01 +0100

From: Stéphane Aulery <[email-masked]>

Almost identical copy of sync.2.

Debian bug #507085 reported by [email-masked]

Signed-off-by: Stéphane Aulery <[email-masked]>
---
 man/sync.x | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/man/sync.x b/man/sync.x
index 79fee22..5b85bba 100644
--- a/man/sync.x
+++ b/man/sync.x
@@ -2,5 +2,10 @@
 sync \- Synchronize cached writes to persistent storage
 [DESCRIPTION]
 .\" Add any additional description here
+[BUGS]
+According to the standard specification (e.g., POSIX.1-2001), sync()
+syscall schedules the writes, but may return before the actual writing is
+done. However, since version 1.3.20 Linux does actually wait. (This still
+does not guarantee data integrity: modern disks have large caches.)
 [SEE ALSO]
 fdatasync(2), fsync(2), sync(2), syncfs(2)
-- 
2.1.4