du(1p)

du(1p)

PROLOG

Denna manualsida är en del av POSIX Programmer's Manual. Linux-implementationen av detta gränssnitt kan skilja sig (se motsvarande Linux-manualsida för detaljer om Linux-beteende), eller så kanske gränssnittet inte är implementerat på Linux.

NAMN

du — uppskatta användning av filutrymme

SYNOPSIS

du [-a|-s] [-kx] [-H|-L] [fil...]

BESKRIVNING

Som standard ska verktyget du skriva till standard ut storleken på det filutrymme som är allokerat till, samt storleken på det filutrymme som är allokerat till varje underkatalog i filhierarkin med roten i var och en av de angivna filerna. Som standard, när en symbolisk länk påträffas på kommandoraden eller i filhierarkin, ska du räkna storleken på den symboliska länken (snarare än filen som länken refererar till), och ska inte följa länken till en annan del av filhierarkin. Storleken på det filutrymme som är allokerat till en fil av typen katalog ska definieras som den sammanlagda mängden utrymme som är allokerat till alla filer i filhierarkin med roten i katalogen plus det utrymme som är allokerat till själva katalogen.

När du inte kan anropa stat() på filer eller stat() eller läsa kataloger, ska det rapportera ett feltillstånd och den slutliga avslutsstatusen påverkas. En fil som förekommer flera gånger under en filoperand och som har ett länktal större än 1 ska räknas och skrivas ut endast för en post. Det är implementationsdefinierat om en fil som har ett länktal som inte är större än 1 räknas och skrivs ut bara en gång, eller räknas och skrivs ut för varje förekomst. Det är implementationsdefinierat om en fil som förekommer under en filoperand räknas för andra filoperander. Den katalogpost som väljs i rapporten är ospecificerad. Som standard ska filstorlekar skrivas i enheter om 512 byte, avrundade uppåt till nästa 512-bytesenhet.

FLAGGOR

Verktyget du ska följa Base Definitions-volymen i POSIX.1-2017, Section 12.2, Utility Syntax Guidelines.

Följande flaggor ska stödjas:

-a

Utöver standardutmatningen, rapportera storleken på varje fil som inte är av typen katalog i filhierarkin med roten i den angivna filen. Flaggan -a ska inte påverka huruvida icke-kataloger som anges som fil-operander listas.

-H

Om en symbolisk länk anges på kommandoraden, ska du räkna storleken på filen eller filhierarkin som länken refererar till.

-k

Skriv filstorlekar i enheter om 1024 byte i stället för standardenheter om 512 byte.

-L

Om en symbolisk länk anges på kommandoraden eller påträffas under traverseringen av en filhierarki, ska du räkna storleken på filen eller filhierarkin som länken refererar till.

-s

I stället för standardutmatningen, rapportera endast totalsumman för var och en av de angivna filerna.

-x

Vid beräkning av filstorlekar, utvärdera endast de filer som ligger på samma enhet som filen som anges av operanden fil.

Att ange mer än en av de ömsesidigt uteslutande flaggorna -H och -L ska inte betraktas som ett fel. Den sist angivna flaggan ska bestämma verktygets beteende.

OPERANDER

Följande operand ska stödjas:

fil

Sökvägen till en fil vars storlek ska skrivas ut. Om ingen fil anges ska aktuell katalog användas.

STDIN

Används inte.

INDATAFILER

Inga.

MILJÖVARIABLER

Följande miljövariabler ska påverka exekveringen av du:

LANG

Ange ett standardvärde för internationaliseringsvariabler som är odefinierade eller tomma. (Se Base Definitions-volymen i POSIX.1-2017, Section 8.2, Internationalization Variables för prioritetsordningen för internationaliseringsvariabler som används för att bestämma värdena för lokalkategorier.)

LC_ALL

Om satt till en icke-tom sträng, åsidosätt värdena för alla andra internationaliseringsvariabler.

LC_CTYPE

Bestäm lokal för tolkningen av sekvenser av byte i textdata som tecken (till exempel enbyte- i stället för flerbytetecken i argument).

LC_MESSAGES

Bestäm lokal som ska användas för att påverka format och innehåll för diagnostiska meddelanden som skrivs till standard error.

NLSPATH

Bestäm platsen för meddelandekataloger för behandling av LC_MESSAGES.

ASYNKRONA HÄNDELSER

Standard.

STDOUT

Utmatningen från du ska bestå av mängden utrymme som är allokerat till en fil och filens namn, i följande format:

"%d %s\n", <storlek>, <sökväg>

STDERR

Standard error ska endast användas för diagnostiska meddelanden.

UTDATAFILER

Inga.

UTVIDGAD BESKRIVNING

Ingen.

AVSLUTSSTATUS

