coprocessor_user_unregister Kernel Service

Purpose

Unregisters the current process as a coprocessor user.

Syntax

#include <sys/coprocessor.h>
kerrno_t coprocessor_user_unregister ( int coprocessor_type )

Parameters

Description

This kernel service allows a kernel extension to unregister the current process that was previously registered as a coprocessor user. When successful, further accesses by the process to the coprocessor type passed as an argument in user mode will fail with a privileged operation exception.

Execution Environment

This kernel service can be called in the process environment only.

Return Values

When the call is successful, the kernel service returns a value of zero. Otherwise, a negative value is returned to indicate an error.

Error Values

Possible errors are:

• Coprocessors not supported (supported only on POWER7® and newer processors).
• Invalid coprocessor type (must be in the range 0-63).
• The current process is not registered for this coprocessor type.
• The service is being called in interrupt context.