chdir

BEZEICHNUNG

chdir, fchdir - aktuelles Arbeitsverzeichnis wechseln

BIBLIOTHEK

Standard-C-Bibliothek ( libc, -lc)

ÜBERSICHT

#include <unistd.h>

int chdir(const char *Pfad);
int fchdir(int dd);

fchdir():

_XOPEN_SOURCE >= 500
    || /* Seit Glibc 2.12: */ _POSIX_C_SOURCE >= 200809L
    || /* Glibc bis zu einschließlich 2.19: */ _BSD_SOURCE

BESCHREIBUNG

chdir() ändert das aktuelle Verzeichnis in das durch Pfad angegebene Verzeichnis. fchdir() ist identisch mit chdir(), jedoch wird das Verzeichnis als geöffneter Dateideskriptor übergeben.

RÜCKGABEWERT

Bei Erfolg wird Null zurückgegeben. Bei einem Fehler wird -1 zurückgegeben und errno gesetzt, um den Fehler anzuzeigen.

FEHLER

Abhängig vom Dateisystem können andere Fehler auftreten und zurückgegeben werden. Die folgende Auflistung nennt lediglich die allgemeineren Fehler von chdir():

EACCES

Dem Prozess ist nicht erlaubt, eine Komponente von Pfad zu durchsuchen. (siehe auch path_resolution(8))

EFAULT

Pfad zeigt aus dem für Sie zugänglichen Adressraum heraus.

EIO

Es ist ein E/A-Fehler (engl. I/O) aufgetreten.

ELOOP

Bei der Auflösung von Pfad wurden zu viele symbolische Links gefunden.

ENAMETOOLONG

Pfad ist zu lang.

ENOENT

Das in Pfad angegebene Verzeichnis existiert nicht.

ENOMEM

Es war nicht genügend Kernelspeicher verfügbar.

ENOTDIR

Eine Komponente von Pfad ist kein Verzeichnis.

Die folgende Auflistung nennt allgemeine Fehler von fchdir():

EACCES

Es ist nicht erlaubt, das durch dd angegebene Verzeichnis zu durchsuchen.

EBADF

dd ist kein zulässiger Dateideskriptor.

ENOTDIR

dd bezieht sich nicht auf ein Verzeichnis.

STANDARDS

POSIX.1-2001, POSIX.1-2008, SVr4, 4.4BSD.

ANMERKUNGEN

Das aktuelle Verzeichnis ist der Ausgangspunkt für die Auswertung relativer Pfadnamen. Diese beginnen nicht mit »/«. Ein mit fork(2) erzeugter Kindprozess erbt das aktuelle Verzeichnis seines Elternprozesses. Das aktuelle Verzeichnis wird von execve(2) nicht verändert.

SIEHE AUCH

chroot(2), getcwd(3), path_resolution(7)

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Daniel Kobras <[email protected]>, Martin Eberhard Schauer <[email protected]> und Mario Blättermann <[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 die Mailingliste der Übersetzer