Add BUGS section which notes that dynamic linker features in dealing

with link sets prevent from including more than one file system on
the link line and that the rest must be loaded dynamically at runtime.
This commit is contained in:
pooka 2008-11-25 06:44:19 +00:00
parent faeb779f91
commit 24bc96c743

View File

@ -1,4 +1,4 @@
.\" $NetBSD: ukfs.3,v 1.4 2008/09/07 15:14:31 pooka Exp $
.\" $NetBSD: ukfs.3,v 1.5 2008/11/25 06:44:19 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 September 7, 2008
.Dd November 28, 2008
.Dt UKFS 3
.Os
.Sh NAME
@ -354,3 +354,14 @@ first appeared in
.Sh NOTES
.Nm
should be considered experimental technology and may change without warning.
.Sh BUGS
Due to how the runtime linker works, it is possible to include
support for only one file system in dynamic binaries at linktime.
The remaining desired file systems can be loaded with
.Fn ukfs_modload .
Statically linked binaries do not have this limitation, but cannot use
.Fn ukfs_modload
at all.
The recommended approach is to use dynamically linked binaries and load all
file system modules with
.Fn ukfs_modload .