lib/Catalyst/Restarter/Forking.pm

   1 package Catalyst::Restarter::Forking;
   2
   3 use Moose;
   4
   5 extends 'Catalyst::Restarter';
   6
   7 has _child => (
   8     is  => 'rw',
   9     isa => 'Int',
  10 );
  11
  12
  13 sub _fork_and_start {
  14     my $self = shift;
  15
  16     if ( my $pid = fork ) {
  17         $self->_child($pid);
  18     }
  19     else {
  20         $self->start_sub->();
  21     }
  22 }
  23
  24 sub _kill_child {
  25     my $self = shift;
  26
  27     return unless $self->_child;
  28
  29     return unless kill 0, $self->_child;
  30
  31     die "Cannot send INT signal to ", $self->_child, ": $!"
  32         unless kill 'INT', $self->_child;
  33     # If we don't wait for the child to exit, we could attempt to
  34     # start a new server before the old one has given up the port it
  35     # was listening on.
  36     wait;
  37 }
  38
  39 __PACKAGE__->meta->make_immutable;
  40
  41 1;
  42
  43 __END__
  44
  45 =head1 NAME
  46
  47 Catalyst::Restarter::Forking - Forks and restarts the child process
  48
  49 =head1 DESCRIPTION
  50
  51 This class forks and runs the server in a child process. When it needs
  52 to restart, it kills the child and creates a new one.
  53
  54 =head1 SEE ALSO
  55
  56 L<Catalyst::Restarter>, L<Catalyst>, <File::ChangeNotify>
  57
  58 =head1 AUTHORS
  59
  60 Catalyst Contributors, see Catalyst.pm
  61
  62 =head1 COPYRIGHT
  63
  64 This program is free software, you can redistribute it and/or modify
  65 it under the same terms as Perl itself.
  66
  67 =cut