From 8d6f6b079a205673b36b91986fce589e930cfc83 Mon Sep 17 00:00:00 2001
From: Thomas Schwinge <schwinge@nic-nac-project.de>
Date: Tue, 18 Aug 2009 12:22:40 +0200
Subject: Add fdatasync, fsync, sync example from glibc.

---
 hurd/interface/fs/13.mdwn | 16 ++++++++++++++++
 hurd/interface/fs/14.mdwn | 10 ++++++++++
 2 files changed, 26 insertions(+)

(limited to 'hurd')

diff --git a/hurd/interface/fs/13.mdwn b/hurd/interface/fs/13.mdwn
index 27239759..72ae0d06 100644
--- a/hurd/interface/fs/13.mdwn
+++ b/hurd/interface/fs/13.mdwn
@@ -20,3 +20,19 @@ License|/fdl]]."]]"""]]
 Sync the individual file.  If `omit_metadata` is set, then it is only necessary
 for the server to updated the actual contents of the file, not any associated
 metadata.
+
+# Usage Examples
+
+## [[glibc]]
+
+  * `fdatasync`
+
+    `file_syncfs (FD, true, true)` -- invoke it on the passed file descriptor,
+    do wait for completion, do allow omitting to update the associated
+    metadata.
+
+  * `fsync`
+
+    `file_syncfs (FD, true, false)` -- invoke it on the passed file descriptor,
+    do wait for completion, don't allow omitting to update the associated
+    metadata.
diff --git a/hurd/interface/fs/14.mdwn b/hurd/interface/fs/14.mdwn
index 1e8c51e7..e168e554 100644
--- a/hurd/interface/fs/14.mdwn
+++ b/hurd/interface/fs/14.mdwn
@@ -18,3 +18,13 @@ License|/fdl]]."]]"""]]
     	do_children: int);
 
 Sync the entire filesystem.
+
+# Usage Examples
+
+## [[glibc]]
+
+  * `sync`
+
+    `file_syncfs ("/", false, true)`-- invoke it on the process' root directory
+    (`INIT_PORT_CRDIR`), don't wait for completion, do synchronize child
+    filesystems.
-- 
cgit v1.2.3