"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "man/inotifywait.1.in" between
inotify-tools-3.20.2.2.tar.gz and inotify-tools-3.20.11.0.tar.gz

About: inotify-tools offers commandline utilities relating to inotify (wait for or watch particular events on files).

inotifywait.1.in  (inotify-tools-3.20.2.2):inotifywait.1.in  (inotify-tools-3.20.11.0)
.TH inotifywait 1 "@MAN_DATE@" "inotifywait @MAN_PACKAGE_VERSION@" .TH inotifywait 1 "@MAN_DATE@" "inotifywait @MAN_PACKAGE_VERSION@"
.SH NAME .SH NAME
inotifywait \- wait for changes to files using inotify inotifywait \- wait for changes to files using inotify
.SH SYNOPSIS .SH SYNOPSIS
.B inotifywait .B inotifywait
.RB [ \-hcmrq ] .RB [ \-hcmrPq ]
.RB [ \-e .RB [ \-e
<event> ] <event> ]
.RB [ \-t .RB [ \-t
<seconds> ] <seconds> ]
.RB [ \-\-format .RB [ \-\-format
<fmt> ] <fmt> ]
.RB [ \-\-timefmt .RB [ \-\-timefmt
<fmt> ] <fmt> ]
<file> [ ... ] <file> [ ... ]
skipping to change at line 93 skipping to change at line 93
that must be specified by \-\-outfile. Implies \-\-syslog. that must be specified by \-\-outfile. Implies \-\-syslog.
.TP .TP
.B \-o, \-\-outfile <file> .B \-o, \-\-outfile <file>
Output events to <file> rather than stdout. Output events to <file> rather than stdout.
.TP .TP
.B \-s, \-\-syslog .B \-s, \-\-syslog
Output errors to Output errors to
.BR syslog(3) .BR syslog(3)
system log module rather than stderr. system log module rather than stderr.
.TP .TP
.B \-P, \-\-no\-dereference
Do not follow symlinks.
.TP
.B \-r, \-\-recursive .B \-r, \-\-recursive
Watch all subdirectories of any directories passed as arguments. Watches Watch all subdirectories of any directories passed as arguments. Watches
will be set up recursively to an unlimited depth. Symbolic links are not will be set up recursively to an unlimited depth. Symbolic links are not
traversed. Newly created subdirectories will also be watched. traversed. Newly created subdirectories will also be watched.
.B Warning: .B Warning:
If you use this option while watching the root directory If you use this option while watching the root directory
of a large tree, it may take quite a while until all inotify watches are of a large tree, it may take quite a while until all inotify watches are
established, and events will not be received in this time. Also, since one established, and events will not be received in this time. Also, since one
inotify watch will be established per subdirectory, it is possible that the inotify watch will be established per subdirectory, it is possible that the
skipping to change at line 150 skipping to change at line 153
Output in CSV (comma-separated values) format. This is useful when filenames Output in CSV (comma-separated values) format. This is useful when filenames
may contain spaces, since in this case it is not safe to simply split the output may contain spaces, since in this case it is not safe to simply split the output
at each space character. at each space character.
.TP .TP
.B \-\-timefmt <fmt> .B \-\-timefmt <fmt>
Set a time format string as accepted by strftime(3) for use with the `%T' conver sion Set a time format string as accepted by strftime(3) for use with the `%T' conver sion
in the \-\-format option. in the \-\-format option.
.TP .TP
.B \-\-no-newline
Don't print newline symbol after user-specified format in the \-\-format option.
.TP
.B \-\-format <fmt> .B \-\-format <fmt>
Output in a user-specified format, using printf-like syntax. The event strings Output in a user-specified format, using printf-like syntax. The event strings
output are limited to around 4000 characters and will be truncated to this lengt h. output are limited to around 4000 characters and will be truncated to this lengt h.
The following conversions are supported: The following conversions are supported:
.TP .TP
%w %w
This will be replaced with the name of the Watched file on which an event occurr ed. This will be replaced with the name of the Watched file on which an event occurr ed.
.TP .TP
skipping to change at line 179 skipping to change at line 186
.TP .TP
%Xe %Xe
Replaced with the Event(s) which occurred, separated by whichever character is Replaced with the Event(s) which occurred, separated by whichever character is
in the place of `X'. in the place of `X'.
.TP .TP
%T %T
Replaced with the current Time in the format specified by the \-\-timefmt option , Replaced with the current Time in the format specified by the \-\-timefmt option ,
which should be a format string suitable for passing to strftime(3). which should be a format string suitable for passing to strftime(3).
.TP
%0
Replaced with NUL.
.TP
%n
Replaced with Line Feed.
.SH "EXIT STATUS" .SH "EXIT STATUS"
.TP .TP
.B 0 .B 0
The program executed successfully, and an event occurred which was being The program executed successfully, and an event occurred which was being
listened for. listened for.
.TP .TP
.B 1 .B 1
An error occurred in execution of the program, or an event occurred which was An error occurred in execution of the program, or an event occurred which was
not being listened for. The latter generally occurs if something happens which not being listened for. The latter generally occurs if something happens which
forcibly removes the inotify watch, such as a watched file being deleted or the forcibly removes the inotify watch, such as a watched file being deleted or the
skipping to change at line 332 skipping to change at line 347
OPEN badfile OPEN badfile
ATTRIB badfile ATTRIB badfile
CLOSE_WRITE:CLOSE badfile CLOSE_WRITE:CLOSE badfile
CREATE goodfile CREATE goodfile
OPEN goodfile OPEN goodfile
ATTRIB goodfile ATTRIB goodfile
CLOSE_WRITE:CLOSE goodfile CLOSE_WRITE:CLOSE goodfile
DELETE badfile DELETE badfile
.fi .fi
.SS Example 4
Enforce file permissions in directory `~/test'
.nf
inotifywait -qmr -e 'moved_to,create' --format '%w%f%0' --no-newline ~/test |\\
while IFS= read -r -d '' file
do
chmod -v a+rX "$file"
done
.fi
.SH BUGS .SH BUGS
There are race conditions in the recursive directory watching code There are race conditions in the recursive directory watching code
which can cause events to be missed if they occur in a directory immediately which can cause events to be missed if they occur in a directory immediately
after that directory is created. This is probably not fixable. after that directory is created. This is probably not fixable.
It is assumed the inotify event queue will never overflow. It is assumed the inotify event queue will never overflow.
.SH AUTHORS .SH AUTHORS
inotifywait was started by Rohan McGovern, and is currently maintained by Eric C urtin and Radu Voicilas. inotifywait was started by Rohan McGovern, and is currently maintained by Eric C urtin and Radu Voicilas.
https://www.openhub.net/p/inotify-tools/contributors/summary gives you a more co mplete list of contributors. https://www.openhub.net/p/inotify-tools/contributors/summary gives you a more co mplete list of contributors.
 End of changes. 5 change blocks. 
1 lines changed or deleted 27 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)