unpincode Kernel Service

Purpose

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

Item	Description
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.

Item	Description
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.