as_puth Kernel Service

Purpose

Indicates that no more references will be made to a virtual memory object obtained using the as_geth kernel service.

Syntax

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

void as_puth (Adspacep,Vmhandle)
adspace_t *Adspacep;
vmhandle_t Vmhandle;

Parameters

Adspacep Points to the address space structure that the virtual memory object handle was obtained from. This must be the same address space pointer that is given to the as_geth kernel service.
Vmhandle Describes the virtual memory object that will no longer be referenced. This handle must have been returned by the as_geth kernel service.

Description

The as_puth kernel service is used to indicate that no more references will be made to the virtual memory object returned by a call to the as_geth kernel service. The virtual memory object must be detached from all address spaces it may have been attached to using the as_att or vm_att kernel services.

Failure to call the as_puth kernel service may result in resources being permanently unavailable for re-use.

If for some reason it is known that the virtual memory object cannot be deleted, the as_getsrval kernel service may be used instead of the as_geth kernel service. This kernel service does not require that the as_puth kernel service be used. This service can also be called from the interrupt environment.

Execution Environment

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

Return Values

The as_puth kernel service always succeeds and returns nothing.

Implementation Specifics

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

Related Information

The getadsp kernel service, as_att kernel service, vm_att kernel service, as_geth kernel service, and as_getsrval kernel service.