netware_mem_info

Returns information about the current available memory.

Library:LibC
Classification:Novell
Service:NetWare Platform

Syntax

  #include <monitor.h>
   
  int netware_mem_info (
     struct memory_info  *info);
  

Parameters

info

(OUT) Points to the memory_info structure, which contains information about the current available memory.

Return Values

If successful, returns 0; otherwise, returns a nonzero error code:

Decimal

Hex

Constant

Description

66

0x42

ENOSYS

The function cannot be exported (error from NetWare ExportPublicSymbol).

Remarks

The netware_mem_info function returns information similar to monitor.nlm and the Novell Remote Manager, but each uses its own methods for calculating memory usage which differ slightly from how the others do it. These methods have evolved over time and are based on many factors including availability of underlying information and component behavior. The returned values can vary from release to release, from support pack to support pack, because changes made by the lowest levels of the system are reflected in the values returned.

The returned values should not be used to calculate memory usage on which software makes timely decisions such as how much memory to allocate or free. The returned values have meaning only when compared against each other across multiple calls. The values themselves are inherently meaningless since they are only a snapshot of the system at the exact instant the function is called; by the time the call returns, the information is already outdated for other running threads have probably allocated, freed or otherwise affected memory.

See Also