pincode Kernel Service
Purpose
Pins the code and data associated with a loaded object module.
Syntax
#include <sys/types.h>
#include <sys/errno.h>
#include <sys/pin.h>int pincode ( func)
int (*func) ();
int (*func) ();
Parameter
| Item | Description |
|---|---|
| func | Specifies an address used to determine the object module to be pinned. The address is typically that of a function exported by this object module. |
Description
The pincode service uses the pin service to pin the specified object module. The loader entry for the object module is used to determine the size of both the code and data.
Execution Environment
The pincode kernel service can be called from the process environment only.
Return Values
| Item | Description |
|---|---|
| 0 | Indicates successful completion. |
| EINVAL | Indicates that the func parameter is not a valid pointer to the function. |
| ENOMEM | Indicates that the pincode service was unable to pin the module due to insufficient real memory. |
When an error occurs, the pincode service returns without pinning any pages.