readinfo(3) CLIX readinfo(3)
NAME
readinfo - Reads system activity information
LIBRARY
Intergraph Device Library *L(libix.a)*O
SYNOPSIS
#include <sys/types.h>
#include <sys/sysinfo.h>
int readinfo(
int itype ,
char *buf ,
int nbytes );
PARAMETERS
itype An integer representing the type of system information sought
buf The buffer into which the information is to be read
nbytes The number of bytes of information to be read
DESCRIPTION
The readinfo() function obtains system activity information. The itype
parameter specifies the type of information to be obtained. The buf
parameter is a pointer to the buffer where the data will be placed. The
nbytes parameter specifies the number of bytes of data to be copied.
The include file <sys/sysinfo.h> contains the following definitions that
describe the types of information that may be obtained.
R_MINFO Obtain system memory information.
R_SYSINFO Obtain system time information.
R_SYSWAIT Obtain system wait times.
R_DINFO Obtain system disk activity.
R_RCINFO Obtain Remote File Sharing (RFS) information.
R_SHLBINFO Obtain shared library information.
R_SYSERR Obtain system error statistics.
2/94 - Intergraph Corporation 1
readinfo(3) CLIX readinfo(3)
The amount of information available for each type is the size of the
corresponding structure also defined in <sys/sysinfo.h>.
RETURN VALUES
Upon successful completion, the number of bytes read is returned.
Otherwise, a value of -1 is returned and errno is set to indicate the
error.
ERRORS
The readinfo() function will fail if one (or both) of the following is
true:
[EFAULT] Buf
points
to
a
nonwritable
memory
address.
[EINVAL] The
type
of
information
requested
is
not
valid.
2 Intergraph Corporation - 2/94