GETRLIMIT

名前

書式

int getrlimit(int resource, struct rlimit *rlim);
int setrlimit(int resource, const struct rlimit *rlim);  

説明

struct rlimit {
    rlim_t rlim_cur;  /* ソフト・リミット */
    rlim_t rlim_max;  /* ハード・リミット
                         (rlim_cur より小さくない) */
};

値 RLIM_INFINITY はリソースに制限がないことを表す (この値は getrlimit() が返す構造体と setrlimit() に渡す構造体の両方で使用される)。

resource は次のいずれか 1 つである。

RLIMIT_AS

プロセスの仮想メモリ (アドレス空間) の最大サイズ (バイト単位)。 この制限は brk(2), mmap(2), mremap(2) の呼び出しに影響し、この制限を超えた場合は エラー ENOMEM で失敗する。 また自動的なスタック拡張にも失敗する (さらに sigaltstack(2) を使った代替スタックを利用可能にしていなかった場合には、 SIGSEGV を生成してそのプロセスを kill する)。 この値は long 型なので、32 ビットの long 型を持つマシンでは、 この制限は最大で 2 GiB になるか、この資源が無制限になる。

RLIMIT_CORE

core ファイルの最大サイズ。 0 の場合、core ファイルは生成されない。 0 以外の場合、このサイズより大きいダンプは切り詰められる。

RLIMIT_CPU

CPU 時間の上限 (秒数)。 プロセスがソフト・リミットに達した場合に、 SIGXCPU シグナルを送る。 このシグナルに対するデフォルトの動作は、プロセスの終了である。 ただしシグナルをキャッチして、ハンドラがメインプログラムに 制御を返すこともできる。 プロセスが CPU 時間を使い続けた場合は、 ハードリミットに達するまで 1 秒毎にプロセスに SIGXCPU を送り、 ハードリミットに達すると SIGKILL を送る。 ソフト・リミットを超過したときの動作は、 Linux 2.2 と 2.4 のものである。 ソフト・リミットを超えて CPU 時間を使い続けるプロセスの 扱い方についての実装は変化してきている。 このシグナルをキャッチする必要のある 移植性を考えたアプリケーションでは、 最初に SIGXCPU を受け取った時点で正しく終了すべきである。

RLIMIT_DATA

プロセスのデータセグメント (初期化されたデータ・初期化されていないデータ・ヒープ) の最大値。 このリミットは brk(2) と sbrk(2) の呼び出しに影響する。 これらの関数は、このリソースのソフト・リミットに達すると、 エラー ENOMEM で失敗する。

RLIMIT_FSIZE

プロセスが作成できるファイルサイズの最大値。 このサイズを超えてファイルを拡張すると、 SIGXFSZ シグナルを送る。 デフォルトでは、このシグナルはプロセスを終了する。 プロセスをキャッチすることもできるが、 関連するシステムコール (write(2), truncate(2) など) はエラー EFBIG で失敗する。

RLIMIT_LOCKS (初期の Linux 2.4 のみ)

このプロセスが実行できる flock(2) ロック数と fcntl(2) リース数の合計値を制限する。

RLIMIT_MEMLOCK

RAM 内にロックできるメモリの最大バイト数。 実際には、この制限はシステムページサイズの最も近い倍数に 切り捨てて丸められる。 この制限は mlock(2), mlockall(2), mmap(2) の MAP_LOCKED 操作に影響する。 Linux 2.6.9 以降では shmctl(2) SHM_LOCK 操作にも影響する。 この操作は呼び出し元プロセスの実 (real) ユーザー ID にロックされる 共有メモリセグメント (shmget(2) を参照) の合計バイト数の最大値を設定する。 shmctl(2) SHM_LOCK によるロックは、 mlock(2), mlockall(2), mmap(2) の MAP_LOCKED によって確立されるプロセス毎のメモリロックとは分けて数える。 1 つのプロセスはこの制限までのバイトをロックできる。 この制限には 2 つの種類がある。 2.6.9 より前の Linux カーネル では、 この制限は特権プロセスによってロックされるメモリの合計を制御していた。 Linux 2.6.9 以降では、特権プロセスがロックするメモリの合計に制限はなく、 代わりにこの制限は非特権プロセスがロックするメモリの合計に 適用されるようになった。

RLIMIT_MSGQUEUE (Linux 2.6.8 以降)

呼び出し元プロセスの実ユーザー ID に対して、 POSIX メッセージキューのために確保できるバイト数の制限を指定する。 この制限は mq_open(3) に対して適用される。 ユーザが作成した各々のメッセージキューのバイト数は 以下の式により計算され、(そのキューが削除されるまでの間) この制限の計算対象に含められる。

    bytes = attr.mq_maxmsg * sizeof(struct msg_msg *) +
            attr.mq_maxmsg * attr.mq_msgsize

