Technical Reference: Kernel and Subsystems, Volume 1

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

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

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.

Related Information

The pin kernel service.

Understanding Execution Environments and Memory Kernel Services in AIX 5L Version 5.2 Kernel Extensions and Device Support Programming Concepts.