Technical Reference: Kernel and Subsystems, Volume 1

unpincode Kernel Service

Unpins the code and data associated with a loaded object module.

#include <sys/types.h>
#include <sys/errno.h>
#include <sys/pin.h>

int unpincode ( func) int (*func) ( );

func	Specifies an address used to determine the object module to be unpinned. The address is typically that of a function that is exported by this object module.

The unpincode kernel service uses the ltunpin kernel service to decrement the pin count for the pages associated with the following items:

Code associated with the object module
Data area of the object module that contains the function specified by the func parameter

The loader entry for the module is used to determine the size of both the code and the data area.

The unpincode kernel service can be called from the process environment only.

0	Indicates successful completion.
EINVAL	Indicates that the func parameter is not a valid pointer to the function.
EFAULT	Indicates that the calling process does not have access to the area of memory that is associated with the module.

The unpin kernel service.

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