cvs commit: modperl-docs/src/download index_top.html
stas2002/08/20 19:19:49 Modified:src/download index_top.html Log: 1.99_05 was released Revision ChangesPath 1.8 +2 -2 modperl-docs/src/download/index_top.html Index: index_top.html === RCS file: /home/cvs/modperl-docs/src/download/index_top.html,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- index_top.html2 Aug 2002 06:35:14 - 1.7 +++ index_top.html21 Aug 2002 02:19:49 - 1.8 @@ -6,7 +6,7 @@ Current releases: -mod_perl 1.0: Version 1.27 - June 1, 2002 +mod_perl 1.0: Version 1.27 - Jun 1, 2002 http://perl.apache.org/dist/mod_perl-1.0-current.tar.gz";>Download | http://perl.apache.org/dist/mod_perl-1.0-current";>Browse | http://perl.apache.org/dist/mod_perl-1.0-current/Changes";>Changes | @@ -14,7 +14,7 @@ -mod_perl 2.0 (in development): Version 1.99_04 - June 22, 2002 +mod_perl 2.0 (in development): Version 1.99_05 - Aug 20, 2002 http://perl.apache.org/dist/mod_perl-2.0-current.tar.gz";>Download | http://perl.apache.org/dist/mod_perl-2.0-current";>Browse | http://perl.apache.org/dist/mod_perl-2.0-current/Changes";>Changes | - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/dist KEYS
cholet 2002/08/21 08:03:52 Modified:src/dist KEYS Log: update my key with new signatures Revision ChangesPath 1.3 +82 -62modperl-docs/src/dist/KEYS Index: KEYS === RCS file: /home/cvs/modperl-docs/src/dist/KEYS,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- KEYS 29 Jul 2002 15:54:08 - 1.2 +++ KEYS 21 Aug 2002 15:03:52 - 1.3 @@ -200,57 +200,66 @@ 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
cvs commit: modperl-docs/src/docs/2.0/api/mod_perl-2.0/Apache SubProcess.pod
stas2002/08/21 10:23:24
Modified:src/docs/2.0/api config.cfg
Added: src/docs/2.0/api/mod_perl-2.0/Apache SubProcess.pod
Log:
- start Apache::SubProcess documentation
- sort the pods order
Revision ChangesPath
1.10 +5 -4 modperl-docs/src/docs/2.0/api/config.cfg
Index: config.cfg
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/config.cfg,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- config.cfg22 Jul 2002 15:21:51 - 1.9
+++ config.cfg21 Aug 2002 17:23:24 - 1.10
@@ -15,11 +15,12 @@
group=> 'Apache',
chapters => [qw(
+mod_perl-2.0/Apache/Log.pod
+mod_perl-2.0/Apache/Reload.pod
mod_perl-2.0/Apache/RequestRec.pod
mod_perl-2.0/Apache/ServerUtil.pod
-mod_perl-2.0/Apache/Log.pod
+mod_perl-2.0/Apache/SubProcess.pod
mod_perl-2.0/Apache/compat.pod
-mod_perl-2.0/Apache/Reload.pod
)],
group=> 'APR',
@@ -30,11 +31,11 @@
group=> 'ModPerl',
chapters => [qw(
-ModPerl-Registry/ModPerl/Registry.pod
ModPerl-Registry/ModPerl/PerlRun.pod
+ModPerl-Registry/ModPerl/Registry.pod
+ModPerl-Registry/ModPerl/RegistryBB.pod
ModPerl-Registry/ModPerl/RegistryCooker.pod
ModPerl-Registry/ModPerl/RegistryLoader.pod
-ModPerl-Registry/ModPerl/RegistryBB.pod
)],
1.1
modperl-docs/src/docs/2.0/api/mod_perl-2.0/Apache/SubProcess.pod
Index: SubProcess.pod
===
=head1 NAME
Apache::SubProcess -- Executing SubProcesses from mod_perl
=head1 SYNOPSIS
use Apache::SubProcess ();
use Config;
use constant PERLIO_IS_ENABLED => $Config{useperlio};
# pass @ARGV / read from the process
$command = "/tmp/argv.pl";
@argv = qw(foo bar);
$out_fh = Apache::SubProcess::spawn_proc_prog($r, $command, [EMAIL
PROTECTED]);
$output = read_data($out_fh);
# pass environment / read from the process
$command = "/tmp/env.pl";
$r->subprocess_env->set(foo => "bar");
$out_fh = Apache::SubProcess::spawn_proc_prog($r, $command);
$output = read_data($out_fh);
# write to/read from the process
$command = "/tmp/in_out_err.pl";
($in_fh, $out_fh, $err_fh) =
Apache::SubProcess::spawn_proc_prog($r, $command);
print $in_fh "hello\n";
$output = read_data($out_fh);
$error = read_data($err_fh);
# helper function to work w/ and w/o perlio-enabled Perl
sub read_data {
my($fh) = @_;
my $data;
if (PERLIO_IS_ENABLED || IO::Select->new($fh)->can_read(10)) {
$data = <$fh>;
}
return defined $data ? $data : '';
}
=head1 DESCRIPTION
C provides the Perl API for running and
communicating with processes spawned from mod_perl handlers.
=head1 API
=head2 spawn_proc_prog()
$out_fh =
Apache::SubProcess::spawn_proc_prog($r, $command, [EMAIL PROTECTED]);
($in_fh, $out_fh, $err_fh) =
Apache::SubProcess::spawn_proc_prog($r, $command, [EMAIL PROTECTED]);
spawn_proc_prog() spawns a sub-process which exec()'s C<$command> and
returns the output pipe filehandle in the scalar context, or input,
output and error pipe filehandles in the list context. Using these
three pipes it's possible to communicate with the spawned process.
The third optional argument is a reference to an array which if passed
becomes ARGV to the spawned program.
It's possible to pass environment variables as well, by calling:
$r->subprocess_env->set($key => $value);
before spawning the subprocess.
There is an issue with reading from the read filehandle (C<$in_fh>)):
A pipe filehandle returned under perlio-disabled Perl needs to call
select() if the other end is not fast enough to send the data, since
the read is non-blocking.
A pipe filehandle returned under perlio-enabled Perl on the other hand
does the select() internally, because it's really a filehandle opened
via C<:APR> layer, which internally uses APR to communicate with the
pipe. The way APR is implemented Perl's select() cannot be used with
it (mainly because select() wants fileno() and APR is a crossplatform
implementation which hides the internal datastructure).
Therefore to write a portable code, you want to use select for
perlio-disabled Perl and do nothing for perlio-enabled Perl, hence you
can use something similar to the read_data() wrapper shown in the
L section.
=cut
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
