OSDN Git Service

(split) Convert release and draft pages to UTF-8.
[linuxjm/LDP_man-pages.git] / draft / man2 / setresuid.2
index 27d22a2..fc4324b 100644 (file)
 .\" Updated & Modified 2005-09-03, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
 .\" Updated & Modified 2005-11-04, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
 .\"
-.\"WORD:       effective user ID       ¼Â¸ú¥æ¡¼¥¶¡¼ID
-.\"WORD:       real user ID            ¼Â¥æ¡¼¥¶¡¼ID
-.\"WORD:       saved set-user-ID       Êݸ¥»¥Ã¥È¥æ¡¼¥¶¡¼ID
-.\"WORD:       effective group ID      ¼Â¸ú¥°¥ë¡¼¥×ID
-.\"WORD:       real group ID           ¼Â¥°¥ë¡¼¥×ID
-.\"WORD:       saved group ID          Êݸ¥°¥ë¡¼¥×ID
+.\"WORD:       effective user ID       å®\9få\8a¹ã\83¦ã\83¼ã\82¶ã\83¼ID
+.\"WORD:       real user ID            å®\9fã\83¦ã\83¼ã\82¶ã\83¼ID
+.\"WORD:       saved set-user-ID       ä¿\9då­\98ã\82»ã\83\83ã\83\88ã\83¦ã\83¼ã\82¶ã\83¼ID
+.\"WORD:       effective group ID      実効グループID
+.\"WORD:       real group ID           実グループID
+.\"WORD:       saved group ID          保存グループID
 .\"
 .TH SETRESUID 2 2007-07-26 "Linux" "Linux Programmer's Manual"
 .\"O .SH NAME
-.SH Ì¾Á°
+.SH 名前
 .\"O setresuid, setresgid \- set real, effective and saved user or group ID
-setresuid, setresgid \- ¥æ¡¼¥¶¤ä¥°¥ë¡¼¥×¤Î ¼Â¡¢¼Â¸ú¡¢Êݸ ID ¤òÀßÄꤹ¤ë
+setresuid, setresgid \- ユーザやグループの 実、実効、保存 ID を設定する
 .\"O .SH SYNOPSIS
-.SH ½ñ¼°
-.B #define _GNU_SOURCE
+.SH 書式
+.\"O .BR "#define _GNU_SOURCE" "         /* See feature_test_macros(7) */"
+.BR "#define _GNU_SOURCE" "         /* feature_test_macros(7) 参照 */"
 .br
 .B #include <unistd.h>
 .sp
@@ -54,38 +55,38 @@ setresuid, setresgid \- 
 .br
 .BI "int setresgid(gid_t " rgid ", gid_t " egid ", gid_t " sgid );
 .\"O .SH DESCRIPTION
-.SH ÀâÌÀ
+.SH 説明
 .\"O .BR setresuid ()
 .\"O sets the real user ID, the effective user ID, and the
 .\"O saved set-user-ID of the calling process.
 .BR setresuid ()
-¤Ï¸Æ¤Ó½Ð¤·¸µ¤Î¥×¥í¥»¥¹¤Î¼Â (real) ¥æ¡¼¥¶¡¼ID¡¢¼Â¸ú (effective) ¥æ¡¼¥¶¡¼ID¡¢
-Êݸ set-user-ID ¤òÀßÄꤹ¤ë¡£
+は呼び出し元のプロセスの実 (real) ユーザーID、実効 (effective) ユーザーID、
+保存 set-user-ID を設定する。
 
 .\"O Unprivileged user processes
 .\"O may change the real UID,
 .\"O effective UID and saved set-user-ID, each to one of:
 .\"O the current real UID, the current effective UID or the
 .\"O current saved set-user-ID.
-ÈóÆø¢¥æ¡¼¥¶¡¼¤Î¥×¥í¥»¥¹¤Ï¡¢¤½¤Î¼Â UID¡¢¼Â¸ú UID¡¢Êݸ set-user-ID ¤ò¡¢
-¸½ºß¤Î¼Â UID¡¢¸½ºß¤Î¼Â¸ú UID¡¢¸½ºß¤ÎÊݸ set-user-ID
-¤Î¤É¤ì¤«¤ËÊѹ¹¤¹¤ë¤³¤È¤¬¤Ç¤­¤ë:
+非特権ユーザーのプロセスは、その実 UID、実効 UID、保存 set-user-ID を、
+現在の実 UID、現在の実効 UID、現在の保存 set-user-ID
+のどれかに変更することができる:
 
 .\"O Privileged processes (on Linux, those having the \fBCAP_SETUID\fP capability)
 .\"O may set the real UID, effective UID, and
 .\"O saved set-user-ID to arbitrary values.
