use Config;
-open OUT, ">FCGI.xs";
+do 'FCGI.cfg' or die "no FCGI.cfg";
-print "Generating FCGI.xs for Perl version $]\n";
-#unless (exists $Config{apiversion} && $Config{apiversion} >= 5.005)
-unless ($] >= 5.005) {
- for (qw(sv_undef diehook warnhook in_eval)) {
- print OUT "#define PL_$_ $_\n"
+open OUT, ">FCGI.pm";
+
+print "Generating FCGI.pm\n";
+print OUT <<'EOP';
+# $Id: FCGI.PL,v 1.27 2001/09/01 13:07:28 skimo Exp $
+
+package FCGI;
+
+require Exporter;
+require DynaLoader;
+
+@ISA = qw(Exporter DynaLoader);
+# Items to export into callers namespace by default. Note: do not export
+# names by default without a very good reason. Use EXPORT_OK instead.
+# Do not simply export all your public functions/methods/constants.
+@EXPORT = qw(
+
+);
+
+$VERSION = '0.60';
+
+EOP
+
+print OUT "bootstrap FCGI;\n" unless ($pure);
+
+print OUT <<'EOP' if ($pure);
+use Symbol;
+use POSIX 'ENOTCONN';
+
+use constant VERSION_1 => 1;
+
+use constant BEGIN_REQUEST => 1;
+use constant PARAMS => 4;
+use constant FCGI_STDIN => 5;
+use constant FCGI_STDOUT => 6;
+use constant FCGI_STDERR => 7;
+
+use constant RESPONDER => 1;
+use constant AUTHORIZER => 2;
+use constant FILTER => 3;
+
+%FCGI::rolenames = (RESPONDER, "RESPONDER",
+ AUTHORIZER, "AUTHORIZER",
+ FILTER, "FILTER",
+ );
+sub IsFastCGI {
+ my ($req) = @_;
+ $req->{isfastcgi} =
+ (!defined getpeername shift->{listen_sock}) && $! == ENOTCONN
+ unless exists $req->{isfastcgi};
+ return $req->{isfastcgi};
+}
+
+sub read_nv_len {
+ my ($stream) = @_;
+ my $buf;
+ return undef unless read $stream, $buf, 1, 0;
+ my ($len) = unpack("C", $buf);
+ if ($len & 0x80) {
+ $buf = pack("C", $len & 0x7F);
+ return undef unless read $stream, $buf, 3, 1;
+ $len = unpack("N", $buf);
}
+ $len;
}
-print OUT while <DATA>;
-close OUT;
-__END__
-/* $Id: FCGI.PL,v 1.8 1999/07/30 08:22:31 skimo Exp $ */
-
-#include "EXTERN.h"
-#include "perl.h"
-#include "XSUB.h"
-
-#include "fcgiapp.h"
-
-#ifndef FALSE
-#define FALSE (0)
-#endif
-
-#ifndef TRUE
-#define TRUE (1)
-#endif
-
-#ifdef WIN32
-#define environ _environ
-#endif
-
-extern char **environ;
-
-#ifdef USE_SFIO
-typedef struct
-{
- Sfdisc_t disc;
- FCGX_Stream *stream;
-} FCGI_Disc;
-
-static ssize_t
-sffcgiread(f, buf, n, disc)
-Sfio_t* f; /* stream involved */
-Void_t* buf; /* buffer to read into */
-size_t n; /* number of bytes to read */
-Sfdisc_t* disc; /* discipline */
-{
- return FCGX_GetStr(buf, n, ((FCGI_Disc *)disc)->stream);
-}
-
-static ssize_t
-sffcgiwrite(f, buf, n, disc)
-Sfio_t* f; /* stream involved */
-const Void_t* buf; /* buffer to read into */
-size_t n; /* number of bytes to read */
-Sfdisc_t* disc; /* discipline */
-{
- n = FCGX_PutStr(buf, n, ((FCGI_Disc *)disc)->stream);
- FCGX_FFlush(((FCGI_Disc *)disc)->stream);
- return n;
-}
-
-Sfdisc_t *
-sfdcnewfcgi(stream)
- FCGX_Stream *stream;
-{
- FCGI_Disc* disc;
-
- New(1000,disc,1,FCGI_Disc);
- if (!disc) return (Sfdisc_t *)disc;
-
- disc->disc.exceptf = (Sfexcept_f)NULL;
- disc->disc.seekf = (Sfseek_f)NULL;
- disc->disc.readf = sffcgiread;
- disc->disc.writef = sffcgiwrite;
- disc->stream = stream;
- return (Sfdisc_t *)disc;
-}
-
-Sfdisc_t *
-sfdcdelfcgi(disc)
- Sfdisc_t* disc;
-{
- Safefree(disc);
- return 0;
+
+sub RequestX {
+ my $self = {
+ in => shift,
+ out => shift,
+ err => shift,
+ env => shift,
+ socket => shift,
+ flags => shift,
+ };
+ open $self->{listen_sock}, "<&=0";
+ bless $self, "FCGI";
}
-#endif
-
-static int isCGI = -1; /* -1: not checked; 0: FCGI; 1: FCGI */
-
-static FCGX_Request global_fcgx_request;
-
-typedef struct FCGP_Request {
- int compat;
- int acceptCalled;
- int finishCalled;
- SV* svin;
- SV* svout;
- SV* sverr;
- GV* gv[3];
- GV* gvNew[3];
- HV* hvEnv;
- FCGX_Stream* in;
- FCGX_ParamArray envp;
- FCGX_Request* requestPtr;
-#ifdef USE_SFIO
- int sfcreated[3];
-#endif
-} FCGP_Request;
-
-static FCGP_Request global_request;
-static SV* global_sverr;
-
-static int
-FCGI_Flush(FCGP_Request* request)
-{
- if(!request->acceptCalled || isCGI) {
- return;
+
+my $run_once = 0;
+
+sub Accept {
+ my ($req) = @_;
+
+ unless ($req->IsFastCGI()) {
+ return -1 if $run_once;
+
+ $run_once = 1;
+ return 0;
}
-#ifdef USE_SFIO
- sfsync(IoOFP(GvIOp(request->gv[1])));
- sfsync(IoOFP(GvIOp(request->gv[2])));
-#else
- FCGX_FFlush((FCGX_Stream *) SvIV((SV*) SvRV(request->svout)));
- FCGX_FFlush((FCGX_Stream *) SvIV((SV*) SvRV(request->sverr)));
-#endif
-}
-
-static void
-FCGI_UndoBinding(FCGP_Request* request)
-{
-#ifdef USE_SFIO
- IO *io[3];
- int i;
-#endif
-
-#ifdef USE_SFIO
- sfdcdelfcgi(sfdisc(IoIFP(io[0] = GvIOp(request->gv[0])), SF_POPDISC));
- sfdcdelfcgi(sfdisc(IoOFP(io[1] = GvIOp(request->gv[1])), SF_POPDISC));
- sfdcdelfcgi(sfdisc(IoOFP(io[2] = GvIOp(request->gv[2])), SF_POPDISC));
- for (i = 0; i < 3; ++i) {
- if (request->sfcreated[i]) {
- sfclose(IoIFP(io[i]));
- IoIFP(io[i]) = IoOFP(io[i]) = Nullfp;
- request->sfcreated[i] = FALSE;
- }
+ $req->Finish();
+ $req->{socket} = gensym();
+ if (!accept($req->{socket}, $req->{listen_sock})) {
+ $req->{error} = "accept";
+ return -1;
}
-#else
- FCGI_Flush(request);
- sv_unmagic((SV *)request->gv[0], 'q');
- sv_unmagic((SV *)request->gv[1], 'q');
- sv_unmagic((SV *)request->gv[2], 'q');
-#endif
-}
-
-static int
-FCGI_Accept(FCGP_Request* request)
-{
- if(isCGI == -1) {
- /*
- * First call to FCGI_Accept. Is application running
- * as FastCGI or as CGI?
- */
- isCGI = FCGX_IsCGI();
- } else if(isCGI) {
- /*
- * Not first call to FCGI_Accept and running as CGI means
- * application is done.
- */
- return(EOF);
- }
- if(request->acceptCalled && !request->finishCalled) {
- FCGI_UndoBinding(request);
+ my ($type, $id, $body) = $req->read_record();
+ if ($type != BEGIN_REQUEST) {
+ $req->{error} = "begin request";
+ return -1;
}
- if(!isCGI) {
-#ifdef USE_SFIO
- IO *io[3];
- int i;
-#endif
- FCGX_Stream *out, *error;
- int acceptResult = FCGX_Accept_r(&request->in, &out, &error,
- &request->envp,
- request->requestPtr);
- if(acceptResult < 0) {
- return acceptResult;
- }
-#ifdef USE_SFIO
- for (i = 0; i < 3; ++i) {
- io[i] = GvIOn(request->gv[i] = request->gvNew[i]);
- if (!(i == 0 ? IoIFP(io[i]) : IoOFP(io[i]))) {
- IoIFP(io[i]) = sftmp(0);
- /*IoIFP(io[i]) = sfnew(NULL, NULL, SF_UNBOUND, 0,
- SF_STRING | (i ? SF_WRITE : SF_READ));*/
- if (i != 0) IoOFP(io[i]) = IoIFP(io[i]);
- request->sfcreated[i] = TRUE;
- }
- }
- sfdisc(IoIFP(io[0]), sfdcnewfcgi(request->in));
- sfdisc(IoOFP(io[1]), sfdcnewfcgi(out));
- sfdisc(IoOFP(io[2]), sfdcnewfcgi(error));
-#else
- if (!request->svout) {
- newSVrv(request->svout = newSV(0), "FCGI::Stream");
- newSVrv(request->sverr = newSV(0), "FCGI::Stream");
- newSVrv(request->svin = newSV(0), "FCGI::Stream");
- }
- sv_magic((SV *)request->gv[1] = request->gvNew[1],
- request->svout, 'q', Nullch, 0);
- sv_magic((SV *)request->gv[2] = request->gvNew[2],
- request->sverr, 'q', Nullch, 0);
- sv_magic((SV *)request->gv[0] = request->gvNew[0],
- request->svin, 'q', Nullch, 0);
- sv_setiv(SvRV(request->svout), (IV) out);
- sv_setiv(SvRV(request->sverr), (IV) error);
- sv_setiv(SvRV(request->svin), (IV) request->in);
-
- if (request->compat) {
- global_sverr = request->sverr;
- if (PL_warnhook) SvREFCNT_dec(PL_warnhook);
- PL_warnhook = SvREFCNT_inc(GvCV(gv_fetchmethod(Nullhv, "FCGI::WARN")));
- if (PL_diehook) SvREFCNT_dec(PL_diehook);
- PL_diehook = SvREFCNT_inc(GvCV(gv_fetchmethod(Nullhv, "FCGI::DIE")));
- }
-#endif
- request->finishCalled = FALSE;
+ my ($role, $flags) = unpack("nC", $body);
+ $req->{role} = $role;
+ $req->{flags} = $flags;
+ $req->{id} = $id;
+
+ %{$req->{env}} = ();
+ $req->{env}{FCGI_ROLE} = $FCGI::rolenames{$req->{role}};
+ my $param = FCGI::Stream->new($req, PARAMS);
+ my ($nlen, $vlen);
+ while (defined($nlen = read_nv_len($param)) &&
+ defined($vlen = read_nv_len($param))) {
+ my ($name, $val);
+ read $param, $name, $nlen;
+ read $param, $val, $vlen;
+ $req->{env}{$name} = $val;
}
- request->acceptCalled = TRUE;
+ $req->Bind;
+ $req->{accepted} = 1;
+
return 0;
}
-static void
-FCGI_Finish(FCGP_Request* request)
-{
- if(!request->acceptCalled || isCGI) {
- return;
+sub UndoBindings {
+ my ($req) = @_;
+ untie ${$req->{in}};
+ untie ${$req->{out}};
+ untie ${$req->{err}};
+ $req->{bound} = 0;
+}
+
+sub Bind {
+ my ($req) = @_;
+ tie ${$req->{in}}, 'FCGI::Stream', $req, FCGI_STDIN;
+ tie ${$req->{out}}, 'FCGI::Stream', $req, FCGI_STDOUT;
+ tie ${$req->{err}}, 'FCGI::Stream', $req, FCGI_STDERR;
+ $req->{bound} = 1;
+}
+
+sub Attach {
+ my ($req) = @_;
+ $req->Bind() if ($req->{accepted} && !$req->{bound});
+}
+
+sub Detach {
+ my ($req) = @_;
+ $req->UndoBindings() if ($req->{accepted} && $req->{bound});
+}
+
+sub Finish {
+ my ($req) = @_;
+ return unless $req->{accepted};
+ if ($req->{bound}) {
+ $req->UndoBindings();
+ close ${$req->{out}};
+ close ${$req->{err}};
}
- FCGI_UndoBinding(request);
- request->in = NULL;
- FCGX_Finish_r(request->requestPtr);
- request->finishCalled = TRUE;
-#ifndef USE_SFIO
- if (request->compat) {
- if (PL_warnhook == (SV*)GvCV(gv_fetchmethod(Nullhv, "FCGI::WARN"))) {
- SvREFCNT_dec(PL_warnhook);
- PL_warnhook = Nullsv;
- }
- if (PL_diehook == (SV*)GvCV(gv_fetchmethod(Nullhv, "FCGI::DIE"))) {
- SvREFCNT_dec(PL_diehook);
- PL_diehook = Nullsv;
+ $req->{accepted} = 0;
+}
+
+sub DESTROY {
+ shift->Finish();
+}
+
+sub read_record {
+ my ($self) = @_;
+ my ($header, $body);
+
+ read($self->{socket}, $header, 8);
+ my ($version, $type, $id, $clen, $plen) = unpack("CCnnC", $header);
+ read($self->{socket}, $body, $clen+$plen);
+ $body = undef if $clen == 0;
+ ($type, $id, $body);
+}
+
+sub read {
+ my ($self, $rtype, $len) = @_;
+ while (length $self->{buf} < $len) {
+ my ($type, $id, $buf) = $self->read_record();
+ return undef unless defined $buf;
+ if ($type != $rtype) {
+ $self->{error} = "unexpected stream type";
+ return 0;
}
+ $self->{buf} .= $buf;
}
-#endif
+ my ($newbuf, $result) = (substr($self->{buf}, $len),
+ substr($self->{buf}, 0, $len));
+ $self->{buf} = $newbuf;
+ $result;
}
-static int
-FCGI_StartFilterData(FCGP_Request* request)
-{
- return request->in ? FCGX_StartFilterData(request->in) : -1;
+sub Flush {
+ my ($req) = @_;
}
-static void
-FCGI_SetExitStatus(FCGP_Request* request, int status)
-{
- if (request->in) FCGX_SetExitStatus(status, request->in);
+sub write {
+ my ($self, $type, $content, $len) = @_;
+ return unless $len > 0;
+ $self->write_record($type, $content, $len);
}
-static FCGP_Request *
-FCGI_Request()
-{
- FCGX_Request* fcgx_req;
- FCGP_Request* req;
+sub write_record {
+ my ($self, $type, $content, $len) = @_;
+ my $padlen = (8 - ($len % 8)) % 8;
+ my $templ = "CCnnCxa${len}x$padlen";
+ my $data = pack($templ,
+ VERSION_1, $type, $self->{id}, $len, $padlen, $content);
+ syswrite $self->{socket}, $data;
+}
- Newz(551, fcgx_req, 1, FCGX_Request);
- Newz(551, req, 1, FCGP_Request);
- req->requestPtr = fcgx_req;
+{ package FCGI::Stream;
- return req;
+sub new {
+ my ($class, $src, $type) = @_;
+ my $handle = do { \local *FH };
+ tie($$handle, $class, $src, $type);
+ $handle;
}
-static void
-FCGI_Release_Request(FCGP_Request *req)
-{
- Safefree(req->requestPtr);
- Safefree(req);
+sub TIEHANDLE {
+ my ($class, $src, $type) = @_;
+ bless { src => $src, type => $type }, $class;
}
-static void
-populate_env(envp, hv)
-char **envp;
-HV *hv;
-{
- int i;
- char *p, *p1;
- SV *sv;
+sub READ {
+ my ($stream, undef, $len, $offset) = @_;
+ my ($ref) = \$_[1];
+ my $buf = $stream->{src}->read($stream->{type}, $len);
+ return undef unless defined $buf;
+ substr($$ref, $offset, 0, $buf);
+ length $buf;
+}
- for(i = 0; ; i++) {
- if((p = envp[i]) == NULL) {
- break;
- }
- p1 = strchr(p, '=');
- assert(p1 != NULL);
- sv = newSVpv(p1 + 1, 0);
- /* call magic for this value ourselves */
- hv_store(hv, p, p1 - p, sv, 0);
- SvSETMAGIC(sv);
+sub PRINT {
+ my ($stream) = shift;
+ for (@_) {
+ $stream->{src}->write($stream->{type}, $_, length($_));
}
}
-/*
- * For each variable in the array envp, either set or unset it
- * in the global hash %ENV.
- */
-static void
-DoPerlEnv(envp, set)
-char **envp;
-int set;
-{
- if (!set)
- perl_eval_pv("%ENV = %FCGI::ENV", 0);
- else {
- perl_eval_pv("%FCGI::ENV = %ENV", 0);
- populate_env(envp, perl_get_hv("ENV", TRUE));
- }
+sub CLOSE {
+ my ($stream) = @_;
+ $stream->{src}->write_record($stream->{type}, undef, 0);
}
-#define REQUEST_ARG(arg,request) \
- if (sv_isa(ST(arg), "FCGI")) { \
- request = (FCGP_Request*) SvIV((SV*)SvRV(ST(arg))); \
- } else \
- croak("request is not of type FCGI")
+}
-typedef FCGX_Stream * FCGI__Stream;
-typedef FCGP_Request * FCGI;
+EOP
+print OUT while <DATA>;
+close OUT;
+__END__
-MODULE = FCGI PACKAGE = FCGI
+# Preloaded methods go here.
-BOOT:
- FCGX_Init();
- FCGX_InitRequest(&global_fcgx_request);
- memset(&global_request, 0, sizeof(global_request));
- global_request.compat = 1;
- global_request.requestPtr = &global_fcgx_request;
- global_request.gvNew[0] = gv_fetchpv("STDIN",TRUE, SVt_PVIO);
- global_request.gvNew[1] = gv_fetchpv("STDOUT",TRUE, SVt_PVIO);
- global_request.gvNew[2] = gv_fetchpv("STDERR",TRUE, SVt_PVIO);
+# Autoload methods go after __END__, and are processed by the autosplit program.
+*FAIL_ACCEPT_ON_INTR = sub() { 1 };
-SV *
-request()
+sub Request(;***$$$) {
+ my @defaults = (\*STDIN, \*STDOUT, \*STDERR, \%ENV, 0, 0);
+ splice @defaults,0,@_,@_;
+ RequestX(@defaults);
+}
- PROTOTYPE:
- CODE:
- RETVAL = Perl_sv_setref_pv(Perl_newSV(0), "FCGI", FCGI_Request());
+sub accept() {
+ warn "accept called as a method; you probably wanted to call Accept" if @_;
+ if (defined %FCGI::ENV) {
+ %ENV = %FCGI::ENV;
+ } else {
+ %FCGI::ENV = %ENV;
+ }
+ my $rc = Accept($global_request);
+ for (keys %FCGI::ENV) {
+ $ENV{$_} = $FCGI::ENV{$_} unless exists $ENV{$_};
+ }
- OUTPUT:
- RETVAL
+ # not SFIO
+ $SIG{__WARN__} = $warn_handler if (tied (*STDIN));
+ $SIG{__DIE__} = $die_handler if (tied (*STDIN));
+ return $rc;
+}
-int
-accept(...)
+sub finish() {
+ warn "finish called as a method; you probably wanted to call Finish" if @_;
+ %ENV = %FCGI::ENV if (defined %FCGI::ENV);
- PROTOTYPE: ;$***$
+ # not SFIO
+ if (tied (*STDIN)) {
+ delete $SIG{__WARN__} if ($SIG{__WARN__} == $warn_handler);
+ delete $SIG{__DIE__} if ($SIG{__DIE__} == $die_handler);
+ }
- PREINIT:
- FCGP_Request* request = &global_request;
+ Finish ($global_request);
+}
- CODE:
- if (items != 0 && items != 5)
- croak("Usage: FCGI::accept() or "
- "FCGI::accept(request, IN, OUT, ERR, env)");
- if (items) {
- static const char* names[] = {"", "IN", "OUT", "ERR"};
- int i;
+sub flush() {
+ warn "flush called as a method; you probably wanted to call Flush" if @_;
+ Flush($global_request);
+}
+
+sub detach() {
+ warn "detach called as a method; you probably wanted to call Detach" if @_;
+ Detach($global_request);
+}
+
+sub attach() {
+ warn "attach called as a method; you probably wanted to call Attach" if @_;
+ Attach($global_request);
+}
+
+# deprecated
+sub set_exit_status {
+}
+
+sub start_filter_data() {
+ StartFilterData($global_request);
+}
+
+$global_request = Request();
+$warn_handler = sub { print STDERR @_ };
+$die_handler = sub { print STDERR @_ unless $^S };
+
+package FCGI::Stream;
+
+sub PRINTF {
+ shift->PRINT(sprintf(shift, @_));
+}
+
+sub BINMODE {
+}
- REQUEST_ARG(0,request);
- for(i = 1; i <= 3; ++i) {
- if (SvROK(ST(i)) && isGV(SvRV(ST(i)))) {
- request->gvNew[i-1] = (GV*)SvRV(ST(i));
- } else
- croak("%s is not a GLOB reference", names[i]);
+sub READLINE {
+ my $stream = shift;
+ my ($s, $c);
+ my $rs = $/ eq '' ? "\n\n" : $/;
+ my $l = substr $rs, -1;
+ my $len = length $rs;
+
+ $c = $stream->GETC();
+ if ($/ eq '') {
+ while ($c eq "\n") {
+ $c = $stream->GETC();
}
- if (SvROK(ST(4)) && SvTYPE(SvRV(ST(4))) == SVt_PVHV) {
- request->hvEnv = (HV*)SvRV(ST(4));
- } else
- croak("env is not a reference to a hash");
}
- {
- int acceptStatus;
- /*
- * Unmake Perl variable settings for the request just completed.
- */
- if(request->envp != NULL) {
- DoPerlEnv(request->envp, FALSE);
- request->envp = NULL;
- }
- /*
- * Call FCGI_Accept but preserve environ.
- */
- acceptStatus = FCGI_Accept(request);
- /*
- * Make Perl variable settings for the new request.
- */
- if(acceptStatus >= 0 && !isCGI) {
- if (request->compat)
- DoPerlEnv(request->envp, TRUE);
- else {
- populate_env(request->envp, request->hvEnv);
- request->envp = NULL;
- }
- } else {
- request->envp = NULL;
- }
- RETVAL = acceptStatus;
+ while (defined $c) {
+ $s .= $c;
+ last if $c eq $l and substr($s, -$len) eq $rs;
+ $c = $stream->GETC();
}
- OUTPUT:
- RETVAL
+ $s;
+}
+sub OPEN {
+ $_[0]->CLOSE;
+ if (@_ == 2) {
+ return open($_[0], $_[1]);
+ } else {
+ my $rc;
+ eval("$rc = open($_[0], $_[1], $_[2])");
+ die $@ if $@;
+ return $rc;
+ }
+}
-void
-finish(...)
+1;
- PROTOTYPE: ;$
+=pod
- PREINIT:
- FCGP_Request* request = &global_request;
+=head1 NAME
- CODE:
- if (items != 0 && items != 1)
- croak("Usage: FCGI::finish() or "
- "FCGI::finish(request)");
- if (items) {
- REQUEST_ARG(0,request);
- }
- {
- /*
- * Unmake Perl variable settings for the completed request.
- */
- if(request->envp != NULL) {
- DoPerlEnv(request->envp, FALSE);
- request->envp = NULL;
- }
- /*
- * Finish the request.
- */
- FCGI_Finish(request);
+FCGI - Fast CGI module
+
+=head1 SYNOPSIS
+
+ use FCGI;
+
+ my $count = 0;
+ my $request = FCGI::Request();
+
+ while($request->Accept() >= 0) {
+ print("Content-type: text/html\r\n\r\n", ++$count);
}
+=head1 DESCRIPTION
-void
-flush(...)
+Functions:
- PROTOTYPE: ;$
+=over 4
- PREINIT:
- FCGP_Request* request = &global_request;
+=item FCGI::Request
- CODE:
- if (items != 0 && items != 1)
- croak("Usage: FCGI::flush([request])");
- if (items) {
- REQUEST_ARG(0,request);
- }
- FCGI_Flush(request);
+Creates a request handle. It has the following optional parameters:
-void
-set_exit_status(...)
+=over 8
- PROTOTYPE: $;$
+=item input perl file handle (default: \*STDIN)
- PREINIT:
- FCGP_Request* request = &global_request;
- int status;
+=item output perl file handle (default: \*STDOUT)
- CODE:
- if (items != 1 && items != 2)
- croak("Usage: FCGI::set_exit_status(status[,request])");
- if (items == 2) {
- REQUEST_ARG(0,request);
- }
- status = (int)SvIV(ST(items-1));
- FCGI_SetExitStatus(request, status);
+=item error perl file handle (default: \*STDERR)
-int
-start_filter_data(...)
+These filehandles will be setup to act as input/output/error
+on succesful Accept.
- PROTOTYPE: ;$
+=item environment hash reference (default: \%ENV)
- PREINIT:
- FCGP_Request* request = &global_request;
+The hash will be populated with the environment.
- CODE:
- if (items != 0 && items != 1)
- croak("Usage: FCGI::flush([request])");
- if (items) {
- REQUEST_ARG(0,request);
- }
- RETVAL = FCGI_StartFilterData(request);
+=item socket (default: 0)
- OUTPUT:
- RETVAL
+Socket to communicate with the server.
+Can be the result of the OpenSocket function.
+For the moment, it's the file descriptor of the socket
+that should be passed. This may change in the future.
+You should only use your own socket if your program
+is not started by a process manager such as mod_fastcgi
+(except for the FastCgiExternalServer case) or cgi-fcgi.
+If you use the option, you have to let your FastCGI
+server know which port (and possibly server) your program
+is listening on.
+See remote.pl for an example.
-void
-DESTROY(request)
- FCGI request;
+=item flags (default: 0)
- CODE:
- FCGI_Release_Request(request);
+Possible values:
+=over 12
+=item FCGI::FAIL_ACCEPT_ON_INTR
-MODULE = FCGI PACKAGE = FCGI::Stream
+If set, Accept will fail if interrupted.
+It not set, it will just keep on waiting.
-#ifndef USE_SFIO
-void
-DIE(msg)
- char * msg;
+=back
- CODE:
- if (!PL_in_eval) /* ? maybe !(PL_in_eval & 1) */
- FCGX_PutS(msg, (FCGX_Stream *) SvIV((SV*) SvRV(global_sverr)));
+=back
-void
-WARN(msg)
- char * msg;
+Example usage:
+ my $req = FCGI::Request;
- CODE:
- FCGX_PutS(msg, (FCGX_Stream *) SvIV((SV*) SvRV(global_sverr)));
+or:
+ my %env;
+ my $in = new IO::Handle;
+ my $out = new IO::Handle;
+ my $err = new IO::Handle;
+ my $req = FCGI::Request($in, $out, $err, \%env);
-void
-PRINT(stream, ...)
- FCGI::Stream stream;
+=item FCGI::OpenSocket(path, backlog)
- PREINIT:
- int n;
+Creates a socket suitable to use as an argument to Request.
- CODE:
- for (n = 1; n < items; ++n) {
- STRLEN len;
- register char *tmps = (char *)SvPV(ST(n),len);
- FCGX_PutStr(tmps, len, stream);
- }
- if (SvTRUEx(perl_get_sv("|", FALSE)))
- FCGX_FFlush(stream);
-
-int
-WRITE(stream, bufsv, len, ...)
- FCGI::Stream stream;
- SV * bufsv;
- int len;
-
- PREINIT:
- int offset;
- char * buf;
- STRLEN blen;
- int n;
-
- CODE:
- offset = (items == 4) ? (int)SvIV(ST(3)) : 0;
- buf = SvPV(bufsv, blen);
- if (offset < 0) offset += blen;
- if (len > blen - offset)
- len = blen - offset;
- if (offset < 0 || offset >= blen ||
- (n = FCGX_PutStr(buf+offset, len, stream)) < 0)
- ST(0) = &PL_sv_undef;
- else {
- ST(0) = sv_newmortal();
- sv_setpvf(ST(0), "%c", n);
- }
+=over 8
+
+=item path
-int
-READ(stream, bufsv, len, ...)
- FCGI::Stream stream;
- SV * bufsv;
- int len;
-
- PREINIT:
- int offset;
- char * buf;
-
- CODE:
- offset = (items == 4) ? (int)SvIV(ST(3)) : 0;
- if (! SvOK(bufsv))
- sv_setpvn(bufsv, "", 0);
- buf = SvGROW(bufsv, len+offset+1);
- len = FCGX_GetStr(buf+offset, len, stream);
- SvCUR_set(bufsv, len+offset);
- *SvEND(bufsv) = '\0';
- (void)SvPOK_only(bufsv);
- SvSETMAGIC(bufsv);
- RETVAL = len;
-
- OUTPUT:
- RETVAL
-
-SV *
-GETC(stream)
- FCGI::Stream stream;
-
- PREINIT:
- int retval;
-
- CODE:
- if ((retval = FCGX_GetChar(stream)) != -1) {
- ST(0) = sv_newmortal();
- sv_setpvf(ST(0), "%c", retval);
- } else ST(0) = &PL_sv_undef;
-
-bool
-CLOSE(stream)
- FCGI::Stream stream;
-
- ALIAS:
- DESTROY = 1
-
- CODE:
- RETVAL = FCGX_FClose(stream) != -1;
-
- OUTPUT:
- RETVAL
-
-#endif
+Pathname of socket or colon followed by local tcp port.
+Note that some systems take file permissions into account
+on Unix domain sockets, so you'll have to make sure that
+the server can write to the created file, by changing
+the umask before the call and/or changing permissions and/or
+group of the file afterwards.
+
+=item backlog
+
+Maximum length of the queue of pending connections.
+If a connection
+request arrives with the queue full the client may receive
+an error with an indication of ECONNREFUSED.
+
+=back
+
+=item FCGI::CloseSocket(socket)
+
+Close a socket opened with OpenSocket.
+
+=item $req->Accept()
+
+Accepts a connection on $req, attaching the filehandles and
+populating the environment hash.
+Returns 0 on success.
+If a connection has been accepted before, the old
+one will be finished first.
+
+Note that unlike with the old interface, no die and warn
+handlers are installed by default. This means that if
+you are not running an sfio enabled perl, any warn or
+die message will not end up in the server's log by default.
+It is advised you set up die and warn handlers yourself.
+FCGI.pm contains an example of die and warn handlers.
+
+=item $req->Finish()
+
+Finishes accepted connection.
+Also detaches filehandles.
+
+=item $req->Flush()
+
+Flushes accepted connection.
+
+=item $req->Detach()
+
+Temporarily detaches filehandles on an accepted connection.
+
+=item $req->Attach()
+
+Re-attaches filehandles on an accepted connection.
+
+=item $env = $req->GetEnvironment()
+
+Returns the environment parameter passed to FCGI::Request.
+
+=item ($in, $out, $err) = $req->GetHandles()
+
+Returns the file handle parameters passed to FCGI::Request.
+
+=item $isfcgi = $req->IsFastCGI()
+
+Returns whether or not the program was run as a FastCGI.
+
+=back
+
+=head1 AUTHOR
+
+Sven Verdoolaege <skimo@kotnet.org>
+
+=cut
+
+__END__