unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 kminstall(1M)						       kminstall(1M)




 NAME
      kminstall - add, delete, update a kernel module

 SYNOPSIS
      /usr/sbin/kminstall [-a|-d|-u] [-s] module_name

 DESCRIPTION
      kminstall will add (-a), delete (-d) or update (-u) a module's
      component files on the system.

      When called with the -a or -u option, kminstall expects to find the
      module's component files in the current directory, and installs or
      updates copies of the files under subdirectories of the /usr/conf and
      /stand directories.

    Options
      The options for kminstall are:

      -a	Add the component files for the named module, module_name,
		to the appropriate system-specific directories.

		A module's component files consist of the following:

		mod.o	       required
		master	       required
		system	       required
		space.h	       optional
		Modstub.o      optional

		kminstall -a expects minimally a readable mod.o, master, and
		system file in the current directory.  It creates the
		required system-specific target directories if they do not
		exist.	If module_name already exists on the system,
		kminstall -a prints a message and fails.

      -d	Remove the component files for the named module,
		module_name, from the system-specific directories.

		kminstall -d deletes the files that have been previously
		installed via kminstall -a or kminstall -u.  If the module
		has been configured for use with the current kernel, and
		kminstall can bring the module to an unregistered state,
		kminstall -d will also remove the loadable image of the
		module from disk.  If the module cannot be unregistered,
		kminstall -d prints a warning message and the loadable image
		remains.

		If module_name is configured as a loadable module and its
		entry is in the /etc/loadmods file (see loadmods(4)), then
		kminstall prints a warning message and removes the module
		entry from /etc/loadmods.



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 kminstall(1M)						       kminstall(1M)




      -s	Silence all warning messages.

      -u	Update the component files for the named module,
		module_name, in the system-specific directories.

		kminstall -u expects minimally the same required component
		files in the current directory as the -a option.  If
		module_name already exists on the system, kminstall updates
		the module.  When updating an existing module, any
		administrator-configurable attributes (see kmsystem(1M) and
		kmtune(1M)) of the existing module will be preserved and
		applied to the updated module.

		If module_name does not exist on the system, then kminstall
		-u prints a warning and proceeds to add the module to the
		system.

		kminstall creates the required system-specific target
		directories if they do not exist.

 RETURN VALUE
      An exit value of zero indicates success.	If an error occurs,
      kminstall exits with a non-zero value and reports an error message.
      Error messages are self-explanatory.

 FILES
      /usr/conf/master.d/*	    Default input master kernel
				    configuration tables

      /stand/dlkm*/mod.d/*	    Configured loadable images associated
				    with a kernel

 SEE ALSO
      config(1M), kmsystem(1M), kmtune(1M), loadmods(4), master(4).




















 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000