tempnam

Section: C Library Functions (3)
Updated: 2026-02-08
Index JM Home Page roff page
 

名前

tempnam - テンポラリファイルの名前を作成する  

ライブラリ

標準 C ライブラリ (libc,~-lc)  

書式

#include <stdio.h>

char *tempnam(const char *dir, const char *pfx);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

tempnam():

    Since glibc 2.19:
        _DEFAULT_SOURCE
    glibc 2.19 and earlier:
        _BSD_SOURCE || _SVID_SOURCE
 

説明

決してこの関数を使用しないこと。 代わりに mkstemp(3) か tmpfile(3) を使うこと。

tempnam() 関数はファイル名として正しい文字列へのポインターを返す。 このファイル名を持つファイルは、 tempnam() がチェックした時点においては存在しない (しなかった)。 pfx が NULL でない 5 バイト以内の文字列であれば、 生成されるパス名のうちのファイル名の部分は pfx から始まるものになる。 生成されるディレクトリの部分は、「適切」でなければならない (大抵の場合、「適切」であるためにはまず少なくとも 書き込み可能でなければならない)。

適切なディレクトリの探索は、以下の手順にしたがって行われる。

(1)
環境変数 TMPDIR が設定されていて、 その内容が適切なディレクトリの名前なら、それを用いる。
(2)
それ以外の場合、 dir 引数が NULL でない文字列でかつ適切なら、それを用いる。
(3)
それ以外の場合、 (<stdio.h> で定義されている) P_tmpdir が適切なら、それを用いる。
(4)
最後に実装で定義されたディレクトリが用いられることになる。

tempnam() が返す文字列は malloc(3) を使って確保される。そのため、 free(3) で解放すべきである。  

返り値

On success, the tempnam() function returns a pointer to a unique temporary filename. It returns NULL if a unique name cannot be generated, with errno set to indicate the error.  

エラー

ENOMEM
保存領域の割り当てに失敗した。
 

属性

この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース属性値
tempnam() Thread safetyMT-Safe env
 

標準規格

POSIX.1-2008.  

歴史

SVr4, 4.3BSD, POSIX.1-2001. Obsoleted in POSIX.1-2008.  

注意

tempnam() は推測が難しい名前を生成するが、それにもかかわらず、 tempnam() がパス名を返してから、プログラムがそのファイルをオープンする までの間に、別のプログラムが同じパス名で、ファイルを open(2) で作成したり、シンボリックリンクを作成したりする可能性がある。 これはセキュリティホールにつながる可能性がある。 そのような可能性を回避するためには、 open(2) の O_EXCL フラグを使ってパス名をオープンすればよい。 もっといいのは、 mkstemp(3) や tmpfile(3) を使うことである。

SUSv2 does not mention the use of TMPDIR; glibc will use it only when the program is not set-user-ID. On SVr4, the directory used under (4) is /tmp (and this is what glibc does).

パス名を返すのに使用するメモリーを動的に確保するので、 tmpnam(3) と違い、 tempnam() はリエントラントであり、スレッドセーフである。

tempnam() 関数は最大 TMP_MAX 回まで、呼び出される度に異なる文字列を作成する (TMP_MAX は <stdio.h> で定義されている)。 もし TMP_MAX 回以上呼び出された場合、動作は実装依存である。

tempnam() は最大で pfx の先頭 5 バイトを使用する。

他と重ならない名前が見つけられなかった場合、glibc の tempnam() の実装はエラー EEXIST で失敗する。  

バグ

「適切」という言葉の正確な意味は定義されていない。 ディレクトリに対してどの程度のアクセス権限が必要なのかは指定されていない。  

関連項目

mkstemp(3), mktemp(3), tmpfile(3), tmpnam(3)


 

Index

名前
ライブラリ
書式
説明
返り値
エラー
属性
標準規格
歴史
注意
バグ
関連項目

This document was created by man2html, using the manual pages.