Renamed some examples to make their function more obvious

Also, added more comments for the same purpose.

5 files changed, 35 insertions, 14 deletions

diff --git a/example/.gitignore b/example/.gitignore
index a738dbc..ea56c8d 100644
--- a/example/.gitignore
+++ b/example/.gitignore
@@ -1,5 +1,5 @@
-/fusexmp
-/fusexmp_fh
+/passthrough
+/passthrough_fh
 /hello
 /hello_ll
 /fioc
@@ -7,6 +7,6 @@
 /fsel
 /fselclient
 /cusexmp
-/fuse_lo-plus
+/passthrough_ll
 /timefs1
 /timefs2
diff --git a/example/Makefile.am b/example/Makefile.am
index 7ddd7d9..5d82f64 100644
--- a/example/Makefile.am
+++ b/example/Makefile.am
@@ -2,12 +2,12 @@
 
 AM_CPPFLAGS = -I$(top_srcdir)/include -D_REENTRANT
 noinst_HEADERS = fioc.h
-noinst_PROGRAMS = fusexmp fusexmp_fh hello hello_ll fioc fioclient \
-		  fsel fselclient cusexmp fuse_lo-plus timefs1 timefs2 \
+noinst_PROGRAMS = passthrough passthrough_fh hello hello_ll fioc fioclient \
+		  fsel fselclient cusexmp passthrough_ll timefs1 timefs2 \
 		  timefs3
 
 LDADD = ../lib/libfuse3.la
-fusexmp_fh_LDADD = ../lib/libfuse3.la @fusexmp_fh_libs@
+passthrough_fh_LDADD = ../lib/libfuse3.la @passthrough_fh_libs@
 
 fioclient_CPPFLAGS =
 fioclient_LDFLAGS =
diff --git a/example/fusexmp.c b/example/passthrough.c
index eae3562..cf72cb2 100644
--- a/example/fusexmp.c
+++ b/example/passthrough.c
@@ -10,14 +10,17 @@
 /** @file
  * @tableofcontents
  *
- * fusexmp.c - FUSE: Filesystem in Userspace
+ * This file system mirrors the existing file system hierarchy of the
+ * system, starting at the root file system. This is implemented by
+ * just "passing through" all requests to the corresponding user-space
+ * libc functions. It's performance is terrible.
  *
  * \section section_compile compiling this example
  *
- * gcc -Wall fusexmp.c `pkg-config fuse3 --cflags --libs` -o fusexmp
+ * gcc -Wall passthrough.c `pkg-config fuse3 --cflags --libs` -o passthrough
  *
  * \section section_source the complete source
- * \include fusexmp.c
+ * \include passthrough.c
  */
 
 
diff --git a/example/fusexmp_fh.c b/example/passthrough_fh.c
index 84fce3f..a179f65 100644
--- a/example/fusexmp_fh.c
+++ b/example/passthrough_fh.c
@@ -10,14 +10,18 @@
 /** @file
  * @tableofcontents
  *
- * fusexmp_fh.c - FUSE: Filesystem in Userspace
+ * This file system mirrors the existing file system hierarchy of the
+ * system, starting at the root file system. This is implemented by
+ * just "passing through" all requests to the corresponding user-space
+ * libc functions. This implementation is a little more sophisticated
+ * than the one in passthrough.c, so performance is not quite as bad.
  *
  * \section section_compile compiling this example
  *
- * gcc -Wall fusexmp_fh.c `pkg-config fuse3 --cflags --libs` -lulockmgr -o fusexmp_fh
+ * gcc -Wall passthrough_fh.c `pkg-config fuse3 --cflags --libs` -lulockmgr -o passthrough_fh
  *
  * \section section_source the complete source
- * \include fusexmp_fh.c
+ * \include passthrough_fh.c
  */
 
 #define FUSE_USE_VERSION 30
diff --git a/example/fuse_lo-plus.c b/example/passthrough_ll.c
index c27f377..66f92cf 100644
--- a/example/fuse_lo-plus.c
+++ b/example/passthrough_ll.c
@@ -6,8 +6,22 @@
   See the file COPYING.
 */
 
-/*
- * gcc -Wall fuse_lo-plus.c `pkg-config fuse3 --cflags --libs` -o fuse_lo-plus
+/** @file
+ * @tableofcontents
+ *
+ * This file system mirrors the existing file system hierarchy of the
+ * system, starting at the root file system. This is implemented by
+ * just "passing through" all requests to the corresponding user-space
+ * libc functions. In contrast to passthrough.c and passthrough_fh.c,
+ * this implementation ises the low-level API. Its performance should
+ * be the least bad among the three.
+ *
+ * \section section_compile compiling this example
+ *
+ * gcc -Wall passthrough_ll.c `pkg-config fuse3 --cflags --libs` -o passthrough_ll
+ *
+ * \section section_source the complete source
+ * \include passthrough_ll.c
  */
 
 #define _GNU_SOURCE