tmpnam_r(3) einen Namen für eine temporäre Datei erzeugen

Other Alias

tmpnam

ÜBERSICHT

#include <stdio.h>


char *tmpnam(char *s);

BESCHREIBUNG

Hinweis: Vermeiden Sie die Verwendung von tmpnam(); verwenden Sie stattdessen mkstemp(3) oder tmpfile(3).

Die Funktion tmpnam() gibt einen Zeiger auf eine Zeichenkette zurück, die ein gültiger Dateiname ist, und sorgt dafür, dass zu diesem Zeitpunkt keine Datei mit diesem Namen existiert, so dass ahnungslose Programmierer denken könnten, es sei ein geeigneter Name für eine temporäre Datei. Falls das Argument s NULL ist, wird dieser Name in einem statischen Puffer generiert und könnte von nächsten tmpnam()-Aufruf überschrieben werden. Falls s nicht NULL ist, wird der Name in das Zeichenfeld kopiert (das mindestens die Länge L_tmpnam hat), auf das s zeigt. Im Erfolgsfall wird s zurückgegeben.

Der erzeugte Pfadname hat das Pfad-Präfix P_tmpdir. (Sowohl L_tmpnam als auch P_tmpdir sind in <stdio.h> definiert, genauso wie das im Folgenden erwähnte TMP_MAX.

RÜCKGABEWERT

Die Funktion tmpnam() gibt einen Zeiger auf den eindeutigen temporären Dateinamen zurück oder NULL, wenn kein eindeutiger Name generiert werden konnte.

FEHLER

Es sind keine Fehler definiert.

ATTRIBUTE

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
SchnittstelleAttributWert
tmpnam() Multithread-FähigkeitMT-Unsafe race:tmpnam/!s
tmpnam_r() Multithread-FähigkeitMT-Safe

KONFORM ZU

SVr4, 4.3BSD, C89, C99, POSIX.1-2001. POSIX.1-2008 kennzeichnet tmpnam() als veraltet.

ANMERKUNGEN

Die Funktion tmpnam() generiert jedesmal, wenn sie aufgerufen wird, eine andere Zeichenkette. Dies geschieht bis zu TMP_MAX Mal. Falls sie öfter als TMP_MAX Mal aufgerufen wird, wird ihr Verhalten durch die Implementierung definiert.

Obwohl tmpnam() Namen generiert, die schwer zu erahnen sind, ist es dennoch möglich, dass in der Zeit zwischen der Rückgabe des Pfadnamens und der Zeit, in der er vom Programm geöffnet wird, ein anderes Programm einen Pfadnamen mit open(2) erzeugt oder ihn als symbolischen Link erstellt. Dies kann zu Sicherheitslücken führen. Um solche Möglichkeiten zu vermeiden, benutzen Sie den Schalter O_EXCL von open(2), um diesen Pfadnamen zu öffnen oder besser noch – benutzen Sie mkstemp(3) oder tmpfile(3).

Portierbare Anwendungen, die Threads benutzen, können tmpnam() nicht mit einem Argument aufrufen, das NULL ist, wenn entweder _POSIX_THREADS oder _POSIX_THREAD_SAFE_FUNCTIONS definiert sind.

Ein ursprünglicher POSIX-Entwurf schlug eine tmpnam_r()-Funktion vor, die wurde wie folgt definiert

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

anscheinend als Warnung, nicht NULL zu verwenden. Einige Systeme implementieren es und eine Implementierung wird von Glibc bereitgestellt.

FEHLER

Benutzen Sie diese Funktion niemals. Benutzen Sie stattdessen mkstemp(3) oder tmpfile(3).

KOLOPHON

Diese Seite ist Teil der Veröffentlichung 4.06 des Projekts Linux-man-pages. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Patrick Rother <[email protected]> und Chris Leick <[email protected]> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an <[email protected]>.