.\" -*- coding: UTF-8 -*- .\" -*- nroff -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH FALLOCATE 1 "September 2011" util\-linux "Dienstprogramme für Benutzer" .SH BEZEICHNUNG fallocate \- einer Datei Platz im Dateisystem zuweisen oder die Zuweisung lösen .SH ÜBERSICHT \fBfallocate\fP [\fB\-n\fP] [\fB\-p\fP] [\fB\-c\fP] [\fB\-z\fP] [\fB\-o\fP \fIVersatz\fP] \fB\-l\fP \fILänge\fP \fIDateiname\fP .PP \fBfallocate\fP \-d [\fB\-o\fP \fIVersatz\fP] [\fB\-l\fP \fILänge\fP] \fIDateiname\fP .SH BESCHREIBUNG \fBfallocate\fP wird verwendet, um Blöcke für eine Datei vorzureservieren oder die Reservierung aufzuheben. Wenn das Dateisystem den fallocate\-Systemaufruf unterstützt, geschieht dies schnell durch Zuweisung von Blöcken und Markierung dieser Blöcke als nicht initialisiert. Dadurch ist direkter E/A\-Zugriff auf die Datenblöcke unnötig. Diese Vorgehensweise ist bedeutend schneller als die Erzeugung der Datei durch Füllen mit Nullen. .PP Der von \fBfallocate\fP zurückgegebene Exit\-Code ist 0 bei Erfolg und 1 bei Fehlschlag. .PP .SH OPTIONEN Die Argumente für \fILänge\fP und \fIVersatz\fP können durch die Binärsuffixe KiB=1024, MiB1024*1024 und so weiter für GiB, TiB, PiB und EiB ergänzt werden, wobei das »iB« nicht erforderlich ist. Zum Beispiel ist »K« gleichbedeutend mit »KiB«. Möglich sind außerdem die Dezimalsuffixe KB=1000, MB=1000*1000, GB, PB und EB. Die Optionen \fB\-\-collapse\-range\fP, \fB\-\-dig\-holes\fP, \fB\-\-punch\-hole\fP und \fB\-\-zero\-range\fP schließen sich gegenseitig aus. .IP "\fB\-n, \-\-keep\-size\fP" 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. .IP "\fB\-p, \-\-punch\-hole\fP" 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 folgende 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. Dies wird für XFS (seit Linux 2.6.38), ext4 (seit Linux 3.0), Btrfs (seit Linux 3.7) und tmpfs (seit Linux 3.5) unterstützt. .IP "\fB\-d, \-\-dig\-holes\fP" Detect and dig holes. Makes the file sparse in\-place, without using extra disk space. The minimal size of the hole depends on filesystem I/O block size (usually 4096 bytes). Also, when using this option, \fB\-\-keep\-size\fP is implied. If no range is specified by \fB\-\-offset\fP and \fB\-\-length\fP, then all file is analyzed for holes. Sie können sich dies wie das Ergebnis des Befehls »cp \-\-sparse« vorstellen, wobei die Zieldatei den Namen der Ursprungsdatei erhält und kein zusätzlicher Speicherplatz erforderlich ist. Mit der Option \fB\-\-punch\-hole\fP erhalten Sie eine Liste der unterstützten Dateisysteme. .IP "\fB\-c, \-\-collapse\-range\fP" Removes a byte range from a file, without leaving a hole. The byte range to be collapsed starts at \fIoffset\fP and continues for \fIlength\fP bytes. At the completion of the operation, the contents of the file starting at the location offset+length will be appended at the location offset, and the file will be \fIlength\fP bytes smaller. The option \fB\-\-keep\-size\fP may not be specified for colapse range operation. Dies ist verfügbar seit Linux 3.15 für ext4 (nur für Extent\-basierte Dateien) und XFS. .IP "\fB\-z, \-\-zero\-range\fP" Zeroes space in the byte range starting at \fIoffset\fP and continuing for \fIlength\fP bytes. Within the specified range, blocks are preallocated for the regions that span the holes in the file. After a successful call, subsequent reads from this range will return zeroes. Zeroing is done within the filesystem preferably by converting the range into unwritten extents. This approach means that the specified range will not be physically zeroed out on the device (except for partial blocks at the either end of the range), and I/O is (otherwise) required only to update metadata. Die Option \fB\-\-keep\-size\fP kann angegeben werden, um Änderungen der Länge der Datei zu verhindern. Dies ist verfügbar seit Linux 3.14 für ext4 (nur für Extent\-basierte Dateien) und XFS. .IP "\fB\-o, \-\-offset\fP \fIVersatz\fP" legt den Anfang des Zuweisungsbereiches in Byte fest. .IP "\fB\-l, \-\-length\fP \fILänge\fP" gibt die Länge des Zuweisungsbereiches in Byte an. .IP "\fB\-h, \-\-help\fP" zeigt eine Hilfe an und beendet das Programm. .IP "\fB\-v, \-\-verbose\fP" aktiviert den ausführlichen Modus. .IP "\fB\-V, \-\-version\fP" zeigt Versionsinformationen an und beendet das Programm. .SH AUTOREN .UR sandeen@redhat.com Eric Sandeen .UE .br .UR kzak@redhat.com Karel Zak .UE .SH "SIEHE AUCH" \fBfallocate\fP(2), \fBposix_fallocate\fP(3), \fBtruncate\fP(1) .SH VERFÜGBARKEIT Der Befehl fallocate ist Teil des Pakets util\-linux, welches aus dem .UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util\-linux/ Linux Kernel\-Archiv .UE . heruntergeladen werden kann. .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Mario Blättermann 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 .