file::changenotify::watcher::kqueue(3pm) [debian man page]

File::ChangeNotify::Watcher::KQueue(3pm)		User Contributed Perl Documentation		  File::ChangeNotify::Watcher::KQueue(3pm)

NAME

       File::ChangeNotify::Watcher::KQueue - KQueue-based watcher subclass

DESCRIPTION

       This class implements watching using IO::KQueue, which must be installed for it to work. This is a BSD alternative to Linux's Inotify and
       similar event-based systems.

CAVEATS

       Although this watcher is more efficient and accurate than the "File::ChangeNotify::Watcher::Default" class, in order to monitor files and
       directories, it must open filehandles to each of them. Because many BSD systems have relatively low defaults for the maximum number of
       files each process can open, you may find you run out of file descriptors.

       On FreeBSD, you can check (and alter) your system's settings with "sysctl" if necessary. The important keys are: "kern.maxfiles" and
       "kern.maxfilesperproc".	You can see how many files your system current has open with "kern.openfiles".

       On OpenBSD, the "sysctl" keys are "kern.maxfiles" and "kern.nfiles".  Per-process limits are set in /etc/login.conf. See login.conf(5) for
       details.

SUPPORT

       I (Dave Rolsky) cannot test this class, as I have no BSD systems. Reasonable patches will be applied as-is, and when possible I will
       consult with Dan Thomas or other BSD users before releasing.

AUTHOR

       Dan Thomas, <dan@cpan.org>

COPYRIGHT AND LICENSE

       This software is Copyright (c) 2010 by Dave Rolsky.

       This is free software, licensed under:

	 The Artistic License 2.0

perl v5.14.2							    2012-04-14				  File::ChangeNotify::Watcher::KQueue(3pm)

File::ChangeNotify(3pm) 				User Contributed Perl Documentation				   File::ChangeNotify(3pm)

NAME

       File::ChangeNotify - Watch for changes to files, cross-platform style

VERSION

       version 0.22

SYNOPSIS

	   use File::ChangeNotify;

	   my $watcher =
	       File::ChangeNotify->instantiate_watcher
		   ( directories => [ '/my/path', '/my/other' ],
		     filter	 => qr/.(?:pm|conf|yml)$/,
		   );

	   if ( my @events = $watcher->new_events() ) { ... }

	   # blocking
	   while ( my @events = $watcher->wait_for_events() ) { ... }

DESCRIPTION

       This module provides an API for creating a File::ChangeNotify::Watcher subclass that will work on your platform.

       Most of the documentation for this distro is in File::ChangeNotify::Watcher.

METHODS

       This class provides the following methods:

   File::ChangeNotify->instantiate_watcher(...)
       This method looks at each available subclass of File::ChangeNotify::Watcher and instantiates the first one it can load, using the arguments
       you provided.

       It always tries to use the File::ChangeNotify::Watcher::Default class last, on the assumption that any other class that is available is a
       better option.

   File::ChangeNotify->usable_classes()
       Returns a list of all the loadable File::ChangeNotify::Watcher subclasses.

BUGS

       Please report any bugs or feature requests to "bug-file-changenotify@rt.cpan.org", or through the web interface at <http://rt.cpan.org>.  I
       will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

DONATIONS

       If you'd like to thank me for the work I've done on this module, please consider making a "donation" to me via PayPal. I spend a lot of
       free time creating free software, and would appreciate any support you'd care to offer.

       Please note that I am not suggesting that you must do this in order for me to continue working on this particular software. I will continue
       to do so, inasmuch as I have in the past, for as long as it interests me.

       Similarly, a donation made in this way will probably not make me work on this software much more, unless I get so many donations that I can
       consider working on free software full time, which seems unlikely at best.

       To donate, log into PayPal and send money to autarch@urth.org or use the button on this page: http://www.urth.org/~autarch/fs-donation.html
       <http://www.urth.org/~autarch/fs-donation.html>

AUTHOR

       Dave Rolsky <autarch@urth.org>

COPYRIGHT AND LICENSE

       This software is Copyright (c) 2012 by Dave Rolsky.

       This is free software, licensed under:

	 The Artistic License 2.0 (GPL Compatible)

perl v5.14.2							    2012-04-14						   File::ChangeNotify(3pm)