NAME

Zing::Daemon - Process Daemon

ABSTRACT

Daemon Process Management

SYNOPSIS

use Zing::Cartridge;
use Zing::Daemon;

my $daemon = Zing::Daemon->new(
  cartridge => Zing::Cartridge->new(
    name => 'example',
    scheme => ['MyApp', [], 1],
  )
);

# $daemon->start;

DESCRIPTION

This package provides the mechanisms for running a Zing application as a daemon process.

INHERITS

This package inherits behaviors from:

Zing::Entity

LIBRARIES

This package uses type constraints from:

Zing::Types

ATTRIBUTES

This package has the following attributes:

cartridge

cartridge(Cartridge)

This attribute is read-only, accepts (Cartridge) values, and is required.

journal

journal(Journal)

This attribute is read-only, accepts (Journal) values, and is optional.

kernel

kernel(Zing)

This attribute is read-only, accepts (Zing) values, and is optional.

log_filter_from

log_filter_from(Str)

This attribute is read-only, accepts (Str) values, and is optional.

log_filter_queries

log_filter_queries(ArrayRef[Str])

This attribute is read-only, accepts (ArrayRef[Str]) values, and is optional.

log_filter_tag

log_filter_tag(Str)

This attribute is read-only, accepts (Str) values, and is optional.

log_level

log_level(Str)

This attribute is read-only, accepts (Str) values, and is optional.

log_reset

log_reset(Bool)

This attribute is read-only, accepts (Bool) values, and is optional.

log_verbose

log_verbose(Bool)

This attribute is read-only, accepts (Bool) values, and is optional.

logger

logger(Logger)

This attribute is read-only, accepts (Logger) values, and is optional.

METHODS

This package implements the following methods:

fork

fork() : Int

The fork method forks the application and returns a pid.

fork example #1

# given: synopsis

my $pid = $daemon->fork;

restart

restart() : Bool

The restart method stops and then starts the application and creates a pid file under the "pidfile" in Zing::Cartridge.

restart example #1

use FlightRecorder;
use Zing::Cartridge;
use Zing::Daemon;

my $daemon = Zing::Daemon->new(
  logger => FlightRecorder->new(auto => undef),
  cartridge => Zing::Cartridge->new(
    name => 'example',
    scheme => ['MyApp', [], 1],
  )
);

$daemon->restart;

start

start() : Bool

The start method forks the application and creates a pid file under the "pidfile" in Zing::Cartridge.

start example #1

use FlightRecorder;
use Zing::Cartridge;
use Zing::Daemon;

my $daemon = Zing::Daemon->new(
  logger => FlightRecorder->new(auto => undef),
  cartridge => Zing::Cartridge->new(
    name => 'example',
    scheme => ['MyApp', [], 1],
  )
);

$daemon->start;

stop

stop() : Bool

The stop method stops the application and removes the pid file under the "pidfile" in Zing::Cartridge.

stop example #1

use FlightRecorder;
use Zing::Cartridge;
use Zing::Daemon;

my $daemon = Zing::Daemon->new(
  logger => FlightRecorder->new(auto => undef),
  cartridge => Zing::Cartridge->new(
    name => 'example',
    scheme => ['MyApp', [], 1],
  )
);

$daemon->stop;

AUTHOR

Al Newkirk, awncorp@cpan.org

LICENSE

This is free software; you can redistribute it and/or modify it under the terms of the The Apache License, Version 2.0, as elucidated in the "license file".