[src/trunk]: src/lib/libukfs some minor updates and reality-checks

[pooka <pooka%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/277d058cef26
branches:  trunk
changeset: 326698:277d058cef26
user:      pooka <pooka%NetBSD.org@localhost>
date:      Fri Feb 14 01:11:04 2014 +0000

description:
some minor updates and reality-checks

diffstat:

 lib/libukfs/ukfs.3 |  32 ++++++++++++--------------------
 1 files changed, 12 insertions(+), 20 deletions(-)

diffs (76 lines):

diff -r a3d19005518f -r 277d058cef26 lib/libukfs/ukfs.3
--- a/lib/libukfs/ukfs.3        Fri Feb 14 00:33:51 2014 +0000
+++ b/lib/libukfs/ukfs.3        Fri Feb 14 01:11:04 2014 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: ukfs.3,v 1.12 2013/07/20 21:39:57 wiz Exp $
+.\"     $NetBSD: ukfs.3,v 1.13 2014/02/14 01:11:04 pooka Exp $
 .\"
 .\" Copyright (c) 2008 Antti Kantee.  All rights reserved.
 .\"
@@ -23,7 +23,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd November 22, 2009
+.Dd February 13, 2014
 .Dt UKFS 3
 .Os
 .Sh NAME
@@ -44,17 +44,17 @@
 As
 .Nm
 is built upon
-.Xr rump 3 ,
-all kernel file systems which are supported by rump are available.
-It allows to write utilities for accessing file systems without having
-to duplicate file system internals knowledge already present in kernel
-file system drivers.
+.Xr rump 3
+kernels, all kernel file systems which are supported by rump kernels
+are available.  It allows to write utilities for accessing file systems
+without having to duplicate file system internals knowledge already
+present in kernel file system drivers.
 .Pp
 .Nm
 provides a high-level pathname based interface for accessing file systems.
 If a lower level interface it desired,
 .Xr rump 3
-should be used directly.
+kernels should be used directly.
 However, much like system calls, the interfaces of
 .Nm ,
 are self-contained and require no tracking and release of resources.
@@ -91,7 +91,7 @@
 file system module.
 For this to succeed, the
 .Xr rump 3
-library and the module targetted must be compiled with compatible kernel
+kernel and the module targetted must be compiled with compatible kernel
 versions and the application must be dynamically linked.
 Additionally, since this routine does not handle dependencies, all the
 dependencies of the library must be loaded beforehand.
@@ -101,7 +101,7 @@
 .Fn ukfs_modload_dir
 loads all
 .Xr rump 3
-file system modules in directory
+kernel file system components in directory
 .Fa dirname .
 It looks for libraries which begin with
 .Pa librumpfs_
@@ -316,13 +316,5 @@
 .An Antti Kantee Aq Mt pooka%cs.hut.fi@localhost
 .Sh NOTES
 .Nm
-should be considered experimental technology and may change without warning.
-.Sh BUGS
-On Linux, dynamically linked binaries can include support for only
-one file system due to restrictions with the dynamic linker.
-If more are desired, they must be loaded at runtime using
-.Fn ukfs_modload .
-Even though
-.Nx
-does not have this restriction, portable programs should load all
-file system drivers dynamically.
+was an early attempt at an interface for kernel file systems
+running in userspace.