名前

sysinfo - システム情報を返す

書式

#include <sys/sysinfo.h>
int sysinfo(struct sysinfo *info);

説明

sysinfo() returns certain statistics on memory and swap usage, as well as the load average.
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 */
};

In the above structure, the sizes of the memory and swap fields are given in bytes.
Linux 2.3.23 (i386)、Linux 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 */
};

In the above structure, sizes of the memory and swap fields are given as multiples of mem_unit bytes.

返り値

成功すると、 sysinfo() は 0 を返す。 エラーの場合、-1 を返し、 errno にエラーの原因を示す値を設定する。

エラー

EFAULT
info が有効なアドレスではない。

バージョン

sysinfo() は Linux 0.98.pl6 で初めて登場した。

準拠

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

注意

All of the information provided by this system call is also available via /proc/meminfo and /proc/loadavg.

関連項目

proc(5)

この文書について

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

Recommended readings

Pages related to sysinfo you should read also: