DragonFly On-Line Manual Pages
Munin::Node::OS(3) User Contributed Perl Documentation Munin::Node::OS(3)
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.20.3 2016-02-19 Munin::Node::OS(3)