BTRFS(8) BTRFS BTRFS(8)

btrfs - ein Werkzeugkasten zum Verwalten von Btrfs-Dateisystemen

ÜBERSICHT

btrfs [global] <Gruppe> [<Gruppe> …] <Befehl> [<Argumente>]

Das Dienstprogramm btrfs ist ein Werkzeugkasten zum Verwalten von Btrfs-Dateisystemen. Es gibt Befehlsgruppen zum Verwalten von Teildatenträgern, Geräten, ganzen Dateisystemen und andere spezifische Aktionen. Siehe den Abschnitt BEFEHLE.

Für einige Aufgaben stehen eigenständige Werkzeuge zur Verfügung, wie btrfs-convert(8) oder btrfstune(8), die historisch bedingt eigenständig sind und/oder nicht in das Hauptwerkzeug integriert wurden. Im Abschnitt EIGENSTÄNDIGE WERKZEUGE finden Sie weitere Details.

Informationen zu weiteren Themen (Einhängeoptionen usw.) finden Sie in der separaten Handbuchseite btrfs(5).

Jeder Befehl kann so weit abgekürzt werden, wie er in der Kurzform als eindeutiger Befehl erkannt werden kann. In Skripten ist es allerdings empfehlenswert, die vollständigen Befehlsnamen zu verwenden. Für alle Befehlsgruppen gibt es eine Handbuchseite gemäß dem Namensschema btrfs-<Gruppe>.

Beispiel: Es ist möglich, btrfs sub snaps anstelle von btrfs subvolume snapshot aufzurufen. Aber btrfs file s ist nicht zulässig, da file s entweder als filesystem show oder als filesystem sync interpretiert werden könnte.

Falls der Befehlsname nicht eindeutig ist, wird eine Liste der im Konflikt stehenden Optionen angezeigt.

Größen können sowohl bei der Ein- als auch bei der Ausgabe in SI- oder IEC-I-Einheiten angegeben werden (siehe https://man7.org/linux/man-pages/man1/numfmt.1.html'numfmt(1) link'), wobei die Endung B angehängt wird. Alle Zahlen werden anhand der Regeln der C-Locale formatiert (wobei die Shell-Locale ignoriert wird, siehe https://man7.org/linux/man-pages/man7/locale.7.html'locale(7) link').

Eine Übersicht zu einem gegebenen Befehl erhalten Sie mit btrfs Befehl --help. Mit btrfs [Befehl …] --help --full werden alle verfügbaren Optionen angezeigt.

Globale Optionen werden zwischen btrfs und dem Gruppen-Namen übergeben. Sie beeinflussen das nicht-befehlsspezifische Verhalten, zum Beispiel die Ausführlichkeit oder die Art der Ausgabe.

zeigt die Ausgabe des Unterbefehls in dem angegebenen Format (text, json) an, sofern der Unterbefehl dieses unterstützt.
erhöht die Ausführlichkeitsstufe des Unterbefehls.
gibt nur Fehler aus.
legt die Protokollierstufe fest (default, info, verbose, debug, quiet).

Die übrigen Optionen sind nur für das Hauptwerkzeug relevant:

gibt eine Kurzhilfe zu allen Unterbefehlen aus.
zeigt die Versionsnummer an.

verteilt Btrfs-Dateisystemteile über einzelne oder mehrere Geräte. Siehe btrfs-balance(8) für Details.
führt eine Offline-Überprüfung eines Btrfs-Dateisystems aus. Siehe btrfs-check(8) für Details.
verwaltet Btrfs-Geräte, kann unter anderem Hinzufügen/Löschen/Durchsuchen usw. Siehe btrfs-device(8) für Details.
verwaltet ein Btrfs-Dateisystem, kann unter anderem Bezeichnungen setzen, synchronisieren usw. Siehe btrfs-filesystem(8) für Details.
stellt Debug-Werkzeuge für Entwickler/Hacker bereit. Siehe btrfs-inspect-internal(8) für Details.
ermittelt oder setzt eine Eigenschaft eines Btrfs-Objekts. Siehe btrfs-property(8) für Details.
verwaltet Speicherplatzkontingente (qgroup) für ein Btrfs-Dateisystem. Siehe btrfs-qgroup(8) für Details.
verwaltet Speicherplatzkontingente auf einem Btrfs-Dateisystem (Aktivieren, neu Einlesen usw.). Siehe btrfs-quota(8) und btrfs-qgroup(8) für Details.
empfängt Teildatenträger-Daten aus der Standardeingabe oder einer Datei zur Wiederherstellung usw. Siehe btrfs-receive(8) für Details.
ersetzt Btrfs-Geräte. Siehe btrfs-replace(8) für Details.
versucht, ein beschädigtes Btrfs-Dateisystem wiederherzustellen. Siehe btrfs-rescue(8) für Details.
versucht, Dateien aus einem beschädigten Btrfs-Dateisystem wiederherzustellen. Siehe btrfs-restore(8) für Details.
bereinigt ein Btrfs-Dateisystem. Siehe btrfs-scrub(8) für Details.
schreibt Teildatenträger-Daten in die Standardausgabe oder eine Datei zur Wiederherstellung usw. Siehe btrfs-send(8) für Details.
erstellt oder löscht einen Btrfs-Teildatenträger, listet ihn auf oder verwaltet ihn. Siehe btrfs-subvolume(8) für Details.

Neue Funktionalität könnte über ein eigenständiges Werkzeug bereitgestellt werden. Wenn sich die Funktionalität als nützlich erweist, wird das eigenständige Werkzeug für veraltet erklärt und seine Funktionalität in das Hauptwerkzeug integriert. Veraltete Werkzeuge werden nach einer längeren Abschreibungsdauer (nach Jahren) entfernt.

Aktiv genutzte Werkzeuge ohne ein Pendant in btrfs:

wandelt Ext2/3/4-Dateisysteme an Ort und Stelle in Btrfs um.
passt die Eigenschaften eines nicht eingehängten Dateisystems an.
ist ein Wiederherstellungswerkzeug zum Überschreiben des primären Superblocks aus einer Sicherungskopie.
ist ein Wiederherstellungs-Hilfswerkzeug zum Auffinden von Dateibaumwurzeln in einem Dateisystem.

In Umgebungen mit beschränkten Platzverhältnissen ist es möglich, ein einzelnes Binärprogramm mit der Funktionalität verschiedener eigenständiger Programme zu erstellen. Dies folgt dem Busybox-Konzept, bei dem der Dateiname die Funktionalität bestimmt. Dies funktioniert für symbolische und harte Links. Eine vollständige Liste erhalten Sie mit btrfs help --box.

btrfs gibt bei Erfolg den Exit-Status 0 zurück. Im Fall eines Fehlschlags wird ein von 0 verschiedener Exit-Status zurückgegeben.

btrfs ist Teil des Pakets Btrfs-progs. Auf https://btrfs.readthedocs.io finden Sie die Dokumentation.

btrfs(5), btrfs-balance(8), btrfs-check(8), btrfs-convert(8), btrfs-device(8), btrfs-filesystem(8), btrfs-inspect-internal(8), btrfs-property(8), btrfs-qgroup(8), btrfs-quota(8), btrfs-receive(8), btrfs-replace(8), btrfs-rescue(8), btrfs-restore(8), btrfs-scrub(8), btrfs-send(8), btrfs-subvolume(8), btrfstune(8), mkfs.btrfs(8)

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Mario Blättermann <mario.blaettermann@gmail.com> 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.

10. Mai 2024 6.8.1