as_seth64 Kernel Service

Purpose

Maps a specified region for the specified virtual memory object.

Syntax

#include <sys/types.h>
#include <sys/errno.h>
#include <sys/vmuser.h>
#include <sys/adspace.h>

int as_seth64 (addr64,vmhandle)
unsigned long long addr64;
vmhandle_t vmhandle;

Parameters

addr64 The region covering this input virtual memory address will be mapped.
vmhandle Describes the virtual memory object being made addressable within a region of the address space.

Description

The as_seth64 kernel service maps the region covering the input addr64 parameter. Any virtual memory object previously mapped within this region is unmapped.

The virtual memory object specified with the vmhandle parameter is then mapped with the access permission specified in the handle.

The as_seth64 kernel service should only be used when it is necessary to map a virtual memory object at a fixed address. The as_att64 kernel service should be used when it is not absolutely necessary to map the virtual memory object at a fixed address.

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

This service will operate correctly for both 32-bit and 64-bit user address spaces. It will also work for kernel processes (kprocs).

Note: This service only operates on the current process's address space. It is not allowed to operate on another address space.

Execution Environment

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

Return Values

0 Successful completion.
EINVAL Input address out of range.

Implementation Specifics

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

Related Information

The as_att64 kernel service, as_puth64 kernel service, as_det64 kernel service, as_getsrval64 kernel service, as_geth64 kernel service.