OSDN Git Service

Update README
[linuxjm/LDP_man-pages.git] / release / man2 / setresuid.2
index c78dcba..1696228 100644 (file)
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH SETRESUID 2 2010\-11\-22 Linux "Linux Programmer's Manual"
+.\"
+.\" Japanese Version Copyright (c) 1997 HANATAKA Shinya
+.\"         all rights reserved.
+.\" Translated 1997-08-30, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
+.\" Updated & Modified 2004-05-22, Yuichi SATO <ysato444@yahoo.co.jp>
+.\" Updated & Modified 2005-01-04, Yuichi SATO
+.\" Updated & Modified 2005-09-03, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\" Updated & Modified 2005-11-04, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\" Updated 2012-04-30, Akihiro MOTOKI <amotoki@gmail.com>
+.\"
+.TH SETRESUID 2 2014\-09\-21 Linux "Linux Programmer's Manual"
 .SH 名前
-setresuid, setresgid \- ユーザやグループの 実、実効、保存 ID を設定する
+setresuid, setresgid \- ã\83¦ã\83¼ã\82¶ã\83¼ã\82\84ã\82°ã\83«ã\83¼ã\83\97ã\81® å®\9fã\80\81å®\9få\8a¹ã\80\81ä¿\9då­\98 ID ã\82\92設å®\9aã\81\99ã\82\8b
 .SH 書式
 \fB#define _GNU_SOURCE\fP /* feature_test_macros(7) 参照 */
 .br
@@ -58,11 +68,22 @@ UID、保存 set\-user\-ID を任意の値に設定できる。
 (さらにファイルシステム GID を実効 GID と同じ値に修正する)。 非特権プロセスは同様の制限を受ける。
 .SH 返り値
 成功した場合は 0 が返される。エラーの場合は \-1 が返され、 \fIerrno\fP が適切に設定される。
+
+\fI注意\fP: 呼び出し元が UID 0 であっても \fBsetresuid\fP() が失敗する場合がある。 \fBsetresuid\fP()
+からのリターンが失敗かどうかの確認を省略することは重大なセキュリティ上のエラーとなる。
 .SH エラー
 .TP 
 \fBEAGAIN\fP
-\fIuid\fP が現在のユーザー ID と違う値で、 この呼び出しにより ユーザー ID が リソース上限 \fBRLIMIT_NPROC\fP
-を超えてしまう。
+この呼び出しで呼び出し元の実 UID が変更されるはずだったが (つまり、 \fIruid\fP が呼び出し元の実 UID と一致していない)、
+必要なカーネルのデータ構造体の割り当てで一時的な失敗があった。
+.TP 
+\fBEAGAIN\fP
+\fIruid\fP は呼び出し元の実 UID と一致しておらず、 この呼び出しで実ユーザー ID \fIruid\fP に属するプロセス数が呼び出し元の
+\fBRLIMIT_NPROC\fP リソース上限を超過するところであった。 Linux 3.1 以降では、このエラーはもはや発生することはない
+(しかし、堅牢性が求められるアプリケーションではこのエラーを確認すべきである)。 \fBexecve\fP(2) の \fBEAGAIN\fP の説明を参照。
+.TP 
+\fBEINVAL\fP
+対象のユーザー ID やグループ ID のうち 1 つ以上がこのユーザー名前空間で有効ではない。
 .TP 
 \fBEPERM\fP
 呼び出したプロセスが特権を持たないのに (\fBCAP_SETUID\fP ケーパビリティを持たないのに)、 ID を許されていない値に変更しようとした。
@@ -82,8 +103,9 @@ glibc の \fBsetresuid\fP() と \fBsetresgid\fP() のラッパー関数は
 カーネルバージョンによるこの違いを吸収している。
 .SH 関連項目
 \fBgetresuid\fP(2), \fBgetuid\fP(2), \fBsetfsgid\fP(2), \fBsetfsuid\fP(2),
-\fBsetreuid\fP(2), \fBsetuid\fP(2), \fBcapabilities\fP(7), \fBcredentials\fP(7)
+\fBsetreuid\fP(2), \fBsetuid\fP(2), \fBcapabilities\fP(7), \fBcredentials\fP(7),
+\fBuser_namespaces\fP(7)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.50 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。