Skip to content
No description or website provided.
Perl
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib/Parse/Daemontools
t
.gitignore
.travis.yml
Build.PL
Changes
LICENSE
META.json
README.md
cpanfile
dist.ini

README.md

Build Status Coverage Status

NAME

Parse::Daemontools::Service - Retrieve status and env of service under daemontools

INSTALLATION

To install this module, run the following commands:

perl Build.PL
./Build
./Build test
./Build install

SYNOPSIS

Normally, Parse::Daemontools::Service requires root privileges because need to read /service/DAEMON/supervise/status file.

use Parse::Daemontools::Service;

my $ds = Parse::Daemontools::Service->new;
my $status = $ds->status("qmail");

my $status = $ds->status("my-daemon",
                         {
                             env_dir => "/service/my-daemon/my-env-dir",
                         });

my $status = $ds->status("my-daemon",
                         {
                             env_dir => [
                                 "/service/my-daemon/env",
                                 "/service/my-daemon/my-env-dir",
                             ],
                         });

DESCRIPTION

Parse::Daemontools::Service retrieves status and env of service under daemontools.

METHODS

  • new({ base_dir => Str })

    base_dir (optional): base directory of daemontools. Default is "/service"

  • status($service_name:Str, { env_dir => Str|ArrayRef[Str] })

    Return status and env of $service_name as following HashRef.

    +{
        service  => Str, # "/service/my-daemon"
        pid      => Int, # PID of daemon process
        seconds  => Int, # uptime of this daemon process
        start_at => Int, # UNIX time of this daemon process started at
        status   => Str, # "up" | "down"
        info     => Str, # "" | "normally down" | "normally up" | ...
        env      => {    # environment variables in envdir
            BAR => "bar",
            FOO => "foo"
        },
    },
    

    Default env_dir is "/service/my-daemon/env". You can specify env_dir(s) by Str or ArrayRef. When you specify more than one env_dirs, same key are overridden by latter env_dir.

AUTHOR

HIROSE Masaaki hirose31@gmail.com

REPOSITORY

https://github.com/hirose31/Parse-Daemontools-Service

git clone git://github.com/hirose31/Parse-Daemontools-Service.git

patches and collaborators are welcome.

SEE ALSO

svstat(1)

COPYRIGHT

Copyright HIROSE Masaaki

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Something went wrong with that request. Please try again.