OSDN Git Service

(split) LDP: Release pages for LDP v3.39.
[linuxjm/LDP_man-pages.git] / release / man2 / seteuid.2
index 0abbd7e..c4f588d 100644 (file)
 .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com>
 .\"     Added notes on capability requirements
 .\"
-.\" Japanese Version Copyright (c) 2001, 2005 Yuichi SATO
-.\"         all rights reserved.
-.\" Translated 2001-06-04, Yuichi SATO <ysato@h4.dion.ne.jp>
-.\" Updated & Modified 2005-01-04, Yuichi SATO <ysato444@yahoo.co.jp>
-.\" Updated 2010-04-23, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.24
+.\"*******************************************************************
 .\"
-.\"WORD:       effective user ID       ¼Â¸ú¥æ¡¼¥¶¡¼ ID
-.\"WORD:       real user ID            ¼Â¥æ¡¼¥¶¡¼ ID
-.\"WORD:       saved user ID           Êݸ¥æ¡¼¥¶¡¼ ID
-.\"WORD:
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.TH SETEUID 2 2009-10-17 "Linux" "Linux Programmer's Manual"
-.SH Ì¾Á°
-seteuid, setegid \- ¼Â¸ú¥æ¡¼¥¶¡¼ ID ¤ä ¼Â¸ú¥°¥ë¡¼¥× ID ¤òÀßÄꤹ¤ë
-.SH ½ñ¼°
-.B #include <sys/types.h>
+.\"*******************************************************************
+.TH SETEUID 2 2009\-10\-17 Linux "Linux Programmer's Manual"
+.SH 名前
+seteuid, setegid \- 実効ユーザー ID や 実効グループ ID を設定する
+.SH 書式
+\fB#include <sys/types.h>\fP
 .br
-.B #include <unistd.h>
+\fB#include <unistd.h>\fP
 .sp
-.BI "int seteuid(uid_t " euid );
+\fBint seteuid(uid_t \fP\fIeuid\fP\fB);\fP
 .br
-.BI "int setegid(gid_t " egid );
+\fBint setegid(gid_t \fP\fIegid\fP\fB);\fP
 .sp
 .in -4n
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
-.RB ( feature_test_macros (7)
-»²¾È):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
 .sp
 .ad l
-.BR seteuid (),
-.BR setegid ():
+\fBseteuid\fP(), \fBsetegid\fP():
+.RS 4
 _BSD_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600
-.ad b
-.SH ÀâÌÀ
-.BR seteuid ()
-¤Ï¸Æ¤Ó½Ð¤·¸µ¤Î¥×¥í¥»¥¹¤Î¼Â¸ú¥æ¡¼¥¶¡¼ ID ¤òÀßÄꤹ¤ë¡£
-ÈóÆø¢¥æ¡¼¥¶¡¼¤Î¥×¥í¥»¥¹¤Î¾ì¹ç¡¢¼Â¸ú¥æ¡¼¥¶¡¼ ID ¤ËÀßÄê¤Ç¤­¤ë¤Î¤Ï¡¢
-¼Â¥æ¡¼¥¶¡¼ ID¡¦¼Â¸ú¥æ¡¼¥¶¡¼ ID¡¦Êݸ set-user-ID ¤Î¤¤¤º¤ì¤«¤À¤±¤Ç¤¢¤ë¡£
+.RE
+.ad
+.SH 説明
+\fBseteuid\fP()  は呼び出し元のプロセスの実効ユーザー ID を設定する。 非特権ユーザーのプロセスの場合、実効ユーザー ID
+に設定できるのは、 実ユーザー ID・実効ユーザー ID・保存 set\-user\-ID のいずれかだけである。
 
-.BR setegid ()
-¤Ï¡Ö¥æ¡¼¥¶¡¼¡×¤Ç¤Ï¤Ê¤¯¡Ö¥°¥ë¡¼¥×¡×¤ËÂФ·¤ÆÁ´¤¯Æ±¤¸¤³¤È¤ò¹Ô¤¦¡£
 .\" When
 .\" .I euid
 .\" equals \-1, nothing is changed.
 .\" (This is an artifact of the implementation in glibc of seteuid()
 .\" using setresuid(2).)
-.SH ÊÖ¤êÃÍ
-À®¸ù¤·¤¿¾ì¹ç¤Ï 0 ¤¬ÊÖ¤µ¤ì¤ë¡£
-¥¨¥é¡¼¤Î¾ì¹ç¤Ï \-1 ¤¬ÊÖ¤µ¤ì¡¢
-.I errno
-¤¬Å¬ÀÚ¤ËÀßÄꤵ¤ì¤ë¡£
-
-.SH ¥¨¥é¡¼
+\fBsetegid\fP()  は「ユーザー」ではなく「グループ」に対して全く同じことを行う。
+.SH 返り値
+成功した場合は 0 が返される。エラーの場合は \-1 が返され、 \fIerrno\fP が適切に設定される。
+.SH エラー
 .\" .TP
 .\" .B EINVAL
