+------------------------------+
			| mkkernel - User Instructions |
			+------------------------------+
    	 			Version 1.4
			+------------------------------+
			     D.Dallas & S.G.Parker 
				 March 1995
			+------------------------------+

+-----------+
 Description
+-----------+
	
	This utility is currently for use with NX Intel, NX Sparc, MPlus, and
  Unixware. It allows you to set up a file, by default called the settings file,
  then you run the script and it will tune the kernel and offer to 
  rebuild automatically.

+--------+
 Contents
+--------+

	There should be 2 files, mkkernel.INTEL and mkkernel.SPARC. The 
   mkkernel.INTEL file, is for user with NX Intel, MPLus and Unixware, the
   mkkernel.SPARC is for use with NX Sparc only.
   The script will NOT allow you to run the wrong script on the wrong machine.

 +-----+
  Usage
 +-----+

	You must have super-user priveliges to tune the kernel, so
	this script requires you to be a super-user. The script will
	not let you continue if you do do have root access.
	
	You can obtain the usage message, from the script by typing : 
		'mkkernel -?'

	mkkernel [-f <filename>] [-e] [-l] [-y]

	Taking each option in turn :

		-f : This option allows you to change the default filename.
		     If you created a settings file and called it douglas,
		     then you would have to use the -f option to tell the
		     script that you were using a file called douglas, if
		     nothing is entered, it will try to use the default
		     which is settings.

                -e : This option tells the script to tune to exactly the
		     values in the settings file, because by default
		     the script will not tune down a parameter, but
		     ensure that the values are at least what is listed
		     in the settings file.
	
		-l : This option list what the file says, what the current
		     settings are and what if would change it to if the
		     script were run without the -l option.

		-y : This option rebuilds the kernel for you with out 
		     asking you, the default will ask you whether or not
		     you wish to rebuild the kernel.

+--------+
 Settings
+--------+

	Before the mkkernel script can be run, a file must be created to 
  contain the values for use. The default name for this file is settings,
  although you can call it anything you want with the -f option. The 
  settings file can also contain comments, but these have to be hashed out. See
  below for an example of a simple settings file.

	# Settings file for preVue
	# All these line as comments
	# Created by me, today

	NPROC 2000
	MAXUP  4000
	SEMMNI 1200
	
       
        If within the settings file there is a non-kernel value , then you 
	are told, but the script continues to run with the rest of the 
	parameters in the settings file.

________________________________________________________________________________

	Any problems with the script, or documentation, please inform
	either :
 
		Douglas Dallas 7263 x3609 afc@bra01.icl.co.uk
				     or
		Steve Parker   7263 x2916 steve@bra01.icl.co.uk
________________________________________________________________________________