ここで attr は mq_attr 構造体であり、 mq_open(3) の第 4 引き数として指定される。

sizeof(struct msg_msg *) (Linux/x86 では 4 バイト) を含む最初の加数は、 ユーザーが長さ 0 のメッセージを無制限に作れないこと保証している (このようなメッセージであっても、 記録のためのオーバーヘッドでシステムメモリを消費する)。

RLIMIT_NICE (カーネル 2.6.12 以降, 下記の「バグ」の節も参照)

setpriority(2) や nice(2) を使って引き上げられるプロセスの nice 値の上限を指定する。 nice 値の実際の上限は 20 - rlim_cur で計算される (このような変な状況は、リソース制限値として負の数を指定できないため 発生する。通常、負の値は特別な意味を持っているからである。 例えば、通常は RLIM_INFINITY の値は -1 である)。

RLIMIT_NOFILE

このプロセスがオープンできるファイルディスクリプタ数の最大値より 1 大きい値を指定する。 (open(2), pipe(2), dup(2) などにより) この上限を超えようとした場合、エラー EMFILE が発生する。

RLIMIT_NPROC

呼び出したプロセスの実ユーザー ID で作成できる最大プロセス数 (より正確には Linux ではスレッド数)。 この上限に達すると、 fork(2) はエラー EAGAIN で失敗する。

RLIMIT_RSS

プロセスの resident set (RAM 上に存在する仮想ページの数) の 上限を (ページ数で) 指定する。 この制限は 2.4.30 より前でしか影響がなく、 madvise(2) に MADV_WILLNEED を指定した関数コールにしか影響しない。

RLIMIT_RTPRIO (Linux 2.6.12 以降, バグの節も参照)

sched_setscheduler(2) や sched_setparam(2) を使って設定できる、そのプロセスのリアルタイム優先度の上限を指定する。

RLIMIT_SIGPENDING (Linux 2.6.8 以降)

呼び出し元プロセスの実ユーザー ID に対して キューに入れられるシグナルの数の制限を指定する。 この制限をチェックするため、 標準シグナルとリアルタイム・シグナルの両方がカウントされる。 しかし、この制限は sigqueue(2) に対してしか強制されず、 kill(2) 使うことで、そのプロセスに対してまだキューに入れられていない シグナルのインスタンスをキューにいれることができる (Linux 2.6.8 以降)。

RLIMIT_STACK

プロセス・スタックの最大サイズをバイト単位で指定する。 この上限に達すると、 SIGSEGV シグナルが生成される。 このシグナルを扱うためには、 プロセスは代りのシグナルスタック (sigaltstack(2)) を使用しなければならない。

RLIMIT_OFILE は RLIMIT_NOFILE の BSD での名前である。

返り値

エラー

EFAULT

rlim がアクセス可能なアドレス空間の外を指している。

EINVAL

resource が有効でない。 または、 setrlimit() で、 rlim->rlim_cur が rlim->rlim_max よりも大きかった。

EPERM

特権のないプロセスが setrlimit() を使用して ソフト・リミットまたはハード・リミットを 現在のハード・リミットより大きくしようと試みた。 これを行うためには CAP_SYS_RESOURCE ケーパビリティが必要である。 または特権のないプロセスが setrlimit() を使用して ソフトまたはハード RLIMIT_NOFILE リミットを現在のカーネルの最大値 (NR_OPEN) 以上に増加させようとした。

準拠

注意

バグ

2.6.17 より前の 2.6.x カーネルでは、 RLIMIT_CPU リミットが 0 の場合、 (RLIM_INFINITY と同じように) 「制限なし」と間違って解釈されていた。 カーネル 2.6.17 以降では、リミットを 0 に設定した場合にも 効果を持つようになっているが、実際にはリミットの値は 1 秒となる。

カーネル 2.6.12 には、 RLIMIT_RTPRIO が動作しないというバグがある。この問題はカーネル 2.6.13 で修正されている。

カーネル 2.6.12 では、 getpriority(2) と RLIMIT_NICE が返す優先度の範囲が一つずれていた。このため、nice 値の実際の上限が 19 - rlim_cur になってしまうという影響があった。これはカーネル 2.6.13 で修正された。

2.4.22 より前のカーネルでは、 rlim->rlim_cur が rlim->rlim_max より大きかった場合、 setrlimit() での EINVAL エラーを検出できない。  

関連項目

Index

名前

書式

説明

返り値

エラー

準拠

注意

バグ

関連項目