.\" Updated 2006-04-14, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.29
.\" Updated 2006-07-26, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.36
.\"
-.\"WORD: temporary file ¥Æ¥ó¥Ý¥é¥ê¥Õ¥¡¥¤¥ë
-.\"WORD: filename ¥Õ¥¡¥¤¥ë̾
-.\"WORD: function ´Ø¿ô
-.\"WORD: directory ¥Ç¥£¥ì¥¯¥È¥ê
-.\"WORD: environment variable ´Ä¶ÊÑ¿ô
-.\"WORD: argument °ú¤¿ô
-.\"WORD: storage ÊݸÎΰè
-.\"WORD: pointer ¥Ý¥¤¥ó¥¿¡¼
+.\"WORD: temporary file テンポラリファイル
+.\"WORD: filename ファイル名
+.\"WORD: function 関数
+.\"WORD: directory ディレクトリ
+.\"WORD: environment variable 環境変数
+.\"WORD: argument 引き数
+.\"WORD: storage 保存領域
+.\"WORD: pointer ã\83\9dã\82¤ã\83³ã\82¿ã\83¼
.\"
.TH TEMPNAM 3 2008-08-06 "" "Linux Programmer's Manual"
.\"O .SH NAME
-.SH ̾Á°
+.SH 名前
.\"O tempnam \- create a name for a temporary file
-tempnam \- ¥Æ¥ó¥Ý¥é¥ê¥Õ¥¡¥¤¥ë¤Î̾Á°¤òºîÀ®¤¹¤ë
+tempnam \- テンポラリファイルの名前を作成する
.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.SH 書式
.nf
.B #include <stdio.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 tempnam ():
_BSD_SOURCE || _SVID_SOURCE
.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
+.SH 説明
.\"O The
.\"O .BR tempnam ()
.\"O function returns a pointer to a string that is a valid filename,
.\"O The directory prefix part of the pathname generated is required to
.\"O be "appropriate" (often that at least implies writable).
.BR tempnam ()
-´Ø¿ô¤Ï¥Õ¥¡¥¤¥ë̾¤È¤·¤ÆÀµ¤·¤¤Ê¸»úÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¡¼¤òÊÖ¤¹¡£
-¤³¤Î¥Õ¥¡¥¤¥ë̾¤ò»ý¤Ä¥Õ¥¡¥¤¥ë¤Ï¡¢
+関数はファイル名として正しい文字列へのポインターを返す。
+このファイル名を持つファイルは、
.BR tempnam ()
-¤¬¥Á¥§¥Ã¥¯¤·¤¿»þÅÀ¤Ë¤ª¤¤¤Æ¤Ï¸ºß¤·¤Ê¤¤ (¤·¤Ê¤«¤Ã¤¿)¡£
+がチェックした時点においては存在しない (しなかった)。
.I pfx
-¤¬ NULL ¤Ç¤Ê¤¤ 5 ¥Ð¥¤¥È°ÊÆâ¤Îʸ»úÎó¤Ç¤¢¤ì¤Ð¡¢
-À¸À®¤µ¤ì¤ë¥Ñ¥¹Ì¾¤Î¤¦¤Á¤Î¥Õ¥¡¥¤¥ë̾¤ÎÉôʬ¤Ï
+が NULL でない 5 バイト以内の文字列であれば、
+生成されるパス名のうちのファイル名の部分は
.I pfx
-¤«¤é»Ï¤Þ¤ë¤â¤Î¤Ë¤Ê¤ë¡£
-À¸À®¤µ¤ì¤ë¥Ç¥£¥ì¥¯¥È¥ê¤ÎÉôʬ¤Ï¡¢¡ÖŬÀڡפǤʤ±¤ì¤Ð¤Ê¤é¤Ê¤¤
-(ÂçÄñ¤Î¾ì¹ç¡¢¡ÖŬÀڡפǤ¢¤ë¤¿¤á¤Ë¤Ï¤Þ¤º¾¯¤Ê¤¯¤È¤â
-½ñ¤¹þ¤ß²Äǽ¤Ç¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤)¡£
+から始まるものになる。
+生成されるディレクトリの部分は、「適切」でなければならない
+(大抵の場合、「適切」であるためにはまず少なくとも
+書き込み可能でなければならない)。
.\"O Attempts to find an appropriate directory go through the following
.\"O steps:
-ŬÀڤʥǥ£¥ì¥¯¥È¥ê¤Îõº÷¤Ï¡¢°Ê²¼¤Î¼ê½ç¤Ë¤·¤¿¤¬¤Ã¤Æ¹Ô¤ï¤ì¤ë¡£
+適切なディレクトリの探索は、以下の手順にしたがって行われる。
.TP 3
a)
.\"O In case the environment variable
.\"O .B TMPDIR
.\"O exists and
.\"O contains the name of an appropriate directory, that is used.
-´Ä¶ÊÑ¿ô
+環境変数
.B TMPDIR
-¤¬ÀßÄꤵ¤ì¤Æ¤¤¤Æ¡¢
-¤½¤ÎÆâÍƤ¬Å¬Àڤʥǥ£¥ì¥¯¥È¥ê¤Î̾Á°¤Ê¤é¡¢¤½¤ì¤òÍѤ¤¤ë¡£
+が設定されていて、
+その内容が適切なディレクトリの名前なら、それを用いる。
.TP
b)
.\"O Otherwise, if the
.\"O .I dir
.\"O argument is non-NULL and appropriate, it is used.
-¤½¤ì°Ê³°¤Î¾ì¹ç¡¢
+それ以外の場合、
.I dir
-°ú¤¿ô¤¬ NULL ¤Ç¤Ê¤¤Ê¸»úÎó¤Ç¤«¤ÄŬÀڤʤ顢¤½¤ì¤òÍѤ¤¤ë¡£
+引き数が NULL でない文字列でかつ適切なら、それを用いる。
.TP
c)
.\"O Otherwise,
.\"O (as defined in
.\"O .IR <stdio.h> )
.\"O is used when appropriate.
-¤½¤ì°Ê³°¤Î¾ì¹ç¡¢
+それ以外の場合、
.RI ( <stdio.h>
-¤ÇÄêµÁ¤µ¤ì¤Æ¤¤¤ë)
+で定義されている)
.I P_tmpdir
-¤¬Å¬Àڤʤ顢¤½¤ì¤òÍѤ¤¤ë¡£
+が適切なら、それを用いる。
.TP
d)
.\"O Finally an implementation-defined directory may be used.
-ºÇ¸å¤Ë¼ÂÁõ¤ÇÄêµÁ¤µ¤ì¤¿¥Ç¥£¥ì¥¯¥È¥ê¤¬ÍѤ¤¤é¤ì¤ë¤³¤È¤Ë¤Ê¤ë¡£
+最後に実装で定義されたディレクトリが用いられることになる。
.PP
.\"O The string returned by
.\"O .BR tempnam ()
.\"O and hence should be freed by
.\"O .BR free (3).
.BR tempnam ()
-¤¬ÊÖ¤¹Ê¸»úÎó¤Ï
+が返す文字列は
.BR malloc (3)
-¤ò»È¤Ã¤Æ³ÎÊݤµ¤ì¤ë¡£¤½¤Î¤¿¤á¡¢
+を使って確保される。そのため、
.BR free (3)
-¤Ç²òÊü¤¹¤Ù¤¤Ç¤¢¤ë¡£
+で解放すべきである。
.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
+.SH 返り値
.\"O The
.\"O .BR tempnam ()
.\"O function returns a pointer to a unique temporary
.\"O filename, or NULL if a unique name cannot be generated.
.BR tempnam ()
-´Ø¿ô¤Ï¾¤È½Å¤Ê¤é¤Ê¤¤¥Æ¥ó¥Ý¥é¥ê¥Õ¥¡¥¤¥ë̾¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
-¾¤È½Å¤Ê¤é¤Ê¤¤Ì¾Á°¤¬À¸À®¤Ç¤¤Ê¤±¤ì¤Ð NULL ¤òÊÖ¤¹¡£
+関数は他と重ならないテンポラリファイル名へのポインタを返す。
+他と重ならない名前が生成できなければ NULL を返す。
.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
+.SH ã\82¨ã\83©ã\83¼
.TP
.B ENOMEM
.\"O Allocation of storage failed.
-ÊݸÎΰè¤Î³ä¤êÅö¤Æ¤Ë¼ºÇÔ¤·¤¿¡£
+保存領域の割り当てに失敗した。
.\"O .SH "CONFORMING TO"
-.SH ½àµò
+.SH 準拠
SVr4, 4.3BSD, POSIX.1-2001.
.\"O POSIX.1-2008 marks
.\"O .BR tempnam ()
.\"O as obsolete.
-POSIX.1-2008 ¤Ï
+POSIX.1-2008 は
.BR tempnam ()
-¤òÇÑ»ßͽÄê¤È¤·¤Æ¤¤¤ë¡£
+を廃止予定としている。
.\"O .SH NOTES
-.SH Ãí°Õ
+.SH 注意
.\"O Although
.\"O .BR tempnam ()
.\"O generates names that are difficult to guess,
.\"O or
.\"O .BR tmpfile (3).
.BR tempnam ()
-¤Ï¿ä¬¤¬Æñ¤·¤¤Ì¾Á°¤òÀ¸À®¤¹¤ë¤¬¡¢¤½¤ì¤Ë¤â¤«¤«¤ï¤é¤º¡¢
+は推測が難しい名前を生成するが、それにもかかわらず、
.BR tempnam ()
-¤¬¥Ñ¥¹Ì¾¤òÊÖ¤·¤Æ¤«¤é¡¢¥×¥í¥°¥é¥à¤¬¤½¤Î¥Õ¥¡¥¤¥ë¤ò¥ª¡¼¥×¥ó¤¹¤ë
-¤Þ¤Ç¤Î´Ö¤Ë¡¢ÊÌ¤Î¥×¥í¥°¥é¥à¤¬Æ±¤¸¥Ñ¥¹Ì¾¤Ç¡¢¥Õ¥¡¥¤¥ë¤ò
+がパス名を返してから、プログラムがそのファイルをオープンする
+までの間に、別のプログラムが同じパス名で、ファイルを
.BR open (2)
-¤ÇºîÀ®¤·¤¿¤ê¡¢¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤òºîÀ®¤·¤¿¤ê¤¹¤ë²ÄǽÀ¤¬¤¢¤ë¡£
-¤³¤ì¤Ï¥»¥¥å¥ê¥Æ¥£¥Û¡¼¥ë¤Ë¤Ä¤Ê¤¬¤ë²ÄǽÀ¤¬¤¢¤ë¡£
-¤½¤Î¤è¤¦¤Ê²ÄǽÀ¤ò²óÈò¤¹¤ë¤¿¤á¤Ë¤Ï¡¢
+で作成したり、シンボリックリンクを作成したりする可能性がある。
+これはセキュリティホールにつながる可能性がある。
+そのような可能性を回避するためには、
.BR open (2)
-¤Î
+の
.B O_EXCL
-¥Õ¥é¥°¤ò»È¤Ã¤Æ¥Ñ¥¹Ì¾¤ò¥ª¡¼¥×¥ó¤¹¤ì¤Ð¤è¤¤¡£
-¤â¤Ã¤È¤¤¤¤¤Î¤Ï¡¢
+フラグを使ってパス名をオープンすればよい。
+もっといいのは、
.BR mkstemp (3)
-¤ä
+や
.BR tmpfile (3)
-¤ò»È¤¦¤³¤È¤Ç¤¢¤ë¡£
+を使うことである。
.\"O SUSv2 does not mention the use of
.\"O .BR TMPDIR ;
.\"O On SVr4, the directory used under \fBd)\fP is
.\"O .I /tmp
.\"O (and this is what glibc does).
-SUSv2 ¤Ç¤Ï
+SUSv2 では
.B TMPDIR
-¤ËÉÕ¤¤¤Æ¸ÀµÚ¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
-glibc ¤Ï¡¢¥×¥í¥°¥é¥à¤¬ set-user-ID ¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¤Ë¸Â¤Ã¤Æ¤³¤ì¤òÍѤ¤¤ë¡£
-SVr4 ¤Ç¤Ï \fBd)\fP ¤Ç»ÈÍѤµ¤ì¤ë¥Ç¥£¥ì¥¯¥È¥ê¤ò
+に付いて言及されていない。
+glibc は、プログラムが set-user-ID されていない場合に限ってこれを用いる。
+SVr4 では \fBd)\fP で使用されるディレクトリを
.I /tmp
-¤ÈÄê¤á¤Æ¤¤¤ë (glibc ¤â¤³¤ÎÄ̤ê¤Ç¤¢¤ë)¡£
+と定めている (glibc もこの通りである)。
.LP
.\"O Because it dynamically allocates memory used to return the pathname,
.\"O .BR tempnam ()
.\"O is reentrant, and thus thread safe, unlike
.\"O .BR tmpnam (3).
-¥Ñ¥¹Ì¾¤òÊÖ¤¹¤Î¤Ë»ÈÍѤ¹¤ë¥á¥â¥ê¤òưŪ¤Ë³ÎÊݤ¹¤ë¤Î¤Ç¡¢
+パス名を返すのに使用するメモリを動的に確保するので、
.BR tmpnam (3)
-¤È°ã¤¤¡¢
+と違い、
.BR tempnam ()
-¤Ï¥ê¥¨¥ó¥È¥é¥ó¥È¤Ç¤¢¤ê¡¢¥¹¥ì¥Ã¥É¥»¡¼¥Õ¤Ç¤¢¤ë¡£
+はリエントラントであり、スレッドセーフである。
.LP
.\"O The
.\"O .BR tempnam ()
.\"O times,
.\"O the behavior is implementation defined.
.BR tempnam ()
-´Ø¿ô¤ÏºÇÂç
+関数は最大
.B TMP_MAX
-²ó¤Þ¤Ç¡¢¸Æ¤Ó½Ð¤µ¤ì¤ëÅ٤˰ۤʤëʸ»úÎó¤òºîÀ®¤¹¤ë
+回まで、呼び出される度に異なる文字列を作成する
.RB ( TMP_MAX
-¤Ï
+は
.I <stdio.h>
-¤ÇÄêµÁ¤µ¤ì¤Æ¤¤¤ë)¡£
-¤â¤·
+で定義されている)。
+もし
.B TMP_MAX
-²ó°Ê¾å¸Æ¤Ó½Ð¤µ¤ì¤¿¾ì¹ç¡¢Æ°ºî¤Ï¼ÂÁõ°Í¸¤Ç¤¢¤ë¡£
+回以上呼び出された場合、動作は実装依存である。
.LP
.\"O .BR tempnam ()
.\"O uses at most the first five bytes from
.\"O .IR pfx .
.BR tempnam ()
-¤ÏºÇÂç¤Ç
+は最大で
.I pfx
-¤ÎÀèƬ 5 ¥Ð¥¤¥È¤ò»ÈÍѤ¹¤ë¡£
+の先頭 5 バイトを使用する。
.\"O The glibc implementation of
.\"O .BR tempnam ()
.\"O will fail with the error
.\"O .B EEXIST
.\"O upon failure to find a unique name.
-¾¤È½Å¤Ê¤é¤Ê¤¤Ì¾Á°¤¬¸«¤Ä¤±¤é¤ì¤Ê¤«¤Ã¤¿¾ì¹ç¡¢glibc ¤Î
+他と重ならない名前が見つけられなかった場合、glibc の
.BR tempnam ()
-¤Î¼ÂÁõ¤Ï¥¨¥é¡¼
+ã\81®å®\9fè£\85ã\81¯ã\82¨ã\83©ã\83¼
.B EEXIST
-¤Ç¼ºÇÔ¤¹¤ë¡£
+で失敗する。
.\"O .SH BUGS
-.SH ¥Ð¥°
+.SH ã\83\90ã\82°
.\"O The precise meaning of "appropriate" is undefined;
.\"O it is unspecified how accessibility of a directory is determined.
-¡ÖŬÀڡפȤ¤¤¦¸ÀÍÕ¤ÎÀµ³Î¤Ê°ÕÌ£¤ÏÄêµÁ¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
-¥Ç¥£¥ì¥¯¥È¥ê¤ËÂФ·¤Æ¤É¤ÎÄøÅ٤Υ¢¥¯¥»¥¹¸¢¸Â¤¬É¬ÍפʤΤ«¤Ï»ØÄꤵ¤ì¤Æ¤¤¤Ê¤¤¡£
+「適切」という言葉の正確な意味は定義されていない。
+ディレクトリに対してどの程度のアクセス権限が必要なのかは指定されていない。
.\"O Never use this function.
.\"O Use
.\"O or
.\"O .BR tmpfile (3)
.\"O instead.
-·è¤·¤Æ¤³¤Î´Ø¿ô¤ò»È¤Ã¤Æ¤Ï¤Ê¤é¤Ê¤¤¡£Âå¤ï¤ê¤Ë
+決してこの関数を使ってはならない。代わりに
.BR mkstemp (3)
-¤«
+か
.BR tmpfile (3)
-¤ò»È¤¦¤³¤È¡£
+を使うこと。
.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR mkstemp (3),
.BR mktemp (3),
.BR tmpfile (3),
OSDN Git Service
