'\" t
.\"     Title: fallocate
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-05-14
.\"    Manual: Dienstprogramme für Benutzer
.\"    Source: util-linux 2.40.1
.\"  Language: English
.\"
.TH "FALLOCATE" "1" "2024-05-14" "util\-linux 2.40.1" "Dienstprogramme für Benutzer"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "BEZEICHNUNG"
fallocate \- einer Datei Platz im Dateisystem zuweisen oder die Zuweisung lösen
.SH "ÜBERSICHT"
.sp
\fBfallocate\fP [\fB\-c\fP|\fB\-p\fP|\fB\-z\fP] [\fB\-o\fP \fIoffset\fP] \fB\-l\fP \fIlength\fP [\fB\-n\fP] \fIfilename\fP
.sp
\fBfallocate\fP \fB\-d\fP [\fB\-o\fP \fIoffset\fP] [\fB\-l\fP \fIlength\fP] \fIfilename\fP
.sp
\fBfallocate\fP \fB\-x\fP [\fB\-o\fP \fIoffset\fP] \fB\-l\fP \fIlength filename\fP
.SH "BESCHREIBUNG"
.sp
\fBfallocate\fP is used to manipulate the allocated disk space for a file, either to deallocate or preallocate it. For filesystems which support the \fBfallocate\fP(2) system call, preallocation is done quickly by allocating blocks and marking them as uninitialized, requiring no IO to the data blocks. This is much faster than creating a file by filling it with zeroes.
.sp
Der von \fBfallocate\fP zurückgegebene Exit\-Status ist 0 bei Erfolg und 1 bei Fehlschlag.
.SH "OPTIONEN"
.sp
Nachfolgend kann den Argumenten \fILänge\fP und \fIVersatz\fP eines der multiplikativen Suffixe KiB (=1024), MiB (=1024*1024) und so weiter für GiB, TiB, PiB, EiB, ZiB und YiB folgen (das »iB« ist optional, zum Beispiel ist »K« gleichbedeutend mit »KiB«) oder die Suffixe KB (=1000), MB (=1000*1000) und so weiter für GB, TB, PB, EB, ZB und YB folgen.
.sp
Die Optionen \fB\-\-collapse\-range\fP, \fB\-\-dig\-holes\fP, \fB\-\-punch\-hole\fP und \fB\-\-zero\-range\fP schließen sich gegenseitig aus.
.sp
\fB\-c\fP, \fB\-\-collapse\-range\fP
.RS 4
entfernt einen Bereich aus einer Datei, ohne ein »Loch« zu hinterlassen. Der »zusammenzuklappende« Dateibereich beginnt bei \fIVersatz\fP und erstreckt sich über die angegebene \fILänge\fP in Byte. Nach Abschluss des Vorgangs ist der Inhalt der Datei, der ursprünglich an der Stelle \fIVersatz\fP+\fILänge\fP stand, nun an der Stelle \fIVersatz\fP und die Datei ist \fILänge\fP Byte kleiner. Die Option \fB\-\-keep\-size\fP kann für die Anwendung von »collapse\-range« nicht angegeben werden.
.sp
Dies ist seit Linux 3.15 für ext4 (nur für Extent\-basierte Dateien) und XFS verfügbar.
.sp
Ein Dateisystem kann Einschränkungen bezüglich der Granularität der Aktion setzen, um eine effiziente Implementierung sicherzustellen. Typischerweise müssen der \fIVersatz\fP und die \fILänge\fP Vielfache der logischen Blockgröße des Dateisystems, die vom Dateisystemtyp und der Konfiguration abhängt, sein. Falls ein Dateisystem so eine Anforderung hat, wird die Aktion mit dem Fehler \fBEINVAL\fP fehlschlagen, falls diese Anforderung verletzt ist.
.RE
.sp
\fB\-d\fP, \fB\-\-dig\-holes\fP
.RS 4
Erkennen und Erstellen von »Löchern«. Hierdurch wird am Speicherort der Datei eine Sparse\-Datei erstellt, ohne zusätzlichen Platz auf der Platte zu verwenden. Die minimale Größe des »Lochs« hängt von der E/A\-Blockgröße des Dateisystems ab (üblicherweise 4096 Byte). Außerdem ist \fB\-\-keep\-size\fP impliziert, wenn diese Option verwendet wird. Wenn kein Bereich durch \fB\-\-offset\fP und \fB\-\-length\fP angegeben wurde, wird die gesamte Datei auf »Löcher« hin analysiert.
.sp
Sie können sich diese Option wie das Ergebnis des Befehls »\fBcp \-\-sparse\fP« vorstellen, wobei die Zieldatei den Namen der Ursprungsdatei erhält und kein zusätzlicher Speicherplatz erforderlich ist.
.sp
Mit der Option \fB\-\-punch\-hole\fP erhalten Sie eine Liste der unterstützten Dateisysteme.
.RE
.sp
\fB\-i\fP, \fB\-\-insert\-range\fP
.RS 4
fügt ein Loch der Länge \fILänge\fP Bytes bei \fIVersatz\fP ein und verschiebt bestehende Daten.
.RE
.sp
\fB\-l\fP, \fB\-\-length\fP \fILänge\fP
.RS 4
gibt die Länge des Zuweisungsbereiches in Byte an.
.RE
.sp
\fB\-n\fP, \fB\-\-keep\-size\fP
.RS 4
verhindert die Änderung der eigentlichen Länge der Datei. Dadurch können tatsächlich auch Blöcke nach dem Dateiende (EOF) zugewiesen werden, die durch Abschneiden entfernt werden können.
.RE
.sp
\fB\-o\fP, \fB\-\-offset\fP \fIVersatz\fP
.RS 4
gibt den Anfang des Zuweisungsbereiches in Byte an.
.RE
.sp
\fB\-p\fP, \fB\-\-punch\-hole\fP
.RS 4
löscht eine Zuweisung (d.h. erzeugt ein »Loch«) im Bereich, der bei \fIVersatz\fP beginnt und sich über die angegebene \fILänge\fP in Bytes erstreckt. Innerhalb des angegebenen Bereiches werden Dateisystemblöcke partiell auf Null gesetzt und ganze Dateisystemblöcke aus der Datei entfernt. Nach erfolgreichem Aufruf geben nachfolgende Aufrufe Nullen aus diesem Bereich zurück. Diese Option darf nicht gleichzeitig mit \fB\-\-zero\-range\fP angegeben werden. Außerdem wird in dieser Option \fB\-\-keep\-size\fP impliziert.
.sp
Dies wird für XFS (seit Linux 2.6.38), ext4 (seit Linux 3.0), Btrfs (seit Linux 3.7), tmpfs (seit Linux 3.5) und gfs2 (seit Linux 4.16) unterstützt.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
aktiviert den ausführlichen Modus.
.RE
.sp
\fB\-x\fP, \fB\-\-posix\fP
.RS 4
aktiviert den POSIX\-Betriebsmodus. In diesem Modus wird die Zuweisung immer abgeschlossen, aber es kann länger dauern, wenn schnelle Zuweisung nicht vom darunterliegenden Dateisystem unterstützt wird.
.RE
.sp
\fB\-z\fP, \fB\-\-zero\-range\fP
.RS 4
Belegt den Raum in dem bei \fIVersatz\fP beginnenden Byte\-Bereich für \fILänge\fP Bytes mit Nullen. Innerhalb des angegebenen Bereichs werden Blöcke für die Regionen, die die Löcher in der Datei überbrücken, vorbelegt. Nach einem erfolgreichen Aufruf liefern nachfolgende Leseanforderungen aus diesem Bereich Nullen zurück.
.sp
Das Nullen erfolgt innerhalb des Dateisystems, vorzugsweise durch Umwandlung des Bereichs in ungeschriebene Extents. Dieser Ansatz bedeutet, dass der angegebene Bereich nicht physisch auf dem Gerät mit Nullen gefüllt wird (außer für Teilblöcke an beiden Enden des Bereichs) und E/A (andernfalls) nur zur Aktualisierung von Metadaten benötigt wird.
.sp
Die Option \fB\-\-keep\-size\fP kann angegeben werden, um Änderungen der Länge der Datei zu verhindern.
.sp
Dies ist seit Linux 3.14 für ext4 (nur für Extent\-basierte Dateien) und XFS verfügbar.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
zeigt einen Hilfetext an und beendet das Programm.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
zeigt Versionsinformationen an und beendet das Programm.
.RE
.SH "AUTOREN"
.sp
.MTO "sandeen\(atredhat.com" "Eric Sandeen" ","
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.SH "SIEHE AUCH"
.sp
\fBtruncate\fP(1),
\fBfallocate\fP(2),
\fBposix_fallocate\fP(3)
.SH "FEHLER MELDEN"
.sp
Nutzen Sie zum Melden von Fehlern das Fehlererfassungssystem auf \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "VERFÜGBARKEIT"
.sp
Der Befehl \fBfallocate\fP ist Teil des Pakets util\-linux, welches aus dem \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux\-Kernel\-Archiv" ""
heruntergeladen werden kann.