[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Kernel and Subsystems, 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.

Related Information

The vm_att kernel service, vms_create kernel service.

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

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]