NAME

kl_util − kernel server loader utility program

SYNOPSIS

/usr/etc/kl_util −s
/usr/etc/kl_util −l server_name ...
/usr/etc/kl_util −u server_name ...
/usr/etc/kl_util −a server_script_file_name ...
/usr/etc/kl_util −d server_name ...
/usr/etc/kl_util −A

DESCRIPTION

Kl_util is a program to communitate with the kernel loader (see kern_loader(8)). 

When used with the −s option, kl_util queries the kernel loader for the status of all registered kernel servers.  Information returned includes the name of each of the registered kernel servers, a status of either loaded, indicating that the kernel server is loaded and running in the kernel, or initialized, indicating that the kernel server space has been allocated in the kernel, and the relocatable has been relocated at the allocated address, but has not yet been loaded into the kernel.  The name of each of the advertized ports (see the "Name Server Functions" section in the "Mach Functions" chapter of TheNeXTSystemReferenceManual) that the kernel server is listening on.

The -l server_name argument tells kern_loader to load the named kernel server(s) into the kernel.  This is normally done on the first message received on a port advertized for this server.  The -u server_name argument tells kern_loader to unload the named server(s).  Loaded kernel servers remain in the kernel until they are explicitly unloaded.  Unloading the server causes any wired pages to be unwired, thus this can be used as a mechanism to free up resources in the system when the server is no longer needed. 

The -a server_script_file_name argument adds a server to kern_loader.  The added server will have kernel space allocated for it and will be initialized to load at that location when referenced. 

The -d server_name argument causes the named kernel server to be deallocated from kern_loader, causing all resources (physical and virtual) associated with the kernel server to be freed. 

The -A argument causes kern_loader to shutdown.  All existing kernel servers are unloaded and deallocated the the running kern_loader task exits. 

SEE ALSO

kern_loader(8). 

NeXT, Inc.  —  21 June 1989