=encoding UTF-8 =head1 NAME collectd-perl - Documentation of collectd's C =head1 SYNOPSIS LoadPlugin perl # ... IncludeDir "/path/to/perl/plugins" BaseName "Collectd::Plugins" EnableDebugger "" LoadPlugin "FooBar" Foo "Bar" =head1 DESCRIPTION The C embeds a Perl-interpreter into collectd and provides an interface to collectd's plugin system. This makes it possible to write plugins for collectd in Perl. This is a lot more efficient than executing a Perl-script every time you want to read a value with the C (see L) and provides a lot more functionality, too. =head1 CONFIGURATION =over 4 =item B I Loads the Perl plugin I. This does basically the same as B would do in a Perl program. As a side effect, the first occurrence of this option causes the Perl-interpreter to be initialized. =item B I Prepends IB<::> to all plugin names loaded after this option. This is provided for convenience to keep plugin names short. All Perl-based plugins provided with the I distributions reside in the C namespace. =item EB IE block This block may be used to pass on configuration settings to a Perl plugin. The configuration is converted into a config-item data type which is passed to the registered configuration callback. See below for details about the config-item data type and how to register callbacks. The I identifies the callback. It is used literally and independent of the B setting. =item B I[=I