GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  IPC::RUN::DEBUG (3)

.ds Aq ’

NAME

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

CONTENTS

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        whats running
   2  data         whats being sent/recieved
   3  details      whats 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.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 IPC::RUN::DEBUG (3) 2012-01-16

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.