.\" -*- coding: UTF-8 -*- .\" Copyright (c) 1999 Andries Brouwer (aeb@cwi.nl) .\" .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" .\" 2003-11-15, aeb, added tmpnam_r .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH TMPNAM 3 "10. September 2010" "" Linux\-Programmierhandbuch .SH BEZEICHNUNG tmpnam, tmpnam_r \- einen Namen für eine temporäre Datei erzeugen .SH ÜBERSICHT .nf \fB#include \fP .sp \fBchar *tmpnam(char *\fP\fIs\fP\fB);\fP .fi .SH BESCHREIBUNG Die Funktion \fBtmpnam\fP() 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 \fIs\fP NULL ist, wird dieser Name in einem statischen Puffer generiert und könnte von nächsten \fBtmpnam\fP()\-Aufruf überschrieben werden. Falls \fIs\fP nicht NULL ist, wird der Name in das Zeichenfeld kopiert (das mindestens die Länge \fIL_tmpnam\fP hat), auf das \fIs\fP zeigt. Im Erfolgsfall wird \fIs\fP zurückgegeben. .LP Der erzeugte Pfadname hat das Pfad\-Präfix \fIP_tmpdir\fP. (Sowohl \fIL_tmpnam\fP als auch \fIP_tmpdir\fP sind in \fI\fP definiert, genauso wie das im Folgenden erwähnte \fBTMP_MAX\fP. .SH RÜCKGABEWERT Die Funktion \fBtmpnam\fP() gibt einen Zeiger auf den eindeutigen temporären Dateinamen zurück oder NULL, wenn kein eindeutiger Name generiert werden konnte. .SH FEHLER Es sind keine Fehler definiert. .SH "KONFORM ZU" SVr4, 4.3BSD, C89, C99, POSIX.1\-2001. POSIX.1\-2008 kennzeichnet \fBtmpnam\fP() als veraltet. .SH ANMERKUNGEN Die Funktion \fBtmpnam\fP() generiert jedesmal, wenn sie aufgerufen wird, eine andere Zeichenkette. Dies geschieht bis zu \fBTMP_MAX\fP Mal. Falls sie öfter als \fBTMP_MAX\fP Mal aufgerufen wird, wird ihr Verhalten durch die Implementierung definiert. .LP Obwohl \fBtmpnam\fP() 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 \fBopen\fP(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 \fBO_EXCL\fP von \fBopen\fP(2), um diesen Pfadnamen zu öffnen oder besser noch – benutzen Sie \fBmkstemp\fP(3) oder \fBtmpfile\fP(3). .LP Portierbare Anwendungen, die Threads benutzen, können \fBtmpnam\fP() nicht mit einem Argument aufrufen, das NULL ist, wenn entweder \fB_POSIX_THREADS\fP oder \fB_POSIX_THREAD_SAFE_FUNCTIONS\fP definiert sind. .LP Ein ursprünglicher POSIX\-Entwurf schlug eine \fBtmpnam_r\fP()\-Funktion vor, die definiert wurde wie folgt .sp .nf .in +4n char * tmpnam_r(char *s) { return s ? tmpnam(s) : NULL; } .in .fi .sp scheinbar als Warnung nicht NULL zu benutzen. Einige Systeme implementierten das. Um einen Glibc\-Prototypen für diese Version von \fI\fP zu bekommen, definieren Sie \fB_SVID_SOURCE\fP oder \fB_BSD_SOURCE\fP (vor dem Einbinden \fIirgendeiner\fP Header\-Datei). .SH FEHLER Benutzen Sie diese Funktion niemals. Benutzen Sie stattdessen \fBmkstemp\fP(3) oder \fBtmpfile\fP(3). .SH "SIEHE AUCH" \fBmkstemp\fP(3), \fBmktemp\fP(3), \fBtempnam\fP(3), \fBtmpfile\fP(3) .SH KOLOPHON Diese Seite ist Teil der Veröffentlichung 3.42 des Projekts Linux\-\fIman\-pages\fP. Eine Beschreibung des Projekts und Informationen, wie Fehler gemeldet werden können, finden sich unter http://www.kernel.org/doc/man\-pages/. .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Patrick Rother und Chris Leick 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 .