unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



kloadsrv(8)							  kloadsrv(8)



NAME

  kloadsrv - Invokes the kernel	load server daemon

SYNOPSIS

  /sbin/kloadsrv [-V] [-f] [-d debug_level] [-k] [-log logfile]	[-q] [-s
  kernel_symtab_file] [kernel_object_filename]

  /sbin/kloadsrv [-w kernel_symtab_file] kernel_object_filename

OPTIONS

  -V  Displays the version of the kloadsrv command.

  -f  Causes the kloadsrv daemon to remain in the foreground. By default, the
      daemon automatically places itself into the background after it ini-
      tializes.

  -d debug_level
      Specifies	the level of debugging information. The	debug_level is a
      small integer. A value of	zero (0) disables debugging. Nonzero values
      from 1 to	higher levels cause kloadsrv to	display	various	log messages.

  -k  Kills the	kloadsrv daemon, if it is running.

  -log logfile
      Specifies	that the debugging information is to be	sent to	the specified
      log file.	The logfilevariable must be specified as a full	pathname. By
      default, the debugging information is sent to the	console	device,
      /dev/console.

  -q  Queries and prints the process id	of the kloadsrv	daemon,	if it is run-
      ning, or prints 0	otherwise.

  -s kernel_symtab_file
      Specifies	the name of the	kernel symbol table file. By default, the
      kernel symbol table file name is /vmunix.sym.

  -w kernel_symtab_file
      Specifies	that the kloadsrv command write	a kernel symbol	table file
      and then exit. When you specify the -w option, you must also specify a
      kernel_object_filename.

DESCRIPTION

  This command invokes the kloadsrv daemon, which loads	kernel modules into
  the kernel. Command options in the first line	of the synopsis	are valid
  when you invoke kloadsrv automatically during	system startup.	The kloadsrv
  daemon typically starts during system	startup	as specified in	the
  /etc/inittab file. Options in	the second line	of the command synopsis	are
  valid	when you invoke	kloadsrv manually from the command line.

  In the first invocation form,	the kernel_object_filename variable is the
  pathname of the file from which the running kernel was booted. In the
  second invocation form, the kernel_object_filename variable is not
  optional. You	must specify a value, which is the path	to any linked kernel
  image	for which you want to generate a kernel	symbol table file.

  If you omit an argument for kernel_object_filename from the startup command
  line,	the kloadsrv daemon uses the running kernel.

  Usually, you must specify an argument	for kernel_object_filename only	if
  you moved the	booted kernel image after the kernel was booted. This is
  required because the kloadsrv	daemon uses the	value returned by the follow-
  ing command:

       /usr/sbin/sizer -b

  The sizer command returns the	default	kernel object file name.

  For example, suppose you move	the running kernel as follows:

       /sbin/mv	/vmunix	/vmunix.bak
       /sbin/mv	/genvmunix /vmunix

  If you then need to restart the kloadsrv daemon, you must invoke it as fol-
  lows:

       /sbin/kloadsrv /vmunix.bak

  When moving the booted kernel, you should take great care. During its	ini-
  tialization, the kloadsrv daemon builds a list of kernel symbols used	by
  device drivers. Moving or overwriting	the kernel object file while in	sin-
  gle user mode, can cause the addresses in this list of symbols to be inac-
  curate. The addresses	in the list reflect the	addresses in the new kernel,
  not the addresses in the booted kernel. This will cause problems if you
  then transition the system to	multiuser mode.

  If the kernel	object file does not exist, the	kloadsrv daemon	reads its
  symbol information from the file named /vmunix.sym which is the default
  pathname for the kernel symbol table.	You can	specify	an alternate path to
  the kernel symbol table file by using	the -s option.

  When the kloadsrv daemon initializes itself, it puts itself into the back-
  ground and enters its	server loop, where it waits to receive and respond to
  load requests, unload	requests, and query requests. If you specify the -f
  option, the daemon remains in	the foreground.

  You can invoke the kloadsrv daemon using the -w option to create a kernel
  symbol table file. You can then specify this symbol table file as an argu-
  ment to the -s option, or copy the file to /vmunix.sym and use it as the
  default kernel symbol	table file.

  When the kloadsrv daemon is invoked with the -w option  it runs in the
  foreground and never enters its server loop.	After writing the symbol
  table	file, the daemon exits without performing any server functions.

SEE ALSO

  Commands: cfgmgr(8), sysconfig(8), sysconfigdb(8), knlist(3)