.\"
.TH CLEARENV 3 2010-10-04 "Linux" "Linux Programmer's Manual"
.\"O .SH NAME
-.SH ̾Á°
+.SH 名前
.\"O clearenv \- clear the environment
-clearenv \- ´Ä¶ (environment) ¤ò¥¯¥ê¥¢¤¹¤ë
+clearenv \- 環境 (environment) をクリアする
.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.SH 書式
.nf
.B #include <stdlib.h>
.sp
.in -4n
.\"O Feature Test Macro Requirements for glibc (see
.\"O .BR feature_test_macros (7)):
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
+glibc 向けの機能検査マクロの要件
.RB ( feature_test_macros (7)
-»²¾È):
+参照):
.in
.sp
.BR clearenv ():
_SVID_SOURCE || _BSD_SOURCE
.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
+.SH 説明
.\"O The
.\"O .BR clearenv ()
.\"O function clears the environment of all name-value
.\"O .I environ
.\"O to NULL.
.BR clearenv ()
-´Ø¿ô¤Ï¡¢Ì¾Á°¤ÈÃͤ¬ÁȤˤʤä¿Á´¤Æ¤Î´Ä¶¤ò¥¯¥ê¥¢¤¹¤ë¡£
-¤µ¤é¤Ë³°ÉôÊÑ¿ô
+関数は、名前と値が組になった全ての環境をクリアする。
+さらに外部変数
.I environ
-¤ÎÃͤò NULL ¤Ë¤¹¤ë¡£
+の値を NULL にする。
.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
+.SH 返り値
.\"O The
.\"O .BR clearenv ()
.\"O function returns zero on success, and a nonzero
.\"O value on failure.
.BR clearenv ()
-´Ø¿ô¤Ï¡¢À®¸ù¤·¤¿¾ì¹ç¤Ï 0 ¤òÊÖ¤·¡¢
-¼ºÇÔ¤·¤¿¾ì¹ç¤Ï 0 °Ê³°¤òÊÖ¤¹¡£
+関数は、成功した場合は 0 を返し、
+失敗した場合は 0 以外を返す。
.\"O .\" Most versions of UNIX return -1 on error, or do not even have errors.
.\"O .\" Glibc info and the Watcom C library document "a nonzero value".
-.\" UNIX ·Ï OS ¤Î¿¤¯¤Ï¡¢¥¨¥é¡¼¤Î¾ì¹ç¤Ë \-1 ¤òÊÖ¤¹¡£
-.\" ¤â¤·¤¯¤Ï¥¨¥é¡¼¤Î¾ì¹ç¤Ç¤â²¿¤âÊÖ¤µ¤Ê¤¤¡£
-.\" glibc ¤Î info ¤È Watcom C ¥é¥¤¥Ö¥é¥ê¤Ë¤Ï¡¢
-.\" ¡Ö0 °Ê³°¤ÎÃÍ (¤òÊÖ¤¹)¡×¤Èµ½Ò¤µ¤ì¤Æ¤¤¤ë¡£
+.\" UNIX 系 OS の多くは、エラーの場合に \-1 を返す。
+.\" もしくはエラーの場合でも何も返さない。
+.\" glibc の info と Watcom C ライブラリには、
+.\" 「0 以外の値 (を返す)」と記述されている。
.\"O .SH VERSIONS
-.SH ¥Ð¡¼¥¸¥ç¥ó
+.SH バージョン
.\"O Not in libc4, libc5.
.\"O In glibc since glibc 2.0.
-libc4, libc5 ¤Ç¤Ï»ÈÍѤǤ¤Ê¤¤¡£
-glibc 2.0 °Ê¹ß¤Î glibc ¤Ç»ÈÍѤǤ¤ë¡£
+libc4, libc5 では使用できない。
+glibc 2.0 以降の glibc で使用できる。
.\"O .SH "CONFORMING TO"
-.SH ½àµò
+.SH 準拠
.\"O Various UNIX variants (DG/UX, HP-UX, QNX, ...).
.\"O POSIX.9 (bindings for FORTRAN77).
.\"O POSIX.1-1996 did not accept
.\"O However, POSIX.1-2001
.\"O only adds \fBputenv\fP(3), and rejected
.\"O .BR clearenv ().
-(DG/UX, HP-UX, QNX, ¤Ê¤É¤Î) ¿¤¯¤Î UNIX ·Ï OS¡£
-(FORTRAN77 ¤Ø¤Î¥Ð¥¤¥ó¥Ç¥£¥ó¥°¤Ç¤¢¤ë) POSIX.9¡£
-POSIX.1-1996 ¤Ç¤Ï
+(DG/UX, HP-UX, QNX, などの) 多くの UNIX 系 OS。
+(FORTRAN77 へのバインディングである) POSIX.9。
+POSIX.1-1996 では
.BR clearenv ()
-¤È
+と
.BR putenv (3)
-¤ÏºÎÍѤµ¤ì¤Ê¤«¤Ã¤¿¤¬¡¢
-Êý¿Ë¤¬Êѹ¹¤µ¤ì¡¢¤³¤Îɸ½àµ¬³Ê¤Î°Ê¹ß¤Î¹æ (B.4.6.1 ¤ò»²¾È) ¤Ç¤Ï
-ºÎÍѤµ¤ì¤ë¤³¤È¤Ë¤Ê¤Ã¤¿¡£
-¤·¤«¤· POSIX.1-2001 ¤Ç¤Ï
+は採用されなかったが、
+方針が変更され、この標準規格の以降の号 (B.4.6.1 を参照) では
+採用されることになった。
+しかし POSIX.1-2001 では
.BR putenv (3)
-¤·¤«Äɲ䵤줺¡¢
+しか追加されず、
.BR clearenv ()
-¤ÎÄɲäÏÈݷ褵¤ì¤¿¡£
+の追加は否決された。
.\"O .SH NOTES
-.SH Ãí°Õ
+.SH 注意
.\"O Used in security-conscious applications.
.\"O If it is unavailable
.\"O the assignment
-¤³¤Î´Ø¿ô¤Ï¥»¥¥å¥ê¥Æ¥£¤Ë¹Íθ¤·¤¿¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤Ç»È¤ï¤ì¤ë¡£
-¤³¤Î´Ø¿ô¤¬»ÈÍѤǤ¤Ê¤¤¾ì¹ç¤Ï¡¢
+この関数はセキュリティに考慮したアプリケーションで使われる。
+この関数が使用できない場合は、
.nf
environ = NULL;
.fi
.\"O will probably do.
-¤È¤¤¤¦¤è¤¦¤ËÊÑ¿ô environ ¤òÀßÄꤹ¤ì¤Ð¤è¤¤¡£
+というように変数 environ を設定すればよい。
.LP
.\"O The DG/UX and Tru64 man pages write: If
.\"O .I environ
.\"O functions, then
.\"O .BR clearenv ()
.\"O will return an error and the process environment will remain unchanged.
-DG/UX ¤È Tru64 man ¥Ú¡¼¥¸¤Ë¤Ï¼¡¤Î¤è¤¦¤Ëµ¤µ¤ì¤Æ¤¤¤ë¡§
+DG/UX と Tru64 man ページには次のように記されている:
.I environ
-¤¬
+が
.BR putenv (3),
.BR getenv (3),
.BR clearenv ()
-´Ø¿ô°Ê³°¤ÇÊѹ¹¤µ¤ì¤¿¾ì¹ç¡¢
+関数以外で変更された場合、
.BR clearenv ()
-¤Ï¥¨¥é¡¼¤òÊÖ¤·¡¢¥×¥í¥»¥¹´Ä¶¤ÏÊѹ¹Á°¤Î¤Þ¤Þ¤Ë¤µ¤ì¤ë¡£
+はエラーを返し、プロセス環境は変更前のままにされる。
.\" .LP
.\"O .\" HP-UX has a ENOMEM error return.
-.\" HP-UX ¤Ë¤Ï ENOMEM ¥¨¥é¡¼¤¬¤¢¤ë¡£
+.\" HP-UX には ENOMEM エラーがある。
.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR getenv (3),
.BR putenv (3),
.BR setenv (3),