From 508d432bd5e43b2af315b1a8a99fdb84c4bd294a Mon Sep 17 00:00:00 2001
From: Thomas Schwinge <schwinge@nic-nac-project.de>
Date: Tue, 18 Aug 2009 15:51:49 +0200
Subject: Some examples gathered from Hurd sources.

---
 hurd/interface/fs/13.mdwn | 22 ++++++++++++++++++++++
 hurd/interface/fs/14.mdwn | 29 +++++++++++++++++++++++++++++
 2 files changed, 51 insertions(+)

(limited to 'hurd/interface/fs')

diff --git a/hurd/interface/fs/13.mdwn b/hurd/interface/fs/13.mdwn
index 72ae0d06..2e06e0c4 100644
--- a/hurd/interface/fs/13.mdwn
+++ b/hurd/interface/fs/13.mdwn
@@ -21,6 +21,28 @@ 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.
 
+# Implementation Examples
+
+Servers that either don't keep any unsynchronized state (or don't have a
+backing store at all) can simply `return 0`.  Examples: [[translator/nfs]].
+
+## [[libtrivfs]]
+
+Pass the call through to the underlying node.
+
+### [[storeio]] / [[streamio]]
+
+Instead of to the underlying node, pass the call through to the backend
+(device).
+
+## [[libnetfs]]
+
+Invoke `netfs_attempt_sync`.
+
+## [[libdiskfs]]
+
+Invoke `diskfs_file_update`.
+
 # Usage Examples
 
 ## [[glibc]]
diff --git a/hurd/interface/fs/14.mdwn b/hurd/interface/fs/14.mdwn
index 85d8a73a..c93613d8 100644
--- a/hurd/interface/fs/14.mdwn
+++ b/hurd/interface/fs/14.mdwn
@@ -19,6 +19,35 @@ License|/fdl]]."]]"""]]
 
 Sync the entire filesystem.
 
+# Implementation Examples
+
+Servers that either don't keep any unsynchronized state (or don't have a
+backing store at all) can simply `return 0`.  Examples: [[translator/nfs]].
+
+The implementation typically doesn't care on which specific node (as exported
+by the implementing server) [[`file_syncfs`|file_syncfs]] is being invoked on.
+
+## [[libtrivfs]]
+
+Invoke [[`file_sync`|file_sync]] on the underlying node.  Rationale: the
+underlying node represents this filesystem's backend, and once this node is
+synchronized, the whole [[libtrivfs]]-based filesystem is to be considered
+synchronized.
+
+### [[storeio]] / [[streamio]]
+
+Instead of the to underlying node, pass the call through to the backend
+(device).
+
+## [[libnetfs]]
+
+Invoke `netfs_attempt_syncfs`.
+
+## [[libdiskfs]]
+
+Invoke [[`fsys_syncfs`|fsys_syncfs]] on all active children, and invoke
+`diskfs_sync_everything` and `diskfs_set_hypermetadata`.
+
 # Usage Examples
 
 ## [[glibc]]
-- 
cgit v1.2.3