Index Index for
Section 8
Index Alphabetical
listing for K
Bottom of page Bottom of
page

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 initializes. -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 running, 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 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 symbols 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 kernel 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)

Index Index for
Section 8
Index Alphabetical
listing for K
Top of page Top of
page