Module Name: src
Committed By: pooka
Date: Fri Feb 14 01:11:04 UTC 2014
Modified Files:
src/lib/libukfs: ukfs.3
Log Message:
some minor updates and reality-checks
To generate a diff of this commit:
cvs rdiff -u -r1.12 -r1.13 src/lib/libukfs/ukfs.3
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libukfs/ukfs.3
diff -u src/lib/libukfs/ukfs.3:1.12 src/lib/libukfs/ukfs.3:1.13
--- src/lib/libukfs/ukfs.3:1.12 Sat Jul 20 21:39:57 2013
+++ src/lib/libukfs/ukfs.3 Fri Feb 14 01:11:04 2014
@@ -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 @@ requires no special kernel support apart
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 @@ is used at runtime to dynamically load a
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 @@ for success.
.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 @@ first appeared in
.An Antti Kantee Aq Mt [email protected]
.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.
