inotifywatch(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 typ av händelse 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 på 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 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/wiki

SE ÄVEN

inotifywait(1), inotify(7)

KOLOFON

Denna sida är en del av projektet inotify-tools, kommandoradsprogram som tillhandahåller ett enkelt gränssnitt till inotify.

Information om projektet finns på:

https://github.com/rvoicilas/inotify-tools/wiki

Om du har en felrapport för denna manualsida, skicka den till:

inotify-tools-general@lists.sourceforge.net

Denna sida hämtades från projektets uppströms Git-förråd:

https://github.com/rvoicilas/inotify-tools.git

den 24 maj 2026.

Vid den tidpunkten var datumet för den senaste commit som hittades i förrådet 24 september 2025.

Om du upptäcker renderingsproblem i denna HTML-version av sidan, eller om du anser att det finns en bättre eller mer aktuell källa för sidan, eller om du har rättelser eller förbättringar av informationen i denna KOLOFON, som inte är en del av den ursprungliga manualsidan, skicka e-post till:

man-pages@man7.org

inotifywatch 4.23.9.0 2023-09-23 inotifywatch(1)

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/inotifywatch.1.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å på https://www.linux.se/kontaka-linux-se/

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