BEZEICHNUNG¶

dup, dup2 - dupliziert einen Datei-Deskriptor

BIBLIOTHEK¶

Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT¶

#include <unistd.h>

int dup(int altdd);
int dup2(int altdd, int neudd);

#define _GNU_SOURCE             /* siehe feature_test_macros(7) */
#include <fcntl.h>              /* Definition der O_*-Konstanten */
#include <unistd.h>

int dup3(int altdd, int neudd, int schalter);

BESCHREIBUNG¶

Der Systemaufruf dup() reserviert einen neuen Dateideskriptor, der sich auf die gleiche offene Dateideskription wie der Deskriptor altdd bezieht. (Für eine Beschreibung von offenen Dateideskriptionen, siehe open(2).) Die neue Dateideskriptornummer ist garantiert der Dateideskriptor mit der niedrigsten Nummer, die in dem aufrufenden Prozess verfügbar war.

Nach der erfolgreichen Rückkehr können die alten und neuen Datei-Deskriptoren synonym benutzt werden. Da die zwei Dateideskriptoren sich auf die gleichen offenen Dateideskriptionen beziehen, teilen sie sich dadurch Dateiversatz (file offset) und Dateistatusschalter. Falls der Dateiversatz zum Beispiel durch lseek(2) auf einem der Dateideskriptoren geändert wurde, wird der Versatz auch für den anderen Dateideskriptor verändert.

Die beiden Dateideskriptoren teilen sich keine Datei-Deskriptor-Schalter (den Schalter »close-on-exec«). Der Schalter »close-on-exec« (FD_CLOEXEC; siehe fcntl(2)) für das Duplikat ist aus.

RÜCKGABEWERT¶

Bei Erfolg geben diese Systemaufrufe den neuen Dateideskriptor zurück. Im Fehlerfall wird -1 zurückgegeben und errno gesetzt, um den Fehler anzuzeigen.

FEHLER¶

EBADF

altdd ist kein Deskriptor für eine geöffnete Datei.

EBADF

neudd liegt außerhalb des erlaubten Bereichs für Datei-Deskriptoren (siehe die Erläuterung von RLIMIT_NOFILE in getrlimit(2)).

EBUSY

(nur Linux) Dies könnte von dup2() oder dup3() während einer Gleichzeitigkeitsbedingung mit open(2) und dup() zurückgegeben werden.

EINTR

Der Aufruf von dup2() oder dup3() wurde von einem Signal unterbrochen; lesen Sie signal(7).

EINVAL

(dup3()) schalter enthalten einen ungültigen Wert.

EINVAL

(dup3()) altdd entsprach neudd.

EMFILE

Die Beschränkung der Anzahl offener Datei-Deskriptoren pro Prozess wurde erreicht (siehe die Erläuterung von RLIMIT_NOFILE in getrlimit(2)).

STANDARDS¶

dup()

dup2()

POSIX.1-2008.

dup3()

Linux.

GESCHICHTE¶

dup()

dup2()

POSIX.1-2001, SVr4, 4.3BSD.

dup3()

Linux 2.6.27, glibc 2.9.

ANMERKUNGEN¶

Der von dup2 zurückgegebene Fehler unterscheidet sich von dem, der von fcntl(…, F_DUPFD,…) zurückgegeben wird, wenn neudd außerhalb des Bereiches ist. Weiterhin gibt dup2 auf einigen Systemen EINVAL wie F_DUPFD zurück.

Falls neudd geöffnet war, sind alle Fehler verlorengegangen, die in dieser Zeit an close(2) gemeldet worden wären. Falls dies von Bedeutung ist, ist die korrekte Herangehensweise, – sofern das Programm nicht in einem einzigen Thread läuft und keine Dateideskriptoren in Signalverarbeitungsprogrammen reserviert –, neudd vor dem Aufruf von dup2() wegen der oben beschriebenen Race Conditions nicht zu schließen. Stattdessen kann Code wie der folgende verwendet werden:

/* Erhält ein Duplikat von »neudd«, das nachfolgend benutzt


   werden kann, um auf Fehler von close() zu prüfen. Ein


   EBADF-Fehler bedeutet, dass »neudd« nicht geöffnet war. */
tmpfd = dup(newfd);
if (tmpfd == -1 && errno != EBADF) {


    /* behandelt unerwartete dup()-Fehler */
}
/* »altdd« atomar auf »neudd« duplizieren */
if (dup2(oldfd, newfd) == -1) {


    /* dup2()-Fehler behandeln */
}
/* Nun wird auf close()-Fehler für die Datei, auf die sich


   »neudd« ursprünglich bezog, geprüft. */
if (tmpfd != -1) {


    if (close(tmpfd) == -1) {


        /* close-Fehler behandeln */


    }
}

SIEHE AUCH¶

close(2), fcntl(2), open(2), pidfd_getfd(2)

ÜBERSETZUNG¶

Die deutsche Übersetzung dieser Handbuchseite wurde von Aldo Valente <aldo@dagobar.rhein.de>, Chris Leick <c.leick@vollbio.de> und Helge Kreutzmann <debian@helgefjell.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 die Mailingliste der Übersetzer.