ipc::run::safehandles(3pm) [debian man page]

IPC::Run::SafeHandles(3pm)				User Contributed Perl Documentation				IPC::Run::SafeHandles(3pm)

NAME

       IPC::Run::SafeHandles - Use IPC::Run and IPC::Run3 safely

SYNOPSIS

	   use IPC::Run::SafeHandles;

DESCRIPTION

       IPC::Run and IPC::Run3 are both very upset when you try to use them under environments where you have STDOUT and/or STDERR tied to
       something else, such as under fastcgi.

       The module adds safe-guarding code when you call IPC::Run or IPC::Run3 under such environment to make sure it always works.

       If you intend to release your code to work under normal envionrment as well as under fastcgi, simply use this module after the "IPC"
       modules are loaded in your code.

   unimport
       When unimport, the original IPC::Run and/or IPC::Run3 functions are restored.

AUTHOR

       Chia-liang Kao, "<clkao at bestpractical.com>"

BUGS

       Please report any bugs or feature requests to "bug-ipc-run-safehandles at rt.cpan.org", or through the web interface at
       <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=IPC-Run-SafeHandles>.  I will be notified, and then you'll automatically be notified of
       progress on your bug as I make changes.

SUPPORT

       You can find documentation for this module with the perldoc command.

	   perldoc IPC::Run::SafeHandles

       You can also look for information at:

       o   AnnoCPAN: Annotated CPAN documentation

	   <http://annocpan.org/dist/IPC-Run-SafeHandles>

       o   CPAN Ratings

	   <http://cpanratings.perl.org/d/IPC-Run-SafeHandles>

       o   RT: CPAN's request tracker

	   <http://rt.cpan.org/NoAuth/Bugs.html?Dist=IPC-Run-SafeHandles>

       o   Search CPAN

	   <http://search.cpan.org/dist/IPC-Run-SafeHandles>

ACKNOWLEDGEMENTS

COPYRIGHT &; LICENSE
       Copyright 2007 Chia-liang Kao, all rights reserved.

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

perl v5.10.0							    2009-01-28						IPC::Run::SafeHandles(3pm)

IPC::Run::Debug(3)					User Contributed Perl Documentation					IPC::Run::Debug(3)

NAME

       IPC::Run::Debug - debugging routines for IPC::Run

SYNOPSIS

	  ##
	  ## Environment variable usage
	  ##
	  ## To force debugging off and shave a bit of CPU and memory
	  ## by compile-time optimizing away all debugging code in IPC::Run
	  ## (debug => ...) options to IPC::Run will be ignored.
	  export IPCRUNDEBUG=none

	  ## To force debugging on (levels are from 0..10)
	  export IPCRUNDEBUG=basic

	  ## Leave unset or set to "" to compile in debugging support and
	  ## allow runtime control of it using the debug option.

DESCRIPTION

       Controls IPC::Run debugging.  Debugging levels are now set by using words, but the numbers shown are still supported for backwards
       compatibility:

	  0  none	  disabled (special, see below)
	  1  basic	  what's running
	  2  data	  what's being sent/recieved
	  3  details	  what's going on in more detail
	  4  gory	  way too much detail for most uses
	  10 all	  use this when submitting bug reports
	     noopts	  optimizations forbidden due to inherited STDIN

       The "none" level is special when the environment variable IPCRUNDEBUG is set to this the first time IPC::Run::Debug is loaded: it prevents
       the debugging code from being compiled in to the remaining IPC::Run modules, saving a bit of cpu.

       To do this in a script, here's a way that allows it to be overridden:

	  BEGIN {
	     unless ( defined $ENV{IPCRUNDEBUG} ) {
		eval 'local $ENV{IPCRUNDEBUG} = "none"; require IPC::Run::Debug"'
		   or die $@;
	     }
	  }

       This should force IPC::Run to not be debuggable unless somebody sets the IPCRUNDEBUG flag; modify this formula to grep @ARGV if need be:

	  BEGIN {
	     unless ( grep /^--debug/, @ARGV ) {
		eval 'local $ENV{IPCRUNDEBUG} = "none"; require IPC::Run::Debug"'
		or die $@;
	  }

       Both of those are untested.

AUTHOR

       Barrie Slaymaker <barries@slaysys.com>, with numerous suggestions by p5p.

perl v5.16.3							    2012-01-16							IPC::Run::Debug(3)