2 files changed, 26 insertions, 0 deletions
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.