pperl(1p) [debian man page]

PPERL(1p)						User Contributed Perl Documentation						 PPERL(1p)

NAME

       PPerl - Make perl scripts persistent in memory

SYNOPSIS

	 $ pperl foo.pl

DESCRIPTION

       This program turns ordinary perl scripts into long running daemons, making subsequent executions extremely fast. It forks several processes
       for each script, allowing many processes to call the script at once.

       It works a lot like SpeedyCGI, but is written a little differently. I didn't use the SpeedyCGI codebase, because I couldn't get it to
       compile, and needed something ASAP.

       The easiest way to use this is to change your shebang line from:

	 #!/usr/bin/perl -w

       To use pperl instead:

	 #!/usr/bin/pperl -w

WARNINGS

       Like other persistent environments, this one has problems with things like BEGIN blocks, global variables, etc. So beware, and try checking
       the mod_perl guide at http://perl.apache.org/guide/ for lots of information that applies to many persistent perl environments.

Parameters
	 $ pperl <perl params> -- <pperl params> scriptname <script params>

       The perl params are sent to the perl binary the first time it is started up.  See perlrun for details.

       The pperl params control how pperl works. Try -h for an overview.

       The script params are passed to the script on every invocation. The script also gets any current environment variables, the current working
       directory, and everything on STDIN.

Killing
       In order to kill a currently running PPerl process, use:

	 pperl -- -k <scriptname>

       You need to make sure the path to the script is the same as when it was invoked.

       Alternatively look for a .pid file for the script in your tmp directory, and kill (with SIGINT) the process with that PID.

ENVIRONMENT

       pperl uses the PPERL_TMP_PATH environment variable to determine the directory where to store the files used for inter-process
       communication.  By default, the subdirectory .pperl of the user's home directory is used.

BUGS

       The process does not reload when the script or modules change.

       $^S is not represented identically with respect to perl, since your script will be run within an eval block

AUTHOR

       Matt Sergeant, matt@sergeant.org. Copyright 2001 MessageLabs Ltd.

SEE ALSO

       perl. perlrun.

perl v5.14.2							    2011-11-15								 PPERL(1p)

FindBin(3pm)						 Perl Programmers Reference Guide					      FindBin(3pm)

NAME

       FindBin - Locate directory of original perl script

SYNOPSIS

	use FindBin;
	use lib "$FindBin::Bin/../lib";

	or

	use FindBin qw($Bin);
	use lib "$Bin/../lib";

DESCRIPTION

       Locates the full path to the script bin directory to allow the use of paths relative to the bin directory.

       This allows a user to setup a directory tree for some software with directories "<root>/bin" and "<root>/lib", and then the above example
       will allow the use of modules in the lib directory without knowing where the software tree is installed.

       If perl is invoked using the -e option or the perl script is read from "STDIN" then FindBin sets both $Bin and $RealBin to the current
       directory.

EXPORTABLE VARIABLES

	$Bin	     - path to bin directory from where script was invoked
	$Script      - basename of script from which perl was invoked
	$RealBin     - $Bin with all links resolved
	$RealScript  - $Script with all links resolved

KNOWN ISSUES

       If there are two modules using "FindBin" from different directories under the same interpreter, this won't work. Since "FindBin" uses a
       "BEGIN" block, it'll be executed only once, and only the first caller will get it right. This is a problem under mod_perl and other
       persistent Perl environments, where you shouldn't use this module. Which also means that you should avoid using "FindBin" in modules that
       you plan to put on CPAN. To make sure that "FindBin" will work is to call the "again" function:

	 use FindBin;
	 FindBin::again(); # or FindBin->again;

       In former versions of FindBin there was no "again" function. The workaround was to force the "BEGIN" block to be executed again:

	 delete $INC{'FindBin.pm'};
	 require FindBin;

KNOWN BUGS

       If perl is invoked as

	  perl filename

       and filename does not have executable rights and a program called filename exists in the users $ENV{PATH} which satisfies both -x and -T
       then FindBin assumes that it was invoked via the $ENV{PATH}.

       Workaround is to invoke perl as

	perl ./filename

AUTHORS

       FindBin is supported as part of the core perl distribution. Please send bug reports to <perlbug@perl.org> using the perlbug program
       included with perl.

       Graham Barr <gbarr@pobox.com> Nick Ing-Simmons <nik@tiuk.ti.com>

COPYRIGHT

       Copyright (c) 1995 Graham Barr & Nick Ing-Simmons. 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.12.1							    2010-04-26							      FindBin(3pm)