BEZEICHNUNG

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

ÜBERSICHT

       #include <stdio.h>

       char *tmpnam(char *s);

BESCHREIBUNG

       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

   Multithreading (siehe pthreads(7))
       Die  Funktion  tmpnam()  ist  mit  einigen  Ausnahmen  Thread-sicher.  Falls sie mit einem
       NULL-Parameter aufgerufen wird, ist sie nicht Thread-sicher.

       Die Funktion tmpnam_r() ist nicht Thread-sicher.

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 definiert wurde
       wie folgt

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

       scheinbar als Warnung nicht NULL zu benutzen. Einige Systeme implementierten das. Um einen
       Glibc-Prototypen  für diese Version von <stdio.h> zu bekommen, definieren Sie _SVID_SOURCE
       oder _BSD_SOURCE (vor dem Einbinden irgendeiner Header-Datei).

FEHLER

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

SIEHE AUCH

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

KOLOPHON

       This page is part of release 3.54 of the Linux man-pages project.  A  description  of  the
       project,     and    information    about    reporting    bugs,    can    be    found    at
       http://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>.

                                          21. Juni 2013                                 TMPNAM(3)