-.TP
-.B EPERM
-¸Æ¤Ó½Ð¤·¸µ¤Î¥×¥í¥»¥¹¤ËÆø¢¤¬¤Ê¤¯¡¢
-.I euid
-.RI ( egid )
-¤¬¼Â¥æ¡¼¥¶¡¼ (¥°¥ë¡¼¥×) ID¡¢¤Þ¤¿¤Ï¼Â¸ú¥æ¡¼¥¶¡¼ (¥°¥ë¡¼¥×) ID¡¢
-Êݸ set-user-ID (Êݸ set-group-ID) ¤Î¤¤¤º¤ì¤Ç¤â¤Ç¤Ï¤Ê¤¤
-(Linux ¤Ë¤ª¤¤¤Æ¤Ï¡¢
-.BR seteuid ()
-¤Ç¤Ï
-.B CAP_SETUID
-¥±¡¼¥Ñ¥Ó¥ê¥Æ¥£ (capability) ¤¬¡¢
-.BR setegid ()
-¤Ç¤Ï
-.B CAP_SETGID
-¥±¡¼¥Ñ¥Ó¥ê¥Æ¥£¤¬¤Ê¤¤¾ì¹ç¤Ë¡¢Æø¢¤¬¤Ê¤¤¤ÈȽÃǤµ¤ì¤ë)¡£
-.SH ½àµò
-4.3BSD, POSIX.1-2001.
-.SH Ãí°Õ
-¼Â¸ú¥æ¡¼¥¶¡¼ (¥°¥ë¡¼¥×) ID ¤òÊݸ set-user-ID (Êݸ set-group-ID) ¤Ë
-ÀßÄê¤Ç¤­¤ë¤Î¤Ï¡¢Linux 1.1.37 (1.1.38) °Ê¹ß¤Ç¤¢¤ë¡£
-Á´¤Æ¤Î¥·¥¹¥Æ¥à¤Ë¤ª¤¤¤Æ
-.B _POSIX_SAVED_IDS
-¤ò¥Á¥§¥Ã¥¯¤¹¤Ù¤­¤Ç¤¢¤ë¡£
+.TP 
+\fBEPERM\fP
+呼び出し元のプロセスに特権がなく、 \fIeuid\fP (\fIegid\fP)  が実ユーザー (グループ) ID、または実効ユーザー (グループ) ID、
+保存 set\-user\-ID (保存 set\-group\-ID) のいずれでもではない (Linux においては、 \fBseteuid\fP()  では
+\fBCAP_SETUID\fP ケーパビリティ (capability) が、 \fBsetegid\fP()  では \fBCAP_SETGID\fP
+ケーパビリティがない場合に、特権がないと判断される)。
+.SH 準拠
+4.3BSD, POSIX.1\-2001.
+.SH 注意
+実効ユーザー (グループ) ID を保存 set\-user\-ID (保存 set\-group\-ID) に 設定できるのは、Linux 1.1.37
+(1.1.38) 以降である。 全てのシステムにおいて \fB_POSIX_SAVED_IDS\fP をチェックすべきである。
 .LP
-libc4, libc5, glibc 2.0 ¤Ç¤Ï¡¢
-.BI seteuid( euid )
-¤Ï
-.BI setreuid(\-1, " euid" )
-¤ÈÅù²Á¤Ç¤¢¤ê¡¢Êݸ set-user-ID ¤òÊѹ¹¤¹¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
-glibc 2.1 ¤Ç¤Ï¡¢
-.BI setresuid(\-1, " euid" ", \-1)"
-¤ÈÅù²Á¤Ç¤¢¤ê¡¢Êݸ set-user-ID Êѹ¹¤·¤Ê¤¤¡£
-ƱÍͤΤ³¤È¤¬
-.BR setegid ()
-¤Ë¤â¸À¤¨¤ë¡£
+libc4, libc5, glibc 2.0 では、 \fBseteuid(\fP\fIeuid\fP\fB)\fP は \fBsetreuid(\-1,\fP\fI
+euid\fP\fB)\fP と等価であり、保存 set\-user\-ID を変更するかもしれない。 glibc 2.1 では、
+\fBsetresuid(\-1,\fP\fI euid\fP\fB, \-1)\fP と等価であり、保存 set\-user\-ID 変更しない。 同様のことが
+\fBsetegid\fP()  にも言える。
 
-POSIX.1 ¤Ç¤Ï¡¢
-.BR seteuid ()
-.RB ( setegid ())
-¤Ç¡¢
-.I euid
-.RI ( egid )
-¤È¤·¤Æ¸½ºß¤Î¼Â¸ú¥æ¡¼¥¶ (¥°¥ë¡¼¥×) ID ¤ÈƱ¤¸Ãͤò»ØÄê²Äǽ¤Ç¤¢¤ë
-ɬÍפϤʤ¤¤È¤µ¤ì¤Æ¤ª¤ê¡¢¤¤¤¯¤Ä¤«¤Î¼ÂÁõ¤Ç¤Ï
-.I euid
-.RI ( egid )
-¤È¤·¤Æ¸½ºß¤Î¼Â¸ú¥æ¡¼¥¶ (¥°¥ë¡¼¥×) ID ¤ÈƱ¤¸Ãͤò
-»ØÄꤹ¤ë¤³¤È¤¬¤Ç¤­¤Ê¤¤¡£
-.SH ´ØÏ¢¹àÌÜ
-.BR geteuid (2),
-.BR setresuid (2),
-.BR setreuid (2),
-.BR setuid (2),
-.BR capabilities (7),
-.BR credentials (7)
+POSIX.1 では、 \fBseteuid\fP()  (\fBsetegid\fP())  で、 \fIeuid\fP (\fIegid\fP)  として現在の実効ユーザ
+(グループ) ID と同じ値を指定可能である 必要はないとされており、いくつかの実装では \fIeuid\fP (\fIegid\fP)  として現在の実効ユーザ
+(グループ) ID と同じ値を 指定することができない。
+.SH 関連項目
+\fBgeteuid\fP(2), \fBsetresuid\fP(2), \fBsetreuid\fP(2), \fBsetuid\fP(2),
+\fBcapabilities\fP(7), \fBcredentials\fP(7)