munin::node::os(3pm) [debian man page]

Munin::Node::OS(3pm)					User Contributed Perl Documentation				      Munin::Node::OS(3pm)

NAME

       Munin::Node::OS - OS related utility methods for the Munin node.

SYNOPSIS

	use Munin::Node::OS;
	my $uid  = Munin::Node::OS->get_uid('foo');
	my $host = Munin::Node::OS->get_fq_hostname();

METHODS

       get_uid
	    $uid = $class->get_uid($user)

	   Returns the user ID. $user might either be a user name or a user ID. Returns undef if the user doesn't exist.

       get_gid
	    $gid = $class->get_gid($group)

	   Returns the group ID. $group might either be a group name or a group ID. Returns undef if the group doesn't exist.

       get_fq_hostname
	    $host = $class->get_fq_hostname()

	   Returns the fully qualified host name of the machine.

       check_perms_if_paranoid
	    $bool = $class->check_perms_if_paranoid($target);

	   If paranoia is enabled, returns false unless $target is owned by root, and has safe permissions.  If $target is a file, also checks the
	   directory it inhabits.

       run_as_child
	     $result = run_as_child($timeout, $coderef, @arguments);

	   Creates a child process to run $code and waits for up to $timeout seconds for it to complete.  Returns a hashref containing the
	   following keys:

	   "stdout", "stderr"
	       Array references containing the output of these filehandles;

	   "retval"
	       The result of wait();

	   "timed_out"
	       True if the child had to be interrupted.

	   System errors will cause it to carp.

       reap_child_group
	    $class->reap_child_group($pid);

	   Sends SIGHUP and SIGKILL to the process group identified by $pid.

	   Sleeps for 2 seconds between SIGHUP and SIGKILL.

       possible_to_signal_process
	    my $bool = $class->possible_to_signal_process($pid)

	   Check whether it's possible to send a signal to $pid (that means, to be brief, that the process is owned by the same user, or we are
	   the super-user).  This is a useful way to check that a child process is alive (even if only as a zombie) and hasn't changed its UID.

       set_effective_user_id
	    eval {
		$class->set_effective_user_id($uid);
	    };
	    if ($@) {
		# Failed to set EUID
	    }

	   The name says it all ...

       set_effective_group_id
	   See documentation for set_effective_user_id()

       set_real_user_id
	   See documentation for set_effective_user_id()

       set_real_group_id
	   See documentation for set_effective_user_id()

       set_umask
	   Set umask so that files created by plugins are group writable Only call right before exec-ing a plugin.

perl v5.14.2							    2013-11-12						      Munin::Node::OS(3pm)

MUNIN-UPDATE(8) 						Munin Documentation						   MUNIN-UPDATE(8)

NAME

       munin-update - A program to gather data from machines running munin-node

SYNOPSIS

       munin-update [options]

	Options:
	    --config_file=<file>    Use <file> as configuration file.
	    --[no]debug 	    Enable [or disable] debug messages. [--nodebug]
	    --[no]fork		    Query hosts in parallell (--fork), or
				    sequentially (--nofork). [--fork]
	    --host <host>	    Limit graphed hosts to <host>. Multiple --host
				    options may be supplied.
	    --service <service>     Limit graphed services to <service>. Multiple
				    --service options may be supplied.
	    --timeout=<seconds>     TCP timeout when talking to clients. [$timeout]
	    --help		    View this message.
	    --version		    View version information.

OPTIONS

       --config_file=<file>
	    Use <file> as the configuration file. [/etc/munin/munin.conf]

       --[no]debug
	    If set, log debug messages. [--nodebug]

       --[no]fork
	    If set, will fork off one process for each host. [--fork]

       --host <host>
	    Limit fetched data to those from <host<gt>. Multiple --host options may be supplied. [unset]

       --service <service>
	    Limit fetched data to those of <service>. Multiple --service options may be supplied. [unset]

       --timeout <seconds>
	    Set the network timeout to <seconds>. [180]

       --help
	    Print the help message then exit.

       --version
	    Print version information then exit.

DESCRIPTION

       Munin-update is a part of the package Munin, which is used in combination with Munin's node.  Munin is a group of programs to gather data
       from Munin's nodes, graph them, create html-pages, and optionally warn Nagios about any off-limit values.

       Munin-update does the gathering. It is usually only used from within munin-cron.

       It contacts each host's munin-node in turn, gathers data from it, and stores them in .rrd-files. If necessary, it will create the rrd-files
       and the directories to store them in.

FILES

	       /etc/munin/munin.conf
	       /var/lib/munin/*
	       /var/log/munin/munin-update
	       /var/run/munin/*

BUGS

       For a list of bugs concerning munin-update, see FI.  ticket report"

       Please report bugs in the bug tracker at http://munin-monitoring.org/ <http://munin-monitoring.org/>.

AUTHORS

       The Munin Team. FIX

COPYRIGHT

       Copyright AX 2002-2009 Jimmy Olsen, Audun Ytterdal, Tore Andersson, Kjell-Magne A~Xierud, Linpro AS, Redpill Linpro AS

       This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
       PARTICULAR PURPOSE.

       This program is released under the GNU General Public License.

2.0.6-4+deb7u2							    2013-11-12							   MUNIN-UPDATE(8)