unpincode Kernel Service

Purpose

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

Syntax

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

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

Parameter

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.

Description

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

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

Execution Environment

The unpincode 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.
EFAULT Indicates that the calling process does not have access to the area of memory that is associated with the module.