.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Plack::Handler::Feersum 3pm"
.TH Plack::Handler::Feersum 3pm 2024-03-07 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
Plack::Handler::Feersum \- plack adapter for Feersum
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 3
\&    plackup \-s Feersum app.psgi
\&    plackup \-s Feersum \-\-listen localhost:8080 app.psgi
\&    plackup \-s Feersum \-\-pre\-fork=4 \-MMy::App \-L delayed app.psgi
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This is a stub module that allows Feersum to be loaded up under \f(CW\*(C`plackup\*(C'\fR and
other Plack tools.  Set \f(CW$ENV{PLACK_SERVER}\fR to 'Feersum' or use the \-s
parameter to plackup to use Feersum under Plack.
.SS "Experimental Features"
.IX Subsection "Experimental Features"
A \f(CW\*(C`\-\-pre\-fork=N\*(C'\fR parameter can be specified to put feersum into pre-forked
mode where N is the number of child processes.  The \f(CW\*(C`\-\-preload\-app\*(C'\fR parameter
that Starlet supports isn't supported yet.  The fork is run immediately
after startup and after the app is loaded (i.e. in the \f(CWrun()\fR method).
.SH METHODS
.IX Header "METHODS"
.ie n .IP assign_request_handler($app) 4
.el .IP \f(CWassign_request_handler($app)\fR 4
.IX Item "assign_request_handler($app)"
Assigns the PSGI request handler to Feersum.
.Sp
Also sets up a SIGTERM handler to call the \f(CWquit()\fR method so that
Plack::Loader::Restarter will work.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Most of the functionality is in Feersum::Runner (the base class)
.SH AUTHOR
.IX Header "AUTHOR"
Jeremy Stashewsky, \f(CW\*(C`stash@cpan.org\*(C'\fR
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
Copyright (C) 2010 by Jeremy Stashewsky & Socialtext Inc.
.PP
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.8.7 or,
at your option, any later version of Perl 5 you may have available.