Technical Reference: Base Operating System and Extensions, Volume 1

perfstat_disk_total Subroutine

Purpose

Retrieves global disk usage statistics.

Library

Perfstat Library (libperfstat.a)

Syntax

#include <libperfstat.h>

int perfstat_disk_total (name, userbuff, sizeof_struct, desired_number) perfstat_id_t * name; perfstat_disk_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 one or more perfstat_disk_total_t structures.
sizeof_struct	Specifies the size of the perfstat_disk_total_t structure: `sizeof(perfstat_cpu_t)`
desired_number	In AIX 5.1, this must always be set to `1`.

Description

The perfstat_disk_total subroutine returns global disk usage statistics in a perfstat_disk_total_t structure.

Return Values

On successful completion, the number of structures that could be filled is returned. 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_disk_total subroutine is unsuccessful if one of the following is true:

EINVAL	One of the parameters is not valid.
EFAULT	Not enough memory.
ENOMEM	The string default length is too short.

Implementation Specifics

The perfstat_disk_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_cpu subroutine, perfstat_cpu_total subroutine, perfstat_memory_total subroutine, perfstat_disk subroutine, perfstat_netinterface subroutine, perfstat_netinterface_total subroutine.