Scroll to navigation

TMPNAM(3) Linux-Programmierhandbuch TMPNAM(3)

BEZEICHNUNG

tmpnam, tmpnam_r - einen Namen für eine temporäre Datei erzeugen

ÜBERSICHT

#include <stdio.h>

char *tmpnam(char *s);
char *tmpnam_r(char *s);


Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

tmpnam_r()

Seit Glibc 2.19:
_DEFAULT_SOURCE
Bis einschließlich Glibc 2.19:
_BSD_SOURCE || _SVID_SOURCE

BESCHREIBUNG

Hinweis: Vermeiden Sie die Verwendung dieser Funktionen; 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.

Die Funktion tmpnam_r() erledigt die gleiche Aufgabe wie tmpnam(), liefert aber NULL (um einen Fehler anzuzeigen) zurück, falls s NULL ist.

RÜCKGABEWERT

Diese Funktionen geben 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.
Schnittstelle Attribut Wert
tmpnam() Multithread-Fähigkeit MT-Unsafe race:tmpnam/!s
tmpnam_r() Multithread-Fähigkeit MT-Safe

KONFORM ZU

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

tmpnam_r() ist eine nicht standardisierte Erweiterung, die auch auf einigen anderen Systemen verfügbar ist.

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 diese Funktionen 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.

FEHLER

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

SIEHE AUCH

mkstemp(3), mktemp(3), tempnam(3), tmpfile(3)

KOLOPHON

Diese Seite ist Teil der Veröffentlichung 4.16 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 <krd@gulu.net> und Chris Leick <c.leick@vollbio.de> 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 <debian-l10n-german@lists.debian.org>.

15. September 2017