ldata_grow Kernel Service

Purpose

Expands the count of available pinned storage elements contained within an ldata pool.

Syntax

#include <sys/ldata.h>

int ldata_grow (ldatap, count)

ldata_t ldatap; 
long count; 

Description

The ldata_grow kernel service increases the number of pinned storage elements contained within a per-SRAD sub-pool associated with the ldata handle ldatap, by count. If the ldata_alloc call fails because there are no more free pinned storage elements in a sub-pool, use the ldata_grow kernel service. The ldata_grow kernel service pins additional count elements from the sub-pool and makes them available for the ldata_alloc call. All of the sub-pools associated with the handle are grown. If count elements are not available or there is not enough pinned memory available, the ldata_grow kernel service fails.

Parameters

Item Description
ldatap Specifies the handle of the ldata pool.
count Specifies the additional number of storage elements to be pinned in the sub-pool. The count value should be greater than 0 and should not increase the sub-pool size beyond the value of maxcount specified with the ldata_create call.

Execution Environment

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

Return Values

Item Description
0 Success.
-1 Error encountered. Illegal parameters or insufficient resources.

Implementation Specifics

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