Technical Reference: Base Operating System and Extensions, Volume 1

perfstat_memory_total Subroutine

Purpose

Retrieves global memory usage statistics.

Library

Perfstat Library (libperfstat.a)

Syntax

#include <libperfstat.h>

int perfstat_memory_total (name, userbuff, sizeof_struct, desired_number) perfstat_id_t * name; perfstat_memory_total_t * userbuff; int sizeof_struct; int desired_number;

Parameters

name	In AIX 5.1, this must always be set to `NULL`.
userbuff	Points to the memory area that is to be filled with the perfstat_memory_total_t structures.
sizeof_struct	Specifies the size of the perfstat_memory_total_t structure: `sizeof(perfstat_memory_total_t)`.
desired_number	In AIX 5.1, this must always be set to `1`.

Description

The perfstat_memory_total subroutine returns global memory usage statistics in a perfstat_memory_total_t structure.

Return Values

The number of structures filled is returned upon successful completion. In AIX 5.1, this will always be 1. Otherwise, a value of -1 is returned and the errno variable is set.

Error Codes

The perfstat_memory_total subroutine is unsuccessful if the following is true:

EINVAL

One of the parameters is not valid.

Implementation Specifics

The perfstat_memory_total subroutine is part of the Base Operating System (BOS) runtime.

Files

/usr/include/libperfstat.h Defines standard macros, data types and subroutines.

Related Information

The perfstat_cpusubroutine, perfstat_cpu_totalsubroutine, perfstat_disksubroutine, perfstat_disk_totalsubroutine, perfstat_netinterfacesubroutine, and perfstat_netinterface_total subroutine.