X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlrun.pod;h=22f8d35e5db091fd2766eb69e0b3603ba93a77d3;hb=2810d90162dc487ea10933114344f32d14b3d619;hp=be366f8afd9f1c7031e2f5904382737a5f38709c;hpb=a66b22caf4f0cb9d9cd0ec14a50f27dd54688a86;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlrun.pod b/pod/perlrun.pod index be366f8..22f8d35 100644 --- a/pod/perlrun.pod +++ b/pod/perlrun.pod @@ -6,7 +6,7 @@ perlrun - how to execute the Perl interpreter B S<[ B<-sTtuUWX> ]> S<[ B<-hv> ] [ B<-V>[:I] ]> - S<[ B<-cw> ] [ B<-d>[:I] ] [ B<-D>[I] ]> + S<[ B<-cw> ] [ B<-d>[B][:I] ] [ B<-D>[I] ]> S<[ B<-pna> ] [ B<-F>I ] [ B<-l>[I] ] [ B<-0>[I] ]> S<[ B<-I>I ] [ B<-m>[B<->]I ] [ B<-M>[B<->]I<'module...'> ]> S<[ B<-P> ]> @@ -342,16 +342,24 @@ be skipped. =item B<-d> +=item B<-dt> + runs the program under the Perl debugger. See L. +If B is specified, it indicates to the debugger that threads +will be used in the code being debugged. =item B<-d:>I +=item B<-dt:>I + runs the program under the control of a debugging, profiling, or tracing module installed as Devel::foo. E.g., B<-d:DProf> executes the program using the Devel::DProf profiler. As with the B<-M> flag, options may be passed to the Devel::foo package where they will be received and interpreted by the Devel::foo::import routine. The comma-separated list of options must follow a C<=> character. +If B is specified, it indicates to the debugger that threads +will be used in the code being debugged. See L. =item B<-D>I @@ -368,8 +376,7 @@ As an alternative, specify a number instead of list of letters (e.g., B<-D14> is equivalent to B<-Dtls>): 1 p Tokenizing and parsing (with v, displays parse stack) - 2 s Stack snapshots - with v, displays all stacks + 2 s Stack snapshots (with v, displays all stacks) 4 l Context (loop) stack processing 8 t Trace execution 16 o Method and overloading resolution @@ -391,7 +398,7 @@ B<-D14> is equivalent to B<-Dtls>): 1048576 v Verbose: use in conjunction with other flags 2097152 C Copy On Write 4194304 A Consistency checks on internal structures - 8388608 q quiet - currently only suppressed the "EXECUTING" message + 8388608 q quiet - currently only suppresses the "EXECUTING" message All these flags require B<-DDEBUGGING> when you compile the Perl executable (but see L, L which may change this). @@ -534,8 +541,8 @@ folks use it for their backup files: $ perl -pi~ -e 's/foo/bar/' file1 file2 file3... Note that because B<-i> renames or deletes the original file before -creating a new file of the same name, UNIX-style hard links will not be -preserved. +creating a new file of the same name, UNIX-style soft and hard links will +not be preserved. Finally, the B<-i> switch does not impede execution when no files are given on the command line. In this case, no backup is made @@ -609,7 +616,7 @@ Note that the lines are not printed by default. See B<-p> to have lines printed. If a file named by an argument cannot be opened for some reason, Perl warns you about it and moves on to the next file. -Here is an efficient way to delete all files that haven't been modifed for +Here is an efficient way to delete all files that haven't been modified for at least a week: find . -mtime +7 -print | perl -nle unlink @@ -723,7 +730,8 @@ if it is invoked with B<-xyz=abc>. if ($xyz) { print "$xyz\n" } Do note that B<--help> creates the variable ${-help}, which is not compliant -with C. +with C. Also, when using this option on a script with +warnings enabled you may get a lot of spurious "used only once" warnings. =item B<-S> @@ -834,12 +842,14 @@ prints the version and patchlevel of your perl executable. prints summary of the major perl configuration values and the current values of @INC. -=item B<-V:>I +=item B<-V:>I Prints to STDOUT the value of the named configuration variable(s), -with multiples when your query looks like a regex. -For example, +with multiples when your configvar argument looks like a regex (has +non-letters). For example: + $ perl -V:libc + libc='/lib/libc-2.2.4.so'; $ perl -V:lib. libs='-lnsl -lgdbm -ldb -ldl -lm -lcrypt -lutil -lc'; libc='/lib/libc-2.2.4.so'; @@ -860,7 +870,7 @@ you to embed queries into shell commands. (mnemonic: PATH separator compression-vars: zcat='' zip='zip' are here ! A leading colon removes the 'name=' part of the response, this allows -you to map to the name you need. +you to map to the name you need. (mnemonic: empty label) $ echo "goodvfork="`./perl -Ilib -V::usevfork` goodvfork=false; @@ -1094,6 +1104,11 @@ The command used to load the debugger code. The default is: BEGIN { require 'perl5db.pl' } +=item PERL5DB_THREADED + +If set to a true value, indicates to the debugger that the code being +debugged uses threads. + =item PERL5SHELL (specific to the Win32 port) May be set to an alternative shell that perl must use internally for @@ -1109,6 +1124,20 @@ fit for interactive use, and setting COMSPEC to such a shell may interfere with the proper functioning of other programs (which usually look in COMSPEC to find a shell fit for interactive use). +=item PERL_ALLOW_NON_IFS_LSP (specific to the Win32 port) + +Set to 1 to allow the use of non-IFS compatible LSP's. +Perl normally searches for an IFS-compatible LSP because this is required +for its emulation of Windows sockets as real filehandles. However, this may +cause problems if you have a firewall such as McAfee Guardian which requires +all applications to use its LSP which is not IFS-compatible, because clearly +Perl will normally avoid using such an LSP. +Setting this environment variable to 1 means that Perl will simply use the +first suitable LSP enumerated in the catalog, which keeps McAfee Guardian +happy (and in that particular case Perl still works too because McAfee +Guardian's LSP actually plays some other games which allow applications +requiring IFS compatibility to work). + =item PERL_DEBUG_MSTATS Relevant only if perl is compiled with the malloc included with the perl @@ -1187,7 +1216,7 @@ L and in F in the Perl source distribution. In Perls 5.8.1 and later. If set to C the pre-Perl-5.8.0 signals behaviour (immediate but unsafe) is restored. If set to C the safe (or deferred) signals are used. -See L. +See L. =item PERL_UNICODE