NAME

Supervisor::RPC::Client - The client interface to the Supervisors environment

SYNOPSIS

 use Supervisor::RPC::Client;

 my $rpc = Supervisor::RPC::Client->new()
 my $result = $rpc->start('sleeper');

DESCRIPTION

This is the client module for external access to the Supervisor. It provides methods to start/stop/reload and retrieve the status of managed processes.

METHODS

new

This initilaize the module and can take two parameters.

 Example:

     my $rpc = Supervisor::RPC::Client->new(
        -port    => 9505,
        -address => 'localhost'
     };

start

This method will start a managed process. It takes one parameter, the name of the process, and returns "started" if successful.

 Example:

     my $result = $rpc->start('sleeper');

stop

This method will stop a managed process. It takes one parameter, the name of the process, and returns "stopped" if successful.

 Example:

     my $result = $rpc->stop('sleeper');

status

This method will do a "stat" on a managed process. It takes one parameter, the name of the process, and returns "alive" if the process is running or "dead" if the process is not.

reload

This method will attempt to "reload" a managed process. It takes one parameter, the name of the process. It will return "reloaded".

 Example:

     my $result = $rpc->reload('sleeper');

SEE ALSO

 Supervisor
 Supervisor::Base
 Supervisor::Class
 Supervisor::Constants
 Supervisor::Controller
 Supervisor::Log
 Supervisor::Process
 Supervisor::ProcessFactory
 Supervisor::Session
 Supervisor::Utils
 Supervisor::RPC::Server
 Supervisor::RPC::Client

AUTHOR

Kevin L. Esteb, <kesteb@wsipc.org>

COPYRIGHT AND LICENSE

Copyright (C) 2009 by Kevin L. Esteb

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.5 or, at your option, any later version of Perl 5 you may have available.