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

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