#
# Copyright (c) 1993 Terrence R. Lambert.
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions
# are met:
# 1. Redistributions of source code must retain the above copyright
# notice, this list of conditions and the following disclaimer.
# 2. Redistributions in binary form must reproduce the above copyright
# notice, this list of conditions and the following disclaimer in the
# documentation and/or other materials provided with the distribution.
# 3. All advertising materials mentioning features or use of this software
# must display the following acknowledgement:
# This product includes software developed by Terrence R. Lambert.
# 4. The name Terrence R. Lambert may not be used to endorse or promote
# products derived from this software without specific prior written
# permission.
#
# THIS SOFTWARE IS PROVIDED BY TERRENCE R. LAMBERT ``AS IS'' AND ANY
# EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE TERRENCE R. LAMBERT BE LIABLE
# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
# SUCH DAMAGE.
#
# $Id: README,v 1.2 1993/11/23 04:48:15 cgd Exp $
#
1.0 Overview
This is the README file for the sample loaded file system.
2.0 Preparation
To use this module, you must have a kernel the does *NOT*
have an existing "kernfs" file system in it. To determine
if your system has the "kernfs" file system in it, check
the build file for your kernel (usually this file is named
"/sys/i386/conf/GENERICISA") for the following:
options KERNFS
By default, NetBSD has this file system compiled as part
of the kernel; if you wish to use this example with NetBSD
you will have to remove this "options" line and rebuild
your kernel.
3.0 Directions
To test the module, do the following:
cd module
make load
A load message (the copyright) will be printed on the console.
You must then add the following line to the "/etc/fstab" file:
kernfs /kern kernfs rw 1 1
At the root prompt, type the following:
mkdir /kern
Ignore the following error if it occurs:
mkdir: /kern: File exists
Again at the root prompt, type the following command:
mount /kern
cd /kern
cat version
This will verify that the module is working correctly.
4.0 Recovering resources
The file system consumes 8 pages of memory when loaded; it
can be freed up by unloading it. To unload it, type the
following from the directory this file is in:
cd module
make unload
The file system will be unloaded by name.
5.0 END OF DOCUMENT
