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) ();

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.