.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
-.\" Japanese Version Copyright (c) 1997-2000 Kazuyuki Tanisako and NAKANO Takeo
-.\" all rights reserved.
-.\" Translated 1997-05-17, Kazuyuki Tanisako <tanisako@osa.dec-j.co.jp>
-.\" Modified 1997-05-27, Kazuyuki Tanisako <tanisako@osa.dec-j.co.jp>
-.\" Modified 1998-02-04, Kazuyuki Tanisako <tanisako@osa.dec-j.co.jp>
-.\" Updated and Modified 2000-10-12, NAKANO Takeo <nakano@apm.seikei.ac.jp>
-.\" 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 ポインター
+.\" This file was generated with po4a. Translate the source file.
.\"
-.TH TEMPNAM 3 2008-08-06 "" "Linux Programmer's Manual"
+.\"*******************************************************************
+.TH TEMPNAM 3 2008\-08\-06 "" "Linux Programmer's Manual"
.SH 名前
tempnam \- テンポラリファイルの名前を作成する
.SH 書式
.nf
-.B #include <stdio.h>
+\fB#include <stdio.h>\fP
.sp
-.BI "char *tempnam(const char *" dir ", const char *" pfx );
+\fBchar *tempnam(const char *\fP\fIdir\fP\fB, const char *\fP\fIpfx\fP\fB);\fP
.fi
.sp
.in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
-.BR tempnam ():
-_BSD_SOURCE || _SVID_SOURCE
+\fBtempnam\fP(): _BSD_SOURCE || _SVID_SOURCE
.SH 説明
-.BR tempnam ()
-関数はファイル名として正しい文字列へのポインターを返す。
-このファイル名を持つファイルは、
-.BR tempnam ()
-がチェックした時点においては存在しない (しなかった)。
-.I pfx
-が NULL でない 5 バイト以内の文字列であれば、
-生成されるパス名のうちのファイル名の部分は
-.I pfx
-から始まるものになる。
-生成されるディレクトリの部分は、「適切」でなければならない
-(大抵の場合、「適切」であるためにはまず少なくとも
-書き込み可能でなければならない)。
+\fBtempnam\fP() 関数はファイル名として正しい文字列へのポインタを返す。 このファイル名を持つファイルは、 \fBtempnam\fP()
+がチェックした時点においては存在しない (しなかった)。 \fIpfx\fP が NULL でない 5 バイト以内の文字列であれば、
+生成されるパス名のうちのファイル名の部分は \fIpfx\fP から始まるものになる。 生成されるディレクトリの部分は、「適切」でなければならない
+(大抵の場合、「適切」であるためにはまず少なくとも 書き込み可能でなければならない)。
適切なディレクトリの探索は、以下の手順にしたがって行われる。
-.TP 3
+.TP 3
a)
-環境変数
-.B TMPDIR
-が設定されていて、
-その内容が適切なディレクトリの名前なら、それを用いる。
-.TP
+環境変数 \fBTMPDIR\fP が設定されていて、 その内容が適切なディレクトリの名前なら、それを用いる。
+.TP
b)
-それ以外の場合、
-.I dir
-引き数が NULL でない文字列でかつ適切なら、それを用いる。
-.TP
+それ以外の場合、 \fIdir\fP 引き数が NULL でない文字列でかつ適切なら、それを用いる。
+.TP
c)
-それ以外の場合、
-.RI ( <stdio.h>
-で定義されている)
-.I P_tmpdir
-が適切なら、それを用いる。
-.TP
+それ以外の場合、 (\fI<stdio.h>\fP で定義されている) \fIP_tmpdir\fP が適切なら、それを用いる。
+.TP
d)
最後に実装で定義されたディレクトリが用いられることになる。
.PP
-.BR tempnam ()
-が返す文字列は
-.BR malloc (3)
-を使って確保される。そのため、
-.BR free (3)
-で解放すべきである。
+\fBtempnam\fP() が返す文字列は \fBmalloc\fP(3) を使って確保される。そのため、 \fBfree\fP(3) で解放すべきである。
.SH 返り値
-.BR tempnam ()
-関数は他と重ならないテンポラリファイル名へのポインタを返す。
-他と重ならない名前が生成できなければ NULL を返す。
+\fBtempnam\fP() 関数は他と重ならないテンポラリファイル名へのポインタを返す。 他と重ならない名前が生成できなければ NULL を返す。
.SH エラー
-.TP
-.B ENOMEM
+.TP
+\fBENOMEM\fP
保存領域の割り当てに失敗した。
.SH 準拠
-SVr4, 4.3BSD, POSIX.1-2001.
-POSIX.1-2008 は
-.BR tempnam ()
-を廃止予定としている。
+SVr4, 4.3BSD, POSIX.1\-2001. POSIX.1\-2008 は \fBtempnam\fP() を廃止予定としている。
.SH 注意
-.BR tempnam ()
-は推測が難しい名前を生成するが、それにもかかわらず、
-.BR tempnam ()
-がパス名を返してから、プログラムがそのファイルをオープンする
-までの間に、別のプログラムが同じパス名で、ファイルを
-.BR open (2)
-で作成したり、シンボリックリンクを作成したりする可能性がある。
-これはセキュリティホールにつながる可能性がある。
-そのような可能性を回避するためには、
-.BR open (2)
-の
-.B O_EXCL
-フラグを使ってパス名をオープンすればよい。
-もっといいのは、
-.BR mkstemp (3)
-や
-.BR tmpfile (3)
-を使うことである。
+\fBtempnam\fP() は推測が難しい名前を生成するが、それにもかかわらず、 \fBtempnam\fP()
+がパス名を返してから、プログラムがそのファイルをオープンする までの間に、別のプログラムが同じパス名で、ファイルを \fBopen\fP(2)
+で作成したり、シンボリックリンクを作成したりする可能性がある。 これはセキュリティホールにつながる可能性がある。 そのような可能性を回避するためには、
+\fBopen\fP(2) の \fBO_EXCL\fP フラグを使ってパス名をオープンすればよい。 もっといいのは、 \fBmkstemp\fP(3) や
+\fBtmpfile\fP(3) を使うことである。
-SUSv2 では
-.B TMPDIR
-に付いて言及されていない。
-glibc は、プログラムが set-user-ID されていない場合に限ってこれを用いる。
-SVr4 では \fBd)\fP で使用されるディレクトリを
-.I /tmp
-と定めている (glibc もこの通りである)。
+SUSv2 では \fBTMPDIR\fP に付いて言及されていない。 glibc は、プログラムが set\-user\-ID
+されていない場合に限ってこれを用いる。 SVr4 では \fBd)\fP で使用されるディレクトリを \fI/tmp\fP と定めている (glibc
+もこの通りである)。
.LP
-パス名を返すのに使用するメモリを動的に確保するので、
-.BR tmpnam (3)
-と違い、
-.BR tempnam ()
+パス名を返すのに使用するメモリを動的に確保するので、 \fBtmpnam\fP(3) と違い、 \fBtempnam\fP()
はリエントラントであり、スレッドセーフである。
.LP
-.BR tempnam ()
-関数は最大
-.B TMP_MAX
-回まで、呼び出される度に異なる文字列を作成する
-.RB ( TMP_MAX
-は
-.I <stdio.h>
-で定義されている)。
-もし
-.B TMP_MAX
-回以上呼び出された場合、動作は実装依存である。
+\fBtempnam\fP() 関数は最大 \fBTMP_MAX\fP 回まで、呼び出される度に異なる文字列を作成する (\fBTMP_MAX\fP は
+\fI<stdio.h>\fP で定義されている)。 もし \fBTMP_MAX\fP 回以上呼び出された場合、動作は実装依存である。
.LP
-.BR tempnam ()
-は最大で
-.I pfx
-の先頭 5 バイトを使用する。
+\fBtempnam\fP() は最大で \fIpfx\fP の先頭 5 バイトを使用する。
-他と重ならない名前が見つけられなかった場合、glibc の
-.BR tempnam ()
-の実装はエラー
-.B EEXIST
-で失敗する。
+他と重ならない名前が見つけられなかった場合、glibc の \fBtempnam\fP() の実装はエラー \fBEEXIST\fP で失敗する。
.SH バグ
-「適切」という言葉の正確な意味は定義されていない。
-ディレクトリに対してどの程度のアクセス権限が必要なのかは指定されていない。
+「適切」という言葉の正確な意味は定義されていない。 ディレクトリに対してどの程度のアクセス権限が必要なのかは指定されていない。
-決してこの関数を使ってはならない。代わりに
-.BR mkstemp (3)
-か
-.BR tmpfile (3)
-を使うこと。
+決してこの関数を使ってはならない。代わりに \fBmkstemp\fP(3) か \fBtmpfile\fP(3) を使うこと。
.SH 関連項目
-.BR mkstemp (3),
-.BR mktemp (3),
-.BR tmpfile (3),
-.BR tmpnam (3)
+\fBmkstemp\fP(3), \fBmktemp\fP(3), \fBtmpfile\fP(3), \fBtmpnam\fP(3)
OSDN Git Service
