'\" t
.\"     Title: fallocate
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-21
.\"    Manual: Användarkommandon
.\"    Source: util-linux 2.42.4
.\"  Language: English
.\"
.TH "FALLOCATE" "1" "2026-09-21" "util\-linux 2.42.4" "Användarkommandon"
.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 "NAMN"
fallocate \- förallokera eller avallokera utrymme till en fil
.SH "SYNOPSIS"
.sp
\fBfallocate\fP [\fB\-c\fP|\fB\-p\fP|\fB\-z\fP|\fB\-w\fP] [\fB\-o\fP \fIposition\fP] \fB\-l\fP \fIlängd\fP [\fB\-n\fP] \fIfilnamn\fP
.sp
\fBfallocate\fP \fB\-d\fP [\fB\-o\fP \fIoffset\fP] [\fB\-l\fP \fIlängd\fP] \fIfilnamn\fP
.sp
\fBfallocate\fP \fB\-r\fP [\fB\-o\fP \fIposition\fP] \fIfilnamn\fP
.sp
\fBfallocate\fP \fB\-x\fP [\fB\-o\fP \fIoffset\fP] \fB\-l\fP \fIlength filename\fP
.SH "BESKRIVNING"
.sp
\fBfallocate\fP används för att manipulera det allokerade diskutrymmet för en fil, antingen för att avallokera eller förallokera det. För filsystem som stöder systemanropet \fBfallocate\fP(2) sker förallokering snabbt genom att block allokeras och markeras som oinitialiserade, vilket inte kräver någon IO till datablocken. Detta är mycket snabbare än att skapa en fil genom att fylla den med nollor.
.sp
Avslutningsstatusen som returneras av \fBfallocate\fP är 0 vid framgång och 1 vid misslyckande.
.SH "FLAGGOR"
.sp
Argumenten \fIlängd\fP och \fIoffset\fP kan följas av de multiplikativa suffixen KiB (=1024), MiB (=1024*1024) och så vidare för GiB, TiB, PiB, EiB, ZiB och YiB (iB är valfritt, t.ex. har "K" samma betydelse som "KiB") eller suffixen KB (=1000), MB (=1000*1000) och så vidare för GB, TB, PB, EB, ZB och YB.
.sp
Flaggorna \fB\-\-collapse\-range\fP, \fB\-\-dig\-holes\fP, \fB\-\-report\-holes\fP, \fB\-\-punch\-hole\fP, \fB\-\-zero\-range\fP, \fB\-\-write\-zeroes\fP och \fB\-\-posix\fP kan inte kombineras.
.sp
\fB\-c\fP, \fB\-\-collapse\-range\fP
.RS 4
Tar bort ett byteintervall från en fil utan att lämna ett hål. Byteintervallet som ska kollapsas börjar vid \fIoffset\fP och fortsätter i \fIlängd\fP bytes. När operationen är klar kommer innehållet i filen som börjar på platsen \fIoffset\fP+\fIlängd\fP att läggas till på platsen \fIoffset\fP, och filen kommer att vara \fIlängd\fP bytes mindre. Flaggan \fB\-\-keep\-size\fP får inte anges för operationen collapse\-range.
.sp
Tillgänglig sedan Linux 3.15 för ext4 (endast för extent\-baserade filer) och XFS.
.sp
Ett filsystem kan lägga begränsningar på operationens granularitet för att säkerställa en effektiv implementering. Vanligtvis måste \fIoffset\fP och \fIlängd\fP vara en multipel av filsystemets logiska blockstorlek, som varierar beroende på filsystemets typ och konfiguration. Om ett filsystem har ett sådant krav kommer åtgärden att misslyckas med felet \fBEINVAL\fP om detta krav inte uppfylls.
.RE
.sp
\fB\-d\fP, \fB\-\-dig\-holes\fP
.RS 4
Upptäck och gräv hål. Detta gör filen gles på plats, utan att använda extra diskutrymme. Den minsta storleken på hålet beror på filsystemets I/O\-blockstorlek (vanligtvis 4096 byte). När du använder den här flaggan är \fB\-\-keep\-size\fP underförstått. Om inget intervall anges med \fB\-\-offset\fP och \fB\-\-length\fP analyseras hela filen efter hål.
.sp
Du kan se den här flaggan som att göra en "\fBcp \-\-sparse\fP" och sedan byta namn på destinationsfilen till originalfilen, utan att det behövs extra diskutrymme.
.sp
Se \fB\-\-punch\-hole\fP för en lista över filsystem som stöds.
.RE
.sp
\fB\-r\fP, \fB\-\-report\-holes\fP
.RS 4
Sök igenom filen och rapportera fördelningen av hål utan att ändra den. Två typer av hål visas: filhål – block som filsystemet inte har allokerat (rapporterade av SEEK_HOLE); datahål – intervall i filen som logiskt är fyllda med nollbyte men fortfarande upptar diskutrymme.
.sp
För varje hål skrivs startposition, slutposition och storlek i byte ut i utförligt läge, följt av en sammanfattning som som standard anger total storlek och andel av filen för varje håltyp. Om ingen position anges med \fB\-\-offset\fP söks hela filen igenom.
.sp
Denna flagga är skrivskyddad och kan användas på vilken fil som helst för att uppskatta hur mycket utrymme som skulle kunna återvinnas med \fB\-\-dig\-holes\fP.
.sp
Se \fB\-\-punch\-hole\fP för en lista över filsystem som stöds.
.RE
.sp
\fB\-i\fP, \fB\-\-insert\-range\fP
.RS 4
Infoga ett hål på \fIlängd\fP byte från \fIoffset\fP och flytta befintliga data.
.sp
Supported for XFS (since Linux 4.1) and ext4 (since Linux 4.2).
.RE
.sp
\fB\-l\fP, \fB\-\-length\fP \fIlängd\fP
.RS 4
Anger längden på intervallet i byte.
.RE
.sp
\fB\-n\fP, \fB\-\-keep\-size\fP
.RS 4
Ändra inte den synliga längden på filen. Detta kan effektivt allokera block efter EOF, som kan tas bort med en truncate.
.RE
.sp
\fB\-o\fP, \fB\-\-offset\fP \fIoffset\fP
.RS 4
Anger startoffset för intervallet, i byte.
.RE
.sp
\fB\-p\fP, \fB\-\-punch\-hole\fP
.RS 4
Avallokerar utrymme (dvs. skapar ett hål) i byteintervallet som börjar vid \fIoffset\fP och fortsätter i \fIlängd\fP bytes. Inom det angivna intervallet nollställs partiella filsystemblock och hela filsystemblock tas bort från filen. Efter ett lyckat anrop kommer efterföljande läsningar från detta intervall att returnera nollor. Den här flaggan får inte anges samtidigt som flaggan \fB\-\-zero\-range\fP. När du använder den här flaggan är \fB\-\-keep\-size\fP underförstått.
.sp
Stöd för XFS (sedan Linux 2.6.38), ext4 (sedan Linux 3.0), Btrfs (sedan Linux 3.7), tmpfs (sedan Linux 3.5) och gfs2 (sedan Linux 4.16).
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
Aktivera utförligt läge.
.RE
.sp
\fB\-w\fP, \fB\-\-write\-zeroes\fP
.RS 4
Nollställer utrymmet i byteintervallet som börjar vid \fIposition\fP och omfattar \fIlängd\fP byte. Inom intervallet förallokeras skrivna block för områden som sträcker sig över hålen i filen. Efter ett lyckat anrop returnerar efterföljande läsningar från intervallet nollor och efterföljande skrivningar till intervallet kräver inga ytterligare ändringar av filens mappningsmetadata.
.sp
Nollställningen görs inom filsystemet. Filsystemet kan använda ett maskinvaruaccelererat nollställningskommando eller vanliga skrivningar. Beteendet beror på filsystemets utformning och tillgänglig maskinvara.
.sp
Flaggan \fB\-\-keep\-size\fP kan inte anges för åtgärden write\-zeroes eftersom det inte är tillåtet att allokera skrivna block bortom inodens storlek.
.RE
.sp
\fB\-x\fP, \fB\-\-posix\fP
.RS 4
Aktivera POSIX\-operationsläge. I det läget slutförs allokeringen alltid, men det kan ta längre tid när snabb allokering inte stöds av det underliggande filsystemet.
.RE
.sp
\fB\-z\fP, \fB\-\-zero\-range\fP
.RS 4
Nollställer utrymmet i byteintervallet som börjar vid \fIoffset\fP och fortsätter i \fIlängd\fP bytes. Inom det angivna intervallet förallokeras block för de regioner som sträcker sig över hålen i filen. Efter ett lyckat anrop kommer efterföljande läsningar från detta intervall att returnera nollor.
.sp
Nollställningen görs inom filsystemet, företrädesvis genom att omvandla intervallet till oskrivna extenter. Detta tillvägagångssätt innebär att det angivna intervallet inte kommer att nollställas fysiskt på enheten (med undantag för partiella block i vardera änden av intervallet), och I/O krävs (annars) endast för att uppdatera metadata.
.sp
Flaggan \fB\-\-keep\-size\fP kan anges för att förhindra ändring av fillängd.
.sp
Tillgänglig sedan Linux 3.14 för ext4 (endast för extent\-baserade filer) och XFS.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Visa hjälptext och avsluta.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Visa version och avsluta.
.RE
.SH "UPPHOVSPERSONER"
.sp
.MTO "sandeen\(atredhat.com" "Eric Sandeen" ","
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.SH "SE ÄVEN"
.sp
\fBtruncate\fP(1), \fBfallocate\fP(2), \fBposix_fallocate\fP(3)
.SH "FELRAPPORTERING"
.sp
För felrapporter, använd \c
.URL "https://github.com/util\-linux/util\-linux/issues" "felhanteraren" "."
.SH "TILLGÄNGLIGHET"
.sp
Kommandot \fBfallocate\fP ingår i paketet util\-linux som kan hämtas från \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."