名前¶

書式¶

#include <stdio.h>

char *tmpnam(char *s);

説明¶

tmpnam() 関数は、ファイル名に使える文字列へのポインターを返す。 ある時点では同じ名前を持つファイルが存在しないファイル名が返されるので、 幼稚なプログラマはこの文字列が一時ファイルのファイル名として 適していると考えるかもしれない。 引き数 s が NULL なら、この名前は内部の静的バッファーに作成され、 次に tmpnam() 関数が呼び出された時に上書きされる。 s が NULL でなければ、ファイル名は s が指す (少なくとも L_tmpnam の長さを持つ) 文字配列にコピーされ、 成功した場合は s が返される。

作成されるパス名は、ディレクトリの部分に P_tmpdir が使われる。 (L_tmpnam と P_tmpdir は、以下で説明する TMP_MAX 同様 <stdio.h> で定義されている。)

返り値¶

エラー¶

属性¶

準拠¶

注意¶

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

移植性が必要な、スレッドを使ったアプリケーションでは、 _POSIX_THREADS か _POSIX_THREAD_SAFE_FUNCTIONS が定義されている場合に、 tmpnam() 関数を NULL 引き数で呼び出してはならない。

POSIX 草案では、関数 tmpnam_r() を使うことを提案している。 この関数は、以下のように定義されており、 NULL を使わないようにという警告の意味で NULL を別扱いしている。

char *
tmpnam_r(char *s)
{
    return s ? tmpnam(s) : NULL;
}

数は少ないが、この関数を実装しているシステムもある。 この関数の glibc のプロトタイプを <stdio.h> から得るには、 (「どの」ヘッダーファイルをインクルードするよりも前に) _SVID_SOURCE か _BSD_SOURCE を定義しておく必要がある。

バグ¶

関連項目¶

この文書について¶