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

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.

