cfg_unconfigure(9r)cfg_unconfigure(9r)NAMEcfg_unconfigure - General: Unconfigures a kernel subsystem
SYNOPSIS
#include <sys/sysconfig.h> ); cfg_status_t cfg_unconfigure(
char *subsys );
ARGUMENTS
Specifies the name of the subsystem to be unconfigured.
DESCRIPTION
The cfg_unconfigure kernel routine is used to unconfigure a subsystem.
If the subsystem is not configured into the kernel, this routine
returns an error. If subsystem is sucessfully unconfigured, the state
of the driver is marked as unconfigured. An attempt is also made to
unload the subsystem's module from the kernel. A dynamically loadable
kernel subsystem is subject to be unloaded.
RETURN VALUES
This routine returns 32 bit status values composed of subsystem status
and framework status segments. The upper 16 bits is the subsystem sta‐
tus (CFG_STATUS_SUBSYS) and the lower 16 bits is the frame status
(CFG_STATUS_FRAME). The return values are organized as follows:
[Upper subsystem 16 bits][Lower framework 16 bits]
The subsystem status is returned by the subsystem's configure routine
and can be any error in errno.h. The framework status is returned by
the configuration framework and the possible values are defined in
<sys/sysconfig.h> as CFG_FRAME_Exxx. A successful operation has ESUC‐
CESS (0) returned in both status segments.
See the cfg_errno(9r) and errno(2) reference pages for more details
about error numbers and status.
EXAMPLE
A subsystem may be unconfigured using the cfg_unconfigure kernel rou‐
tine as follows:
status = cfg_unconfigure(subsystem_name);
SEE ALSO
Routines: cfg_subsys_unconfig(3), cfg_configure(9r), cfg_errno(9r),
cfg_query(9r), cfg_reconfigure(9r), cfg_subsysop(9r),
Other: errno(2),
cfg_unconfigure(9r)