collectd-perl(5): Mention that "Globals" should be enabled.
authorSebastian Harl <sh@tokkee.org>
Wed, 28 Jul 2010 20:42:48 +0000 (22:42 +0200)
committerSebastian Harl <sh@tokkee.org>
Wed, 28 Jul 2010 20:42:48 +0000 (22:42 +0200)
src/collectd-perl.pod

index 5637053..5c11b65 100644 (file)
@@ -4,7 +4,9 @@ collectd-perl - Documentation of collectd's C<perl plugin>
 
 =head1 SYNOPSIS
 
-  LoadPlugin perl
+  <LoadPlugin perl>
+    Globals true
+  </LoadPlugin>
   # ...
   <Plugin perl>
     IncludeDir "/path/to/perl/plugins"
@@ -25,6 +27,12 @@ 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<exec plugin> (see
 L<collectd-exec(5)>) and provides a lot more functionality, too.
 
+When loading the C<perl plugin>, the B<Globals> option should be enabled.
+Else, the perl plugin will fail to load any Perl modules implemented in C,
+which includes, amongst many others, the B<threads> module used by the plugin
+itself. See the documentation of the B<Globals> option in L<collectd.conf(5)>
+for details.
+
 =head1 CONFIGURATION
 
 =over 4