TMPFILE

Section: C Library Functions (3)
索引 jman

BSD mandoc
 

索引

名称

tempnam tmpfile tmpnam - 一時ファイルルーチン  

索引

ライブラリ

Lb libc  

索引

書式

In stdio.h Ft FILE * Fn tmpfile void Ft char * Fn tmpnam char *str Ft char * Fn tempnam const char *tmpdir const char *prefix  

索引

解説

Fn tmpfile 関数は、 mkstemp(3) ルーチンによって返されたファイル記述子に 結合されたストリームへのポインタを返します。 作成されたファイルは Fn tmpfile 関数から返る前にリンクが削除されます。 そのため、そのファイルへの最後の参照が閉じられた時に、 ファイルは自動的に削除されます。 そのファイルは、アクセス値 `w+' によって開かれます。 TMPDIR が設定されている場合、ファイルは、この環境変数によって決定される ディレクトリに作成されます。 TMPDIR が設定されていない場合のデフォルト値は /tmp です。

Fn tmpnam 関数は、過去のある不特定の時点で P_tmpdir ディレクトリに存在していたファイルを参照していたものではない ファイル名へのポインタを返します。 P_tmpdir は、インクルードファイル Aq Pa stdio.h の中で定義されています。 引数 Fa str が NULL でない場合は、ファイル名はそれが参照するバッファにコピーされます。 それ以外の場合は、ファイル名は静的バッファにコピーされます。 どちらの場合でも、 Fn tmpnam 関数はそのファイル名へのポインタを返します。

Fa str により参照されるバッファの長さは、少なくとも L_tmpnam バイトなければなりません。 L_tmpnam は、インクルードファイル Aq Pa stdio.h の中で定義されています。

Fn tempnam 関数は、 Fn tmpnam 関数と同じようなものですが、一時ファイルを収容するディレクトリと ファイル名プレフィックスを指定する機能を持っています。

一時ファイルを保存するディレクトリとしては、環境変数 TMPDIR (これが設定されている場合)、引数 Fa tmpdir (これが NULL でない場合)、ディレクトリ P_tmpdir ディレクトリ /tmp が、この順番で試されます。

ファイル名プレフィックスを指定するためには、値が NULL でない場合は引数 Fa prefix が使われ、これが作成されるファイル名の最初の部分になります。 Fn tempnam 関数は、ファイル名を保存するメモリを割り当てます。 返されたポインタは、 free(3) への次に続く引数として使うことができます。  

索引

戻り値

Fn tmpfile 関数は、成功した場合には開いたファイルストリームへのポインタを、 エラーの場合には NULL ポインタを返します。

Fn tmpnam および Fn tempfile 関数は、成功した場合にはファイル名へのポインタを、 エラーの場合には NULL ポインタを返します。  

索引

エラー

Fn tmpfile 関数が失敗した場合、ライブラリ関数 fdopen(3) または mkstemp(3) で規定されるエラーのいずれかが、グローバル変数 errno に設定される場合があります。

Fn tmpnam 関数が失敗した場合、ライブラリ関数 mktemp(3) で規定されるエラーのいずれかが errno が設定される場合があります。

Fn tempnam 関数が失敗した場合、ライブラリ関数 malloc(3) または mktemp(3) で規定されるエラーのいずれかが errno が設定される場合があります。  

索引

関連項目

mkstemp(3), mktemp(3)  

索引

規格

Fn tmpfile および Fn tmpnam 関数は、 St -isoC に適合しています。  

索引

バグ

これらのインタフェースは、System V および ANSI との互換性のみのために提供されています。 mkstemp(3) インタフェースの使用を強く推奨します。

これらのインタフェースには (古い mktemp(3) インタフェースと同様に)、4 つの重大な問題があります。 まず第一に、ファイル名選択とファイル作成および削除の間には 明らかな競合があります。 第二に、ほとんどの古いシステムでは、ファイル名がリサイクルされるまでには、 限られた数 (通常は 26) の一時ファイル名しか使えないことです。 第三に、これらの関数 (および mktemp(3) ) の System V における実装は、一時ファイル作成の可否を決めるために access(2) 関数を用いていることです。 これは、setuid および setgid プログラムに対して 明らかな問題を派生させ、このようなプログラムにこれらの インタフェースを移植して使うことを複雑にします。 最後に、一時ファイルを作成する許可に関する指定がありません。

この実装にはこれらの欠陥はありませんが、移植可能な ソフトウェアはそれを頼りにすることはできません。 特に、 Fn tmpfile インタフェースは、ユーザが一時ファイルを公開して読み書き可能にすることを 望まない可能性がある場合は、他のシステム上で使用されることが予想される ソフトウェアの中では使うべきではありません。


 

索引

Index

名称
ライブラリ
書式
解説
戻り値
エラー
関連項目
規格
バグ

jman



Time: 07:07:14 GMT, January 12, 2009