Win32::ChangeNotify - Monitor events related to files and directories |
Win32::ChangeNotify - Monitor events related to files and directories
require Win32::ChangeNotify;
$notify = Win32::ChangeNotify->new($Path,$WatchSubTree,$Events); $notify->wait or warn "Something failed: $!\n"; # There has been a change.
This module allows the user to use a Win32 change notification event object from Perl. This allows the Perl program to monitor events relating to files and directory trees.
The wait
method and wait_all
& wait_any
functions are
inherited from the Win32::IPC module.
$path
is the
directory to monitor. If $subtree
is true, then all directories
under $path
will be monitored. $filter
indicates what events
should trigger a notification. It should be a string containing any
of the following flags (separated by whitespace and/or |
).
ATTRIBUTES Any attribute change DIR_NAME Any directory name change FILE_NAME Any file name change (creating/deleting/renaming) LAST_WRITE Any change to a file's last write time SECURITY Any security descriptor change SIZE Any change in a file's size
($filter
can also be an integer composed from the
FILE_NOTIFY_CHANGE_*
constants.)
undef $notify
instead (but
close
works even if there are other copies of the object). This
happens automatically when your program exits.
new
, but it is not required.)
reset
afterwards if you want
to continue monitoring.
Win32::ChangeNotify still supports the ActiveWare syntax, but its use is deprecated.
FindFirst($Obj,$PathName,$WatchSubTree,$Filter)
$Obj = Win32::ChangeNotify->new($PathName,$WatchSubTree,$Filter)
instead.
FindNext()
$obj->reset
instead.
Close()
$obj->close
instead.
Christopher J. Madsen <chris_madsen@geocities.com>
Loosely based on the original module by ActiveWare Internet Corp., http://www.ActiveWare.com
Win32::ChangeNotify - Monitor events related to files and directories |