-Æø¢¥×¥í¥»¥¹ (Linux ¤Ç¤Ï \fBCAP_SETUID\fP ¥±¡¼¥Ñ¥Ó¥ê¥Æ¥£ (capability) ¤ò»ý¤Ä
-¥×¥í¥»¥¹) ¤Ï¡¢¼Â UID¡¢¼Â¸ú UID¡¢Êݸ set-user-ID ¤òǤ°Õ¤ÎÃͤËÀßÄê¤Ç¤­¤ë¡£
+特権プロセス (Linux では \fBCAP_SETUID\fP ケーパビリティ (capability) を持つ
+プロセス) は、実 UID、実効 UID、保存 set-user-ID を任意の値に設定できる。
 
 .\"O If one of the arguments equals \-1, the corresponding value is not changed.
-°ú¤­¿ô¤Î¤É¤ì¤«¤¬ \-1 ¤Î¾ì¹ç¤Ï¤½¤ÎÃͤÏÊѹ¹¤µ¤ì¤º¤Ë»Ä¤µ¤ì¤ë¡£
+引き数のどれかが \-1 の場合はその値は変更されずに残される。
 
 .\"O Regardless of what changes are made to the real UID, effective UID,
 .\"O and saved set-user-ID, the file system UID is always set to the same
 .\"O value as the (possibly new) effective UID.
-¼Â UID¡¢¼Â¸ú UID¡¢Êݸ set-user-ID ¤Ë¤É¤ó¤ÊÊѹ¹¤¬¹Ô¤ï¤ì¤¿¤«¤Ë´Ø¤ï¤é¤º¡¢
-¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à UID ¤Ï¾ï¤Ë¼Â¸ú UID (²Äǽ¤Ç¤¢¤ì¤ÐÊѹ¹¸å¤Î¿·¤·¤¤¼Â¸ú UID)
-¤ÈƱ¤¸ÃͤËÀßÄꤵ¤ì¤ë¡£
+実 UID、実効 UID、保存 set-user-ID にどんな変更が行われたかに関わらず、
+ファイルシステム UID は常に実効 UID (可能であれば変更後の新しい実効 UID)
+と同じ値に設定される。
 
 .\"O Completely analogously,
 .\"O .BR setresgid ()
@@ -93,22 +94,22 @@ setresuid, setresgid \- 
 .\"O of the calling process (and always modifies the file system GID
 .\"O to be the same as the effective GID),
 .\"O with the same restrictions for unprivileged processes.
-Á´¤¯Æ±¤¸¤è¤¦¤Ë¡¢
+全く同じように、
 .BR setresgid ()
-¤Ï¸Æ¤Ó½Ð¤·¸µ¤Î¥×¥í¥»¥¹¤Î¼Â GID¡¢¼Â¸ú GID¡¢Êݸ set-group-ID ¤òÀßÄꤹ¤ë
-(¤µ¤é¤Ë¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à GID ¤ò¼Â¸ú GID ¤ÈƱ¤¸Ãͤ˽¤Àµ¤¹¤ë)¡£
-ÈóÆø¢¥×¥í¥»¥¹¤ÏƱÍͤÎÀ©¸Â¤ò¼õ¤±¤ë¡£
+は呼び出し元のプロセスの実 GID、実効 GID、保存 set-group-ID を設定する
+(さらにファイルシステム GID を実効 GID と同じ値に修正する)。
+非特権プロセスは同様の制限を受ける。
 .\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
+.SH 返り値
 .\"O On success, zero is returned.
 .\"O On error, \-1 is returned, and
 .\"O .I errno
 .\"O is set appropriately.
-À®¸ù¤·¤¿¾ì¹ç¤Ï 0 ¤¬ÊÖ¤µ¤ì¤ë¡£¥¨¥é¡¼¤Î¾ì¹ç¤Ï \-1 ¤¬ÊÖ¤µ¤ì¡¢
+成功した場合は 0 が返される。エラーの場合は \-1 が返され、
 .I errno
