Manpages

名 前

setresuid, setresgid − ユ ー ザ ー や グ ル ー プ の 実 、 実 効 、 保 存 ID を 設 定 す る

書 式

#define _GNU_SOURCE /* feature_test_macros(7) 参 照 */
#include <unistd.h>

int setresuid(uid_t ruid, uid_t euid, uid_t suid);
int setresgid(gid_t rgid, gid_t egid, gid_t sgid);

説 明

setresuid() は 呼 び 出 し 元 の プ ロ セ ス の 実 (real) ユ ー ザ ー ID、 実 効 (effective) ユ ー ザ ー ID、 保 存 set−user−ID を 設 定 す る 。 非 特 権 ユ ー ザ ー の プ ロ セ ス は 、 そ の 実 UID、 実 効 UID、 保 存 set−user−ID を 、 現 在 の 実 UID、 現 在 の 実 効 UID、 現 在 の 保 存 set−user−ID の ど れ か に 変 更 す る こ と が で き る : 特 権 プ ロ セ ス (Linux で は CAP_SETUID ケ ー パ ビ リ テ ィ (capability) を 持 つ プ ロ セ ス ) は 、 実 UID、 実 効 UID、 保 存 set−user−ID を 任 意 の 値 に 設 定 で き る 。 引 き 数 の ど れ か が −1 の 場 合 は そ の 値 は 変 更 さ れ ず に 残 さ れ る 。 実 UID、 実 効 UID、 保 存 set−user−ID に ど ん な 変 更 が 行 わ れ た か に 関 わ ら ず 、 フ ァ イ ル シ ス テ ム UID は 常 に 実 効 UID (可 能 で あ れ ば 変 更 後 の 新 し い 実 効 UID) と 同 じ 値 に 設 定 さ れ る 。 全 く 同 じ よ う に 、 setresgid() は 呼 び 出 し 元 の プ ロ セ ス の 実 GID、 実 効 GID、 保 存 set−group−ID を 設 定 す る (さ ら に フ ァ イ ル シ ス テ ム GID を 実 効 GID と 同 じ 値 に 修 正 す る )。 非 特 権 プ ロ セ ス は 同 様 の 制 限 を 受 け る 。

返 り 値

成 功 し た 場 合 は 0 が 返 さ れ る 。 エ ラ ー の 場 合 は −1 が 返 さ れ 、 errno が 適 切 に 設 定 さ れ る 。 注 意 : 呼 び 出 し 元 が UID 0 で あ っ て も setresuid() が 失 敗 す る 場 合 が あ る 。 setresuid() か ら の リ タ ー ン が 失 敗 か ど う か の 確 認 を 省 略 す る こ と は 重 大 な セ キ ュ リ テ ィ 上 の エ ラ ー と な る 。

エ ラ ー

り 、 ruid が 呼 び 出 し 元 の 実 UID と 一 致 し て い な い )、 必 要 な カ ー ネ ル の デ ー タ 構 造 体 の 割 り 当 て で 一 時 的 な 失 敗 が あ っ た 。