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::ConfigData(3pm)			User Contributed Perl Documentation		       File::ChangeNotify::ConfigData(3pm)

NAME

       File::ChangeNotify::ConfigData - Configuration for File::ChangeNotify

SYNOPSIS

	 use File::ChangeNotify::ConfigData;
	 $value = File::ChangeNotify::ConfigData->config('foo');
	 $value = File::ChangeNotify::ConfigData->feature('bar');

	 @names = File::ChangeNotify::ConfigData->config_names;
	 @names = File::ChangeNotify::ConfigData->feature_names;

	 File::ChangeNotify::ConfigData->set_config(foo => $new_value);
	 File::ChangeNotify::ConfigData->set_feature(bar => $new_value);
	 File::ChangeNotify::ConfigData->write;  # Save changes

DESCRIPTION

       This module holds the configuration data for the "File::ChangeNotify" module.  It also provides a programmatic interface for getting or
       setting that configuration data.  Note that in order to actually make changes, you'll have to have write access to the
       "File::ChangeNotify::ConfigData" module, and you should attempt to understand the repercussions of your actions.

METHODS

       config($name)
	   Given a string argument, returns the value of the configuration item by that name, or "undef" if no such item exists.

       feature($name)
	   Given a string argument, returns the value of the feature by that name, or "undef" if no such feature exists.

       set_config($name, $value)
	   Sets the configuration item with the given name to the given value.	The value may be any Perl scalar that will serialize correctly
	   using "Data::Dumper".  This includes references, objects (usually), and complex data structures.  It probably does not include
	   transient things like filehandles or sockets.

       set_feature($name, $value)
	   Sets the feature with the given name to the given boolean value.  The value will be converted to 0 or 1 automatically.

       config_names()
	   Returns a list of all the names of config items currently defined in "File::ChangeNotify::ConfigData", or in scalar context the number
	   of items.

       feature_names()
	   Returns a list of all the names of features currently defined in "File::ChangeNotify::ConfigData", or in scalar context the number of
	   features.

       auto_feature_names()
	   Returns a list of all the names of features whose availability is dynamically determined, or in scalar context the number of such
	   features.  Does not include such features that have later been set to a fixed value.

       write()
	   Commits any changes from "set_config()" and "set_feature()" to disk.  Requires write access to the "File::ChangeNotify::ConfigData"
	   module.

AUTHOR

       "File::ChangeNotify::ConfigData" was automatically created using "Module::Build".  "Module::Build" was written by Ken Williams, but he
       holds no authorship claim or copyright claim to the contents of "File::ChangeNotify::ConfigData".

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