kloadsrv(8)kloadsrv(8)NAMEkloadsrv - 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
Displays the version of the kloadsrv command. Causes the kloadsrv dae‐
mon to remain in the foreground. By default, the daemon automatically
places itself into the background after it initializes. 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. Kills the
kloadsrv daemon, if it is running. Specifies that the debugging infor‐
mation is to be sent to the specified log file. The logfilevariable
must be specified as a full pathname. By default, the debugging infor‐
mation is sent to the console device, /dev/console. Queries and prints
the process id of the kloadsrv daemon, if it is running, or prints 0
otherwise. Specifies the name of the kernel symbol table file. By
default, the kernel symbol table file name is /vmunix.sym. 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 ker‐
nel_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 synop‐
sis 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
following 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
follows:
/sbin/kloadsrv /vmunix.bak
When moving the booted kernel, you should take great care. During its
initialization, the kloadsrv daemon builds a list of kernel symbols
used by device drivers. Moving or overwriting the kernel object file
while in single user mode, can cause the addresses in this list of sym‐
bols to be inaccurate. 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
background 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 ker‐
nel symbol table file. You can then specify this symbol table file as
an argument 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)kloadsrv(8)