ISSETUGID(2)

名称
issetugid - 現在のプロセスの uid または gid の変化による汚染状況

ライブラリ
libc

書式
<unistd.h> int issetugid(void)

解説
issetugid() 関数は、プロセスの環境またはメモリアドレス空間が “汚染されている” と見なされる場合 1 を返し、そうでない場合は 0 を返します。

setuid または setgid ビットのどちらかが設定されたプロセスを execve(2) システムコールで実行した (そして結果として追加の特権が与えられた) 場合、あるいはプロセスの、実ユーザ ID, 実効ユーザ ID, 保存されたユーザ ID, グループ ID の いずれかが実行後に変更された場合、そのプロセスは汚染されていると 見なされます。

このシステムコールは、ユーザから得られた情報を使用するのが 安全かどうかをライブラリルーチン (たとえば libc や libtermcap) が 信頼性を持って判定できるようにするために存在します。 特に getenv(3) からの結果を、オペレーションの制御のために使用する場合には 疑いを持って見る必要があります。

“汚染された” 状態は、 fork(2) システムコール (あるいは popen(3) のような fork を呼び出す他のライブラリコード) の結果として、 子プロセスに継承されます。

別のプログラムを実行する準備をするときにすべての特権を クリアするプログラムは、環境もリセットすると想定されます。 したがって “汚染された” 状態は引き渡されません。 setuid を開始するけれども汚染されていない プロセスを作成できる必要のある su(1) のようなプログラムにはこれは重要です。

エラー
issetugid() 関数は必ず正常に完了するので、エラーを示すための戻り値はありません。

関連項目
execve(2), fork(2), setegid(2), seteuid(2), setgid(2), setregid(2), setreuid(2), setuid(2)

歴史
issetugid() 関数は OpenBSD 2.0 ではじめて登場し、 FreeBSD 3.0 でも実装されました。