Provided by: manpages-de-dev_2.5-1_all 
BEZEICHNUNG
pivot_root - die Dateisystemwurzel ändern
ÜBERSICHT
int pivot_root(const char *neue_Wurzel, const char *alte_Wurzel);
Hinweis: Es gibt keinen Glibc-Wrapper für diesen Systemaufruf; siehe ANMERKUNGEN.
BESCHREIBUNG
pivot_root verschiebt die Dateisystemwurzel des aktuellen Prozesses in das Verzeichnis
alte_Wurzel und macht neue_Wurzel zur neuen Dateisystemwurzel.
Der typische Anwendungsfall von pivot_root() ist während des Systemstarts, wenn das System
ein temporäres Wurzeldateisystem einhängt, zum Beispiel ein initrd. Danach wird das reale
Wurzeldateisystem eingehängt und eventuell in die aktuelle Wurzel aller relevanten
Prozesse und Threads verwandelt.
pivot_root() kann die aktuelle Wurzel und das aktuelle Arbeitsverzeichnis von Prozessen
und Threads ändern, welche das alte Wurzelverzeichnis nutzen, muss dies aber nicht. Der
Prozess, welcher pivot_root() aufruft, muss sicherstellen, dass Prozesse mit Wurzel- oder
aktuellem Arbeitsverzeichnis in jedem Fall korrekt arbeiten. Ein einfacher Weg hierzu ist
die Änderung von Wurzel- und aktuellem Arbeitsverzeichnis auf die neue_Wurzel, bevor
pivot_root() aufgerufen wird.
Der vorige Absatz ist absichtlich etwas ungenau, da sich die Implementation von
pivot_root() in der Zukunft ändern kann. Zum Zeitpunkt der Erstellung dieses Dokuments
ändert pivot_root() das Wurzel- und Arbeitsverzeichnis jedes Prozesses oder Threads auf
die neue_Wurzel, falls diese auf das alte Wurzelverzeichnis zeigen. Dies ist notwendig,
damit die Kernel-Threads nicht das alte Wurzelverzeichnis weiterhin mit ihrem alten
Wurzel- und Arbeitsverzeichnis belegen, selbst wenn sie in keiner Weise auf das
Dateisystem zugegriffen haben. In der Zukunft könnte ein neuer Mechanismus bewirken, dass
die Kernel-Threads auf jeglichen Zugriff auf das Dateisystem verzichten, so dass dieser
recht unsichere alte Mechanismus aus pivot_root() entfernt werden kann.
Beachten Sie, dass sich das auch auf den aufrufenden Prozess auswirkt: pivot_root() kann
sein aktuelles Arbeitsverzeichnis ändern, muss aber nicht. Es wird daher empfohlen,
chdir("/") unmittelbar nach pivot_root() aufzurufen.
Die folgenden Einschränkungen gelten für die neue_Wurzel und die alte_Wurzel:
- Sie müssen Verzeichnisse sein.
- Die neue_Wurzel und die alte_Wurzel dürfen sich nicht im gleichen Dateisystem befinden
wie die aktuelle Wurzel.
- Die alte_Wurzel muss sich unterhalb der neuen_Wurzel befinden, das heißt, Hinzufügen
einer von null verschiedenen Anzahl von /.. zur Zeichenkette, die auf die alte_Wurzel
zeigt, muss das gleiche Verzeichnis wie die neue_Wurzel ergeben.
- In der alten_Wurzel darf kein weiteres Dateisystem eingehängt sein.
In pivot_root(8) finden Sie zusätzliche Anwendungsbeispiele.
Falls die aktuelle Wurzel kein Einhängepunkt ist (zum Beispiel nach chroot(2) oder
pivot_root(), siehe auch unten), wird nicht das alte Wurzelverzeichnis, sondern der
Einhängepunkt des Dateisystems eingehängt, das in der alten_Wurzel eingehängt ist.
Die neue_Wurzel muss keinen Einhängepunkt haben. In diesem Fall zeigt /proc/mounts den
Einhängepunkt des Dateisystems an, welches die neue_Wurzel als Wurzel enthält (/).
RÜCKGABEWERT
Bei Erfolg wird Null zurückgegeben. Bei einem Fehler wird -1 zurückgegeben und errno
entsprechend gesetzt.
FEHLER
pivot_root() kann (in errno) jeden der von stat(2) zurückgegebenen Fehler zurückgeben.
Zusätzlich kann Folgendes zurückgegeben werden:
EBUSY Die neue_Wurzel oder die alte_Wurzel sind im aktuellen Wurzeldateisystem oder ein
Dateisystem ist bereits in der alten_Wurzel eingehängt.
EINVAL Die alte_Wurzel ist nicht unterhalb der neuen_Wurzel.
ENOTDIR
neue_Wurzel oder alte_Wurzel ist kein Verzeichnis.
EPERM Der aufrufende Prozess verfügt nicht über die CAP_SYS_ADMIN-Capability.
VERSIONEN
pivot_root() wurde in Linux 2.3.41 eingeführt.
KONFORM ZU
pivot_root() ist Linux-spezifisch und daher nicht portierbar.
ANMERKUNGEN
Die Glibc stellt keinen Wrapper für diesen Systemaufruf bereit; rufen Sie ihn mit
syscall(2) auf.
FEHLER
pivot_root() sollte nicht das Wurzel- und Arbeitsverzeichnis aller anderen Prozesse im
System ändern müssen.
Einige der weniger bekannten Anwendungen von pivot_root() können schnell in den Wahnsinn
führen.
SIEHE AUCH
chdir(2), chroot(2), stat(2), initrd(4), pivot_root(8), switch_root(8)
KOLOPHON
Diese Seite ist Teil der Veröffentlichung 4.15 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 Mario Blättermann
<mario.blaettermann@gmail.com> 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>.