ldata_destroy Kernel Service

Purpose

Destroys an ldata pool created by the ldata_create kernel service.

Syntax

#include <sys/ldata.h>

void ldata_destroy (ldatap)

ldata_t ldatap; 

Description

The ldata_destroy kernel service destroys an ldata pool previously created by an ldata_create call. This routine assumes that all elements allocated from the pool have been freed back to the pool and there are no longer any active elements in the pool.

The ldata_destroy call unpins and frees all of the storage associated with the handle.

Parameters

Item Description
ldatap Specifies the handle of the ldata pool to be destroyed.

Execution Environment

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

Return Values

None.

Implementation Specifics

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