facility_disable Kernel Service
Purpose
Disables a specified facility that was previously enabled for the kernel environment.
Syntax
#include <sys/machine.h>
int facility_disable (facility)
uint64_t facility;
Parameter
- facility
- Specifies the facility that must be disabled.
Description
The facility_disable kernel service disables a facility that was previously
enabled by the facility_enable kernel service. Examples of such facilities include
the Vector Multimedia Extension (VMX) facility or the Vector Scalar Extension (VSX) facility.
Facilities that are supported by the facility_disable kernel service are defined in
the /usr/include/sys/machine.h include file.
The facility_disable kernel service restores the state of the facility and then
enables interrupts.
Execution environment
The facility_disable kernel service can be called from either the process or
interrupt environment.
Return values
- 0
- The
facility_disablekernel service has successfully disabled the facility that was previously enabled by using thefacility_enablekernel service, and the previous interrupt level is restored. - ENOSYS
- A facility is not disabled because the
facility_enablekernel service was not called.