[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 1

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

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

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.

Implementation Specifics

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

Related Information

The unpin kernel service.

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

[ Previous | Next | Contents | Home | Search ]