mkdtemp(3)

mktemp − 一意な一時ファイル名を作成

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

#include <unistd.h>

char *

mktemp(char *template);

int

mkstemp(char *template);

int

mkstemps(char *template, int suffixlen);

char *

mkdtemp(char *template);

解説

mktemp() 関数は、与えられたファイル名テンプレートの一部を書き換えてファイ ル名を作成します。このファイル名は、関数が呼ばれた時に存在していないこと が保証されており、アプリケーションでの使用に適しています。テンプレートと しては、 /tmp/temp.XXXXXX のように、任意のファイル名に数桁の文字 ‘X’ が付 いているものが使用されます。後ろに続く ‘X’ は、英数字の一意の組合せに置き 換えられます。 mktemp() が戻す一意的なファイル名の数は、 ‘X’ の数によって 決まります。 ‘X’ が 6 桁である場合、56800235584 (62 ** 6) 通りの可能な一 時ファイル名から mktemp() によって一つ選ばれます。

mkstemp() 関数は、テンプレートを同じように置き換え、モード 0600 でテンプ レートファイルを作成し、読み書き用としてオープンしたファイル記述子を返し ます。こうすることにより、ファイルの存在を確認することと使用するために オープンすることとの間の競合状態を避けられます。

mkstemps() は、テンプレートにサフィックスを含めることができることを除いて mkstemp() と同様に動作します。テンプレートは、 /tmp/tmpXXXXXXsuffix とい う形式である必要があります。 mkstemps() は、サフィックス文字列の長さを必 要とします。

mkdtemp() 関数は、テンプレートを mktemp(3) と同じように置き換え、モード 0700 でテンプレートディレクトリを作成します。

成功した場合、 mktemp() 関数と mkdtemp() 関数は、テンプレートへのポインタ を返し、失敗した場合 NULL を返します。 mkstemp() 関数と mkstemps() 関数 は、適切なファイルを作成できない場合に −1 を返します。どの関数呼出しでも エラーが発生すると、エラーコードがグローバル変数 errno に書き込まれます。

mkstemp(), mkstemps(), mkdtemp() 関数は、以下の値のうち 1 つを errno に設 定します。

テンプレートのパス名部分が、存在するディレクトリではあ りません。

mkstemp(), mkstemps(), mkdtemp() 関数は、 stat(2) 関数で規定されるどの値 も errno に設定する可能性があります。

mkstemp() 関数と mkstemps() 関数は、 open(2) 関数で規定されるどの値も errno に設定する可能性があります。

mkdtemp() 関数は、 mkdir(2) 関数で規定されるどの値も errno に設定する可能 性があります。

注

コアダンプを引き起こす問題としてよくあるものは、プログラマが、 mktemp(), mkstemp(), mkstemps(), mkdtemp() に読込み専用文字列を渡しているものです。 この問題は、 ISO/IEC 9899:1990 (‘‘ISO C89’’) コンパイラが普及する前に開発 されたプログラムで多く見られます。たとえば引数 "/tmp/tempfile.XXXXXX" を 指定して mkstemp() を呼び出すと、 mkstemp() が、指定された文字列定数を書 き換えようとしてコアダンプが起こります。問題を起こすプログラムが、このよ うな関数呼出しを頻繁に行っている場合は、メモリの書込み可能セグメントへ文 字列定数を保持するようにプログラムをコンパイルすることもできます。詳細に ついては、 gcc(1) を参照してください。

この関数群は推測可能なファイル名を生成しますが、 ‘X’ の数を多くし作成可能 な一時ファイル名の数を増やすことで、推測される危険を最小化します。 mktemp() では、あるファイルが存在するかのテスト ( mktemp() 関数呼び出しの 中) と、そのファイルを使用するためのオープン (その後のユーザアプリケー ションの中) との間で競合が発生し、これはセキュリティの面から見て、とても 危険です。 mkstemp() には競合状態がありませんので、可能な限り、この関数を 使うべきでしょう。もし mkstemp() が使用できない場合は、 mktemp() で生成さ れたファイル名を open(2) で開く時に O_EXCL フラグをつけるようにし、失敗し ていないか戻り値をテストすべきでしょう。こうすることによって、攻撃者が ファイルの内容を操作したり読んだりする意図を持ってファイルを既に作成して いても、プログラムが無闇に動作を継続することがなくなります。

chmod(2), getpid(2), mkdir(2), open(2), stat(2)

mktemp() 関数は、 Version 7 AT&T UNIX で登場しました。 mkstemp() 関数は、 4.4BSD で登場しました。 mkdtemp() 関数は、 OpenBSD 2.2 ではじめて登場し、 その後 FreeBSD 3.2 で登場しました。 mkstemps() は OpenBSD 2.4 ではじめて 登場し、その後 FreeBSD 3.4 で登場しました。

FreeBSD 10.0 February 11, 1998 FreeBSD 10.0