sysinfo(2) システム全体の統計情報を返す。

書式

#include <sys/sysinfo.h>

int sysinfo(struct sysinfo *info);

説明

Linux 2.3.16 までは sysinfo() は以下の構造体に情報を入れて返す。

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 */
};

ここでバイト単位で与えられる。

Linux 2.3.23 (i386)、2.3.48 (全てのアーキテクチャ) からは構造体は

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 */
    unsigned long totalhigh; /* Total high memory size */
    unsigned long freehigh;  /* Available high memory size */
    unsigned int mem_unit;   /* Memory unit size in bytes */
    char _f[20-2*sizeof(long)-sizeof(int)]; /* Padding to 64 bytes */
};

となり、大きさは mem_unit バイトの倍数で与えられる。

sysinfo() はシステム全体の統計を取得する簡単な方法を提供する。 これは /dev/kmem を読むよりも移植性の高い方法である。

返り値

成功した場合は 0 が返される。エラーの場合は -1 が返され、 errno が適切に設定される。

エラー

EFAULT
sysinfo 構造体 へのポインターが不正である。

準拠

この関数は Linux 特有であり、移植を意図したプログラムでは 使用すべきでない。

Linux カーネルは 0.98.pl6 から sysinfo() システムコールを持っている。 Linux の libc は 5.3.5 より、glibc では 1.90 より sysinfo() ルーチンを含んでいる。

この文書について

この man ページは Linux man-pages プロジェクトのリリース 3.65 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。