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

vm_handle Kernel Service

Purpose

Constructs a virtual memory handle for mapping a virtual memory object with a specified access level.

Syntax

#include <sys/types.h>
#include <sys/errno.h>
#include <sys/vmuser.h>
vmhandle_t vm_handle (vmid, key)
vmid_t  vmid; 
int key;                                       

Parameters

vmid Specifies a virtual memory object identifier, as returned by the vms_create kernel service.
key Specifies an access key. This parameter has a 1 value for limited access and a 0 value for unlimited access, respectively.

Description

The vm_handle kernel service constructs a virtual memory handle for use by the vm_att kernel service. The handle identifies the virtual memory object specified by the vmid parameter and contains the access key specified by the key parameter.

A virtual memory handle is used with the vm_att kernel service to map a virtual memory object into the current address space.

The vm_handle kernel service assumes an address space model of fixed-size virtual memory objects and address space regions.

Execution Environment

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

Return Values

The vm_handle kernel service returns a virtual memory handle type.

Implementation Specifics

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

Related Information

The vm_att kernel service, vms_create kernel service.

Memory Kernel Services and Understanding Virtual Memory Manager Interfaces in AIX Kernel Extensions and Device Support Programming Concepts.


[ Previous | Next | Contents | Home | Search ]