fsnotifywatch(1)
NAMN
inotifywatch, fsnotifywatch – samla filsystemsåtkomststatistik med inotify eller fanotify
SYNOPSIS
inotifywatch [-hvzrPqfIFS] [-e <event> ] [-t <seconds> ] [-a <event> ] [-d <event> ] <file> [ ... ] fsnotifywatch [-hvzrPqfIFS] [-e <event> ] [-t <seconds> ] [-a <event> ] [-d <event> ] <file> [ ... ]
BESKRIVNING
inotifywatch lyssnar som standard efter filsystemshändelser med Linux gränssnitt inotify(7), och skriver sedan ut en sammanfattande räkning av händelserna som mottagits för varje fil eller katalog.
fsnotifywatch liknar inotifywatch men använder som standard Linux gränssnitt fanotify(7). Om det uttryckligen anges använder det gränssnittet inotify(7).
UTDATA
inotifywatch och fsnotifywatch skriver ut en tabell på standardutdata med en kolumn för varje händelsetyp och en rad för varje bevakad fil eller katalog.
Tabellen visar antalet gånger varje händelse inträffade för varje bevakad fil eller katalog.
Utdata kan sorteras efter en viss händelse med optionerna -a eller -d.
Viss diagnostisk information skrivs till standardfel.
OPTIONER
-h, --help
- Skriv ut viss hjälpsam användningsinformation.
-v, --verbose
- Skriv ut extra information till standardfel under körning.
@<file>
- När ett katalogträd bevakas rekursivt, exkludera den angivna filen från att bevakas.
- Filen måste anges med en relativ eller absolut sökväg beroende på om en relativ eller absolut sökväg anges för bevakade kataloger.
- Om en specifik sökväg uttryckligen både inkluderas och exkluderas kommer den alltid att bevakas.
- Observera: Om du behöver bevaka en katalog eller fil vars namn börjar med @, ange den absoluta sökvägen.
--fromfile <file>
- Läs filnamn som ska bevakas eller exkluderas från en fil, ett filnamn per rad.
- Om filnamn börjar med @ exkluderas de enligt beskrivningen ovan.
- Om <file> är `-' läses filnamn från standardindata.
- Använd denna option om du behöver bevaka för många filer för att skicka in dem som kommandoradsargument.
-z, --zero
- Skriv ut tabellrader och kolumner även om alla element är noll.
- Som standard skrivs rader och kolumner endast ut om de innehåller element som inte är noll.
- Att använda denna option när alla händelser bevakas på många filer kan resultera i mycket utdata!
--exclude <pattern>
- Behandla inte några händelser för den delmängd av filer vars filnamn matchar det angivna POSIX-reguljära uttrycket, skiftlägeskänsligt.
--excludei <pattern>
- Behandla inte några händelser för den delmängd av filer vars filnamn matchar det angivna POSIX-reguljära uttrycket, utan skiftlägeskänslighet.
--include <pattern>
- Behandla endast händelser för den delmängd av filer vars filnamn matchar det angivna POSIX-reguljära uttrycket, skiftlägeskänsligt.
--includei <pattern>
- Behandla endast händelser för den delmängd av filer vars filnamn matchar det angivna POSIX-reguljära uttrycket, utan skiftlägeskänslighet.
-r, --recursive
- Bevaka alla underkataloger till kataloger som skickas som argument.
- Bevakningar sätts upp rekursivt till obegränsat djup.
- Symboliska länkar följs inte.
- Om nya kataloger skapas inne i bevakade kataloger kommer de automatiskt att bevakas.
- Varning: Om du använder denna option medan du bevakar rotkatalogen för ett stort träd kan det ta ganska lång tid innan alla inotify-bevakningar är etablerade, och händelser kommer inte att tas emot under denna tid.
- Eftersom en inotify-bevakning etableras per underkatalog är det också möjligt att det maximala antalet inotify-bevakningar per användare nås.
- Standardmaximum är 8192; det kan ökas genom att skriva till:
/proc/sys/fs/inotify/max_user_watches
-P, --no-dereference
- Följ inte symlänkar.
-t <seconds>, --timeout <seconds>
- Lyssna endast under det angivna antalet sekunder.
- Om detta inte anges kommer inotifywatch att samla statistik tills det tar emot en avbrottssignal, till exempel genom att trycka CONTROL-C i konsolen.
-e <event>, --event <event>
- Lyssna endast efter specifika händelser.
- Händelserna som kan lyssnas efter listas i avsnittet HÄNDELSER.
- Denna option kan anges mer än en gång.
- Om den utelämnas lyssnas alla händelser efter.
-a <event>, --ascending <event>
- Sortera utdata stigande efter händelseräkningar för den angivna händelsen.
- Sorterbara händelser inkluderar `total' och alla händelser som listas i avsnittet HÄNDELSER utom `move' och `close'. Du måste använda `moved_to', `moved_from', `close_write' eller `close_nowrite' i stället.
- Standard är att sortera fallande efter `total'.
-d <event>, --descending <event>
- Sortera utdata fallande efter händelseräkningar för den angivna händelsen.
- Sorterbara händelser inkluderar `total' och alla händelser som listas i avsnittet HÄNDELSER utom `move' och `close'. Du måste använda `moved_to', `moved_from', `close_write' eller `close_nowrite' i stället.
- Standard är att sortera fallande efter `total'.
-I, --inotify
- Bevaka med inotify, standard för inotifywatch.
-F, --fanotify
- Bevaka med fanotify, standard för fsnotifywatch.
- fanotify-stöd för rapportering av händelser med inotify-kompatibel information lades till i kärna v5.9.
- Med äldre kärnor kommer kommandot att misslyckas.
- Från och med kärna v5.12 kräver fanotify administratörsprivilegier.
-S, --filesystem
- Bevaka hela filsystemet för kataloger som skickas som argument med fanotify.
AVSLUTNINGSSTATUS
0
- Programmet kördes framgångsrikt.
1
- Ett fel inträffade vid körning av programmet.
HÄNDELSER
Följande händelser är giltiga för användning med optionen -e:
access
- En bevakad fil eller en fil i en bevakad katalog lästes från.
modify
- En bevakad fil eller en fil i en bevakad katalog skrevs till.
attrib
- Metadata för en bevakad fil eller en fil i en bevakad katalog ändrades.
- Detta inkluderar tidsstämplar, filrättigheter, utökade attribut med mera.
close_write
- En bevakad fil eller en fil i en bevakad katalog stängdes efter att ha öppnats i skrivbart läge.
- Detta innebär inte nödvändigtvis att filen skrevs till.
close_nowrite
- En bevakad fil eller en fil i en bevakad katalog stängdes efter att ha öppnats i skrivskyddat läge.
close
- En bevakad fil eller en fil i en bevakad katalog stängdes, oavsett hur den öppnades.
- Observera att detta i själva verket implementeras helt enkelt genom att lyssna efter både close_write och close_nowrite; därför kommer alla mottagna close-händelser att skrivas ut som en av dessa, inte som CLOSE.
open
- En bevakad fil eller en fil i en bevakad katalog öppnades.
moved_to
- En fil eller katalog flyttades in i en bevakad katalog.
- Denna händelse inträffar även om filen bara flyttas från och till samma katalog.
moved_from
- En fil eller katalog flyttades från en bevakad katalog.
- Denna händelse inträffar även om filen bara flyttas från och till samma katalog.
move
- En fil eller katalog flyttades från eller till en bevakad katalog.
- Observera att detta i själva verket implementeras helt enkelt genom att lyssna efter både moved_to och moved_from; därför kommer alla mottagna close-händelser att skrivas ut som en eller båda av dessa, inte som MOVE.
move_self
- En bevakad fil eller katalog flyttades.
- Efter denna händelse bevakas filen eller katalogen inte längre.
create
- En fil eller katalog skapades i en bevakad katalog.
delete
- En fil eller katalog i en bevakad katalog raderades.
delete_self
- En bevakad fil eller katalog raderades.
- Efter denna händelse bevakas filen eller katalogen inte längre.
- Observera att denna händelse kan inträffa även om den inte uttryckligen lyssnas efter.
unmount
- Filsystemet där en bevakad fil eller katalog finns avmonterades.
- Efter denna händelse bevakas filen eller katalogen inte längre.
- Observera att denna händelse kan inträffa även om den inte uttryckligen lyssnas efter.
EXEMPEL
Bevaka katalogen `~/.beagle' i 60 sekunder:
% inotifywatch -v -e access -e modify -t 60 -r ~/.beagle Establishing watches... Setting up watch(es) on /home/rohan/.beagle OK, /home/rohan/.beagle is now being watched. Total of 302 watches. Finished establishing watches, now collecting statistics. Will listen for events for 60 seconds. total access modify filename 1436 1074 362 /home/rohan/.beagle/Indexes/FileSystemIndex/PrimaryIndex/ 1323 1053 270 /home/rohan/.beagle/Indexes/FileSystemIndex/SecondaryIndex/ 303 116 187 /home/rohan/.beagle/Indexes/KMailIndex/PrimaryIndex/ 261 74 187 /home/rohan/.beagle/TextCache/ 206 0 206 /home/rohan/.beagle/Log/ 42 0 42 /home/rohan/.beagle/Indexes/FileSystemIndex/Locks/ 18 6 12 /home/rohan/.beagle/Indexes/FileSystemIndex/ 12 0 12 /home/rohan/.beagle/Indexes/KMailIndex/Locks/ 3 0 3 /home/rohan/.beagle/TextCache/54/ 3 0 3 /home/rohan/.beagle/TextCache/bc/ 3 0 3 /home/rohan/.beagle/TextCache/20/ 3 0 3 /home/rohan/.beagle/TextCache/62/ 2 2 0 /home/rohan/.beagle/Indexes/KMailIndex/SecondaryIndex/
VARNINGAR OCH BEGRÄNSNINGAR
När inotifywatch används garanteras inte att filnamnet som skrivs ut är aktuellt efter en flytt, eftersom det är inoden som övervakas.
Dessutom garanteras inte att någon av de observerade operationerna har utförts på det filnamn som inotifywatch instruerades att övervaka i fall där filen är känd under flera namn i filsystemet.
FEL
Det finns race conditions i koden för rekursiv katalogbevakning som kan göra att händelser missas om de inträffar i en katalog omedelbart efter att katalogen skapats.
Detta är troligen inte möjligt att åtgärda.
Det antas att inotify-händelsekön aldrig kommer att svämma över.
FÖRFATTARE
inotifywatch påbörjades av Rohan McGovern, och underhålls för närvarande av Eric Curtin och Radu Voicilas.
Följande sida ger en mer komplett lista över bidragsgivare:
https://www.openhub.net/p/inotify-tools/contributors/summary inotifywatch är en del av inotify-tools. Webbplatsen för inotify-tools finns på: https://github.com/inotify-tools/inotify-tools/wikiSE ÄVEN
inotifywait(1), inotify(7) 2025-09-23 inotifywatch 4.23.9.0Sidslut
Orginalhemsidan på Engelska https://man.archlinux.org/man/fsnotifywatch.1.en 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å på https://www.linux.se/kontaka-linux-se/
Tack till Datorservice som har sponsrat Linux.se med webbhotell.