Manpages

名 前

setuid − ユ ー ザ ー 識 別 (identity) を 設 定 す る

書 式

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

int setuid(uid_t uid);

説 明

setuid() は 呼 び 出 し 元 の プ ロ セ ス の 実 効 (effective) ユ ー ザ ー ID を 設 定 す る 。 も し 呼 び 出 し 元 プ ロ セ ス の 実 効 UID が root な ら ば 、 実 (real) UID と 保 存 (saved) set−user−ID も 設 定 さ れ る 。

Linux で は 、 setuid() は _POSIX_SAVED_IDS を も っ た POSIX 版 の よ う に 実 装 さ れ て い る 。 こ れ は (ル ー ト 以 外 の ) set−user−ID プ ロ グ ラ ム に そ の ユ ー ザ ー の 特 権 を 全 て 与 え 、 特 権 の 必 要 な い 仕 事 を し 、 本 来 の 実 効 ユ ー ザ ー ID に 安 全 な 方 法 で 再 び 戻 す こ と を 許 す 。 ユ ー ザ ー が root ま た は プ ロ グ ラ ム が root に set−user−ID さ れ て い る な ら ば 、 特 別 の 注 意 が 払 わ れ る 。 setuid() 関 数 は 呼 び 出 し 者 の 実 効 ユ ー ザ ー ID を チ ェ ッ ク し 、 そ れ が ス ー パ ー ユ ー ザ ー な ら ば 、 プ ロ セ ス に 関 連 す る 全 て の ユ ー ザ ー ID に uid を 設 定 す る 。 こ れ が 行 な わ れ た 後 に は プ ロ グ ラ ム が 再 び ル ー ト の 特 権 を 得 る こ と は で き な い 。 し た が っ て 、 set−user−ID−root プ ロ グ ラ ム で 、 一 時 的 に ル ー ト 特 権 を 解 除 し 、 非 特 権 ユ ー ザ ー で あ る か の よ う に 振 舞 い 、 後 で ル ー ト 権 限 を も う 一 度 得 よ う と す る 場 合 に は 、 setuid() を 使 う こ と が で き な い 。 そ の 場 合 に は 、 seteuid(2) を 使 う 必 要 が あ る 。

返 り 値

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

エ ラ ー

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