Följande avslutsvärden ska returneras:

0

Framgångsrikt avslut.

>0

Ett fel inträffade.

KONSEKVENSER AV FEL

Standard.

Följande avsnitt är informativa.

ANVÄNDNING

Ingen.

EXEMPEL

Inga.

MOTIVERING

Användningen av enheter om 512 byte är historisk praxis och upprätthåller kompatibilitet med ls och andra verktyg i denna volym av POSIX.1-2017. Detta kräver inte att själva filsystemet är baserat på block om 512 byte. Flaggan -k' lades till som en kompromissåtgärd. Standardens utvecklare kom överens om att 512 byte var den bästa standardenheten på grund av dess fullständiga historiska konsekvens på System V (jämfört med blandad användning av 512/1024 byte på BSD-system), och att en flagga -k för att växla till enheter om 1024 byte var en bra kompromiss. Användare som föredrar mängden 1024 byte kan enkelt aliasera du till du -k utan att bryta de många historiska skript som förlitar sig på enheter om 512 byte.

Flaggan -b lades till i ett tidigt förslag för att ge en lösning på situationen där System V- och BSD-system anger siffror för filstorlekar i block, vilket är ett implementationsdefinierat begrepp. (I vanlig användning är blockstorleken 512 byte för System V och 1024 byte för BSD-system.) -b togs dock senare bort, eftersom standarden till slut fastställdes till enheter om 512 byte.

Historiska filsystem gav inget sätt att få exakta siffror för det allokerade utrymmet till filer. Det finns två kända områden där historiska filsystem är inexakta: fall där indirekta block används av filsystemet eller glesa filer ger felaktigt höga värden. Ett indirekt block är utrymme som används av filsystemet för lagring av filen, men det behöver inte räknas som utrymme allokerat till filen. En gles fil är en fil där ett anrop till lseek() har gjorts till en position bortom filens slut och data därefter har skrivits vid den punkten. Ett filsystem behöver inte allokera alla mellanliggande, nollfyllda block till en sådan fil. Det är upp till implementationen att definiera exakt hur noggranna dess metoder är.

Flaggorna -a och -s var ömsesidigt uteslutande i den ursprungliga versionen av du. Beskrivningen i POSIX Shell and Utilities följer av formuleringen i SVID där -s beskrivs som att endast den totala summan rapporteras. Vissa system kan producera utdata för -sa, men ett strikt POSIX-följande program får inte använda den kombinationen.

Flaggorna -a och -s antogs från SVID, med undantag för att System V-beteendet att inte uttryckligen lista icke-kataloger som angetts som operander, om inte flaggan -a anges, betraktades som ett fel; BSD-beteendet (rapport för alla operander) är obligatoriskt. Standardbeteendet i du enligt SVID när det gäller att rapportera misslyckanden att läsa filer (det producerar inga meddelanden) ansågs kontraintuitivt, och därför specificerades att POSIX-standardbeteendet ska vara att producera sådana meddelanden. Dessa meddelanden kan stängas av med skalomdirigering för att uppnå System V-beteendet.

Flaggan -x är historisk praxis på senare BSD-system. Den har antagits i denna volym av POSIX.1-2017 eftersom det inte fanns någon annan historisk metod för att begränsa du-sökningen till en enda filhierarki. Denna begränsning av sökningen är nödvändig för att göra det möjligt att få information om filutrymmesanvändning för ett filsystem där andra filsystem är monterade, utan att behöva ta till långa skript med find och awk.

FRAMTIDA UTVECKLING

En framtida version av denna standard kan komma att kräva att en fil som förekommer flera gånger ska räknas och skrivas ut endast för en post, även om förekomsterna ligger under olika filoperander.

SE ÄVEN

ls(1p)

Base Definitions-volymen i POSIX.1-2017, Chapter 8, Environment Variables, Section 12.2, Utility Syntax Guidelines

System Interfaces-volymen i POSIX.1-2017, fstatat(3p)

COPYRIGHT

Delar av denna text återges och reproduceras i elektronisk form från IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 av Institute of Electrical and Electronics Engineers, Inc och The Open Group. Vid varje avvikelse mellan denna version och den ursprungliga IEEE- och The Open Group-standarden är den ursprungliga IEEE- och The Open Group-standarden det styrande dokumentet. Originalstandarden kan erhållas online på http://www.opengroup.org/unix/online.html .

Eventuella typografiska fel eller formateringsfel som förekommer på denna sida har sannolikt introducerats under konverteringen av källfilerna till manualsidesformat. För att rapportera sådana fel, se https://www.kernel.org/doc/man-pages/reporting_bugs.html .

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/du.1p.html Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorservice som har sponsrat Linux.se med webbhotell.