.\" -*- nroff -*- .\" .\" (C)opyright 1993 by Dan Miner (dminer@nyx.cs.du.edu) .\" .\" Permission is granted to freely distribute or modify this file .\" for the purpose of improving Linux or its documentation efforts. .\" If you modify this file, please put a date stamp and HOW you .\" changed this file. Thanks. -DM .\" .\" Modified Sat Jul 24 12:35:12 1993 by Rik Faith .\" Modified Tue Oct 22 22:29:51 1996 by Eric S. Raymond .\" .TH SYSINFO 2 "24 July 1993" "Linux 0.99.10" "Linux Programmer's Manual" .SH NAME sysinfo \- returns information on overall system statistics .SH SYNOPSIS .B #include .br .B #include .sp .BI "int sysinfo(struct sysinfo *" info ); .SH DESCRIPTION .B sysinfo returns information in the following structure: .RS .nf struct sysinfo { long uptime; /* Seconds since boot */ unsigned long loads[3]; /* 1, 5, and 15 minute load averages */ unsigned long totalram; /* Total usable main memory size */ unsigned long freeram; /* Available memory size */ unsigned long sharedram; /* Amount of shared memory */ unsigned long bufferram; /* Memory used by buffers */ unsigned long totalswap; /* Total swap space size */ unsigned long freeswap; /* swap space still available */ unsigned short procs; /* Number of current processes */ char _f[22]; /* Pads structure to 64 bytes */ }; .fi .RE .B sysinfo provides a simple way of getting overall system statistics. This is more portable than reading \fI/dev/kmem\fP. .SH "RETURN VALUE" On success, zero is returned. On error, \-1 is returned, and .I errno is set appropriately. .SH ERRORS .TP 0.8i .B EFAULT pointer to \fIstruct\ sysinfo\fP is invalid .SH "CONFORMING TO" This function is Linux-specific, and should not be used in programs intended to be portable. .SH BUGS The Linux DLL 4.4.1 libraries do not contain a proper prototype for this function.