Manpages

名 前

swapon, swapoff − フ ァ イ ル /デ バ イ ス へ の ス ワ ッ プ を 開 始 /停 止 す る

書 式

#include <unistd.h>
#include <sys/swap.h>

int swapon(const char *path, int swapflags);
int swapoff(const char *path);

説 明

swapon() は path で 指 定 さ れ た フ ァ イ ル や ブ ロ ッ ク デ バ イ ス に ス ワ ッ プ 領 域 を 設 定 す る 。 swapoff() は path で 指 定 さ れ た フ ァ イ ル や ブ ロ ッ ク デ バ イ ス へ の ス ワ ッ プ を 停 止 す る 。

swapon() の swapflags 引 き 数 に SWAP_FLAG_PREFER フ ラ グ が 指 定 さ れ た 場 合 、 新 し い ス ワ ッ プ 領 域 は デ フ ォ ル ト よ り も 高 い 優 先 度 を 持 つ 。 優 先 度 は 以 下 の よ う に 変 換 さ れ て swapflags に 指 定 す る 。

(prio << SWAP_FLAG_PRIO_SHIFT) & SWAP_FLAG_PRIO_MASK

SWAP_FLAG_DISCARD フ ラ グ が swapon() の swapflags 引 き 数 に 指 定 さ れ た 場 合 、 ス ワ ッ プ デ バ イ ス が 破 棄 (discard) 操 作 や trim 操 作 を サ ポ ー ト し て い る 場 合 に は 、 解 放 さ れ た ス ワ ッ プ ペ ー ジ は 再 利 用 さ れ る 前 に 破 棄 さ れ る (こ れ に よ り 、 SSD (Solid State Device) に よ っ て は 性 能 が 向 上 す る こ と が あ る が 、 た い て い は 性 能 の 向 上 は な い )。 「 注 意 」 も 参 照 の こ と 。 こ れ ら の 関 数 は 特 権 プ ロ セ ス (CAP_SYS_ADMIN ケ ー パ ビ リ テ ィ (capability) を 持 つ プ ロ セ ス ) の み が 使 用 で き る 。 優 先 度 そ れ ぞ れ の ス ワ ッ プ 領 域 は 高 (high) と 低 (low) の ど ち ら か の 優 先 度 を 持 つ 。 デ フ ォ ル ト の 優 先 度 は 低 で あ る 。 低 い 優 先 度 の 領 域 に お い て 、 新 し い 領 域 は 古 い 領 域 よ り さ ら に 低 い 優 先 度 を 持 つ 。

swapflags が 設 定 さ れ た も の は 全 て 高 い 優 先 度 と な り 、 デ フ ォ ル ト よ り も 高 い 優 先 度 を 持 つ 。 使 用 者 は そ れ ら に 負 で な い 値 が 指 定 で き る 。 大 き な 数 字 は 高 い 優 先 度 を 意 味 す る 。 高 い 優 先 度 の 領 域 か ら 順 に ス ワ ッ プ ペ ー ジ と し て 使 用 さ れ る 。 よ り 低 い 優 先 度 の 領 域 を 使 用 す る 前 に よ り 高 い 優 先 度 の 領 域 を 使 い 切 る 。 も し 二 つ 以 上 の 領 域 が 同 じ 優 先 度 を 持 ち 、 使 え る 中 で 一 番 高 い 優 先 度 で あ れ ば 、 そ れ ら の ペ ー ジ は 間 で ラ ウ ン ド ロ ビ ン 方 式 で 配 分 さ れ る 。

Linux 1.3.6 に お い て 、 カ ー ネ ル は 通 常 は こ れ ら の 規 則 に 従 っ て い る 。 し か し 例 外 も 存 在 し て い る 。

返 り 値

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

エ ラ ー