[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, 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.

Implementation Specifics

The pincode kernel service is part of Base Operating System (BOS) Runtime.

Related Information

The pin kernel service.

Understanding Execution Environments and Memory Kernel Services in AIX Kernel Extensions and Device Support Programming Concepts.


[ Previous | Next | Contents | Home | Search ]