GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MUNIN::NODE::OS (3)

.ds Aq ’

NAME

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

CONTENTS

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.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 MUNIN::NODE::OS (3) 2016-04-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.