manページ  — SETRESUID

getresgid, getresuid, setresgid, setresuid – ユーザまたはグループの実 ID、実効 ID、退避 ID を取得もしくは設定する

ライブラリ 書式 解説 戻り値 エラー 関連項目 規格 歴史

Standard C Library (libc, -lc)

#include <sys/types.h>

#include <unistd.h>

int
getresgid(gid_t *rgid, gid_t *egid, gid_t *sgid);

int
getresuid(uid_t *ruid, uid_t *euid, uid_t *suid);

int
setresgid(gid_t rgid, gid_t egid, gid_t sgid);

int
setresuid(uid_t ruid, uid_t euid, uid_t suid);

setresuid() システムコールは、 現在のプロセスのユーザの実 ID、実効 ID、退避 ID をセットします。 同様に setresgid() はグループの実 ID、実効 ID、退避 ID をセットします。

特権を持つプロセスは、これらの ID を任意の値にセットできます。 特権を持たないプロセスは、新しい ID のそれぞれが現在の ID のうちの いずれかと一致しなければならないという制限を受けます。

値を変更したくない場合は、対応する引数に -1 を渡します。

getresgid() 呼び出しと getresuid() 呼び出しは、それぞれ現在のプロセスのユーザもしくはグループの 実 ID、実効 ID、退避 ID を取得します。

Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

[EPERM]
	呼び出し元プロセスが特権を持っておらず、1 つ以上の ID を 現在の実 ID、実効 ID、退避 ID 以外の値に変更しようとしました。
[EFAULT]
	getresgid() もしくは getresuid() に渡されたアドレスは不正です。

これらのシステムコールを持たないプラットホームはたくさんあります。 これらは GNU libc2 とリンクされた Linux バイナリを FreeBSD でサポートするために用意されています。

これらの関数は HP-UX ではじめて登場しました。