This is the file-notify Reference Manual, version 1.0.0, generated automatically by Declt version 4.0 beta 2 "William Riker" on Sun Jun 15 05:31:24 2025 GMT+0.
The main system appears first, followed by any subsystem dependency.
file-notifyAccess to file change and access notification.
Yukari Hafner <shinmera@tymoon.eu>
Yukari Hafner <shinmera@tymoon.eu>
(GIT https://github.com/Shinmera/file-notify.git)
zlib
1.0.0
trivial-features (system).
documentation-utils (system).
cffi (system).
com-on (system)., for feature :windows
package.lisp (file).
protocol.lisp (file).
inotify.lisp (file).
windows.lisp (file).
fsevent.lisp (file).
documentation.lisp (file).
Files are sorted by type and then listed depth-first from the systems components trees.
file-notify/file-notify.asdfile-notify/package.lispfile-notify/protocol.lispfile-notify/inotify.lispfile-notify/windows.lispfile-notify/fsevent.lispfile-notify/documentation.lispfile-notify/protocol.lisppackage.lisp (file).
file-notify (system).
failure (condition).
with-events (macro).
define-implementable (macro).
define-implementation (macro).
file-notify/inotify.lisp:linux
protocol.lisp (file).
file-notify (system).
init (function).
list-watched (function).
process-events (function).
shutdown (function).
unwatch (function).
watch (function).
%var-accessor-errno (function).
(setf %var-accessor-errno) (function).
*fd* (special variable).
*path->watch* (special variable).
*watch->path* (special variable).
check-errno (macro).
code (reader method).
errno (symbol macro).
error-message (function).
event-cookie (function).
(setf event-cookie) (function).
event-length (function).
(setf event-length) (function).
event-mask (function).
(setf event-mask) (function).
event-name (function).
(setf event-name) (function).
event-tclass (class).
event-watch (function).
(setf event-watch) (function).
function-name (reader method).
handle-event (function).
inotify-add-watch (function).
inotify-close (function).
inotify-failure (function).
inotify-failure (condition).
inotify-init (function).
inotify-read (function).
inotify-rm-watch (function).
map-type (function).
message (reader method).
poll (function).
pollfd-events (function).
(setf pollfd-events) (function).
pollfd-fd (function).
(setf pollfd-fd) (function).
pollfd-revents (function).
(setf pollfd-revents) (function).
pollfd-tclass (class).
process (function).
file-notify/windows.lisp:windows
inotify.lisp (file).
protocol.lisp (file).
file-notify (system).
file-notify/fsevent.lisp:darwin
windows.lisp (file).
inotify.lisp (file).
protocol.lisp (file).
file-notify (system).
file-notify/documentation.lispfsevent.lisp (file).
windows.lisp (file).
inotify.lisp (file).
protocol.lisp (file).
file-notify (system).
Packages are listed by definition order.
org.shirakumo.file-notifycommon-lisp.
failure (condition).
init (function).
list-watched (function).
process-events (function).
shutdown (function).
unwatch (function).
watch (function).
with-events (macro).
%var-accessor-errno (function).
(setf %var-accessor-errno) (function).
*fd* (special variable).
*path->watch* (special variable).
*watch->path* (special variable).
check-errno (macro).
code (generic reader).
define-implementable (macro).
define-implementation (macro).
errno (symbol macro).
error-message (function).
event-cookie (function).
(setf event-cookie) (function).
event-length (function).
(setf event-length) (function).
event-mask (function).
(setf event-mask) (function).
event-name (function).
(setf event-name) (function).
event-tclass (class).
event-watch (function).
(setf event-watch) (function).
function-name (generic reader).
handle-event (function).
inotify-add-watch (function).
inotify-close (function).
inotify-failure (function).
inotify-failure (condition).
inotify-init (function).
inotify-read (function).
inotify-rm-watch (function).
map-type (function).
message (generic reader).
poll (function).
pollfd-events (function).
(setf pollfd-events) (function).
pollfd-fd (function).
(setf pollfd-fd) (function).
pollfd-revents (function).
(setf pollfd-revents) (function).
pollfd-tclass (class).
process (function).
Definitions are sorted by export status, category, package, and then by lexicographic order.
Shorthand macro to process file change events.
See PROCESS-EVENTS
Initialises the library for use.
You should call this function before anything else. It is safe to call
this function an arbitrary number of times, initialisation will only
occur once.
See SHUTDOWN
Returns the list of files the user passed to WATCH.
See WATCH
Processes available file change events.
FUNCTION is called with two arguments – the path of the file changed,
and the type of change event that occurred. The function may be called
multiple times.
TIMEOUT may be either T, NIL, or a real in [0, infty[.
When T, events will be continuously and indefinitely received. When
NIL, events will only be processed if immediately available. When a
real, the function will wait up to at most that number of seconds to
receive events.
The events received may be of types that were not explicitly requested
in the WATCH command, and for files that were not explicitly
watched. It is up to you to only look at the files and event types you
care about.
The TYPE passed to the function may be one of the following:
:ACCESS — The file was accessed somehow.
:ATTRIBUTE — The file’s attributes were changed.
:CLOSE-NOWRITE — The file was closed without writing.
:CLOSE-WRITE — The file was closed and written to.
:CREATE — The file was created.
:DELETE — The file was deleted.
:MODIFY — The file was modified somehow.
:MOVE — The file was moved.
:MOVED-FROM — A file was moved and this is the old name.
:MOVED-TO — A file was moved and this is the new name.
:OPEN — The file was opened.
Note: on MacOS the timeout parameter is almost guaranteed to be useless.
See WATCH
See UNWATCH
See WITH-EVENTS
See NORMALIZE-EVENT
Cleans up and shuts down the library.
All active watches will be cleared after this call.
After calling this you should not call any other library functions
unless you also call INIT again beforehand.
See INIT
Removes one or more files from the watch list.
FILE/S may either be a single pathname, or a list of pathnames for
files to be unwatched. If a given pathname was not watched, it is
ignored.
Note that, depending on other files being watched, you may still receive events for a file even after you’ve explicitly unwatched it.
See WATCH
See LIST-WATCHED
Adds one or more files to the watch list.
FILE/S may either be a single pathname, or a list of pathnames for
files to be watched. If a given file does not exist or is not
accessible, an error may be signalled.
EVENTS should be T or a list of events to watch. Supported event types
are:
:ACCESS — [LINUX] The file was accessed.
:ALL — [ALL] All available events are watched.
:ATTRIBUTE — [ALL] The file attributes changed.
:CLOSE — [LINUX] A file was closed.
:CLOSE-NOWRITE — [LINUX] A file was closed without writing.
:CLOSE-WRITE — [LINUX] A file was closed after writing.
:CREATE — [ALL] A file was created.
:DELETE — [ALL] A file was deleted.
:DELETE-SELF — [LINUX] The file was deleted.
:MODIFY — [ALL] The file was modified.
:MOVE — [ALL] A move or rename occurred.
:MOVE-SELF — [LINUX] The file was moved.
:MOVED-FROM — [LINUX] A file was moved from elsewhere.
:MOVED-TO — [LINUX] A file was moved elsewhere.
:OPEN — [LINUX] The file was opened.
:RENAME-FILE — [WINDOWS] A file was renamed, created, or deleted.
:RENAME-DIRECTORY — [WINDOWS] A directory was renamed, created, or deleted.
:SECURITY — [WINDOWS] A security descriptor changed
:SIZE — [WINDOWS] The size of the file changed
It is safe to call WATCH on the same file multiple times. Subsequent
watches will be ignored, and the watch will only happen once.
When a directory is watched, events for files contained within the
directory (subject to the above event filters) will be watched.
Note that it is not guaranteed that the filename you passed will
actually be watched. The underlying system may not accurately support
the capabilities you asked and may upgrade the events watched or even
the files being watched.
This will call INIT for you.
See UNWATCH
See LIST-WATCHED
See PROCESS-EVENTS
See INIT
Erro signalled when an OS failure occurs.
error.
inotify-failure)) ¶code.
inotify-failure)) ¶inotify-failure)) ¶(quote nil)
:function-name
This slot is read-only.
| Jump to: | %
(
C D E F G H I L M P S U W |
|---|
| Jump to: | %
(
C D E F G H I L M P S U W |
|---|
| Jump to: | *
C E F M S |
|---|
| Jump to: | *
C E F M S |
|---|
| Jump to: | C D E F I O P S W |
|---|
| Jump to: | C D E F I O P S W |
|---|