NAME
    MooseX::StdDaemon - Boilerplate for standard *nix daemons

SYNOPSIS
      ###
      # myapp.pl - the script/daemon you execute:
      ###
      use MyApp;
      MyApp->new_with_options()->daemon_action();

      ###
      # MyApp.pm - the class where you put your code:
      ###

      use Moose;
      with 'MooseX::StdDaemon';

      # default the configfile
      has +configfile { default => '/etc/myapp.yaml' }

      # Your class attributes like these can be specified
      #  on the commandline or in the configfile:
      has something {
        is => 'ro',
        isa => 'Int',
        documentation => '--something|-s    Some Thing',
      }

      sub run {
        my $self = shift;

        $self->do_stuff_a_daemon_does();
        $self->do_stuff_a_daemon_does();
        $self->do_stuff_a_daemon_does();

        return; # exits daemon, clearing pidfile
      }

      ###
      # Invoke with explicit configfile and pidfile locations:
      ###
      ./myapp.pl --something 123 --configfile /tmp/foo.yaml --pidfile /var/run/x.pid start

      ###
      # Invoke in foreground mode (does not daemonize, log output
      #  goes to STDERR):
      ###
      ./myapp.pl --something 234 --configfile /tmp/foo.yaml -f start

DESCRIPTION
    This role serves to pull together several useful MooseX roles into a
    standardized boilerplate for normal run-of-the-mill daemons. It
    automatically gives you daemonization with a pidfile, simple initscript
    integration, commandline flags with usage information, configfile
    support, and logging to syslog (or stderr if running in the foreground
    for debug purposes).

    Writing initscripts for your daemon is easy too. All of the hard parts
    have been wrapped up in this role already.

    Just invoke the daemon (with any necessary options like configfile) with
    any of the standard initscript commands (stop/start/restart/status) as
    the initscript action, as in (assuming you've got the rest of your
    normal OS initscript down):

      case "$1" in
        start)
              echo -n "Starting ${DESC}: "
              myapp.pl $OPTIONS start
              exit $?
              ;;
        stop)
              echo -n "Stopping ${DESC}: "
              myapp.pl $OPTIONS stop
              exit $?
              ;;
        restart)
              echo -n "Restarting ${DESC}: "
              myapp.pl $OPTIONS restart
              exit $?
              ;;
        status)
              echo -n "$DESC Status: "
              myapp.pl $OPTIONS status
              exit $?
              ;;

ATTRIBUTES
CLASS METHODS
  daemon_action
    This checks for standard start/stop/status/restart on the commandline
    and takes the appropriate action for you.

SEE ALSO
    Moose

    MooseX::Daemonize

    MooseX::Getopt

    MooseX::SimpleConfig

    MooseX::LazyLogDispatch

AUTHOR
    Brandon L. Black, <blblack@gmail.com>

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