-¤¬Å¬ÀÚ¤ËÀßÄꤵ¤ì¤ë¡£
+が適切に設定される。
 .\"O .SH ERRORS
-.SH ¥¨¥é¡¼
+.SH ã\82¨ã\83©ã\83¼
 .TP
 .B EAGAIN
 .\"O .I uid
@@ -117,40 +118,40 @@ setresuid, setresgid \- 
 .\"O .B RLIMIT_NPROC
 .\"O resource limit.
 .I uid
-¤¬¸½ºß¤Î¥æ¡¼¥¶¡¼ ID ¤È°ã¤¦Ãͤǡ¢
-¤³¤Î¸Æ¤Ó½Ð¤·¤Ë¤è¤ê ¥æ¡¼¥¶¡¼ ID ¤¬
-¥ê¥½¡¼¥¹¾å¸Â
+が現在のユーザー ID と違う値で、
+この呼び出しにより ユーザー ID が
+リソース上限
 .B RLIMIT_NPROC
-¤òĶ¤¨¤Æ¤·¤Þ¤¦¡£
+を超えてしまう。
 .TP
 .B EPERM
 .\"O The calling process is not privileged (did not have the \fBCAP_SETUID\fP
 .\"O capability) and tried to change the IDs to values that are not permitted.
-¸Æ¤Ó½Ð¤·¤¿¥×¥í¥»¥¹¤¬Æø¢¤ò»ý¤¿¤Ê¤¤¤Î¤Ë
-(\fBCAP_SETUID\fP ¥±¡¼¥Ñ¥Ó¥ê¥Æ¥£¤ò»ý¤¿¤Ê¤¤¤Î¤Ë)¡¢
-ID ¤òµö¤µ¤ì¤Æ¤¤¤Ê¤¤ÃͤËÊѹ¹¤·¤è¤¦¤È¤·¤¿¡£
+呼び出したプロセスが特権を持たないのに
+(\fBCAP_SETUID\fP ケーパビリティを持たないのに)、
+ID を許されていない値に変更しようとした。
 .\"O .SH VERSIONS
-.SH ¥Ð¡¼¥¸¥ç¥ó
+.SH バージョン
 .\"O It is available under Linux since Linux 2.1.44.
-Linux ¤Ç¤Ï¥Ð¡¼¥¸¥ç¥ó 2.1.44 ¤è¤êÍøÍѲÄǽ¤Ë¤Ê¤Ã¤¿¡£
+Linux ではバージョン 2.1.44 より利用可能になった。
 .\"O .SH "CONFORMING TO"
-.SH ½àµò
+.SH 準拠
 .\"O These calls are nonstandard;
 .\"O they also appear on HP-UX and some of the BSDs.
-¤³¤ì¤é¤Î¥³¡¼¥ë¤ÏÈóɸ½à¤Ç¤¢¤ë¡£
-HP-UX ¤ä BSD ·Ï¤Î¤¤¤¯¤Ä¤«¤Ë¤â¸ºß¤¹¤ë¡£
+これらのコールは非標準である。
+HP-UX や BSD 系のいくつかにも存在する。
 .\"O .SH NOTES
-.SH Ãí°Õ
+.SH 注意
 .\"O Under HP-UX and FreeBSD the prototype is found in
 .\"O .IR <unistd.h> .
-HP-UX ¤ä FreeBSD ¤Ç¤Ï
+HP-UX や FreeBSD では
 .I <unistd.h>
-¤Ë¥×¥í¥È¥¿¥¤¥×¤¬Â¸ºß¤¹¤ë¡£
+にプロトタイプが存在する。
 .\"O Under Linux the prototype is provided by glibc since version 2.3.2.
-Linux ¤Ç¤Ï¡¢glibc 2.3.2 °Ê¹ß¤Ç
-¥×¥í¥È¥¿¥¤¥×¤¬Ä󶡤µ¤ì¤Æ¤¤¤ë¡£
+Linux では、glibc 2.3.2 以降で
+プロトタイプが提供されている。
 .\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
 .BR getresuid (2),
 .BR getuid (2),
 .BR setfsgid (2),
@@ -158,5 +159,4 @@ Linux 
 .BR setreuid (2),
 .BR setuid (2),
 .BR capabilities (7),
-.BR credentials (7),
-.BR feature_test_macros (7)
+.BR credentials (7)